属性を使用してデータをフィルタリングする

Performance Monitoring では、属性を使用してパフォーマンス データをセグメント化し、実際のさまざまなシナリオでアプリのパフォーマンスに注目することができます。

トレース テーブル (パフォーマンスダッシュボードの下部にあります) でトレース名をクリックすると、関心のあるメトリックにドリルダウンできます。フィルターaddボタン (画面の左上) を使用して、属性別にデータをフィルター処理します。次に例を示します。

• ページ URLでフィルタして、サイトの特定のページのデータを表示します
• 有効な接続タイプでフィルター処理して、3g 接続がアプリに与える影響を確認します
• 国でフィルター処理して、データベースの場所が特定の地域に影響していないことを確認します

デフォルト属性

Performance Monitoring は、トレースのタイプに応じてさまざまなデフォルト属性を自動的に収集します。

これらのデフォルト属性に加えて、カスタム コード トレースにカスタム属性を作成して、アプリ固有のカテゴリ別にデータをセグメント化することもできます。たとえば、ゲームでは、ゲーム レベルごとにデータをセグメント化できます。

Web アプリ用に収集される既定の属性

Web アプリのすべてのトレースは、デフォルトで次の属性を収集します。

• ブラウザ
• 国
• 有効接続タイプ
• ページの URL
• サービスワーカーのステータス
• 可視状態

ユーザーデータの収集

カスタム属性を作成する

インストルメント化されたカスタム コード トレースのいずれかでカスタム属性を作成できます。

Performance Monitoring Trace APIを使用して、カスタム属性をカスタム コード トレースに追加します。

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

次の点に注意してください。

• カスタム属性の名前は、次の要件を満たす必要があります。

  • 先頭または末尾の空白、先頭のアンダースコア ( _ ) 文字なし
  • 場所がない
  • 最大長は 32 文字です
  • 名前に使用できる文字は、 AZ 、 az 、および_です。

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

• カスタム属性には、Google が個人を特定できる情報が含まれていないことを確認してください。

  このガイドラインの詳細

import { trace } from "firebase/performance";

const t = trace(perf, "test_trace");
t.putAttribute("experiment", "A");

// Update scenario
t.putAttribute("experiment", "B");

// Reading scenario
const experimentValue = t.getAttribute("experiment");

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

// Read attributes
const traceAttributes = t.getAttributes();
perf_add_custom_attributes.js

const trace = perf.trace("test_trace");
trace.putAttribute("experiment", "A");

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

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

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

// Read attributes
const traceAttributes = trace.getAttributes();
index.js