Google は、黒人コミュニティのための人種的公平の促進に取り組んでいます。詳細をご覧ください。

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

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

リクエストごとに、Firebase はネットワーク リクエストの URL がURL パターンに一致するかどうかを確認します。リクエストURLがURLパターンと一致する場合、FirebaseはリクエストのデータをURLパターンの下に自動的に集約します。

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

Firebaseは、Firebaseコンソールのパフォーマンスダッシュボードの下部にあるトレーステーブルの[ネットワークリクエスト]サブタブに、すべてのURLパターン(カスタムURLパターンを含む)とそれらの集計データを表示します。

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

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

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

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

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

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

  • 以前のリクエストからの一致と集約データは、新しいカスタムURLパターンを作成しても影響を受けません。 Firebaseは、リクエストデータをさかのぼって再集計しません。

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

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

Firebase コンソールのパフォーマンスダッシュボードの下部にあるトレース テーブルの [ネットワーク リクエスト]サブタブからカスタム URL パターンを作成できます。

新しいカスタム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

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

Firebaseは、Firebaseコンソールのパフォーマンスダッシュボードの下部にあるトレーステーブルの[ネットワークリクエスト]サブタブに、すべてのURLパターン(カスタムURLパターンを含む)とそれらの集計データを表示します。

カスタム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 パターンが表示されません。