状態レポート
パートナー センターの状態レポートによって、クラッシュや応答停止イベントなど、アプリの品質とパフォーマンスに関連するデータを取得できます。 このデータは、パートナー センターで表示することも、レポートをダウンロードしてオフラインで表示することもできます。 必要に応じて、スタック トレースや CAB ファイルを表示してさらにデバッグ することができます。
または、 Microsoft Store Analytics REST API を使用して、このレポート内のデータをプログラムで取得することもできます。
アプリとゲームパブリッシャーのクラッシュ エラー分類の変更
障害追跡の精度と品質を向上させるために、クラッシュ エラーの分類に関する変更が計画されています。 前述の変更は、2024 年 10 月 15 日以降の正常性データセットの分析情報に適用されます。
Note
2024 年 10 月 15 日の分析情報は、2024 年 10 月 15 日または 16 日に表示されます。 2024 年 10 月 15 日より前の分析情報については、変更はありません。
正常性データセットには過去 30 日間の分析情報が表示されるため、2024 年 10 月 15 日から 11 月 15 日の間に移行期間が発生し、その間に古いデータ バケットと新しいデータ バケットが共存します。
これらの変更は、ダウンロード ハブ、パブリック API、パートナー センター UI、ダウンロード ハブ データセットにアクセスするためのプログラム API 内で使用できる正常性データ セットに影響します。
次の変更は、エラー名の前にあるカテゴリに適用されます。
| カテゴリ | 変更点 |
|---|---|
| - INVALID_POINTER_READ - INVALID_POINTER_WRITE - INVALID_POINTER_EXECUTE - BAD_INSTRUCTION_PTR - NULL_INSTRUCTION_PTR - SOFTWARE_NX_FAULT - ACCESS_VIOLATION_ACCESS_VIOLATION_ |
左側に記載されているすべてのカテゴリは、新しいカテゴリ ACCESS_VIOLATIONの下にグループ化されます。 |
| - ACCESS_VIOLATION_FAIL_FAST | カテゴリから始まるエラーの名前が FAIL_FAST に変更されます。 |
| - STACK_BUFFER_OVERRUN_STACK_BUFFER_OVERRUN | STACK_BUFFER_OVERRUNに名前を変更しました |
| - MISSING_GSFRAME_ - GS_FALSE_POSITIVE_ - GS_POSITIVE_ - GS_NOT_UP2DATE_ - GS_UP2DATE_NOT_KNOWN_ - GS_UNKNOWN_ - GS_COOKIE_INIT_ - GS_SUSPECT_ - ZERO_CANARY_WITH_SE - MINGLY_INTACT_BP_ - NO_MODULE_ -コード_ - PROBABLY_NOT_USING_GS_ - STACK_COOKIE_CHECK_FAILURE - GLOBAL_COOKIE_CORRUPT_ - INCORRECT_STACK_ - COOKIES_MATCH_ - RUNNING_ON_STACK_ - STRING_DEREFERENCE_ |
前述のカテゴリは、エラー名から削除されます。 |
フィルターを適用する
ページの上部で、データを表示する期間を選択できます。 既定の選択は 72H (72 時間) ですが、代わりに 30D を選択して、過去 30 日間のデータを表示できます。 データは、 72H ビューの場合はローカル タイム ゾーンに表示され、 30D ビューの場合は UTC で表示されます。
Filters を展開して、パッケージのバージョン、市場、デバイスの種類でこのページのすべてのデータをフィルター処理することもできます。
- パッケージのバージョン: 既定の設定は All です。 アプリに複数のパッケージが含まれている場合は、ここで特定のパッケージを選択できます。
- 市場: 既定のフィルターは すべての市場ですが、データは 1 つ以上の市場に制限できます。
- デバイスの種類: 既定の設定は All ですが、特定のデバイスの種類を 1 つだけ表示するように選択できます。 Other カテゴリには、make/model が認識されるデバイスが含まれていますが、このフィルターに示されている定義済みのカテゴリのいずれかに含めることはできません。 これらのデバイスの場合、デバイス モデルは、Failure の詳細 レポートの Failure ログ セクションで表示できます。
- OS バージョン: 既定値は すべての OS バージョンですが、特定の OS バージョンを選択できます。
- OS リリース バージョン: 既定値は すべての OS リリース バージョンですが、選択した OS バージョンの特定のリリース バージョンを選択。
- サンドボックス: 既定値は Retail ですが、複数の開発サンドボックス (Xbox Live と統合されたゲームなど) を使用する製品の場合は、ここで特定のものを選択できます。 (製品がサンドボックスを使用していない場合、このフィルターには のみが表示されます小売 適用されません。
- アーキテクチャ: 既定値は すべてのアーキテクチャですが、特定のシステム アーキテクチャの種類を選択できます。 このフィルターは、 30D が選択されている場合にのみ使用できます。
- PRAID: 既定の設定は All ですが、アプリ パッケージの作成時に複数のパッケージ相対アプリ ID (PRAID) を定義した場合は、1 つの PRAID に関連するデータのみを表示するように選択できます。 複数の PRAID を定義していない場合、このフィルターは表示されません。
ここで説明するすべてのグラフの情報には、選択した日付範囲とフィルターが反映されます。 一部のセクションでは、追加のフィルターを適用することもできます。
エラー ヒット
Failure ヒット数グラフには、選択した期間中にアプリを使用したときに発生した 1 日のクラッシュとイベントの数が表示されます。 アプリで発生したイベントの種類ごとに、クラッシュ、ハング、JavaScript 例外、メモリ エラーが個別に追跡されます。
30D期間を選択すると、円マーカーが表示されることがあります。 これは、特定の値の大幅な増加または減少を表しており、把握しておく必要があると思われるものです。 円が表示される日付は、前の週と比較して大幅な増加または減少が検出された週の終わりを表しています。 何が変化したかの詳細を確認するには、円の上にマウスポインターを移動します。
ヒント
直近 30 日間の重要な変化に関連する分析情報の詳細は、「インサイト レポート」で確認できます。
市場別の故障ヒット数
市場別のヒット数グラフには、選択した期間のクラッシュとイベントの合計数が市場別に表示されます。
このデータは、 Table フォームで表示できます。 テーブル フォームには、一度に 5 つの市場が表示され、アルファベット順またはユーザー セッションの最大数または最小数で並べ替えられます。 また、データをダウンロードして、すべての市場の情報をまとめて表示することもできます。
パッケージのバージョン
Package バージョングラフには、選択した期間のクラッシュとイベントの合計数がパッケージ バージョン別に表示されます。 既定では、最もヒット数が多かったパッケージ バージョンが表示され、そこから下に進みます。 この順序を逆にするには、このグラフの Hits 列の矢印を切り替えます。
障害
Failures グラフには、選択した期間のクラッシュとイベントの合計数がエラー名別に表示されます。 各エラー名は、1 つ以上の問題クラス、例外/バグ チェック コード、エラーが発生したイメージ/ドライバーの名前、および関連する関数名の 4 つの部分で構成されます。 既定では、ヒット数が最も多かったエラーが表示され、そこから下に進みます。 この順序を逆にするには、このグラフの Hits 列の矢印を切り替えます。 エラーごとに、失敗の合計数に対する割合も表示されます。
ヒント
このセクションでは、 Unknown のエントリが表示されることがあります。 これは、ベスト エフォートにもかかわらず、1 つ以上の障害の完全な詳細を収集できない場合に発生します。これらはすべて Unknown の下にグループ化されます。 ほとんどの場合、これはストレージの制約が原因で発生しますが、デバイスのプライバシー設定、ネットワーク接続の問題、部分的/無効なクラッシュ ダンプ、その他の要因が原因である可能性もあります。
エラー名の一部として !unknown が表示される場合は、シンボルが存在していなかったため、エラー名を識別できませんでした。 正確な故障分析を得るには、必ずパッケージにシンボルを含めるようにしてください。 「 アプリ パッケージの構成」を参照してください。 これに対し、 !unknown_error_in_ と !unknown_function を含むエラー名は、他のさまざまな理由で完全な詳細を収集できなかったことを意味します。
失敗の詳細レポートを表示するには、エラー名を選択します。 シンボル ファイルが含まれている場合、 Failure の詳細 レポートには、過去 1 か月間のエラー ヒット数と、発生の詳細 (日付、パッケージ バージョン、デバイスの種類、デバイス モデル、OS ビルド) とスタック トレースや CAB ファイルへのリンク (使用可能な場合) が一覧表示されるエラー ログが含まれます。
ヒント
CAB ファイルは、Windows Insider ビルドを使用しているコンピューターでエラーが発生した場合にのみ使用できるため、すべてのエラーに CAB ダウンロード オプションが含まれるわけではありません。 CAB ファイルを含むエラーのみを表示するには、セクション フィルターで [Failures with downloads]\(ダウンロードでの失敗\) を選びます。 また、[エラー ログ] の [リンク] 見出しをクリックすると、結果を並べ替えて、CAB ファイルを含むエラーを一覧の先頭に表示できます。
Failure の詳細 ページには、エラーの原因となった上位スタックを示すスタックの普及率グラフ、割合順に並べ替えられた、Device 構成 (30D) グラフも表示されます。このグラフには、障害が発生したデバイスの構成に関する詳細が表示されます。
クラッシュフリーのセッションとデバイス (30 日間)
Crash なしのセッションとデバイスグラフには、過去 30 日間にクラッシュが発生しなかったデバイスまたはユーザー セッションの割合が表示されます。 この情報は、クラッシュによりユーザーが受ける影響の大きさを把握するのに役立ちます。 たとえば、あるアプリで 1 日に 1 万のクラッシュが発生するとします。 デバイスの 90% が影響を受ける場合は、おそらく、それを重大として分類し、すぐに修正することでしょう。 しかし、アプリを使っているデバイスの数が 5% しかない場合は、優先度を低くするかもしれません。
このグラフには 2 つのタブがあります。
- クラッシュのないデバイス: 毎日 (過去 30 日間) に障害が発生しなかった一意のデバイスの割合を示します。
- クラッシュフリー セッション: 毎日 (過去 30 日間) に失敗しなかった一意のユーザー セッションの割合を示します。
クラッシュ 率
クラッシュ率は、ゲームに対して発生したクラッシュの合計を、特定の期間に発生したアクティブ化の合計で除算して、ゲームをプレイしているすべてのユーザーに対して定義されます。 ゲームがプレイのために開かれた/開始/起動されるたびに、1 つのアクティブ化としてカウントされます。 アクティブ化とクラッシュのタイムラインは異なる場合があります。 アクティブ化が今日行われた可能性がありますが、クラッシュは翌日に発生しました。 クラッシュ率は、上記の期間内にのみカウントされます。 どのアクティブ化によってクラッシュが発生したかについての情報は提供されません。