モバイルSDKガイド

New Relic モバイル SDK API 呼び出しを使用して、モバイルアプリが New Relic にレポートするデータをカスタマイズおよび拡張します。

当社のソリューションはすぐに使用できる強力なデータ収集機能を提供しますが、モバイルアプリが New Relic に報告するデータをカスタマイズして拡張する必要がある場合があります。たとえば、パブリック SDK APIコールを使用して次のことを行うことができます。

モバイルアプリのイベントからインタラクショントレースを開始および停止する
カスタムメトリクスの記録
カスタム属性とイベントを送信する
ライブラリからのネットワーク要求の追跡は自動的にはサポートされません
ユーザーセッションにカスタムIDを設定する

始めましょう

最新のモバイルエージェントがインストールされていることを確認してください。
以下の表からカスタマイズを選択し、メソッドのドキュメントに従ってください。

利用可能なカスタマイズ

以下の表は、モバイルエージェントインストルメンテーションをカスタマイズするためにサポートされている SDK メソッドを示しています。各エージェントタイプの構文と使用例を表示する方法を選択します。

あなたがしたい場合は...	この方法を使用してください
ブレッドクラムを記録して、クラッシュのトラブルシューティングに役立つアプリのアクティビティを追跡します。	パン粉の記録
メソッドをインタラクションとして追跡します。	インタラクションの開始インタラクションの停止ヒントこれらのメソッドを使用する場合、インストゥルメントされたインタラクションは[インタラクション]ページに表示されませんが、次のような NRQL クエリで見つけることができます。 `SELECT name FROM Mobile SINCE 7 DAYS AGO`
インタラクションに名前を付けるか、名前を変更します。	名前の相互作用
インタラクションに関連付けるアプリのビルド ID またはバージョンを設定します。	アプリのビルド番号を設定するアプリのバージョン番号を設定する
カスタムメトリクスを作成します。	カスタムメトリクスの記録
カスタム属性とイベントをレポートします。	カスタム属性とイベントをレポートするには、いくつかの方法があります。カスタム属性を記録するセッション属性数を増やす属性の削除すべての属性を削除カスタムイベントの記録パン粉の記録イベントプールの最大サイズを設定するエージェントがイベントをメモリに保存する最大時間を設定する現在のセッションの ID を取得するイベントおよび属性に関連付けるカスタムユーザー ID を設定する使用するのに最適な方法とその理由の詳細については、「モバイル監視のカスタムイベントと属性をレポートする」を参照してください。
カスタムネットワークリクエストと障害を追跡します。	HTTPリクエストを追跡する失敗したHTTPリクエストを追跡する
処理された例外を、発生したコンテキストを含めてイベントとして記録します。	処理された例外を記録する
エラーを記録します。	記録エラー
アプリの起動時のアクティビティに名前を付けます。	アプリの起動時間の目標アクティビティを設定する
エージェントをシャットダウンします。	エージェントのシャットダウン
デフォルトのモバイル監視設定を有効/無効にします。	監視機能の有効化/無効化
テストクラッシュレポートを実行します。	テストクラッシュレポート

モバイル SDK API の使用

(Android) 自動的に計測されるメソッド

自動インストルメンテーションは、Android エージェントのより便利な機能の 1 つです。ただし、トレース中のメソッドが妨げられる場合は、メソッドに @SkipTrace を追加すると、エージェントはコンパイル時のインストルメンテーション中にそれをスキップします。

Classes	Methods
`Activity`	`onCreate` `onCreateView`
`AsyncTask`	`execute` `executeOnExecutor`
`BitmapFactory`	`decodeFile` `decodeResourceStream` `decodeResource` `decodeByteArray` `decodeStream` `decodeFileDescriptor` `decodeResourceStream`
`SQLiteDatabase`	`query` `queryWithFactory` `rawQuery` `rawQueryWithFactory` `insert` `insertOrThrow` `insertWithOnConflict` `replace` `replaceOrThrow` `delete` `update` `updateWithOnConflict` `execSql`
`GSON`	`toJson` `fromJson`
`JSONObject`	`<init>` `toString`
`JSONArray`	`<init>` `toString`
`Log`	`d // debug` `w // warning` `i // info` `v // verbose` `e // error`

(iOS) 自動的に計測されるメソッド

自動インストルメンテーションは、iOS エージェントのより便利な機能の 1 つです。デフォルトで有効になっています。無効にするには、機能フラグNRFeatureFlag_DefaultInteractionsとNRFeatureFlag_InteractionTracingを構成してください。

以下の表に、iOS エージェントで自動的にインスツルメントされるクラスとメソッドを示します。

Classes	Methods
`UIViewController`	`viewDidLoad` `viewWillAppear` `viewDidAppear` `viewWillDisappear` `viewDidDisappear` `viewWillLayoutSubviews` `viewDidLayoutSubviews`
`UIImage`	`imageNamed` `imageWithContentsOfFile` `imageWithData` `imageWithData:scale:` `initWithContentsOfFile:` `initWithData:` `initWithData:scale:`
`NSJSONSerialization`	`JSONObjectWithData:options:error:` `JSONObjectWithStream:options:error:` `dataWithJSONObject:options:error:` `writeJSONObject:toStream:options:error:`
`NSManagedObjectContext`	`executeFetchRequest:error:` `processPendingChanges`

(iOS) カスタム属性とイベントの送信

カスタム属性とイベントをレポートする場合は、 NewRelic オブジェクト内の SDK メソッドを使用します。

BOOL の結果を返すメソッドは、成功した場合は YES を返し、操作が完了しなかった場合は NO を返します。これらのメソッドは、New Relic iOS エージェントのバージョン 5.0.0 以降で利用できます。

SDKは、一度に最大128のユーザー定義のカスタム属性を保存できます。 128を超える属性を保存しようとすると、SDKはNOを返します。

カスタム属性に名前を付ける場合は、単一の単語の属性を使用し、スペースを使用しないなど、必要な最も単純な形式を使用することをお勧めします。たとえば、 My Custom Attribute myCustomAttributeにフォーマットする必要があります。

カスタムメトリクスに名前を付ける場合:

名前を付けるときに、文字/ ] [ | *の使用は避けてください。
マルチバイト文字は避けてください。

この機械翻訳は、参考として提供されています。