次の方法で共有


診断機能

重要

Visual Studio App Center は、2026 年 6 月 30 日まで引き続きサポートされる分析機能と診断機能を除き、2025 年 3 月 31 日に廃止されました。 詳細を参照してください。

このセクションでは、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 をアタッチできます。 これを行うには、対象プラットフォーム AndroidiOSmacOSReact NativetvOSUnityUWPWPF/WinFormsMAUI/Xamarin で App Center SDK を使用します。 グループ内の問題をクリックすると、クラッシュまたはエラーに関連付けられているユーザー ID が表示されます。

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

添付ファイル

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

クラッシュ レポートに添付ファイルを追加する方法については、 AndroidiOSmacOSReact NativeUWPWPF/WinFormsMAUI/Xamarin アプリの SDK クラッシュに関するドキュメントを参照してください。

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

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

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

クラッシュ前のイベント

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

カスタム イベントを定義するには、AndroidiOSmacOSReact NativeWindowsMAUI/XamarinSDK ドキュメントを参照してください。

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

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

キーと値のペア

文字列値のディクショナリを (キーと値のペアとして) TrackError メソッドに渡すことで、App Center に送信されるエラー レポートを調整して、エラーの追加コンテキストを含めることができます。 これらのプロパティは省略可能です。 キーと値のペアを設定するには、 AndroidMAUI/XamarinUnityUWPWPF/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

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

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

スレッド数

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

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

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

[警告の構成]

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

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

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

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

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

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

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

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