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

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

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

前提条件

このメソッドを使うには、最初に次の作業を行う必要があります。

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

要求

要求の構文

認証方法	要求 URI
GET	https://manage.devcenter.microsoft.com/v1.0/my/analytics/stacktrace

要求ヘッダー

Header	型	説明
承認	string	必須。 Bearer<トークン> という形式の Azure AD アクセス トークン。

要求パラメーター

パラメーター	型	内容	必須
applicationId	string	スタック トレースを取得するアプリのストア ID。 ストア ID は、パートナー センターのアプリ ID ページで確認できます。 ストア ID は、たとえば 9WZDNCRFJ3Q8 のような文字列です。	はい
cabId	string	スタック トレースを取得するエラーに関連付けられている 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>

[応答]

応答本文

値	種類	説明
値	array	各オブジェクトにスタック トレース データの 1 つのフレームが格納されたオブジェクトの配列です。 各オブジェクトのデータについて詳しくは、次の「スタック トレースの値」セクションをご覧ください。
@nextLink	string	データの追加ページがある場合、この文字列には、データの次のページを要求するために使用できる URI が含まれます。 たとえば、要求の top パラメーターを 10 に設定した場合、クエリに適合するエラーが 10 行を超えると、この値が返されます。
TotalCount	整数 (integer)	クエリの結果データ内の行の総数です。

スタック トレースの値

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

値	種類	説明
level	string	コール スタックでこの要素が表すフレーム番号です。
image	string	このスタック フレームで呼び出される関数が含まれている実行可能ファイルまたはライブラリ イメージの名前です。
関数 (function)	string	このスタック フレームで呼び出される関数の名前。 これは、アプリが実行可能ファイルまたはライブラリのシンボルを含んでいる場合のみ使用可能です。
offset	string	関数の先頭を基準とした現在の命令のバイト オフセットです。

Note

このメソッドは、過去 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 ファイルをダウンロードする