次の方法で共有


デスクトップ アプリケーションのエラー報告データを取得する

Windows デスクトップ アプリケーション プログラムに追加したデスクトップ アプリケーションの集計エラー報告データを取得するには、Microsoft Store 分析 API の次のメソッドを使用します。 このメソッドは、過去 30 日間に発生したエラーのみを取得できます。 この情報は、パートナー センターのデスクトップ アプリケーションの 正常性レポート でも確認できます。

[前提条件]

このメソッドを使用するには、まず次の操作を行う必要があります。

リクエスト

リクエスト構文

メソッド URI リクエスト
取得する https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failurehits

リクエストヘッダー

ヘッダ タイプ 説明
認証 ひも 必須。 Bearer<token> 形式の Azure AD アクセス トークン。

要求パラメーター

パラメーター タイプ 説明 必須
アプリケーションID ひも エラー報告データを取得するデスクトップ アプリケーションの製品 ID。 デスクトップ アプリケーションの製品 ID を取得するには、パートナー センター でデスクトップ アプリケーションの 分析レポート (正常性レポートなど) を開き、URL から製品 ID を取得します。 イエス
開始日 日付 取得するエラー報告データの日付範囲の開始日を、mm/dd/yyyy形式で指定します。 既定値は現在の日付です。

注: このメソッドは、過去 30 日間に発生したエラーのみを取得できます。
いいえ
終了日 日付 取得するエラー報告データの日付範囲の終了日を、mm/dd/yyyy形式で指定します。 既定値は現在の日付です。 いいえ
ページのトップへ 整数 (int) 要求で返されるデータの行数。 最大値と既定値 (指定しない場合) は 10000 です。 クエリにさらに行がある場合、応答本文には次のリンクが含まれています。このリンクを使用して、データの次のページを要求できます。 いいえ
スキップ 整数 (int) クエリでスキップする行数。 大きなデータ セットをページングするには、このパラメーターを使用します。 たとえば、top=10000 と skip=0 はデータの最初の 10000 行を取得し、top=10000 と skip=10000 は次の 10000 行のデータを取得します。 いいえ
フィルター ひも 応答内の行をフィルター処理する 1 つ以上のステートメント。 各ステートメントには、応答本文のフィールド名と、eq または ne 演算子に関連付けられている値が含まれており、ステートメントは、、またはを使用して結合できます。 文字列値は、 フィルター パラメーター内で一重引用符で囲む必要があります。 応答本文から次のフィールドを指定できます。

  • ファイル名
  • アプリケーションバージョン
  • 障害名
  • フェイルハッシュ
  • シンボル
  • オペレーティングシステムバージョン
  • osビルド
  • osリリース
  • イベントタイプ
  • 市場
  • デバイスタイプ
  • productName を する
  • 日付
いいえ
集約レベル ひも 集計データを取得する時間範囲を指定します。 次のいずれかの文字列を指定できます:、または月します。 指定しない場合、既定値は day です または を指定した場合、failureNamefailureHash の値は1000バケットに制限されます。

いいえ
オーダーバイ (orderby) ひも 結果データ値を並べ替えるステートメント。 構文は orderby=field [order],field [order],...です。 フィールド パラメーターには、次のいずれかの文字列を指定できます。
  • ファイル名
  • アプリケーションバージョン
  • 障害名
  • フェイルハッシュ
  • シンボル
  • オペレーティングシステムバージョン
  • osビルド
  • osリリース
  • イベントタイプ
  • 市場
  • デバイスタイプ
  • productName を する
  • 日付
order パラメーターは省略可能で、asc または desc を使用して各フィールドの昇順または降順を指定できます。 既定値は ascです。

例として次のような orderby 文字列があります: orderby=date、market

いいえ
グループバイ ひも 指定したフィールドにのみデータ集計を適用するステートメント。 次のフィールドを指定できます。
  • 障害名
  • フェイルハッシュ
  • シンボル
  • オペレーティングシステムバージョン
  • イベントタイプ
  • 市場
  • デバイスタイプ

返されるデータ行には、 groupby パラメーターで指定されたフィールドと、次のものが含まれます。

  • 日付
  • アプリケーションID
  • アプリケーション名
  • で eventCount を行う

groupby パラメーターは aggregationLevel パラメーターと共に使用できます。 例: &groupby=failureName,market&aggregationLevel=week

いいえ

要求の例

次の例では、エラー報告データを取得するためのいくつかの要求を示します。 applicationId 値をデスクトップ アプリケーションの製品 ID に置き換えます。

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failurehits?applicationId=10238467886765136388&startDate=1/1/2018&endDate=2/1/2018&top=10&skip=0 HTTP/1.1
Authorization: Bearer <your access token>

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failurehits?applicationId=10238467886765136388&startDate=8/1/2017&endDate=8/31/2017&skip=0&filter=market eq 'US' and deviceType eq 'PC' HTTP/1.1
Authorization: Bearer <your access token>

[応答]

応答内容

価値 タイプ 説明
価値 配列 集計エラー報告データを含むオブジェクトの配列。 各オブジェクトのデータの詳細については、以下のセクション エラー値 参照してください。
@nextLink ひも 追加のデータ ページがある場合、この文字列には、データの次のページを要求するために使用できる URI が含まれます。 たとえば、この値は、要求の top パラメーターが 10000 に設定されているが、クエリに 1,0000 行を超えるエラーがある場合に返されます。
トータルカウント 整数 (integer) クエリのデータ結果内の行の合計数。

エラー値

Value 配列内の要素には、次の値が含まれています。

価値 タイプ 説明
日付 ひも エラー データの日付範囲の最初の日付 (yyyy-mm-dd形式)。 要求で 1 日が指定されている場合、この値はその日付になります。 要求で長い日付範囲が指定されている場合、この値はその日付範囲の最初の日付になります。 時間aggregationLevel 値を指定する要求の場合、この値には hh:mm:ss形式の時刻値も含まれます。
アプリケーションID ひも エラー データを取得したデスクトップ アプリケーションの製品 ID。
製品名 ひも 関連付けられている実行可能ファイルのメタデータから派生したデスクトップ アプリケーションの表示名。
アプリ名 ひも 未定
ファイル名 ひも デスクトップ アプリケーションの実行可能ファイルの名前。
エラー名 ひも エラーの名前。1 つ以上の問題クラス、例外/バグ チェック コード、エラーが発生したイメージの名前、および関連する関数名の 4 つの部分で構成されます。
failureHash (フェイリャーハッシュ) ひも エラーの識別子(ユニーク ID)。
記号 ひも このエラーに割り当てられたシンボル。
osビルド ひも エラーが発生した OS の 4 部構成のビルド番号。
osVersion (英語) ひも デスクトップ アプリケーションをインストールする OS のバージョンを指定する次のいずれかの文字列。

  • Windows 7
  • Windows 8.1
  • Windows 10
  • Windows 11
  • Windows Server 2016
  • Windows Server 1709 の場合
  • 不明
osリリース ひも エラーが発生した OS リリースまたはフライト リング (OS バージョン内のサブ集団として) を指定する次の文字列のいずれか。

Windows 11 の場合: バージョン 2110

Windows 10 の場合:

  • バージョン 1507
  • バージョン 1511
  • バージョン 1607
  • バージョン 1703
  • バージョン 1709
  • バージョン 1803
  • リリース プレビュー
  • インサイダーファスト
  • インサイダースロー

Windows Server 1709 の場合:

  • RTMの

Windows Server 2016 の場合:

  • バージョン 1607

Windows 8.1 の場合:

  • アップデート1

Windows 7 の場合:

  • サービスパック 1

OS リリースまたはフライティング リングが不明な場合、このフィールドの値は [不明] になります

イベントタイプ ひも エラー イベントの種類を示す次のいずれかの文字列。
  • クラッシュ
  • ハング
  • メモリ
  • JSEの
市場 ひも デバイス市場の ISO 3166 国コード。
デバイスタイプ ひも エラーが発生したデバイスの種類を指定する次のいずれかの文字列。

  • パソコン
  • サーバー
  • タブレット
  • 不明
アプリケーションバージョン ひも エラーが発生したアプリケーション実行可能ファイルのバージョン。
イベント数 指定された集計レベルでこのエラーに起因するイベントの数。

応答の例

次の例は、この要求の JSON 応答本文の例を示しています。

{
  "Value": [
    {
      "date": "2018-02-01",
      "applicationId": "10238467886765136388",
      "productName": "Contoso Demo",
      "appName": "Contoso Demo",
      "fileName": "contosodemo.exe",
      "failureName": "SVCHOSTGROUP_localservice_IN_PAGE_ERROR_c0000006_hardware_disk!Unknown",
      "failureHash": "11242ef3-ebd8-d525-838d-b5497b225695",
      "symbol": "hardware_disk!Unknown",
      "osBuild": "10.0.15063.850",
      "osVersion": "Windows 10",
      "osRelease": "Version 1703",
      "eventType": "crash",
      "market": "US",
      "deviceType": "PC",
      "applicationVersion": "2.2.2.0",
      "eventCount": 0.0012422360248447205
    }
  ],
  "@nextLink": "desktop/failurehits?applicationId=10238467886765136388&aggregationLevel=week&startDate=2018/02/01&endDate2018/02/08&top=1&skip=1",
  "TotalCount": 21
}