次の方法で共有


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

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
}