모바일 SDK 가이드

New Relic 모바일 SDK API 호출을 사용하여 모바일 앱이 New Relic에 보고하는 데이터를 사용자 정의하고 확장하십시오.

당사의 솔루션은 즉시 사용 가능한 강력한 데이터 수집 기능을 제공하지만 모바일 앱이 뉴렐릭에 보고하는 데이터를 맞춤설정하고 확장해야 할 수도 있습니다. 예를 들어 공개 SDK API 호출을 사용하여 다음을 수행할 수 있습니다.

모바일 앱의 이벤트에서 상호 작용 추적 시작 및 중지
맞춤 측정항목 기록
사용자 정의 속성 및 이벤트 보내기
자동으로 지원되지 않는 라이브러리의 네트워크 요청 추적
사용자 세션에 맞춤 ID 설정

시작하다

최신 모바일 에이전트가 설치되어 있는지 확인하십시오.
아래 표에서 사용자 정의를 선택하고 방법의 문서를 따르십시오.

사용 가능한 사용자 정의

아래 표에는 모바일 에이전트 계측을 사용자 지정하기 위해 지원되는 SDK 방법이 나열되어 있습니다. 각 에이전트 유형에 대한 구문 및 사용 예를 보려면 방법을 선택하십시오.

원하는 경우...	이 방법을 사용하십시오
충돌 문제 해결에 도움이 될 수 있는 앱 활동을 추적하기 위해 이동 경로를 기록합니다.	이동 경로 기록
메서드를 상호 작용으로 추적합니다.	상호 작용 시작 상호 작용 중지 팁 이러한 방법을 사용하는 경우, 계측된 복합체 복합은 복합복합 페이지에 표시되지 않지만 다음과 같은 NRQL 쿼리를 통해 찾을 수 있습니다. `SELECT name FROM Mobile SINCE 7 DAYS AGO`
상호 작용의 이름을 지정하거나 이름을 바꿉니다.	이름 상호 작용
상호 작용과 연결할 앱의 빌드 ID 또는 버전을 설정합니다.	앱 빌드 번호 설정 앱 버전 번호 설정
사용자 지정 메트릭을 만듭니다.	맞춤 측정항목 기록
사용자 정의 속성 및 이벤트를 보고합니다.	사용자 정의 속성 및 이벤트를 보고하는 방법에는 여러 가지가 있습니다. 사용자 정의 속성 기록 증가 세션 속성 수 속성 제거 모든 속성 제거 맞춤 이벤트 기록 이동 경로 기록 이벤트 풀의 최대 크기 설정 에이전트가 메모리에 이벤트를 저장하는 최대 시간 설정 현재 세션의 ID 얻기 이벤트 및 속성과 연결할 사용자 정의 사용자 ID 설정 가장 좋은 사용 방법과 그 이유에 대한 자세한 내용 은 모바일 모니터링 사용자 정의 이벤트 및 속성 보고를 참조하세요.
사용자 지정 네트워크 요청 및 실패를 추적합니다.	HTTP 요청 추적 실패한 HTTP 요청 추적
발생한 상황을 포함하여 처리된 예외를 이벤트로 기록합니다.	처리된 예외 기록
오류를 기록합니다.	오류 기록
앱 실행 시간에 대한 이름 활동.	앱 실행 시간 목표 활동 설정
에이전트를 종료합니다.	에이전트 종료
기본 모바일 모니터링 설정을 활성화/비활성화합니다.	모니터링 기능 활성화/비활성화
테스트 충돌 보고서를 실행합니다.	충돌 보고 테스트

모바일 SDK API 사용

(Android) 자동 계측 방법

자동 계측은 Android 에이전트의 보다 편리한 기능 중 하나입니다. 그러나 추적 중인 메서드를 방해하는 경우 메서드에 @SkipTrace 추가하면 에이전트가 컴파일 시간 계측 중에 이를 건너뜁니다.

Classes	Methods
`Activity`	`onCreate` `onCreateView`
`AsyncTask`	`execute` `executeOnExecutor`
`BitmapFactory`	`decodeFile` `decodeResourceStream` `decodeResource` `decodeByteArray` `decodeStream` `decodeFileDescriptor` `decodeResourceStream`
`SQLiteDatabase`	`query` `queryWithFactory` `rawQuery` `rawQueryWithFactory` `insert` `insertOrThrow` `insertWithOnConflict` `replace` `replaceOrThrow` `delete` `update` `updateWithOnConflict` `execSql`
`GSON`	`toJson` `fromJson`
`JSONObject`	`<init>` `toString`
`JSONArray`	`<init>` `toString`
`Log`	`d // debug` `w // warning` `i // info` `v // verbose` `e // error`

(iOS) 자동 계측 방법

자동 계측은 iOS 에이전트의 더욱 편리한 기능 중 하나입니다. 기본적으로 활성화되어 있습니다. 비활성화하려면 기능 플래그 NRFeatureFlag_DefaultInteractions 및 NRFeatureFlag_InteractionTracing 을 구성하십시오.

아래 표에는 iOS 에이전트에서 자동으로 계측되는 클래스와 메서드가 나열되어 있습니다.

Classes	Methods
`UIViewController`	`viewDidLoad` `viewWillAppear` `viewDidAppear` `viewWillDisappear` `viewDidDisappear` `viewWillLayoutSubviews` `viewDidLayoutSubviews`
`UIImage`	`imageNamed` `imageWithContentsOfFile` `imageWithData` `imageWithData:scale:` `initWithContentsOfFile:` `initWithData:` `initWithData:scale:`
`NSJSONSerialization`	`JSONObjectWithData:options:error:` `JSONObjectWithStream:options:error:` `dataWithJSONObject:options:error:` `writeJSONObject:toStream:options:error:`
`NSManagedObjectContext`	`executeFetchRequest:error:` `processPendingChanges`

(iOS) 맞춤 속성 및 이벤트 보내기

맞춤 속성 및 이벤트를 보고 할 때 NewRelic 개체 내에서 SDK 메서드를 사용하세요.

BOOL 결과를 반환하는 메서드는 성공하면 YES 반환하고 작업이 완료되지 않으면 NO 반환합니다. 이러한 메서드는 New Relic iOS 에이전트 버전 5.0.0 이상에서 사용할 수 있습니다.

SDK는 한 번에 최대 128개의 사용자 정의 사용자 정의 속성 을 저장할 수 있습니다. 128개 이상의 속성을 저장하려고 하면 SDK가 NO 을 반환합니다.

사용자 정의 속성의 이름을 지정할 때 단일 단어 속성을 사용하고 공백을 사용하지 않는 등 필요한 가장 간단한 형식을 사용하는 것이 좋습니다. 예를 들어 My Custom Attribute myCustomAttribute 형식이어야 합니다.

맞춤 측정항목의 이름을 지정할 때:

사물의 이름을 지을 때 / ] [ | * 문자 사용을 피하세요.
다중 바이트 문자를 피하십시오.

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