構文
Java
NewRelic.recordCustomEvent(string $eventType, [string $eventName,] map<string, object> $eventAttributes)
コトリン [#kotlin]
NewRelic.recordCustomEvent( eventType: String?, eventName: String?, eventAttributes: MutableMap<String?, Any?>? )
説明 [#description]
カスタム New Relic イベントを記録します。
NRQL で使用するカスタム イベントを作成して記録します。イベントには、マップとして指定された属性のリストが含まれています。setAttribute
を使用するのとは異なり、カスタム イベントに属性を追加すると、そのイベントにのみ属性が追加されます。これらはセッション属性ではありません。
重要な検討事項やベストプラクティスは以下の通りです。
イベントタイプの総数を約5つに制限する必要があります。
eventType
は、高レベルのカテゴリに使用されることを意図しています。たとえば、イベントタイプGestures
を作成できます。Do not use
eventType
to name your custom events.プロパティを作成してイベントに名前を付けるか、オプションの
name
問題を使用します。 カスタムイベントはたくさん作成できます。制限する必要があるのはイベントの種類のみです。オプションの
name
パラメータを使用すると、attributes
ディクショナリにname
キーを追加するのと同じ効果があります。name
は、NewRelicUIでイベントを表示するために使用されるキーワードです。便利なname
を作成するには、いくつかの属性を組み合わせることができます(例を参照)。
重要
New Relic Androidエージェントバージョン5.12.0以降、 recordEvent
メソッドは非推奨になり、 recordCustomEvent
に置き換えられました。 recordEvent
メソッドは不特定の期間機能し続けますが、アプリにrecordEvent
メソッドが含まれている場合、NewRelicはそれらを置き換えることをお勧めします。
これらのメソッドを更新すると、非推奨のイベントタイプを使用するNRQLクエリとダッシュボードに影響します。必要に応じて、NRQLクエリとダッシュボードを調整してください。
パラメーター [#parameters]
パラメータ | タイプ | 説明 |
---|---|---|
|
| 必須。 イベントの種類。 Do not |
|
| オプション。 注: すべてのオブジェクト タイプがサポートされているわけではありません。サポートされているタイプの詳細については、 「setAttribute」を参照してください。 重要カスタム属性のキーを設定するときは、オーバーライドできないデフォルト属性があることに注意してください。 |
戻り値 [#return-values]
イベントが正常に記録された場合はtrue
を返し、そうでない場合はfalse
を返します。
例 [#examples]
基本的なカスタム イベントの例を次に示します。
Java [#java]
Map attributes = new HashMap();attributes.put("attributeName1", "value1");attributes.put("attributeName1", 2);boolean eventRecorded = NewRelic.recordCustomEvent("eventType", attributes);
コトリン [#kotlin]
val attributes = mutableMapOf<String,Any>("attributeName1" to "value1", "attributeName1" to 2)val eventRecorded = NewRelic.recordCustomEvent("eventType", attributes)
いくつかの属性を持つカスタム イベントの例を次に示します。
Java [#java]
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);
コトリン [#kotlin]
val attributes = mutableMapOf<String,Any>()attributes["make"] = "Ford"attributes["model"] = "ModelT"attributes["color"] = "Black"attributes["VIN"] = "123XYZ" attributes["maxSpeed"] = 12 NewRelic.recordCustomEvent("Car", attributes)
name
パラメータを使用したカスタム イベントの例を次に示します。
Java [#java]
Map attributes = new HashMap();attributes.put("make", "Ford");attributes.put("model", "ModelT");
NewRelic.recordCustomEvent("Car", "Ford Model T", attributes);
コトリン [#kotlin]
val attributes = mutableMapOf<String,Any>() attributes["make"] = "Ford" attributes["model"] = "ModelT" NewRelic.recordCustomEvent("Car", "Ford Model T", attributes);
重要
New Relic iOSエージェントバージョン5.12.0以降、 recordEvent
メソッドは非推奨になり、 recordCustomEvent
に置き換えられました。 recordEvent
メソッドは不特定の期間機能し続けますが、アプリにrecordEvent
メソッドが含まれている場合、NewRelicはそれらを置き換えることをお勧めします。
これらのメソッドを更新すると、廃止されたイベントタイプを使用しているすべてのクエリとダッシュボードに影響があります。必要に応じて、NRQL クエリとダッシュボードを調整してください。
構文
目的-c
+ (BOOL) recordCustomEvent:(NSString*)eventType attributes:(NSDictionary*)attributes;
+ (BOOL) recordCustomEvent:(NSString*)eventType name:(NSString*)name attributes:(NSDictionary*)attributes;
迅速 [#swift]
NewRelic.recordCustomEvent(eventType: String!, attributes:[NSObject : AnyObject]!) -> Bool
NewRelic.recordCustomEvent(eventType: String!, name: String!, attributes:[NSObject : AnyObject]!) -> Bool
説明 [#description]
NRQL を使用してクエリできる カスタム イベント を作成および記録します。イベントには、マップとして指定された属性のリストが含まれています。setAttribute
を使用するのとは異なり、カスタム イベントに属性を追加すると、そのイベントにのみ属性が追加されます。これらはセッション属性ではありません。
重要な検討事項やベストプラクティスは以下の通りです。
eventType
値の総数を約5つに制限します。これは、次のような高レベルのカテゴリに使用することを目的としています。Gestures.
- カスタムイベントに名前を付けるために
eventType
を使用しないでください。代わりに、カスタムイベントに名前を付ける属性を作成するか、オプションのname
パラメーターを使用してください。 name
キーワードを使用して、モバイル監視UIにイベントを表示します。便利な名前を作成するために、いくつかの属性を組み合わせることができます。name
パラメータを使用すると、属性ディクショナリにname
キーを追加するのと同じ効果があります。- 属性オブジェクトの要素は、NSStringまたはNSNumberタイプでなければなりません。
パラメーター [#parameters]
パラメータ | タイプ | 説明 |
---|---|---|
|
| 必須。イベントの種類。カスタムイベントに名前を付けるために |
|
| オプション。このパラメータを使用してイベントに名前を付けます。このパラメータを使用することは、 |
|
| オプション。 役立つと思われるイベント記述子の属性を作成できます。カスタムイベントに名前を付けるには、 重要カスタム属性のキーを設定するときは、 オーバーライドできないデフォルト属性があることに注意してください。 |
戻り値 [#return-values]
イベントが正常に記録された場合はtrue
を返し、そうでない場合はfalse
を返します。
例 [#examples]
Objective-C [#obj-c]
BOOL eventRecorded = [NewRelic recordCustomEvent:@"eventType"attributes:@{@"attributeName1": @"value1", @"attributeName2": @2}];
BOOL eventRecorded = [NewRelic recordCustomEvent:@"Vehicle" name:@"1908 Ford ModelT"attributes:@{@"make":@"Ford", @"model":@"ModelT", @"year": @1908, @"color": @"black", @"mileage": @250000}];
迅速 [#swift]
let eventRecorded = NewRelic.recordCustomEvent("eventType", attributes: ["attributeName1" : "value1", "attributeName2": 2])
let eventRecorded = NewRelic.recordCustomEvent("Vehicle", name:"1908 Ford ModelT", attributes:["make":"Ford", "model":"ModelT", "year": 1908, "color": "black", "mileage": 250000]);
構文
recordCustomEvent(options: { eventType: string; eventName: string; attributes: object; }) => void
説明 [#description]
NRQL で使用する カスタム イベントを作成して記録します。
パラメーター [#parameters]
パラメータ | タイプ | 説明 |
---|---|---|
|
| 必須。イベントの種類。カスタムイベントに名前を付けるために |
|
| オプション。このパラメータを使用してイベントに名前を付けます。このパラメータを使用することは、 |
|
| オプション。サブカテゴリを |
戻り値 [#return-values]
イベントが正常に記録された場合はtrue
を返し、そうでない場合はfalse
を返します。
例 [#example]
NewRelicCapacitorPlugin.recordCustomEvent({ eventType: "mobileClothes", eventName: "pants", attributes:{"pantsColor": "blue","pantssize": 32,"belt": true} });
構文
recordCustomEvent(eventType: string, eventName?: string, attributes?: {[key: string]: boolean | number | string}): void;
説明 [#description]
NRQL で使用する カスタム イベントを作成して記録します。
パラメーター [#parameters]
パラメータ | タイプ | 説明 |
---|---|---|
|
| 必須。イベントの種類。カスタムイベントに名前を付けるために |
|
| オプション。このパラメータを使用してイベントに名前を付けます。このパラメータを使用することは、 |
|
| オプション。サブカテゴリを |
戻り値 [#return-values]
イベントが正常に記録された場合はtrue
を返し、そうでない場合はfalse
を返します。
例 [#example]
NewRelic.recordCustomEvent("mobileClothes", "pants", {"pantsColor": "blue","pantssize": 32,"belt": true});
構文
RecordCustomEvent(string eventType, string eventName, Dictionary<string, object> attributes): bool;
説明 [#description]
NRQL で使用する カスタム イベントを作成して記録します。
選択したカスタム属性に加えて、イベントには関連付けられた セッション属性も含まれます。setAttribute
を使用する場合とは異なり、ブレッドクラム イベントに属性を追加すると、そのイベントにのみ属性が追加されます。これらはセッション属性ではありません。
パラメーター [#parameters]
パラメータ | タイプ | 説明 |
---|---|---|
|
| 必須。イベントの種類。カスタムイベントに名前を付けるために |
|
| オプション。このパラメータを使用してイベントに名前を付けます。このパラメータを使用することは、 |
|
| オプション。カスタム イベントに関する追加情報を提供するために使用できるキーと値のペアの辞書。 |
戻り値 [#return-values]
イベントが正常に記録された場合はtrue
を返し、そうでない場合はfalse
を返します。
例 [#example]
CrossNewRelic.Current.RecordCustomEvent("MAUICustomEvent", "MAUICustomEventCategory", new Dictionary<string, object>() { {"BreadNumValue", 12.3 }, {"BreadStrValue", "MAUIBread" }, {"BreadBoolValue", true } } );
構文
recordCustomEvent(String eventType,{String eventName = "", Map<String, dynamic>? eventAttributes}): void;
説明 [#description]
NRQL で使用する カスタム イベントを作成して記録します。
パラメーター [#parameters]
パラメータ | タイプ | 説明 |
---|---|---|
|
| 必須。イベントの種類。カスタムイベントに名前を付けるために |
|
| オプション。このパラメータを使用してイベントに名前を付けます。このパラメータを使用することは、 |
|
| オプション。サブカテゴリを |
戻り値 [#return-values]
イベントが正常に記録された場合はtrue
を返し、そうでない場合はfalse
を返します。
例 [#example]
NewrelicMobile.instance.recordCustomEvent("Major",eventName: "User Purchase",eventAttributes: {"item1":"Clothes","price":34.00});
構文
recordCustomEvent(eventType: string, eventName?: string, attributes?: {[key: string]: any}): void;
説明 [#description]
NRQL で使用する カスタム イベントを作成して記録します。
パラメーター [#parameters]
パラメータ | タイプ | 説明 |
---|---|---|
|
| 必須。イベントの種類。カスタムイベントに名前を付けるために |
|
| オプション。このパラメータを使用してイベントに名前を付けます。このパラメータを使用することは、 |
|
| オプション。サブカテゴリを |
戻り値 [#return-values]
イベントが正常に記録された場合はtrue
を返し、そうでない場合はfalse
を返します。
例 [#example]
NewRelic.recordCustomEvent("mobileClothes", "pants", {"pantsColor": "blue","pantssize": 32,"belt": true});
構文
RecordCustomEvent(string name, Dictionary<string, object> attributes): bool;
説明 [#description]
NRQL で使用する カスタム イベントを作成して記録します。
パラメーター [#parameters]
パラメータ | タイプ | 説明 |
---|---|---|
|
| このパラメータを使用してイベントに名前を付けます。このパラメータを使用することは、 |
|
| オプション。カスタム イベントに関する追加情報を提供するために使用できるキーと値のペアの辞書。 |
戻り値 [#return-values]
イベントが正常に記録された場合はtrue
を返し、そうでない場合はfalse
を返します。
例 [#example]
Dictionary<string, object> dic = new Dictionary<string, object>(); dic.Add("Unity Custom Attribute", "Data2");
NewRelicAgent.RecordCustomEvent("Unity Custom Event Example", dic);
構文
RecordCustomEvent(string name, Dictionary<string, object> attributes): bool;
説明 [#description]
NRQL で使用する カスタム イベントを作成して記録します。
パラメーター [#parameters]
パラメータ | タイプ | 説明 |
---|---|---|
|
| このパラメータを使用してイベントに名前を付けます。このパラメータを使用することは、 |
|
| オプション。カスタム イベントに関する追加情報を提供するために使用できるキーと値のペアの辞書。 |
戻り値 [#return-values]
イベントが正常に記録された場合はtrue
を返し、そうでない場合はfalse
を返します。
例 [#example]
Dictionary<string, object> dic = new Dictionary<string, object>(); dic.Add("Unity Custom Attribute", "Data2");
NewRelicAgent.RecordCustomEvent("Unity Custom Event Example", dic);
構文
recordCustomEvent(FString eventType, TMap <FString, FString> eventAttributes):void
recordCustomEventWithEventType(FString eventType,FString eventName, TMap <FString, FString> eventAttributes):void
説明 [#description]
NRQL で使用する カスタム イベントを作成して記録します。
パラメーター [#parameters]
パラメータ | タイプ | 説明 |
---|---|---|
|
| 必須。 イベントの種類。 Do not |
|
| オプション。 注: すべてのオブジェクト タイプがサポートされているわけではありません。サポートされているタイプの詳細については、 「setAttribute」を参照してください。 重要カスタム属性のキーを設定するときは、オーバーライドできないデフォルト属性があることに注意してください。 |
例 [#example]
#include "NewRelicBPLibrary.h"
TMap<FString, FString> customEventMap; customEventMap.Add("place", TEXT("Robots")); customEventMap.Add("user", TEXT("user1"));
UNewRelicBPLibrary::recordCustomEvent("Unreal Custom Event Example", customEventMap);
TMap<FString, FString> customEventMap; customEventMap.Add("place", TEXT("Robots")); customEventMap.Add("user", TEXT("user1"));
UNewRelicBPLibrary::recordCustomEvent("Unreal Custom Event Type","Unreal Custom Event Example", customEventMap);
構文
RecordCustomEvent(string eventType, string eventName, Dictionary<string, object> attributes): bool;
説明 [#description]
NRQL で使用する カスタム イベントを作成して記録します。
パラメーター [#parameters]
パラメータ | タイプ | 説明 |
---|---|---|
|
| 必須。イベントの種類。カスタムイベントに名前を付けるために |
|
| オプション。このパラメータを使用してイベントに名前を付けます。このパラメータを使用することは、 |
|
| オプション。カスタム イベントに関する追加情報を提供するために使用できるキーと値のペアの辞書。 |
戻り値 [#return-values]
イベントが正常に記録された場合はtrue
を返し、そうでない場合はfalse
を返します。
例 [#example]
CrossNewRelicClient.Current.RecordCustomEvent("XamarinCustomEvent", "XamarinCustomEventCategory", new Dictionary<string, object>() { {"BreadNumValue", 12.3 }, {"BreadStrValue", "XamBread" }, {"BreadBoolValue", true } } );