통사론
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에 대한 자세한 내용은 맞춤 속성 및 이벤트 보내기 를 참조하세요.
매개변수
매개변수 | 설명 |
---|---|
끈 | 필수의. 이벤트 유형입니다. |
끈 | 선택 과목. 이 매개변수를 사용하여 이벤트의 이름을 지정합니다. (이 매개변수를 사용하는 것은 |
맵<문자열, 객체> | 선택 과목. 중요사용자 정의 속성에 대한 키를 설정할 때 재정의할 수 없는 기본 속성이 있다는 점에 유의하십시오. |
반환 값
이벤트가 성공적으로 기록되면 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);