• ログイン無料アカウント

本書は、お客様のご参考のために原文の英語版を機械翻訳したものです。

英語版と齟齬がある場合、英語版の定めが優先するものとします。より詳しい情報については、本リンクをご参照ください。

問題を作成する

recordCustomEvent(Android SDK API)

構文

NewRelic.recordCustomEvent(string $eventType, [string $eventName,] map<string, object> $eventAttributes)

New Relic モバイルモニタリングのカスタムイベントを記録します。

要件

Agentバージョン5.12.0以上。

説明

NRQL で使用する カスタムイベント を作成、記録します。このイベントには、マップとして指定された属性のリストが含まれます。 setAttribute を使った場合とは異なり、カスタムイベントに属性を追加すると、そのイベントにのみ属性が追加され、セッション属性にはなりません。

重要な検討事項やベストプラクティスは以下の通りです。

  • eventType は、高レベルのカテゴリーに使用することを意図しています。例えば、イベントタイプ Gestures を作成するとします。
  • カスタムイベントの名前に eventType を使用しないでください。 イベントの名前を付ける属性を作成するか、オプションの name パラメータを使用してください。多くのカスタムイベントを作成することができますが、制限すべきはイベントタイプのみです。
  • オプションの name パラメータを使用すると、 name キーを attributes 辞書に追加するのと同じ効果があります。 name は、New Relic UI でイベントを表示する際に使用するキーワードです。便利な 名前 を作成するには、いくつかの属性を組み合わせるとよいでしょう(例を参照)。

重要

New Relic Android agent version 5.12.0 の時点で、 recordEvent メソッドは非推奨となり、 recordCustomEvent に置き換えられます。 recordEvent メソッドは不特定多数の期間、継続して動作しますが、アプリに recordEvent メソッドが含まれている場合、New Relic はそれらを置き換えることを推奨します。

これらのメソッドを更新すると、廃止されたイベントタイプを使用しているInsightsのクエリやダッシュボードに影響があります。必要に応じて、NRQL クエリとダッシュボードを調整してください。

その他のAndroid APIについては、 Insightsへのカスタム属性やイベントの送信 をご覧ください。

パラメータ

パラメーター

説明

イベントタイプ

文字列

必須です。 $eventType を使用して、カスタム・イベントの名前を付けないでください。代わりに、カスタム属性またはオプションの 名前 を使用します。

$eventName

文字列

オプションです。このパラメータを使用して、イベントの名前を付けます。(このパラメーターを使用することは、 name パラメーターを作成することと同じです)。

$eventAttributes

マップ<文字列, オブジェクト>

任意です。 $eventType へのサブカテゴリーをさらに指定する属性のリストを含むマップです。役に立ちそうなイベント記述子の属性を作成することができます。カスタム・イベントに名前を付けるには、 name 属性を作成するか、 eventName パラメータを使用します。

重要

カスタムアトリビュートのキーを設定する際には、オーバーライドできない デフォルトのアトリビュートがあることに注意してください

戻り値

イベントの記録に成功した場合は true を、失敗した場合は false を返します。

基本的なカスタムイベント

Map attributes = new HashMap();
attributes.put("attributeName1", "value1");
attributes.put("attributeName1", 2);
boolean eventRecorded = NewRelic.recordCustomEvent("eventType", attributes);

複数の属性を持つカスタムイベント

eventType パラメータが、上位のカテゴリである Car に使用されていることに注目してください。

Map attributes = new HashMap();
attributes.put("make", "Ford");
attributes.put("model", "ModelT");
attributes.put("color", "Black");
attributes.put("VIN", "123XYZ");
attributes.put("maxSpeed", 12);
NewRelic.recordCustomEvent("Car", attributes);

name'パラメータを使用したカスタムイベント

Map attributes = new HashMap();
attributes.put("make", "Ford");
attributes.put("model", "ModelT");
NewRelic.recordCustomEvent("Car", "Ford Model T", attributes);
Copyright © 2022 New Relic Inc.