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

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

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

• アプリのバージョンでフィルタリングして、過去のリリースまたは最新のリリースに関するデータを表示します
• デバイスでフィルタリングして、古いデバイスがアプリをどのように処理するかを確認します
• 国でフィルタリングして、データベースの場所が特定の地域に影響を与えていないことを確認します

属性に基づくさらに強力な分析を行うには、パフォーマンスデータをBigQueryにエクスポートします。

デフォルトの属性

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

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

AppleおよびAndroidアプリのデフォルト属性

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

• アプリ版
• 国
• OSレベル
• デバイス
• 無線
• キャリア

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

• MIMEタイプ

ユーザーデータの収集

カスタム属性を作成する

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

Performance Monitoring Trace API（ Swift | Obj-C ）を使用して、カスタムコードトレースにカスタム属性を追加します。

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

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

• カスタム属性の名前は、次の要件を満たしている必要があります。先頭または末尾の空白、先頭の下線（ _ ）文字、最大長は32文字です。

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

• Googleに対して個人を個人的に識別する情報を含むカスタム属性を使用しないでください。

  このガイドラインの詳細

let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

trace.setValue("A", forAttribute: "experiment")

// Update scenario.
trace.setValue("B", forAttribute: "experiment")

// Reading scenario.
let experimentValue:String? = trace.valueForAttribute("experiment")

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

// Read attributes.
let attributes:[String, String] = trace.attributes;

FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

[trace setValue:@"A" forAttribute:@"experiment"];

// Update scenario.
[trace setValue:@"B" forAttribute:@"experiment"];

// Reading scenario.
NSString *experimentValue = [trace valueForAttribute:@"experiment"];

// Delete scenario.
[trace removeAttribute:@"experiment"];

// Read attributes.
NSDictionary <NSString *, NSString *> *attributes = [trace attributes];