診断機能

  • [アーティクル]

重要

Visual Studio App Center は、2025 年 3 月 31 日に廃止される予定です。 完全に廃止されるまで Visual Studio App Center を引き続き使用できますが、移行を検討できる推奨される代替手段がいくつかあります。

サポートタイムラインと代替手段の詳細については、こちらを参照してください。

このセクションでは、App Center の診断サービスで使用できる機能セットについて説明します。

クラッシュとエラー分析

App Center 診断では、App Center によって自動的に生成された分析データを表示して、アプリでクラッシュまたはエラーが発生したタイミングを把握できます。

既定では、App Center にアプリの 1 日あたりのクラッシュとエラーが横に並んで表示されます。

左上のタブを使用してクラッシュとエラーにドリルダウンします。 これを行うと、左側のグラフは 1 日あたりのクラッシュ/エラーの数を示し、右側のグラフには影響を受けるユーザーの数が表示されます。 アプリのバージョン、期間、状態でグラフをフィルター処理して、より焦点を絞ったビューを表示します。

注意

App Center では、機密情報がフィルター処理される可能性があります。 フィルター処理される機密情報の例としては、URL、JSON 文字列、要求 ID があります。

App Center では、クラッシュとエラーに関する分析が表示されます

グループ化

App Center 診断では、問題の理由やアプリで問題が発生した場所など、類似点によってクラッシュとエラーがグループ化されます。 クラッシュとエラー グループごとに、失敗したコード行、クラスまたはメソッド名、ファイル名、行番号、クラッシュ、またはエラーの種類とメッセージが表示され、これらのグループを一目で理解しやすくなります。 グループを選択して詳細情報を表示し、詳細な問題レポートとログの一覧にアクセスします。 これにより、クラッシュやエラー時のアプリの動作をより深く理解するために、機能セットをさらに詳しく調べることができます。

URL の呼び出しが失敗した ("azure.com の呼び出しエラーや google.com" などの) クラッシュが原因でクラッシュが発生した場合、App Center はその URL によってクラッシュをグループ化できます (たとえば、すべての失敗した azure.com はグループ化され、呼び出しに失敗 google.com はグループ化されます)。 ただし、クラッシュ ログから HTTP または HTTPS の前に付加された URL を削除するため、このグループ化は、次の http://azure.com"構文を回避する場合にのみ機能します。は他の Azure 呼び出しとグループ化されませんが、"エラー呼び出し azure.com" は同様のエラー レポートでグループ化されます。

App Center グループは、類似点に基づいてクラッシュとエラーをグループ化します

ユーザー ID

App Center Diagnostics を使用すると、クラッシュやエラーにユーザー ID をアタッチできます。 これを行うには、対象となるプラットフォーム Android、Apache Cordova、iOS、macOS、React Native、tvOS、Unity、UWP、WPF/WinForms、MAUI/Xamarin で App Center SDK を使用します。 グループ内の問題をクリックすると、クラッシュまたはエラーに関連付けられているユーザー ID が表示されます。

ユーザー ID をアタッチした後、App Center の検索機能を使用して、指定した ID でクラッシュを検索できます。 これを行う方法については、App Center の 検索ドキュメントに従います。

[Attachments]

App Center 診断 UI では、クラッシュレポートとエラー レポートのバイナリ添付ファイルとテキスト添付ファイルを表示およびダウンロードできます。

クラッシュ レポートに添付ファイルを追加する方法については、Android、iOS、macOS、React Native、UWP、WPF/WinForms、MAUI/Xamarin アプリの SDK クラッシュに関するドキュメントを参照してください。

処理されたエラーの添付ファイルは、Android、Unity、UWP、WPF、WinForms、Xamarin プラットフォームでのみサポートされます。 Android、Unity、UWP、WPF/WinForms、MAUI/Xamarin アプリの SDK ドキュメントで、エラー レポートに添付ファイルを追加する方法について説明します。

添付ファイルを表示してダウンロードするには、クラッシュまたはエラー グループ、特定のデバイス レポートを選択し、[添付ファイル] タブをクリックします。

App Center を使用すると、クラッシュ レポートとエラー レポートに添付ファイルを追加できます

クラッシュ前のイベント

クラッシュに至るまでのイベントを追跡して、アプリの状態に関する有用な情報をキャプチャします。

カスタム イベントを定義するには、Android、iOS、macOS、React Native、Windows、MAUI/Xamarin の SDK ドキュメントをチェックします。

クラッシュの前にイベントを表示するには、クラッシュ グループ、特定のデバイス レポートを選択し、[イベント] タブをクリックします。

App Center を使用すると、クラッシュにつながるイベントを追跡できます

キーと値のペア

(キーと値のペアとして) 文字列値のディクショナリを メソッドに渡すことで、App Center に送信されるエラー レポートを調整して、エラーの追加のコンテキストを TrackError 含めることができます。 これらのプロパティは省略可能です。 キー値のペアを設定するには、 Android、 MAUI/Xamarin、 Unity、 UWP、 WPF/WinForms のドキュメントを参照してください。

注意

この機能は、現在、Android、iOS、Xamarin、React Native、Unity、UWP、WinForms、WPF エラーでのみサポートされています。

診断データのエクスポート

App Center では、診断 (クラッシュとエラー) の生データを Azure にエクスポートできます。 診断データを Blob Storage にエクスポートして、データをカスタマイズします。

クラッシュ、添付ファイル、エラーをエクスポートするには、 Export Configurations API を呼び出す必要があります。

POST /v0.1/apps/{owner_name}/{app_name}/export_configurations

exportEntities API プロパティのフィールドで、エクスポートするデータの種類 (クラッシュ、エラー、添付ファイル) を指定する必要があります。 そうすると、シンボリック化された完全なクラッシュと、対応するスタック トレースがエクスポートされます。

の利点と、データをエクスポートする方法の詳細については、 エクスポート ドキュメントを参照してください。

Threads

クラッシュ レポートでは、アプリがクラッシュしたときにアクティブだった現在のスレッドを確認できます。 クラッシュしたスレッドは赤で強調表示され、アプリの状態をよりよく理解できます。

App Center には、クラッシュ時の現在のスレッドが表示されます

注意

Windows では、クラッシュしたスレッドからのスタック トレースのみがレポートに表示されます。 クラッシュの時点での他のスレッドの状態の表示は、Windows ではサポートされていません。

[警告の構成]

App Center アプリ定義の設定を構成してメール通知を送信することで、クラッシュを引き続き確認できます。 アプリごとにこの設定を構成して、新しいクラッシュ グループが作成されたときにすぐにメールを送信するか、アプリの上位クラッシュを含む毎日の概要メールを送信できます。 これらのアラートを構成するには:

  1. App Center にログインし、アプリを選択する
  2. 左側のメニューで、[設定] に移動します
  3. [Email通知] をクリックします
  4. [ 即時]、[ 毎日]、または [なし] を選択します。 既定の構成は [なし] に設定されています。

[クラッシュメール通知の頻度] の設定のスクリーンショット

通知の詳細については、 App Center ダッシュボードのドキュメントを参照してください。

バグ トラッカーを作成する

サード パーティのバグ トラッカー ツールを App Center に統合すると、クラッシュの情報を得て適切に管理できるようになります。 開始する方法については、バグ トラッカーのドキュメントを参照してください。

App Center にレポートをアップロードする

API を使用してクラッシュをアップロードするドキュメントが移動しました。