処理されたエラーにイベントを使用する方法

重要

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

重要

処理されたエラーは、App Center のクラッシュ サービスの一部としてまだ使用できません。 1 つの回避策は、カスタム イベントを使用することです。 これは、"処理されたエラー" がサポートされる方法ではなく、イベントの主な目的でもありません。 ただし、このページには、処理されたエラーを報告するためにイベントを最適に使用する方法に関するアドバイスが含まれています。

このセクションでは、イベントを使用して処理されたエラーに関する情報を取得する方法について説明します。 処理されたエラーのこのようなイベントは、エラーが発生した回数のカウントに関心がある場合に役立ちます。 イベントごとに、カウント、カウントの変更、ユーザー数、ユーザー数の変更、ユーザーごとのカウント、セッションごとのカウントの6つの指標が得られます。

イベント名

イベントには、コンテキスト情報を提供する名前を付けすることをお勧めします。 処理されたエラーは一般的な場合があるため、より明確な方法でエラーを識別する追加情報を提供する必要があります。 コンテキスト情報の例として、エラーが処理されるファイル/メソッド名があります。

:

ユーザーが WiFi に接続できない頻度を理解したい状況を想像してみましょう。 "UnknownHostException:ConnectWiFi"。"UnknownHostException" は例外のジェネリック名、"ConnectWiFi" はメソッド名です。

イベントのプロパティ

さまざまな特性 (デバイスの種類、OS バージョン、ビルド番号、製造元など) に対するこれらの処理されたエラーの分布の詳細を理解したい場合は、プロパティとプロパティ値を使用できます。

:

プロパティ キー: OS バージョン

プロパティ値 1: 10.2.1

プロパティ値 2: 10.3

プロパティ値 3: 9.3.5

特定のユース ケースによっては、代わりにイベント名の一部としてこれらを含めることができます。 ただし、イベント名の数は 200 に制限されています。 処理されたエラーにイベントを使用して最も価値を得るために、何に答えたいのかを知っていることが重要です。 バージョンでフィルター処理する場合は、イベント ページの右上にあるドロップダウンを使用できるため、プロパティの一部として含める必要はありません。

APP VERSIONS リストを使用して、レポートするバージョンを選択する

例外メッセージを含める場合は、別のプロパティとして含めることができます。

:

プロパティ キー: 例外メッセージ

プロパティ値: スレッド "main" java.lang.RuntimeException での例外

プロパティ値の文字数は 64 文字に制限されているため、文字列を切り捨てたりフィルター処理したりする必要があります。 最後に、同じ理由で、スタック トレースをイベント名またはプロパティ値の一部として含めてはいけません。