デフォルトでは、New Relic は、インタラクション、セッション、クラッシュ、リクエスト エラーなどの一部のイベント データを モバイル アプリから New Relic に収集します。ただし、独自のカスタム属性とイベントを作成して、より詳細なクエリと分析を行うこともできます。
カスタムアトリビュートとイベントの作成 デフォルトのカスタムセッションレベル属性を作成できます。 モバイル監視 モバイル エージェント SDK を使用したイベント。たとえば、iOS または Android アプリの一部のusername属性を記録するには、setAttribute API
recordCustomEvent API
クラッシュ分析を支援するために、SDKを使用してMobileBreadcrumbおよびMobileHandledExceptionイベントを作成できます。これらのイベントはクエリに使用でき、クラッシュイベントトレイルUI にも表示されます。
カスタムアトリビュートやカスタムイベントの作成については、以下を参照してください。
モバイルイベントと属性クエリの例 ここでは、 NRQL を使って、モバイルアプリのイベントや属性を照会する例を紹介します。
カスタムイベントの例。購入履歴の確認 アプリでの購入を追跡するには、 recordCustomEventを使用してイベントタイプ（「UserAction」など）を作成し、「name」（値は「Purchase」）、価格、数量、SKUなどの属性を関連付けます。
ヒント パフォーマンス上の理由から、イベントタイプの総数を1つか2つに制限する必要があります。 recordCustomEventパラメータeventTypeは、高レベルのカテゴリに使用するためのものです。たとえば、イベントタイプGesturesを作成してから、 Gestureイベントタイプの下にさまざまなカスタムイベント名を作成できます。
iOSでイベントを作成します。
BOOL purchaseRecorded = [NewRelic recordCustomEvent :@"UserAction" attributes:@{@"name": @"Purchase", @"sku": @"12345LPD", @"quantity": @1, @"unitPrice": @99.99, @"total": @99.99}];Androidでイベントを作成します。
Map<String, Object> userActionAttributes = new HashMap<String, Object>();
userActionAttributes.put("name", "Purchase");
userActionAttributes.put("sku", "12345LPD");
userActionAttributes.put("quantity", 1);
userActionAttributes.put("unitPrice", 99.99);
userActionAttributes.put("total", 99.99);
boolean userActionRecorded = NewRelic.recordCustomEvent ("UserAction", userActionAttributes);New Relicは、タイプUserActionおよび名前Purchaseのカスタムイベントを報告します。これにより、前日にアプリで行われたすべての購入をクエリできます。
SELECT * from UserAction where name = 'Purchase' since 1 day ago
非推奨のrecordEventメソッドを置き換えます。
Androidエージェントバージョン5.12.0 およびiOSエージェントバージョン5.12.0 では、 recordCustomEventメソッドを使用してこれらのカスタムイベントを作成します。カスタムイベントの非推奨のrecordEventメソッドを置き換えた場合は、対応するNRQLクエリも新しい形式に置き換えてください。
次のような、 recordEventメソッドで使用されるクエリを探します。
SELECT * from Mobile where category = 'Custom' and name = 'Purchase' since 1 day ago
それらをrecordCustomEventで使用されるクエリ形式に置き換えます。
SELECT * from UserAction where name = 'Purchase' since 1 day ago
属性の例。特定のユーザーを追跡する カスタム属性を作成して、セッション全体でカスタムユーザー識別子を追跡し、そのユーザーのすべてのインタラクションを照会できます。 userIdの属性を追加するには、 setUserIdメソッドを呼び出します。
iOS でuserIdを設定します。
BOOL userIdWasSet = [NewRelic setUserId:@"jsmith"];
Android でuserIdを設定します。
boolean userIdWasSet = NewRelic.setUserId("jsmith");
この属性を使用すると、WHEREusernameによって実行されたすべてのアクションを確認できます。
SELECT * from Mobile WHERE userId = 'jsmith' since 1 day ago
属性の例。特定のストアIDを追跡する カスタム属性を作成して、セッション全体でストアIDを追跡し、そのストアのすべてのインタラクションを照会できます。 storeIdの属性を追加するには、 setAttributeメソッドを呼び出します。
iOS でstoreIdを設定します。
BOOL attributeSet = [NewRelic setAttribute :@"storeId" value:@"NY0531"];Android でstoreIdを設定します。
boolean attributeSet = NewRelic.setAttribute ("storeId", "NY0531");この属性を使用すると、WHEREstoreIdによって実行されたすべてのアクションを確認できます。
SELECT * from Mobile WHERE storeId = 'NY0531' since 1 day ago
カスタムアトリビュートの例。特定のアクションを追跡する カスタム属性を使用すると、アプリケーション内で特定のアクションが発生した回数を追跡することができます。例えば、ボタンがクリックされた回数や、ゲームでレベルをクリアした回数などを記録することができます。
ゲームレベルの完了を追跡するには、値を指定せずにincrementAttributeを呼び出します。これにより、デフォルト値1の属性が作成されます。
iOSでカウンターを作成します。
Androidでカウンターを作る。
incrementAttributeへの後続の各呼び出しは、属性levelに1を追加します。
iOSでカウンタをインクリメントすることができます。
Androidでカウンタをインクリメントします。
重要 最初からやり直す場合は、必ず0に戻してください。
レベルを1または0にリセットするには、 setAttributeを呼び出します。
iOSのカウンターをリセットします。
Androidでカウンターをリセットする。
クエリを実行するときは、このlevel属性を使用してデータをフィルタリングします。たとえば、 username }属性とlevel属性がある場合は、 max()
SELECT max(level) from Mobile where username = 'jsmith'
サイズ制限と制限文字 Limits for カスタムアトリビュートをデフォルトのモバイルイベントに追加 :
アトリビュート。最大128個 文字列属性。最大長さ4KB（空の文字列値は受け付けません） カスタムイベントの制限値
アトリビュート。1イベントあたり最大254個（デフォルトの セッションアトリビュート を含む数です。） 文字列属性。最大長さ4KB（空の文字列値は受け付けません） ネーミングの構文とルール カスタムデータのルール を参照してください。
データを送信する時間の設定 デフォルトでは、New Relicはこれらのいずれの状況でもイベントデータを送信します。
セッションは600秒継続しています。 アプリのセッションはバックグラウンドで終了します。 アプリがクラッシュします。 アプリがクラッシュした場合、NewRelicはそのセッションの属性とイベントを収集します。 （iOSでは、これは次にアプリが起動されたときに発生します）。次に、NRQLを使用して、イベントおよび属性データを照会および分析できます。
エージェントがイベントをメモリに保存する最大時間 (秒単位) を設定するには、 「最大バッファー時間を設定する」 を参照してください。
プライバシーへの配慮 カスタム属性によって個人データを収集したい場合は、プライバシーチームまたは法務チームにご相談ください。通知や同意の規定については、必ず組織の義務に従ってください。