このページは Cloud Translation API によって翻訳されました。

Flutterのパフォーマンスモニタリングを開始する

このクイックスタートでは、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
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 コンソールでパフォーマンスデータを表示、追跡、フィルタリングします。
カスタムコードトレースをインストルメント化して、アプリ内の特定のタスクまたはワークフローの監視を追加します。
属性を使用してパフォーマンスデータをフィルタリングします。