New Relic モバイル SDK API 呼び出しを使用して、モバイルアプリが New Relic にレポートするデータをカスタマイズおよび拡張します。
当社のソリューションはすぐに使用できる強力なデータ収集機能を提供しますが、モバイル アプリが New Relic に報告するデータをカスタマイズして拡張する必要がある場合があります。 たとえば、パブリック SDK APIコールを使用して次のことを行うことができます。
- モバイルアプリのイベントからインタラクショントレースを開始および停止する
- カスタムメトリクスの記録
- カスタム属性とイベントを送信する
- ライブラリからのネットワーク要求の追跡は自動的にはサポートされません
- ユーザーセッションにカスタムIDを設定する
始めましょう
- 最新のモバイル エージェントがインストールされていることを確認してください。
- 以下の表からカスタマイズを選択し、メソッドのドキュメントに従ってください。
利用可能なカスタマイズ
以下の表は、モバイル エージェント インストルメンテーションをカスタマイズするためにサポートされている SDK メソッドを示しています。各エージェント タイプの構文と使用例を表示する方法を選択します。
あなたがしたい場合は... | この方法を使用してください |
---|---|
ブレッドクラムを記録して、クラッシュのトラブルシューティングに役立つアプリのアクティビティを追跡します。 | |
メソッドをインタラクションとして追跡します。 | ヒントこれらのメソッドを使用する場合、インストゥルメントされたインタラクションは[インタラクション]ページに表示されませんが、次のような NRQL クエリで見つけることができます。
|
インタラクションに名前を付けるか、名前を変更します。 | |
インタラクションに関連付けるアプリのビルド ID またはバージョンを設定します。 | |
カスタムメトリクスを作成します。 | |
カスタム属性とイベントをレポートします。 | カスタム属性とイベントをレポートするには、いくつかの方法があります。 |
カスタム ネットワーク リクエストと障害を追跡します。 | |
処理された例外を、発生したコンテキストを含めてイベントとして記録します。 | |
エラーを記録します。 | |
アプリの起動時のアクティビティに名前を付けます。 | |
エージェントをシャットダウンします。 | |
デフォルトのモバイル監視設定を有効/無効にします。 | |
テストクラッシュレポートを実行します。 |
モバイル SDK API の使用
(Android) 自動的に計測されるメソッド
自動インストルメンテーションは、Android エージェントのより便利な機能の 1 つです。ただし、トレース中のメソッドが妨げられる場合は、メソッドに @SkipTrace
を追加すると、エージェントはコンパイル時のインストルメンテーション中にそれをスキップします。
Classes | Methods |
---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
(iOS) 自動的に計測されるメソッド
自動インストルメンテーションは、iOS エージェントのより便利な機能の 1 つです。デフォルトで有効になっています。無効にするには、機能フラグNRFeatureFlag_DefaultInteractions
とNRFeatureFlag_InteractionTracing
を構成してください。
以下の表に、iOS エージェントで自動的にインスツルメントされるクラスとメソッドを示します。
Classes | Methods |
---|---|
|
|
|
|
|
|
|
|
(iOS) カスタム属性とイベントの送信
カスタム属性とイベントをレポートする場合は、 NewRelic
オブジェクト内の SDK メソッドを使用します。
BOOL
の結果を返すメソッドは、成功した場合は YES
を返し、操作が完了しなかった場合は NO
を返します。これらのメソッドは、New Relic iOS エージェントのバージョン 5.0.0 以降で利用できます。
SDKは、一度に最大128のユーザー定義のカスタム属性を保存できます。 128を超える属性を保存しようとすると、SDKはNO
を返します。
カスタム属性に名前を付ける場合は、単一の単語の属性を使用し、スペースを使用しないなど、必要な最も単純な形式を使用することをお勧めします。たとえば、 My Custom Attribute
myCustomAttribute
にフォーマットする必要があります。
カスタムメトリクスに名前を付ける場合:
- 名前を付けるときは、文字
/ ] [ | *
を使用しないでください。 - マルチバイト文字は避けてください。