アプリのエラーに関するスタックトレースの取得

2025-05-05

Microsoft Store 分析 API のこのメソッドを使用して、アプリ内のエラーのスタックトレースを取得します。このメソッドは、過去 30 日間に発生したアプリエラーのスタックトレースのみをダウンロードできます。スタックトレースは、パートナーセンターの ヘルスレポート の Failures セクションでも利用可能です。

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

[前提条件]

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

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

リクエスト

リクエスト構文

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

リクエストヘッダー

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

要求パラメーター

パラメーター	タイプ	説明	必須
アプリケーションID	ひも	スタックトレースを取得するアプリのストア ID。ストア ID は、パートナーセンターの [アプリ ID] ページで使用できます。ストア ID の例は 9WZDNCRFJ3Q8 です。	イエス
cabId(キャビッド)	ひも	エラーに関連付けられた CAB ファイルのスタックトレースを取得するための一意の ID。この ID を取得するには、アプリメソッドでエラーの詳細を取得し、アプリ内の特定のエラーの詳細を取得し、そのメソッドの応答本文で cabId 値を使用します。	イエス

要求の例

次の例では、このメソッドを使用してスタックトレースを取得する方法を示します。 applicationId の値をアプリのストア ID に置き換えます。

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/stacktrace?applicationId=9NBLGGGZ5QDR&cabId=1336373323853 HTTP/1.1
Authorization: Bearer <your access token>

[応答]

応答内容

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

スタックトレース値

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

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

注

このメソッドは、過去 30 日間に発生したアプリエラーのスタックトレースのみをダウンロードできます。

要求と応答の例

次のコードスニペットは、これらの要求の要求と JSON 応答本文の例を示しています。

サンプル依頼

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/stacktrace?applicationId=9NBLGGGZ5QDR&cabId=1234567890123456789
HTTP/1.1
Authorization: Bearer <your access token>

応答の例

{
    "Value": [
        {
            "level": "0",
            "image": "Microsoft.Contoso",
            "function": "HANG_QUIESCE",
            "offset": "0x0000000000000000",
            "isBlamedFrame": true
        },
        {
            "level": "1",
            "image": "unknown.dll",
            "function": "[.ecxr]",
            "offset": "0x0000000000000000",
            "isBlamedFrame": false
        },
        {
            "level": "2",
            "image": "ntdll.dll",
            "function": "RtlpHpSegFree",
            "offset": "0x0000000000000000",
            "isBlamedFrame": false
        },
        {
            "level": "3",
            "image": "ntdll.dll",
            "function": "RtlpHpFreeHeap",
            "offset": "0x0000000000000000",
            "isBlamedFrame": false
        },
        {
            "level": "4",
            "image": "ntdll.dll",
            "function": "RtlpFreeHeapInternal",
            "offset": "0x0000000000000000",
            "isBlamedFrame": false
        }
    ],
    "TotalCount": 5
}

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