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

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

トレーステーブル（パフォーマンスダッシュボードの下部）でトレース名をクリックすると、目的の指標にドリルダウンできます。[フィルタ ] ボタン（画面左上）を使用して属性でデータをフィルタできます。以下に例を示します。

属性でフィルタされた Firebase Performance Monitoring データの画像

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

属性に基づいてより強力に分析を行うには、パフォーマンスデータを BigQuery にエクスポートしてください。

デフォルト属性

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

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

Apple アプリと Android アプリのデフォルト属性

Apple アプリと Android アプリのすべてのトレースではデフォルトで次の属性が収集されます。

アプリのバージョン
国
OS レベル
デバイス
無線通信
携帯通信会社

さらに、ネットワークリクエストトレースは次の属性も収集します。

MIME タイプ

ユーザーデータの収集

ユーザーデータの収集: Performance Monitoring は、名前、メールアドレス、電話番号などの個人情報（PII）を一切収集しません。デベロッパーは、カスタムコードトレースにカスタム属性を作成することで、Performance Monitoring を使用して追加のデータを収集できます。Performance Monitoring を通じて収集されるデータに、Google が個人を特定できる情報は含まれません。

個人を特定できる情報を含まないログメッセージの例を次に示します。

trace.putAttribute("experiment", "A");

次は、個人を特定できる情報を含む例です（アプリではこのようなカスタム属性を使用しないでください）。

trace.putAttribute("email", user.getEmailAddress());

個人を特定できる情報が公開されるようなデータは、予告なく削除される場合があります。

カスタム属性の作成

計測されたカスタムコードトレースのいずれかにカスタム属性を作成できます。

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

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

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

カスタム属性の名前は次の要件を満たす必要があります。
- 先頭や末尾に空白は使用できず、先頭にアンダースコア（_）も使用できません。
- スペースは使用できません。
- 最大長は 32 文字です。
- 名前に使用できる文字は、A-Z、a-z、_ です。
各カスタムコードトレースでは、最大 5 つのカスタム属性を記録できます。
カスタム属性には、Google が個人を特定できる情報が含まれていないことを確認してください。
このガイドラインの詳細
ユーザーデータの収集: Performance Monitoring は、名前、メールアドレス、電話番号などの個人情報（PII）を一切収集しません。デベロッパーは、カスタムコードトレースにカスタム属性を作成することで、Performance Monitoring を使用して追加のデータを収集できます。Performance Monitoring を通じて収集されるデータに、Google が個人を特定できる情報は含まれません。

個人を特定できる情報を含まないログメッセージの例を次に示します。
```
trace.putAttribute("experiment", "A");
```
次は、個人を特定できる情報を含む例です（アプリではこのようなカスタム属性を使用しないでください）。
```
trace.putAttribute("email", user.getEmailAddress());
```
個人を特定できる情報が公開されるようなデータは、予告なく削除される場合があります。

Kotlin+KTX

Firebase.performance.newTrace("test_trace").trace {
    // Update scenario.
    putAttribute("experiment", "A")

    // Reading scenario.
    val experimentValue = getAttribute("experiment")

    // Delete scenario.
    removeAttribute("experiment")

    // Read attributes.
    val traceAttributes = this.attributes
}MainActivity.kt

Java

Trace trace = FirebasePerformance.getInstance().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();MainActivity.java