iOS 向け Firebase Performance Monitoring を使ってみる

このガイドでは、アプリで Firebase Performance Monitoring を使用する方法を次の手順に沿って説明します。

  1. 事前準備
  2. Firebase を iOS プロジェクトに追加する
  3. Performance Monitoring をアプリに追加する
  4. (オプション)カスタム トレースと 1 つ以上のカウンターをアプリに定義する
  5. Firebase コンソールで Performance Monitoring の結果を確認する
  6. アプリをデプロイし、Firebase コンソールで結果をレビューする

Performance Monitoring は現在ベータ版です。

前提条件

事前に次の環境を準備しておく必要があります。

  • Xcode 8.2.1 以降
  • iOS 8 以降をターゲットにした Xcode プロジェクト
  • アプリのバンドル識別子
  • CocoaPods 1.0.0 以降

Firebase を iOS プロジェクトに追加する

次に、Firebase をアプリに追加し、SDK を追加して、アプリで Firebase を初期化する必要があります。手順については、Firebase を iOS プロジェクトに追加するを参照してください。

Performance Monitoring をアプリに追加する

  1. プロジェクト用に作成した podfile を開き(または pod init コマンドを使用して作成)、ターゲット セクション内に次の行を追加します。
    pod 'Firebase/Performance'
  2. podfile があるディレクトリで、次のコマンドを実行して Performance Monitoring SDK をインストールします。
    pod install
  3. コマンドの最後で、Xcode を使用して .xcworkspace ファイルを開きます。
  4. Firebase モジュールを UIApplicationDelegate サブクラスにインポートします。

    Swift

    import Firebase
    

    Objective-C

    @import Firebase;
    
  5. FirebaseApp 共有インスタンスを設定します。通常はアプリケーションの application:didFinishLaunchingWithOptions: メソッドを使用します。

    Swift

    // Use Firebase library to configure APIs
    FirebaseApp.configure()
    

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
    
  6. アプリを再コンパイルします。 これで自動トレースと HTTP/S ネットワーク リクエストがモニタリングされるようになりました。

(オプション)カスタム トレースと 1 つ以上のカウンターをアプリに定義する

カスタム トレースは、アプリ内の特定のコードに関連付けられたパフォーマンス データのレポートです。カスタム トレースの詳細については、Performance Monitoring の概要を参照してください。アプリには複数のカスタム トレースを設定でき、一度に複数のカスタム トレースを実行できます。各カスタム トレースには、アプリ内のパフォーマンス関連のイベントをカウントする 1 つ以上のカウンタを設定でき、これらのカウンタは、それぞれを作成するトレースに関連付けられています。

  1. Performance Monitoring モジュールをヘッダーに追加します。

    Swift

    import FirebasePerformance

    Objective-C

    @import FirebasePerformance;

  2. アプリのトレースを開始するコードの直前に、次のコード行を追加して、test trace というトレースを開始します。

    Swift

    let trace = Performance.startTrace(name: "test trace")

    Objective-C

    FIRTrace *trace = [FIRPerformance startTraceWithName:@"test trace"];

  3. アプリで発生するパフォーマンス関連のイベント(キャッシュ ヒットや再試行など)をカウントするには、イベントが発生するたびに、次のような行を追加します。異なる種類のイベントをカウントする場合は、retry 以外の文字列を使用してイベントの名前を指定します。

    Swift

    trace.incrementCounter(named:"retry")

    Objective-C

    [trace incrementCounterNamed:@"retry"];

  4. トレースを停止するコードの直後に、次のコード行を追加します。

    Swift

    trace.stop()

    Objective-C

    [trace stop];

Firebase コンソールで Performance Monitoring の結果を確認する

  1. Xcode シミュレータでアプリを実行します([製品] - > [実行])。
  2. Firebase コンソールに Performance Monitoring の結果が表示されていることを確認します。結果は 12 時間以内に表示されます。

アプリをデプロイし、Firebase コンソールで結果をレビューする

Xcode シミュレータと 1 つまたは複数のテストデバイスを使用して Performance Monitoring を検証したら、アプリのアップデート バージョンをユーザーにデプロイし、Firebase コンソールを使用してパフォーマンス データをモニタリングできます。

既知の問題

  • Performance Monitoring には、GTMSQLite との互換性に関する既知の問題があります。GTMSQLite を使用するアプリでは、Performance Monitoring を使用しないことをおすすめします。
  • Performance Monitoring は、NSURLConnection クラスを使用して行われるネットワーク リクエストをサポートしていません。
  • アプリで NSURLSession クラスのデリゲート メソッドを使用しているものの、すべての可能なデリゲート メソッドを実装していない場合、これらのセッションは HTTP / S ネットワーク リクエストのモニタリングによって正しくキャプチャされない可能性があります。
  • FirebaseApp.configure() を呼び出した後のメソッドの実装入れ替えは、Performance Monitoring SDK に影響する可能性があります。
  • iOS 8.0~8.2 シミュレータの既知の問題により、Performance Monitoring でパフォーマンス イベントがキャプチャされなくなります。これらの問題は、iOS シミュレータ 8.3 以降のバージョンで修正されています。

次のステップ

フィードバックを送信...

ご不明な点がありましたら、Google のサポートページをご覧ください。