통사론
recordCustomEvent:(NSString*)eventType attributes:(NSDictionary*)attributes;NewRelic.recordCustomEvent(string $eventType, [string $eventName,] map<string, object> $eventAttributes)맞춤형 모바일 모니터링 이벤트를 기록합니다.
요구 사항
New Relic iOS 에이전트 버전 5.12.0 부터 recordEvent 메서드는 더 이상 사용되지 않으며 recordCustomEvent 로 대체됩니다. recordEvent 메서드는 지정되지 않은 기간 동안 계속 작동하지만 앱에 recordEvent 메서드가 포함된 경우 New Relic은 이를 대체할 것을 권장합니다.
이러한 메서드를 업데이트하면 더 이상 사용되지 않는 이벤트 유형을 사용하는 모든 쿼리 및 대시보드에 영향을 줍니다. 필요에 따라 NRQL 쿼리 및 대시보드를 조정해야 합니다.
설명
NRQL 을 사용하여 쿼리할 수 있는 사용자 지정 이벤트 를 만들고 기록합니다. 이벤트에는 맵으로 지정된 속성 목록이 포함됩니다. setAttribute 사용과 달리 맞춤 이벤트에 속성을 추가하면 해당 이벤트에만 속성이 추가됩니다. 세션 속성이 아닙니다.
중요한 고려 사항 및 모범 사례는 다음과 같습니다.
eventType값의 총 수를 약 5개로 제한합니다. 다음과 같은 고급 범주에 사용됩니다.Gestures.eventType을 사용하여 사용자 정의 이벤트의 이름을 지정하지 마십시오. 대신 속성을 만들어 맞춤 이벤트의 이름을 지정하거나 선택적name매개변수를 사용하세요.name키워드를 사용하여 모바일 모니터링 UI 에 이벤트를 표시합니다. 유용한 이름을 만들기 위해 여러 속성을 결합할 수 있습니다.name매개변수를 사용하면 속성 사전에name키를 추가하는 것과 같은 효과가 있습니다.- 속성 개체의 요소는 NSString 또는 NSNumber 유형이어야 합니다.
매개변수
매개변수 | 설명 |
|---|---|
끈 | 필수의. 이벤트 유형입니다. |
끈 | 선택 과목. 이 매개변수를 사용하여 이벤트의 이름을 지정합니다. (이 매개변수를 사용하는 것은 |
맵<문자열, 객체> | 선택 과목. 유용할 것으로 생각되는 모든 이벤트 설명자에 대한 속성을 생성할 수 있습니다. 맞춤 이벤트의 이름을 지정하려면 중요사용자 정의 속성에 대한 키를 설정할 때 재정의할 수 없는 기본 속성이 있다는 점에 유의하십시오. |
반환 값
이벤트가 성공적으로 기록되면 true 을 반환하고 그렇지 않으면 false 을 반환합니다.
예
오브젝티브-C
행동 양식:
+ (BOOL) recordCustomEvent:(NSString*)eventType attributes:(NSDictionary*)attributes;+ (BOOL) recordCustomEvent:(NSString*)eventType name:(NSString*)name attributes:(NSDictionary*)attributes;예:
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}];빠른
행동 양식:
NewRelic.recordCustomEvent(eventType: String!, attributes:[NSObject : AnyObject]!) -> BoolNewRelic.recordCustomEvent(eventType: String!, name: String!, attributes:[NSObject : AnyObject]!) -> Bool예:
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]);