안드로이드 SDK API 가이드

중요

New Relic Android 에이전트 버전 5.9.0부터 사용자 세션을 분석 이벤트 및 속성과 연결하도록 사용자 지정 사용자 식별자 값을 설정할 수 있습니다. 자세한 내용은 NewRelic.setUserId 메서드 를 참조하세요.

Android 에이전트는 애플리케이션 모니터링을 위한 사용자 지정 계측 을 설정하는 SDK API를 제공합니다. API는 다음과 같은 기능을 제공합니다.

자신의 코드를 계측하십시오 .
모바일 앱의 이벤트에서 상호 작용 추적을 만들고 이름 을 지정하고 종료 합니다.
맞춤 측정항목을 기록 합니다.
사용자 정의 속성 및 이벤트를 보냅니다 .
자동으로 지원되지 않는 라이브러리에서 네트워킹을 추적 합니다.

SDK 설치

Android SDK API를 사용하기 전에:

Android SDK API 릴리스 정보 를 검토하여 앱이 모바일 모니터링을 위한 최신 SDK로 계측되었는지 확인하십시오.
one.newrelic.com 으로 이동, 데이터 추가 를 클릭한 다음 Android용 단계를 따릅니다.

자세한 내용은 자세한 Android 설치 및 구성 절차 를 참조하십시오. Android 2.2를 지원해야 하는 경우 기존 Android 에이전트 SDK 절차 를 참조하세요.

코드 계측

주의

추적은 크게 최적화되어 있지만 성능 오버헤드가 발생합니다. 수백 번 호출될 것으로 예상되는 계측 방법을 피하십시오.

상호 작용 추적에 포함하려는 사용자 지정 라이브러리 또는 애플리케이션 코드가 있는 경우:

다음 Java 주석을 사용하십시오.
```
import com.newrelic.agent.android.instrumentation.Trace;
```
계측하려는 메서드 에 @Trace 주석을 추가합니다.
```
@Trace
  public void myHeavyweightMethod() {
  …
```
추적 중인 메서드의 종류를 나타내려면 선택적 category 속성 을 사용합니다.

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

클래스	행동 양식
`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`

카테고리는 사용자 정의 이름이거나 사전 정의된 MetricCategory 열거형(아래 나열) 중 하나일 수 있습니다. 다음은 사전 정의된 IMAGE 카테고리를 사용하여 이미지 처리 방법을 계측하는 예입니다.

@Trace(category = MetricCategory.IMAGE)
public void processImageData() {
…

사용 가능한 MetricCategory 열거형은 다음과 같습니다.

MetricCategory	설명
`VIEW_LOADING`	하위 보기, 컨트롤 및 기타 관련 작업 만들기
`VIEW_LAYOUT`	레이아웃의 팽창, 구성 요소 해결
`DATABASE`	SQLite 및 기타 파일 I/O
`IMAGE`	이미지 로딩 및 처리
`JSON`	JSON 구문 분석 또는 생성
`NETWORK`	웹 서비스 통합 방법, 원격 리소스 로딩

API 메서드 사용

다음 표에는 일반적인 사용 사례에 따라 정렬된 모든 New Relic Android SDK API 호출 이 나열되어 있습니다.

원하는 경우...	이 작업을 수행
충돌 문제 해결에 도움이 될 수 있는 앱 활동 추적	`recordBreadcrumb` 을(를) 참조하세요.
방법을 상호 작용으로 추적	`startInteraction` 을(를) 참조하세요.
상호 작용 이름 지정 또는 이름 바꾸기	`setInteractionName` 을(를) 참조하세요.
상호작용 종료	`endInteraction` 을(를) 참조하세요.
모든 상호 작용 비활성화 또는 활성화	`withInteractionTracing` 을(를) 참조하세요.
상호 작용과 연결된 앱 버전 설정	`withApplicationVersion` 을(를) 참조하세요.
사용자 정의 빌드 ID 설정	`withApplicationBuild` 을(를) 참조하세요.
맞춤 측정항목 만들기	`recordMetric` 을(를) 참조하세요.
맞춤 속성 및 이벤트 보고	사용자 정의 속성 및 이벤트를 추가하는 방법에는 여러 가지가 있습니다. 사용하는 가장 좋은 방법과 그 이유에 대한 자세한 내용은 사용자 지정 데이터 추가 를 참조하세요. 속성 만들기: `setAttribute` 속성 수 증가: `incrementAttribute` 속성 제거: `removeAttribute` 모든 속성 제거: `removeAllAttributes` 맞춤 이벤트 기록: `recordCustomEvent` 탐색경로 이벤트 기록: `recordBreadcrumb` 이벤트 풀의 최대 크기 설정: `setMaxEventPoolSize` 에이전트가 이벤트를 메모리에 저장하는 최대 시간 설정: `setMaxEventBufferTime` 현재 세션의 ID 반환: `currentSessionId` 세션을 이벤트 및 속성과 연결하기 위한 맞춤 사용자 ID 설정: `setUserId`
맞춤형 네트워크 요청 및 실패 추적	다음 방법을 사용하십시오. 다양한 세부 정보 수준에서 HTTP 트랜잭션을 기록합니다. `noticeHttpTransaction` 을(를) 참조하십시오. 네트워크 장애 기록: `noticeNetworkFailure` 참조.
컨텍스트를 포함하여 처리된 예외를 이벤트로 기록	`recordHandledException()` 을(를) 참조하세요.
ReactNative 앱의 JavaScript 오류 기록	`recordJSErrorException` 을(를) 참조하세요.
앱 실행 시간 목표 활동 설정	`withLaunchActivityName` 을(를) 참조하세요.
에이전트 종료	`shutdown`) 참조하십시오.

수동 교차 애플리케이션 추적

noticeHttpTransaction 코드는 애플리케이션 간 추적 이 작동하도록 하는 데 필요한 적절한 헤더 ID 값을 자동으로 추가하지 않습니다. 이것이 모바일 앱용 New Relic의지도 페이지 또는 HTTP 요청 페이지 에서 Android 앱의 애플리케이션 링크를 볼 수 없는 이유입니다.

New Relic에 의해 이미 계측된 경우 New Relic Android SDK의 공개 메서드를 사용하여 HTTP 요청과 함께 백엔드 애플리케이션에 전달할 적절한 ID를 얻을 수 있습니다. 적절한 헤더 ID는 응답의 백엔드 애플리케이션에서 전달되어 애플리케이션 간 추적이 작동하는 데 필요한 모든 것을 제공합니다.

이 예에서는 외부 HTTP 연결로 conn 을 사용하여 백엔드 HTTP 요청에 NewRelic-ID 을 추가합니다. (추가 가져오기에 유의하십시오.)

import com.newrelic.agent.android.NewRelic;
import com.newrelic.agent.android.Agent; //required for getCrossProcessId()
...
...

//new method for appending the crossProcessID necessary for CAT in New Relic
public static void setCrossProcessHeader(HttpURLConnection conn) {
    String crossProcessId = Agent.getCrossProcessId(); // API call into the agent for the X-NewRelic-ID
    if (crossProcessId != null) {
        conn.setRequestProperty("X-NewRelic-ID", crossProcessId);
    }
}

백엔드 앱에 대한 요청에 적절한 헤더를 추가한 후 앱의 응답은 X-Newrelic-App-Data 헤더에 대해 구문 분석된 다음 noticeHttpTransaction 호출에 문자열로 추가되어야 합니다. 예를 들어:

//NewRelic.noticeHttpTransaction(url, httpMethod, statusCode, startTimeMs, endTimeMs, bytesSent, bytesReceived, responseBody, params, response);
//Where xNewRelicAppDataHeader is the value of the X-NewRelic-App-Data header
NewRelic.noticeHttpTransaction("http://api.newrelic.com", "GET", 200, System.nanoTime(), System.nanoTime(),100 ,100, "Test", new HashMap<String, String>(), xNewRelicAppDataHeader);

이 한글 문서는 사용자의 편의를 위해 기계 번역되었습니다.

중요

SDK 설치

코드 계측

주의

자동으로 계측된 분석법

카테고리 속성 예

API 메서드 사용

수동 교차 애플리케이션 추적

교차 애플리케이션 추적 예제