カスタムイベントの記録

構文

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を作成できます。
カスタムイベントの名前にはeventTypeを使用しないでください。プロパティを作成してイベントに名前を付けるか、オプションのname問題を使用します。多数のカスタムイベントを作成できますが、 eventTypeの数を制限することが重要です。
オプションのnameパラメータを使用すると、 attributesディクショナリにnameキーを追加するのと同じ効果があります。 nameは、NewRelicUIでイベントを表示するために使用されるキーワードです。便利なnameを作成するには、いくつかの属性を組み合わせることができます（例を参照）。

重要

New Relic Androidエージェントバージョン5.12.0以降、 recordEventメソッドは非推奨になり、 recordCustomEventに置き換えられました。 recordEventメソッドは不特定の期間機能し続けますが、アプリにrecordEventメソッドが含まれている場合、NewRelicはそれらを置き換えることをお勧めします。

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

パラメーター [#parameters]

パラメータ	タイプ	説明
`$eventType`	`string`	必須。イベントの種類。カスタムイベントの名前には`$eventType`を使用しないでください。代わりに、カスタムアトリビュートまたはオプションの`name`を使用してください。
`$eventName`	`dictionary`	オプション。 `$eventType`のサブカテゴリをさらに指定する属性のリストを含むマップ。役立つと思われるイベント記述子の属性を作成できます。カスタムイベントに名前を付けるには、 `name`属性を作成するか、 `eventName`パラメーターを使用します。注: すべてのオブジェクトタイプがサポートされているわけではありません。サポートされているタイプの詳細については、「setAttribute」を参照してください。重要カスタム属性のキーを設定するときは、オーバーライドできないデフォルト属性があることに注意してください。

パラメータ

タイプ

説明

$eventType

string

必須。イベントの種類。カスタムイベントの名前には$eventTypeを使用しないでください。代わりに、カスタムアトリビュートまたはオプションのnameを使用してください。

$eventName

dictionary

オプション。 $eventTypeのサブカテゴリをさらに指定する属性のリストを含むマップ。役立つと思われるイベント記述子の属性を作成できます。カスタムイベントに名前を付けるには、 name属性を作成するか、 eventNameパラメーターを使用します。

注: すべてのオブジェクトタイプがサポートされているわけではありません。サポートされているタイプの詳細については、「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]

パラメータ	タイプ	説明
`$eventType`	`string`	必須。イベントの種類。カスタムイベントに名前を付けるために`$eventType`を使用しないでください。カスタム属性またはオプションの`name`パラメーターを使用します。
`$eventName`	`string`	オプション。このパラメータを使用してイベントに名前を付けます。このパラメータを使用することは、 `name` パラメータを作成することと同じです。
`$eventAttributes`	`dictionary`	オプション。 `$eventType`のサブカテゴリをさらに指定する属性のリストを含むマップ。属性オブジェクトの要素は、NSStringまたはNSNumberタイプである必要があります。役立つと思われるイベント記述子の属性を作成できます。カスタムイベントに名前を付けるには、 `name`属性を作成するか、 `eventName`パラメーターを使用します。重要カスタム属性のキーを設定するときは、オーバーライドできないデフォルト属性があることに注意してください。

パラメータ

タイプ

説明

$eventType

string

必須。イベントの種類。カスタムイベントに名前を付けるために$eventTypeを使用しないでください。カスタム属性またはオプションのnameパラメーターを使用します。

$eventName

string

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

$eventAttributes

dictionary

オプション。 $eventTypeのサブカテゴリをさらに指定する属性のリストを含むマップ。属性オブジェクトの要素は、NSStringまたはNSNumberタイプである必要があります。

役立つと思われるイベント記述子の属性を作成できます。カスタムイベントに名前を付けるには、 name属性を作成するか、 eventNameパラメーターを使用します。

重要

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

戻り値 [#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]

パラメータ	タイプ	説明
`eventType`	`string`	必須。イベントの種類。カスタムイベントに名前を付けるために`$eventType`を使用しないでください。カスタム属性またはオプションの`name`パラメーターを使用します。
`eventName`	`string`	オプション。このパラメータを使用してイベントに名前を付けます。このパラメータを使用することは、 `name` パラメータを作成することと同じです。
`attributes`	`object`	オプション。サブカテゴリを `eventType`にさらに指定する属性のリストを含むマップ。

戻り値 [#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]

パラメータ	タイプ	説明
`eventType`	`string`	必須。イベントの種類。カスタムイベントに名前を付けるために`$eventType`を使用しないでください。カスタム属性またはオプションの`name`パラメーターを使用します。
`eventName?`	`string`	オプション。このパラメータを使用してイベントに名前を付けます。このパラメータを使用することは、 `name` パラメータを作成することと同じです。
`attributes?`	`dictionary`	オプション。サブカテゴリを `eventType`にさらに指定する属性のリストを含むマップ。

戻り値 [#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]

パラメータ	タイプ	説明
`eventType`	`string`	必須。イベントの種類。カスタムイベントに名前を付けるために`$eventType`を使用しないでください。カスタム属性またはオプションの`name`パラメーターを使用します。
`eventName`	`string`	オプション。このパラメータを使用してイベントに名前を付けます。このパラメータを使用することは、 `name` パラメータを作成することと同じです。
`attributes`	`Dictionary<string, object>`	オプション。カスタムイベントに関する追加情報を提供するために使用できるキーと値のペアの辞書。

戻り値 [#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]

パラメータ	タイプ	説明
`eventType`	`string`	必須。イベントの種類。カスタムイベントに名前を付けるために`$eventType`を使用しないでください。カスタム属性またはオプションの`name`パラメーターを使用します。
`eventName`	`string`	オプション。このパラメータを使用してイベントに名前を付けます。このパラメータを使用することは、 `name` パラメータを作成することと同じです。
`eventAttributes`	`dictionary`	オプション。サブカテゴリを `eventType`にさらに指定する属性のリストを含むマップ。

戻り値 [#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]

パラメータ	タイプ	説明
`eventType`	`string`	必須。イベントの種類。カスタムイベントに名前を付けるために`$eventType`を使用しないでください。カスタム属性またはオプションの`name`パラメーターを使用します。
`eventName`	`string`	オプション。このパラメータを使用してイベントに名前を付けます。このパラメータを使用することは、 `name` パラメータを作成することと同じです。
`attributes`	`dictionary`	オプション。サブカテゴリを `eventType`にさらに指定する属性のリストを含むマップ。

戻り値 [#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]

パラメータ	タイプ	説明
`name`	`string`	このパラメータを使用してイベントに名前を付けます。このパラメータを使用することは、 `name`パラメータを作成することと同じです。
`attributes`	`Dictionary<string, object>`	オプション。カスタムイベントに関する追加情報を提供するために使用できるキーと値のペアの辞書。

戻り値 [#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]

パラメータ	タイプ	説明
`name`	`string`	このパラメータを使用してイベントに名前を付けます。このパラメータを使用することは、 `name`パラメータを作成することと同じです。
`attributes`	`Dictionary<string, object>`	オプション。カスタムイベントに関する追加情報を提供するために使用できるキーと値のペアの辞書。

戻り値 [#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]

パラメータ	タイプ	説明
`$eventType`	`string`	必須。イベントの種類。カスタムイベントの名前には`$eventType`を使用しないでください。代わりに、カスタムアトリビュートまたはオプションの`name`を使用してください。
`$eventName`	`eventAttributes`	オプション。 `$eventType`のサブカテゴリをさらに指定する属性のリストを含むマップ。役立つと思われるイベント記述子の属性を作成できます。カスタムイベントに名前を付けるには、 `name`属性を作成するか、 `eventName`パラメーターを使用します。注: すべてのオブジェクトタイプがサポートされているわけではありません。サポートされているタイプの詳細については、「setAttribute」を参照してください。重要カスタム属性のキーを設定するときは、オーバーライドできないデフォルト属性があることに注意してください。

パラメータ

タイプ

説明

$eventType

string

$eventName

eventAttributes

重要

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

例 [#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);

Screenshot of the Unreal Engine Plugin Record Custom Event

構文

RecordCustomEvent(string eventType, string eventName, Dictionary<string, object> attributes): bool;

説明 [#description]

NRQL で使用するカスタムイベントを作成して記録します。

パラメーター [#parameters]

パラメータ	タイプ	説明
`eventType`	`string`	必須。イベントの種類。カスタムイベントに名前を付けるために`$eventType`を使用しないでください。カスタム属性またはオプションの`name`パラメーターを使用します。
`eventName`	`string`	オプション。このパラメータを使用してイベントに名前を付けます。このパラメータを使用することは、 `name` パラメータを作成することと同じです。
`attributes`	`Dictionary<string, object>`	オプション。カスタムイベントに関する追加情報を提供するために使用できるキーと値のペアの辞書。

戻り値 [#return-values]

イベントが正常に記録された場合はtrueを返し、そうでない場合はfalseを返します。

例 [#example]

CrossNewRelicClient.Current.RecordCustomEvent("XamarinCustomEvent", "XamarinCustomEventCategory", new Dictionary<string, object>()
    {
        {"BreadNumValue", 12.3 },
        {"BreadStrValue", "XamBread" },
        {"BreadBoolValue", true }
    }
);

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

構文 .css-21sua1{background:none;border:none;width:0;padding:0;}

Java

コトリン [#kotlin]

説明 [#description]

重要

パラメーター [#parameters]

重要

戻り値 [#return-values]

例 [#examples]

Java [#java]

コトリン [#kotlin]

Java [#java]

コトリン [#kotlin]

Java [#java]

コトリン [#kotlin]

重要

構文

目的-c

迅速 [#swift]

説明 [#description]

パラメーター [#parameters]

重要

戻り値 [#return-values]

例 [#examples]

Objective-C [#obj-c]

迅速 [#swift]

構文

説明 [#description]

パラメーター [#parameters]

戻り値 [#return-values]

例 [#example]

構文

説明 [#description]

パラメーター [#parameters]

戻り値 [#return-values]

例 [#example]

構文

説明 [#description]

パラメーター [#parameters]

戻り値 [#return-values]

例 [#example]

構文

説明 [#description]

パラメーター [#parameters]

戻り値 [#return-values]

例 [#example]

構文

説明 [#description]

パラメーター [#parameters]

戻り値 [#return-values]

例 [#example]

構文

説明 [#description]

パラメーター [#parameters]

戻り値 [#return-values]

例 [#example]

構文

説明 [#description]

パラメーター [#parameters]

戻り値 [#return-values]

例 [#example]

構文

説明 [#description]

パラメーター [#parameters]

重要

例 [#example]

構文

説明 [#description]

パラメーター [#parameters]

戻り値 [#return-values]

例 [#example]

構文