통사론
recordHandledException:(NSException* __nonnull)exception withAttributes:(NSDictionary* __nullable)attributes;
처리된 예외를 기록합니다. 선택적으로 컨텍스트를 표시하는 추가 속성이 있는 맵을 가져옵니다.
요구 사항
에이전트 버전 5.15.0 이상 .
설명
recordHandledException
API는 충돌 분석에 유용합니다. 캡처된 이벤트는 애플리케이션에서 예외가 발생하는 빈도와 조건을 이해하는 데 도움이 됩니다. 연결된 사용자 정의 속성 외에도 이벤트에는 연결된 세션 속성 도 있습니다.
이 API는 NSException
및 선택적 NSDictionary
속성 사전의 인스턴스를 가져온 다음 recordHandledException
이벤트를 생성합니다. 충돌 이벤트 추적 UI 에서 이벤트 데이터를 보고 NRQL을 사용하여 쿼리할 수 있습니다.
이 API를 사용하는 방법에 대한 컨텍스트는 사용자 정의 속성 및 이벤트 전송에 대한 문서를 참조하십시오.
매개변수
매개변수 | 설명 |
---|---|
NSException | 필수의. throw된 예외 개체입니다. |
NSDictionary | 선택 과목. 컨텍스트를 제공하는 속성 사전. |
예
오브젝티브-C
방법:
+ (void) recordHandledException:(NSException* __nonnull)exception withAttributes:(NSDictionary* __nullable)attributes;
+ (void) recordHandledException:(NSException* __nonnull)exception;
예:
간단한 Objective-C 예:
@try { @throw [NSException exceptionWithName:@"versionException" reason:@"App version no longer supported" userInfo:nil]; } @catch (NSException* e) { [NewRelic recordHandledException:e]; }
사전이 있는 Objective-C 예:
NSException *exception = [NSException exceptionWithName:@"MyException" reason:@"I have my reason" userInfo:nil]; NSDictionary* dictionary = @{@"int": @1, @"Test Group" : @"A | B"}; [NewRelic recordHandledException:exception withAttributes:dictionary];