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

2025-05-03

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

このメソッドを使用する前に、まず、デスクトップアプリケーションメソッドでエラーの詳細を取得するを使用して、スタックトレースを取得するエラーに関連付けられている CAB ファイルの ID ハッシュを取得する必要があります。

[前提条件]

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

まだ行っていない場合は、Microsoft Store 分析 API の前提条件をすべて満たしてください。
このメソッドの要求ヘッダーで使用する Azure AD アクセストークンを取得します。アクセストークンを取得すると、有効期限が切れるまで 60 分かかります。トークンの有効期限が切れた後、新しいトークンを取得できます。
スタックトレースを取得するエラーに関連付けられている CAB ファイルの ID ハッシュを取得します。この値を取得するには、デスクトップアプリケーションメソッドでエラーの詳細を取得し、アプリ内の特定のエラーの詳細を取得し、そのメソッドの応答本文で cabIdHash 値を使用します。

リクエスト

リクエスト構文

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

リクエストヘッダー

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

要求パラメーター

パラメーター	タイプ	説明	必須
アプリケーションID	ひも	スタックトレースを取得するデスクトップアプリケーションの製品 ID。デスクトップアプリケーションの製品 ID を取得するには、パートナーセンターでデスクトップアプリケーションの分析レポート (正常性レポートなど) を開き、URL から製品 ID を取得します。	イエス
cabIdHash (英語)	ひも	スタックトレースを取得したいエラーに関連付けられている CAB ファイルの一意の ID ハッシュ。この値を取得するには、デスクトップアプリケーションメソッドでエラーの詳細を取得し、アプリケーション内の特定のエラーの詳細を取得し、そのメソッドの応答本文で cabIdHash 値を使用します。	イエス

要求の例

次の例では、このメソッドを使用してスタックトレースを取得する方法を示します。 applicationId パラメーターと cabIdHash パラメーターを、デスクトップアプリケーションに適した値に置き換えます。

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/stacktrace?applicationId=10238467886765136388&cabIdHash=00001111-aaaa-2222-bbbb-3333cccc4444 HTTP/1.1
Authorization: Bearer <your access token>

[応答]

応答内容

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

スタックトレース値

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

価値	タイプ	説明
レベル	ひも	この要素が呼び出し履歴で表すフレーム番号。
画像	ひも	このスタックフレームで呼び出される関数を含む実行可能ファイルまたはライブラリイメージの名前。
機能	ひも	このスタックフレームで呼び出される関数の名前。これは、アプリに実行可能ファイルまたはライブラリのシンボルが含まれている場合にのみ使用できます。
オフセット	ひも	関数の先頭を基準とした現在の命令のバイトオフセット。

応答の例

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

{
  "Value": [
    {
      "level": "0",
      "image": "Contoso.ContosoApp",
      "function": "Contoso.ContosoApp.MainPage.DoWork",
      "offset": "0x25C"
    }
    {
      "level": "1",
      "image": "Contoso.ContosoApp",
      "function": "Contoso.ContosoApp.MainPage.Initialize",
      "offset": "0x26"
    }
    {
      "level": "2",
      "image": "Contoso.ContosoApp",
      "function": "Contoso.ContosoApp.Start",
      "offset": "0x66"
    }
  ],
  "@nextLink": null,
  "TotalCount": 3
}

健康報告書
Microsoft Store サービスを使用して分析データにアクセスする
デスクトップアプリケーションのエラー報告データを取得する
デスクトップアプリケーションのでエラーの詳細を取得する
デスクトップアプリケーションでエラーが発生した場合に CAB ファイルをダウンロード