Performance Monitoring についてのトラブルシューティングとよくある質問

パフォーマンス イベントのログメッセージを表示する方法

1. ブラウザのデベロッパー ツール（Chrome デベロッパー ツールの [ネットワーク] タブや Firefox のネットワーク モニターなど）を開きます。

2. ブラウザでウェブアプリを更新します。

3. ログメッセージにエラー メッセージがないか確認します。

4. 数秒後、ブラウザのデベロッパー ツールで、firebaselogging.googleapis.com に対するネットワーク呼び出しを確認します。ネットワーク呼び出しが存在する場合、ブラウザがパフォーマンス データを Firebase に送信しています。

アプリがパフォーマンス イベントをログに記録していない場合は、トラブルシューティングのヒントをご覧ください。

SDK をアプリに追加したが、SDK を追加するようコンソールに指示が表示される

Firebase は、アプリからイベント情報（アプリの操作など）を受け取るときに、アプリに Performance Monitoring SDK が正常に追加されたかどうかを検出できます。通常、アプリを起動してから 10 分以内に、Firebase コンソールのパフォーマンス ダッシュボードに「SDK を検出しました」というメッセージが表示されます。

最新バージョンの SDK をアプリに追加してから 10 分以上経過してもこの検出メッセージが表示されない場合は、ログメッセージを確認して、Performance Monitoring がイベントをログに記録していることを確認します。下記の該当するトラブルシューティングの手順を試して、SDK 検出メッセージの遅延についてトラブルシューティングを行います。

SDK を検出したとコンソールに表示されるが、データが表示されない

Performance Monitoring がパフォーマンス イベントデータを処理した後に、パフォーマンス ダッシュボードにそのデータが表示されます。

「SDK を検出しました」というメッセージが表示されてから 24 時間以上経過してもデータが表示されない場合は、既知の停止が発生しているかどうか Firebase ステータス ダッシュボードを確認します。停止が発生していない場合は、Firebase サポートにお問い合わせください。

アプリがパフォーマンス イベントをログに記録しない

パフォーマンス イベントのログメッセージが表示されない場合は、次のトラブルシューティング手順をお試しください。

1. アプリで Performance Monitoring SDK が正しく初期化されていることを確認します。

2. 次のフラグによって Performance Monitoring SDK が無効になっていないことを確認します。

   • performance.instrumentationEnabled

3. ブラウザ キャッシュが無効になっていることを確認します。無効でない場合、ブラウザは新しいインストゥルメンテーション設定を取得しない場合があります。

4. ウェブページのタブを閉じてからもう一度開きます。再度ロギングを確認します。

   アプリに Performance Monitoring SDK を追加したばかりの場合は、SDK が機能するようにアプリを完全に再起動する必要がある場合があります。

5. アプリで無効になっているものが見つからない場合は、Firebase サポートにお問い合わせください。

パフォーマンス ダッシュボードに初回入力遅延データが表示されない

初回入力遅延指標のデータが表示されない場合は、次のトラブルシューティング手順をお試しください。

1. Performance Monitoring が初回入力遅延指標を記録するのは、ページの読み込み後 5 秒以内にウェブページをクリックした場合のみであることに注意してください。

2. この指標を測定するようにアプリを設定していることを確認します。初回入力遅延指標には手動設定が必要です。具体的には、この指標にポリフィル ライブラリを追加する必要があります。インストール方法については、ライブラリのドキュメントをご覧ください。

   このポリフィル ライブラリを追加しなくても、Performance Monitoring は他のウェブアプリ指標を報告できます。

パフォーマンス ダッシュボードにカスタム トレースデータが表示されない

自動収集されるトレースのパフォーマンス データは表示され、カスタムコード トレースのデータは表示されませんか。次のトラブルシューティング手順をお試しください。

1. Trace API を使用してインストルメント化したカスタム コード トレースの設定を確認します。特に次の点に注意してください。

   • カスタム コード トレースとカスタム指標の名前には制限があります。先頭または末尾が空白文字でなく、先頭がアンダースコア（_）でない 32 文字以下の名前を指定する必要があります。
   • すべてのトレースを開始して停止する必要があります。開始されていないトレース、停止されていないトレース、開始前に停止されたトレースはログに記録されません。

   record() メソッドを使用している場合は、トレースを明示的に開始または停止する必要はありません。

2. 次のフラグによって Performance Monitoring のデータ収集が無効になっていないことを確認します。

   • performance.dataCollectionEnabled

     このフラグは、すべてのデータではなく、カスタム コード トレースのデータ収集のみを制御します。

3. ログメッセージを確認して、Performance Monitoring が、想定されるカスタム コード トレースをログに記録していることを確かめます。

4. Performance Monitoring がイベントをログに記録しているが、24 時間経過してもデータが表示されない場合は、Firebase サポートにお問い合わせください。

パフォーマンス ダッシュボードにネットワーク リクエスト データが表示されない

ネットワーク リクエスト データが表示されない場合は、次の点に注意してください。

• Performance Monitoring は、ブラウザ API によって報告されたネットワーク リクエストの指標を自動的に収集します。これらのレポートには、失敗したネットワーク リクエストは含まれません。

• コードとそのコードで使用しているネットワーキング ライブラリの動作によっては、Performance Monitoring で報告されるのが、完了したネットワーク リクエストだけになることがあります。この場合、開いたままの HTTP/S 接続が報告されていない可能性があります。

ネットワーク リクエスト データが想定どおりに集計されない

詳細については、URL パターンで Performance Monitoring がネットワーク リクエスト データを集計する方法をご覧ください。

カスタム URL パターンもお試しください。

「ほぼリアルタイム」のパフォーマンス データとは何ですか？

Firebase Performance Monitoring のデータ収集機能が強化され、収集したパフォーマンス データの処理待ち時間が短くなります。Firebase コンソールに表示されるパフォーマンス データには、「ほぼリアルタイム」のデータが反映されるようになります（データが表示されるまでの遅延は数分です）。

以前は、収集したデータをバッチ処理していたため、データの収集からコンソールでの表示までに数時間のギャップがありました。今後は収集したデータがすぐに処理され、はるかに迅速にデータが表示されるようになります。

ほぼリアルタイムのデータ処理が完全にリリースされた後、それを利用するには、リアルタイム対応の SDK バージョンをアプリで使用する必要があります。

ほぼリアルタイムのパフォーマンス データをアプリで取得する方法を教えてください。

ほぼリアルタイムのデータ処理が完全にリリースされた後、それを利用するには、リアルタイムのデータ処理に対応したバージョンの Performance Monitoring SDK をアプリで使用します。これだけで準備完了です。

リアルタイム対応の SDK のバージョンは次のとおりです。

• iOS - v7.3.0 以降
• Android - v19.0.10 以降（または Firebase Android BoM v26.1.0 以降）
• ウェブ - v7.14.0 以降

常に最新バージョンの SDK を使用することをおすすめします。ただし、上記のいずれのバージョンでも、Performance Monitoring でほぼリアルタイムのデータ処理が行われます。

どのバージョンの Performance Monitoring SDK がリアルタイムに対応していますか？

リアルタイムのデータ処理に対応している SDK のバージョンは次のとおりです。

• iOS - v7.3.0 以降
• Android - v19.0.10 以降（または Firebase Android BoM v26.1.0 以降）
• ウェブ - v7.14.0 以降

常に最新バージョンの SDK を使用することをおすすめします。ただし、上記のいずれのバージョンでも、Performance Monitoring でほぼリアルタイムのデータ処理が行われます。

リアルタイム対応の SDK バージョンを使用するようにアプリを更新していないとどうなりますか？

リアルタイム対応の SDK バージョンをアプリで使用していない場合でも、Firebase コンソールにはアプリのパフォーマンス データがすべて表示されます。ただし、リアルタイム データ処理の機能が完全にリリースされた後は、パフォーマンス データはデータの収集からおよそ 36 時間遅れて表示されます。

リアルタイム対応の SDK バージョンにアップデートしましたが、一部のユーザーは古いバージョンのアプリを使用しています。それらのユーザーのパフォーマンス データも Firebase コンソールで引き続き表示されますか？

はい。アプリ インスタンスで使用している SDK バージョンに関係なく、すべてのユーザーのパフォーマンス データが表示されます。

リアルタイム データ処理の機能が完全にリリースされた後は、多少の違いが生じることに注意してください。たとえば、最近のデータ（約 36 時間以内）に表示されるデータは、リアルタイム対応の SDK バージョンを使用するアプリ インスタンスのユーザーのデータになります。一方、最近ではないデータには、すべてのバージョンのアプリのパフォーマンス データが表示されます。