Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

カスタムURLパターンを作成する

Firebase Performance Monitoringは、同様のネットワークリクエストのデータを自動的に集計して、ネットワークリクエストのパフォーマンスの傾向を理解するのに役立ちます。

ネットワーク要求のURLが一致した場合、各要求、FirebaseチェックのURLパターンを。リクエストのURLがURLパターンと一致する場合、FirebaseはリクエストのデータをURLパターンの下に自動的に集約します。

あなたはFirebaseは、その派生でキャプチャされていないこと、特定のURLパターンを監視するためのカスタムURLパターンを作成することができる自動URLパターンマッチング。たとえば、カスタムURLパターンを使用して、特定のURLのトラブルシューティングを行ったり、特定のURLセットを経時的に監視したりできます。

Firebaseディスプレイネットワーク内のすべてのURL(カスタムURLパターンを含む)パターンとその集計されたデータは、の一番下にあるトレーステーブルのサブタブ要求性能ダッシュボードFirebaseコンソールのを。

カスタムURLパターンマッチングはどのように機能しますか?

Firebaseは、自動URLパターンマッチングにフォールバックする前に、リクエストURLを設定済みのカスタムURLパターンと照合しようとします。カスタムURLパターンに一致するリクエストについては、FirebaseはリクエストのデータをカスタムURLパターンに集約します。

リクエストのURLが複数のカスタムURLパターンと一致した場合、Firebaseは、以下の特異順序に従って、唯一の最も具体的なカスタムURLパターンにリクエストをマッピングします。プレーンテキスト> * > **パスで左から右に。例えば、への要求example.com/books/dog 2つのカスタムURLパターンに一致します。

  • example.com/books/*
  • example.com/*/dog

しかし、パターンexample.com/books/*左端のセグメントのため、最も具体的なマッチングURLパターンであるbooksexample.com/books/*左端のセグメントよりも優先されます*example.com/*/dog

新しいカスタムURLパターンを作成するときは、次の点に注意してください。

  • 以前の要求からマッチと集計されたデータは、新しいカスタムURLパターンを作成することによって影響を受けません。 Firebaseは、リクエストデータをさかのぼって再集計しません。

  • 唯一の今後の要求は、新しいカスタムURLパターンを作成することによって影響を受けます。パフォーマンスモニタリングが新しいカスタムURLパターンでデータを収集および集約するまで、最大12時間待つ必要がある場合があります。

カスタムURLパターンを作成する

あなたはの一番下にあるネットワークトレーステーブルにサブタブを要求し、からカスタムURLパターンを作成することができ、パフォーマンスダッシュボードFirebaseコンソールの。

プロジェクトメンバーでなければなりません所有者またはエディタ新しいカスタムURLパターンを作成します。ただし、すべてのプロジェクトメンバーは、カスタムURLパターンとその集約データを表示できます。

アプリごとに合計最大400のカスタムURLパターンを作成し、そのアプリのドメインごとに最大100のカスタムURLパターンを作成できます。

カスタムURLパターンを作成するには、ホスト名から始めて、パスセグメントを続けます。ホスト名には有効なドメインが含まれている必要があり、オプションでサブドメインを含めることができます。次のパスセグメント構文を使用して、URLに一致するパターンを作成します。

  • プレーンテキスト—完全に一致する文字列
  • * -シングルパスセグメント内の最初のサブドメインセグメント、または任意の文字列にマッチします
  • ** -任意のパスサフィックスに一致します

次の表は、いくつかの潜在的なカスタムURLパターンマッチングについて説明しています。

合わせる...次のようなカスタムURLパターンを作成します...このURLパターンに一致する例
正確なURL example.com/foo/baz example.com/foo/baz
任意の単一のパスセグメント( * example.com/*/baz example.com/foo/baz
example.com/bar/baz
example.com/*/*/baz example.com/foo/bar/baz
example.com/bah/qux/baz
example.com/foo/* example.com/foo/baz
example.com/foo/bar

注:このパターンは一致しませんexample.com/foo

任意のパスのサフィックス( ** example.com/foo/** example.com/foo
example.com/foo/baz
example.com/foo/baz/more/segments
subdomain.example.com/foo.bar/** subdomain.example.com/foo.bar
subdomain.example.com/foo.bar/baz
subdomain.example.com/foo.bar/baz/more/segments
最初のサブドメインセグメント( * *.example.com/foo bar.example.com/foo
baz.example.com/foo

カスタムURLパターンとそのデータを表示する

Firebaseディスプレイネットワーク内のすべてのURL(カスタムURLパターンを含む)パターンとその集計されたデータは、の一番下にあるトレーステーブルのサブタブ要求性能ダッシュボードFirebaseコンソールのを。

ネットワークトレーステーブルのサブタブを要求のみカスタムURLパターンを表示するには、ドロップダウンメニューから[カスタムパターンを選択します。カスタムURLパターンに集約データがない場合は、このリストにのみ表示されることに注意してください。

場合、データ保持期間のURLパターンの下に集計されたデータのための端部は、Firebaseは、URLパターンからそのデータを削除します。すべてのデータは、パターンの有効期限が切れたカスタムURLの下に集約した場合、FirebaseはFirebaseコンソールからカスタムURLパターンを削除しません。その代わり、Firebaseは、ネットワークカスタムパターンのリストでカスタムURLパターンを「空」リストに続くトレーステーブルのサブタブを要求します

カスタムURLパターンを削除する

プロジェクトからカスタムURLパターンを削除できます。自動URLパターンは削除できないことに注意してください。

  1. パフォーマンスダッシュボード、そして、トレーステーブルにスクロールダウンし、ネットワーク要求サブタブを選択します。

  2. ネットワークのドロップダウンメニューから[カスタムパターンはサブタブを要求します

  3. 削除するカスタムURLパターンの行にカーソルを合わせます。

  4. クリック右端の列の時に、削除カスタムパターンを選択し、ダイアログで削除を確認。

カスタムURLパターンを削除するときは、次の点に注意してください。

  • 将来要求次の最も具体的なマッチングのカスタムURLパターンにマッピングされます。 Firebaseが一致するカスタムURLパターンを見つけることができなかった場合、それはにフォールバック自動URLパターンマッチング

  • 以前の要求からマッチと集計されたデータは、カスタムURLパターンを除去することにより、影響を受けません。

    あなたはまだ削除されたカスタムURLパターンにアクセスすることができ、ネットワーク内のその集約されたデータは、該当するデータ保持期間が終了するまで(選択されたすべてのネットワーク要求を持つ)サブタブを要求します。削除されたカスタムURLパターンの下にあるすべての集計データが期限切れになると、FirebaseはカスタムURLパターンを削除します。

  • ネットワーク要求サブタブ(カスタムパターンとの選択)は、取り外されたカスタムURLパターンのリストを表示しません。