통사론
자바
NewRelic.recordCustomEvent(string $eventType, [string $eventName,] map<string, object> $eventAttributes)
코틀린 [#kotlin]
NewRelic.recordCustomEvent( eventType: String?, eventName: String?, eventAttributes: MutableMap<String?, Any?>?)
설명 [#description]
사용자 정의 뉴렐릭 이벤트를 기록합니다.
NRQL에서 사용할 맞춤 이벤트를 생성하고 기록합니다. 이벤트에는 맵으로 지정된 속성 목록이 포함됩니다. setAttribute
사용과 달리 맞춤 이벤트에 속성을 추가하면 해당 이벤트에만 속성이 추가됩니다. 이는 세션 속성이 아닙니다.
중요한 고려 사항 및 모범 사례는 다음과 같습니다.
- 총 이벤트 유형 수를 약 5개로 제한해야 합니다.
eventType
은 상위 수준 카테고리에 사용됩니다. 예를 들어, 이벤트 유형Gestures
을 만들 수 있습니다. - 맞춤형 대시보드 이름을 지정하는 데
eventType
사용하지 마세요. 이벤트 이름을 지정하는 속성을 생성하거나 선택적name
모델을 사용합니다. 다양한 맞춤형 대시보드를 만들 수 있지만eventType
의 수를 제한하는 것이 중요합니다. - 선택적
name
매개변수를 사용하면attributes
사전에name
키를 추가하는 것과 같은 효과가 있습니다.name
은 New Relic UI에서 이벤트를 표시하는 데 사용되는 키워드입니다. 유용한name
를 생성하기 위해 여러 속성을 결합할 수 있습니다(예제 참조).
중요
New Relic Android 에이전트 버전 5.12.0 부터 recordEvent
메서드는 더 이상 사용되지 않으며 recordCustomEvent
로 대체되었습니다. recordEvent
메서드는 지정되지 않은 기간 동안 계속 작동하지만 앱에 recordEvent
메서드가 포함된 경우 New Relic은 이를 대체할 것을 권장합니다.
이러한 방법을 업데이트하면 더 이상 사용되지 않는 이벤트 유형을 사용하는 모든 NRQL 쿼리 및 대시보드에 영향을 미칩니다. 필요에 따라 NRQL 쿼리 및 대시보드를 조정해야 합니다.
매개변수 [#parameters]
매개변수 | 유형 | 설명 |
---|---|---|
|
| 필수의. 이벤트 유형입니다. 맞춤형 대시보드 이름을 지정하는 데 |
|
| 선택 과목. 참고: 모든 개체 유형이 지원되는 것은 아닙니다. 지원되는 유형에 대한 자세한 내용은 setAttribute를 참조하세요. 중요맞춤 속성에 대한 키를 설정할 때 재정의할 수 없는 기본 속성이 있다는 점에 유의하세요. |
반환 값 [#return-values]
이벤트가 성공적으로 기록되면 true
을 반환하고 그렇지 않으면 false
을 반환합니다.
예 [#examples]
다음은 기본 맞춤 이벤트의 예입니다.
자바 [#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]
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"] = 12NewRelic.recordCustomEvent("Car", attributes)
다음은 name
매개변수를 사용하는 맞춤 이벤트의 예입니다.
자바 [#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
메서드가 포함된 경우 New Relic은 이를 대체할 것을 권장합니다.
이러한 메서드를 업데이트하면 더 이상 사용되지 않는 이벤트 유형을 사용하는 모든 쿼리 및 대시보드에 영향을 줍니다. 필요에 따라 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]
오브젝티브-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]
매개변수 | 유형 | 설명 |
---|---|---|
|
| 필수의. 이벤트 유형입니다. 맞춤형 대시보드 이름을 지정하는 데 |
|
| 선택 과목. 참고: 모든 개체 유형이 지원되는 것은 아닙니다. 지원되는 유형에 대한 자세한 내용은 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 } });