特定のアプリのコードにカスタム モニタリングを追加する

Performance Monitoring では、トレースを収集してアプリのパフォーマンスをモニタリングできます。トレースとは、アプリ内の 2 つの時点の間でキャプチャされたパフォーマンス データのレポートです。

独自のトレースを作成して、アプリ内の特定のコードに関連付けられたパフォーマンス データをモニタリングできます。カスタムコード トレースを使用すると、一連の画像の読み込みやデータベースのクエリなど、アプリが特定のタスクや一連のタスクを完了するのにかかる時間を測定できます。

カスタムコード トレースのデフォルトの指標は「所要時間」（トレースの開始時点と終了時点の間の時間）ですが、カスタム指標を追加することもできます。

コードでは、Performance Monitoring SDK に用意された API を使用して、カスタムコード トレースの開始と終了を定義します。

カスタムコード トレースは作成後にいつでも開始でき、スレッドセーフです。

これらのトレースで収集されるデフォルトの指標は「所要時間」であるため、「所要時間トレース」と呼ばれることもあります。

これらのトレースのデータは、パフォーマンス ダッシュボードの下部にあるトレース テーブルの [カスタム トレース] サブタブで表示できます（このページの後半で、コンソールの使用をご覧ください）。

デフォルト属性、カスタム属性、カスタム指標

カスタムコード トレースでは、Performance Monitoring によってデフォルトの属性（アプリのバージョン、国、デバイスなどの一般的なメタデータ）が自動的にログに記録され、Firebase コンソールでトレースするデータをフィルタできます。また、カスタム属性（ゲームレベルやユーザー プロパティなど）を追加してモニタリングすることもできます。

カスタムコード トレースは、トレースの範囲内で発生したパフォーマンス関連イベントのカスタム指標を記録するように構成することもできます。たとえば、キャッシュのヒット数とミス数や、UI が一定の期間反応しなかった回数についてのカスタム指標を作成できます。

カスタム属性とカスタム指標は、トレースのデフォルトの属性とデフォルトの指標とともに Firebase コンソールに表示されます。

カスタムコード トレースを追加する

Performance Monitoring の Trace API を使用して、カスタムコード トレースを追加し、特定のアプリケーション コードをモニタリングします。

次の点にご注意ください。

  • アプリには複数のカスタムコード トレースを設定できます。
  • 複数のカスタムコード トレースを同時に実行できます。
  • カスタムコード トレースの名前には要件があります。先頭も末尾も空白ではなく、先頭がアンダースコア（_）でない、100 文字以下の名前にする必要があります。
  • カスタムコード トレースには、カスタム指標とカスタム属性を追加できます。

カスタムコード トレースを開始して停止するには、トレースするコードを次のようなコードで囲みます。

Trace customTrace = FirebasePerformance.instance.newTrace('custom-trace');
await customTrace.start();

// Code you want to trace

await customTrace.stop();

カスタムコード トレースにカスタム指標を追加する

カスタムコード トレースにカスタム指標を追加するには、Performance Monitoring Trace API を使用します。

次の点にご注意ください。

  • カスタム指標の名前には要件があります。先頭や末尾が空白ではなく、先頭がアンダースコア（_）でない 100 文字以下の名前にする必要があります。
  • 各カスタムコード トレースは、最大 32 個の指標（デフォルトの所要時間指標を含む）を記録できます。

カスタム指標を追加するには、次のようなコード行を追加し、イベントが発生するたびに実行されるようにします。たとえば、このカスタム指標は、キャッシュのヒットや再試行など、アプリで発生したパフォーマンス関連のイベントをカウントします。

Trace customTrace = FirebasePerformance.instance.newTrace("custom-trace");
await customTrace.start();

// Code you want to trace

customTrace.incrementMetric("metric-name", 1);

// More code

await customTrace.stop();

カスタムコード トレースのカスタム属性を作成する

カスタム属性を使用するには、属性を定義するアプリにコードを追加して、特定のカスタムコード トレースに関連付けます。カスタム属性は、トレースの開始から停止までの間の任意の時点に設定できます。

次の点にご注意ください。

  • カスタム属性の名前には要件があります。先頭や末尾が空白ではなく、先頭がアンダースコア（_）でない 32 文字以下の名前にする必要があります。

  • 各カスタムコード トレースでは、最大 5 つのカスタム属性を記録できます。

  • Google が個人を特定できる情報を含むカスタム属性は使用しないでください。

Trace trace = FirebasePerformance.instance.newTrace("test_trace");

// Update scenario.
trace.putAttribute("experiment", "A");

// Reading scenario.
String? experimentValue = trace.getAttribute("experiment");

// Delete scenario.
trace.removeAttribute("experiment");

// Read attributes.
Map<String, String> traceAttributes = trace.getAttributes();

パフォーマンス データの追跡、表示、フィルタリング

ダッシュボードで特定の指標を追跡する

主要な指標の傾向を確認するには、パフォーマンス ダッシュボードの上部にある指標ボードに追加します。前週比の変化を確認することで、すみやかに回帰を特定できます。また、最近のコード変更でパフォーマンスが改善されたか確認することもできます。

指標ボードに指標を追加するには、Firebase コンソールのパフォーマンス ダッシュボードに移動し、[ダッシュボード] タブをクリックします。空の指標カードをクリックし、ボードに追加する既存の指標を選択します。入力された指標カードのその他アイコン（⋮）をクリックすると、指標の置き換えや削除などの詳細オプションが表示されます。

指標ボードには、グラフおよび数値（割合の変化）の形式で、収集された指標データが時系列で表示されます。

ダッシュボードの使用で詳細をご確認ください。

トレースとそのデータを表示する

トレースを表示するには、Firebase コンソールのパフォーマンス ダッシュボードに移動し、トレース テーブルまで下にスクロールして、適切なサブタブをクリックします。表には、各トレースの主要な指標が表示されます。また、特定の指標の変化率でリストを並べ替えることもできます。

トレース テーブルでトレース名をクリックすると、さまざまな画面をクリックして移動し、トレースを調べて目的の指標にドリルダウンできます。ほとんどのページでは、[フィルタ] ボタン（画面左上）を使用して属性でデータをフィルタできます。以下に例を示します。

  • 過去のリリースや最新のリリースに関するデータを表示するには、[アプリのバージョン] でフィルタします。
  • 古いデバイスにおけるアプリの処理方法を確認するには、[デバイス] でフィルタします。
  • データベースのロケーションが特定のリージョンに影響していないことを確認するには、[国] でフィルタします。

詳細については、トレースのデータを表示するをご覧ください。

次のステップ

  • パフォーマンス データを調査することを目的とする属性の使用について、詳しく確認する。

  • Firebase コンソールでパフォーマンスの問題を追跡する方法を学習する。

  • アプリのパフォーマンスを低下させるコード変更に関するアラートを設定する。たとえば、特定のカスタムコード トレースの所要時間が設定したしきい値を超えた場合に、チームに送信するメール通知アラートを構成できます。