このクイックスタートでは、Flutter アプリのパフォーマンス特性を把握するために Firebase Performance Monitoring を設定する方法について説明します。
あなたが始める前に
まだ行っていない場合は、Flutter プロジェクトでFirebase を構成して初期化します。
ステップ 1 : Performance Monitoring をアプリに追加する
Flutter プロジェクトのルート ディレクトリから次のコマンドを実行して、Performance Monitoring Flutter プラグインをインストールします。
flutter pub add firebase_performance
Flutter プロジェクトのルート ディレクトリから、次のコマンドを実行します。
flutterfire configure
このコマンドを実行すると、Flutter アプリの Firebase 構成が最新の状態になり、Android の場合は、必要な Performance Monitoring Gradle プラグインがアプリに追加されます。
完了したら、Flutter プロジェクトを再構築します。
flutter run
Performance Monitoring SDK を追加すると、Firebase はアプリのライフサイクルに関連するデータ (アプリの開始時間など) とHTTP/S ネットワーク リクエストのデータの収集を自動的に開始します。
Flutter では、個々の Flutter 画面に対して自動画面レンダリング パフォーマンス モニタリングを行うことはできません。単一のビュー コントローラーが Flutter アプリケーション全体をネイティブにカプセル化するため、基盤となるネイティブの Firebase SDK は画面遷移を認識しません。
ステップ 2 : 初期データ表示用のパフォーマンス イベントを生成する
SDK をアプリに正常に追加すると、Firebase はイベントの処理を開始します。まだローカルで開発している場合は、アプリを操作して、初期データの収集と処理のためのイベントを生成します。
シミュレーターまたはテスト デバイスを使用してアプリの開発を続けます。
アプリのバックグラウンドとフォアグラウンドを数回切り替えたり、画面間を移動してアプリを操作したり、ネットワーク リクエストをトリガーしたりして、イベントを生成します。
Firebase コンソールのパフォーマンスダッシュボードに移動します。数分以内に最初のデータが表示されます。
初期データが表示されない場合は、トラブルシューティングのヒントを確認してください。
ステップ 3 : (オプション)パフォーマンス イベントのログ メッセージを表示する
ログ メッセージでエラー メッセージを確認します。
Performance Monitoring は、ログ メッセージをフィルタリングできるように、ログ メッセージに次のタグを付けます。
- iOS+:
Firebase/Performance
- Android:
FirebasePerformance
- iOS+:
Performance Monitoring がパフォーマンス イベントをログに記録していることを示す次の種類のログを確認します。
-
Logging trace metric: TRACE_NAME , FIREBASE_PERFORMANCE_CONSOLE_URL
-
Logging network request trace: URL
-
URL をクリックして、Firebase コンソールでデータを表示します。ダッシュボードでデータが更新されるまで、少し時間がかかる場合があります。
ステップ 4 : (オプション)特定のコードのカスタム モニタリングを追加する
アプリ内の特定のコードに関連付けられたパフォーマンス データを監視するために、カスタム コード トレースを計測できます。
カスタム コード トレースを使用すると、一連の画像の読み込みやデータベースへのクエリなど、アプリが特定のタスクまたは一連のタスクを完了するのにかかる時間を測定できます。カスタム コード トレースのデフォルトのメトリックはその期間ですが、キャッシュ ヒットやメモリ警告などのカスタム メトリックを追加することもできます。
コードでは、Performance Monitoring SDK によって提供される API を使用して、カスタム コード トレースの開始と終了を定義します (必要なカスタム メトリックを追加します)。
これらの機能とそれらをアプリに追加する方法について詳しくは、特定のコードの監視を追加するをご覧ください。
ステップ 5 : アプリをデプロイして結果を確認する
エミュレーターと 1 つ以上のテスト デバイスを使用して Performance Monitoring を検証したら、更新されたバージョンのアプリをユーザーにデプロイできます。
Firebase コンソールのパフォーマンスダッシュボードでパフォーマンス データをモニタリングできます。
次のステップ
Performance Monitoring によって自動的に収集されるデータの詳細:
- アプリの起動時間など、アプリのライフサイクルに関連するデータ
- アプリによって発行されたHTTP/S ネットワーク リクエストのデータ
Firebase コンソールでパフォーマンス データを表示、追跡、フィルタリングします。
カスタム コード トレースをインストルメント化して、アプリ内の特定のタスクまたはワークフローの監視を追加します。