recordCustomEvent(안드로이드 SDK API)

통사론

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

맞춤형 New Relic 모바일 모니터링 이벤트를 기록합니다.

요구 사항

에이전트 버전 5.12.0 이상.

설명

NRQL에서 사용할 사용자 지정 이벤트 를 만들고 기록합니다. 이벤트에는 맵으로 지정된 속성 목록이 포함됩니다. setAttribute 사용과 달리 맞춤 이벤트에 속성을 추가하면 해당 이벤트에만 속성이 추가됩니다. 세션 속성이 아닙니다.

중요한 고려 사항 및 모범 사례는 다음과 같습니다.

총 이벤트 유형 수를 약 5개로 제한해야 합니다. eventType 은 상위 수준 카테고리에 사용됩니다. 예를 들어, 이벤트 유형 Gestures 을 만들 수 있습니다.
eventType 을 사용하여 사용자 정의 이벤트의 이름을 지정하지 마십시오. 이벤트 이름을 지정하는 속성을 생성하거나 선택적 name 매개변수를 사용합니다. 많은 사용자 정의 이벤트를 만들 수 있습니다. 제한해야 하는 것은 이벤트 유형뿐입니다.
선택적 name 매개변수를 사용하면 attributes 사전에 name 키를 추가하는 것과 같은 효과가 있습니다. name 은 New Relic UI에서 이벤트를 표시하는 데 사용되는 키워드입니다. 유용한 name 를 생성하기 위해 여러 속성을 결합할 수 있습니다(예제 참조).

중요

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

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

다른 Android API에 대한 자세한 내용은 맞춤 속성 및 이벤트 보내기 를 참조하세요.

매개변수

매개변수	설명
`$eventType` 끈	필수의. 이벤트 유형입니다. `$eventType` 을 사용하여 사용자 정의 이벤트의 이름을 지정 하지 마십시오 . 대신, 사용자 정의 속성 또는 선택적 `name` 을 사용하십시오.
`$eventName` 끈	선택 과목. 이 매개변수를 사용하여 이벤트의 이름을 지정합니다. (이 매개변수를 사용하는 것은 `name` 매개변수를 만드는 것과 같습니다.)
`$eventAttributes` 맵<문자열, 객체>	선택 과목. `$eventType` 에 대한 하위 카테고리를 추가로 지정하는 속성 목록이 포함된 지도입니다. 유용할 것으로 생각되는 모든 이벤트 설명자에 대한 속성을 생성할 수 있습니다. 맞춤 이벤트의 이름을 지정하려면 `name` 속성을 생성하거나 `eventName` 매개변수를 사용하세요. 중요 사용자 정의 속성에 대한 키를 설정할 때 재정의할 수 없는 기본 속성이 있다는 점에 유의하십시오.

설명

$eventType

끈

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

$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);

'이름' 매개변수를 사용하는 맞춤 이벤트

Map attributes = new HashMap();
attributes.put("make", "Ford");
attributes.put("model", "ModelT");

NewRelic.recordCustomEvent("Car", "Ford Model T", attributes);

사용자의 편의를 위해 제공되는 기계 번역입니다.