• EnglishEspañol日本語한국어Português
  • 로그인지금 시작하기

이 한글 문서는 사용자의 편의를 위해 기계 번역되었습니다.

영문본과 번역본이 일치하지 않는 경우 영문본이 우선합니다. 보다 자세한 내용은 이 페이지를 방문하시기 바랍니다.

문제 신고

맞춤 이벤트 기록

통사론

자바

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 을 만들 수 있습니다.

  • Do not use eventType to name your custom events.

    이벤트 이름을 지정하는 속성을 생성하거나 선택적 name 보고서를 사용합니다. 다양한 맞춤형 대시보드를 만들 수 있습니다. 제한해야 하는 것은 이벤트 유형뿐입니다.

  • 선택적 name 매개변수를 사용하면 attributes 사전에 name 키를 추가하는 것과 같은 효과가 있습니다. name 은 New Relic UI에서 이벤트를 표시하는 데 사용되는 키워드입니다. 유용한 name 를 생성하기 위해 여러 속성을 결합할 수 있습니다(예제 참조).

중요

New Relic Android 에이전트 버전 5.12.0 부터 recordEvent 메서드는 더 이상 사용되지 않으며 recordCustomEvent 로 대체되었습니다. recordEvent 메서드는 지정되지 않은 기간 동안 계속 작동하지만 앱에 recordEvent 메서드가 포함된 경우 New Relic은 이를 대체할 것을 권장합니다.

이러한 방법을 업데이트하면 더 이상 사용되지 않는 이벤트 유형을 사용하는 모든 NRQL 쿼리 및 대시보드에 영향을 미칩니다. 필요에 따라 NRQL 쿼리 및 대시보드를 조정해야 합니다.

매개변수 [#parameters]

매개변수

유형

설명

$eventType

string

필수의. 이벤트 유형입니다. Do not $eventType 사용하여 맞춤형 대시보드 이름을 지정합니다. 대신 사용자 정의 속성이나 선택적 name 사용하세요.

$eventName

dictionary

선택 과목. $eventType 에 대한 하위 카테고리를 추가로 지정하는 속성 목록이 포함된 지도입니다. 유용할 것으로 생각되는 모든 이벤트 설명자에 대한 속성을 생성할 수 있습니다. 맞춤 이벤트의 이름을 지정하려면 name 속성을 생성하거나 eventName 매개변수를 사용하세요.

참고: 모든 개체 유형이 지원되는 것은 아닙니다. 지원되는 유형에 대한 자세한 내용은 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"] = 12
NewRelic.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]

매개변수

유형

설명

$eventType

string

필수의. 이벤트 유형입니다. $eventType 을 사용하여 사용자 정의 이벤트의 이름을 지정하지 마십시오. 사용자 정의 속성 또는 선택적 name 매개변수를 사용하십시오.

$eventName

string

선택 과목. 이 매개변수를 사용하여 이벤트 이름을 지정하십시오. 이 매개변수를 사용하는 것은 name 매개변수를 만드는 것과 같습니다.

$eventAttributes

dictionary

선택 과목. $eventType 에 대한 하위 카테고리를 추가로 지정하는 속성 목록이 포함된 지도입니다. 속성 개체의 요소는 NSString 또는 NSNumber 유형이어야 합니다.

유용할 것으로 생각되는 모든 이벤트 설명자에 대한 속성을 생성할 수 있습니다. 맞춤 이벤트의 이름을 지정하려면 name 속성을 생성하거나 eventName 매개변수를 사용하세요.

중요

맞춤 속성의 키를 설정할 때 재정의할 수 없는 기본 속성이 있다는 점에 유의하세요.

반환 값 [#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]

매개변수

유형

설명

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(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 }
}
);
Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.