Android 에이전트를 설치하려면 안내 설치를 사용해야 합니다. Android 에이전트를 설정하려면 모니터링하려는 각 모바일 앱을 인증하는 애플리케이션 토큰이 필요합니다. 앱 토큰은 안내 설치를 통해서만 사용할 수 있습니다.
안내 설치를 통한 Android 에이전트 설치 방법
- one.newrelic.com > Integrations & Agents > Mobile > Android으로 이동합니다.
- 안내 설치의 단계에 따라 Android 에이전트를 설정합니다.
- 몇 분 정도 기다린 후 one.newrelic.com > All capabilities > Mobile > (select your app)으로 이동하여 데이터를 확인합니다.
Android 에이전트 수동 설치 방법
이러한 절차는 안내 설치에 나와 있습니다. 문서를 통해 빌드 파일을 업데이트하는 경우에도 앱을 뉴렐릭에 추가하고 안내 설치에서 생성된 앱 토큰을 가져와야 한다는 점을 기억하시기 바랍니다. 그렇지 않으면 Android 앱에 대한 데이터를 캡처할 수 없습니다.
- Gradle & Android Studio 탭에 있는
build.gradle
파일에 다음 코드를 추가합니다. 계측하려는 최상위 빌드 스니펫과 각 하위 모듈을 업데이트해야 합니다.
- 앱 권한을 설정합니다.
AndroidManifest.xml
파일에 다음 행을 추가하여 Android 앱이INTERNET
및ACCESS_NETWORK_STATE
권한을 요청하도록 합니다.
<uses-permission android:name="android.permission.INTERNET" /><uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
- Android 에이전트를 시작합니다. 매니페스트에 있는 기본 활동에서
NewRelic
클래스를 가져옵니다.
import com.newrelic.agent.android.NewRelic;
예상치 못한 동작이나 불안정한 동작이 발생할 수 있으므로 다른 클래스에서는 에이전트를 시작하는 것을 지원하지 않습니다.
NewRelic
클래스를 가져온 후, 안내 설치에서 생성된 앱 토큰을 포함하는 추가 스니펫을onCreate()
메서드에 추가해야 합니다. 스니펫은 다음과 같습니다.
NewRelic.withApplicationToken("GENERATED_TOKEN").start(this.getApplicationContext());
- 축소를 사용하는 경우(예: ProGuard 또는 Dexguard 사용) 앱 레벨 디렉터리(projectname/app)에
newrelic.properties
파일을 추가해야 합니다. 이 단계는 ProGuard 및 DexGuard 사용자에게만 적용됩니다.
com.newrelic.application_token=GENERATED_TOKEN
축소 설정을 완료하려면 Android 앱용 ProGuard 또는 DexGuard 구성 단계를 따르십시오.
프로젝트를 삭제한 후 에뮬레이터 또는 디바이스에서 앱을 실행하여 트래픽을 생성합니다. 에이전트가 해당 데이터를 캡처하는 동안 몇 분 정도 기다립니다.
Android 앱의 데이터를 확인합니다. one.newrelic.com > All capabilities > Mobile > (select an app)으로 이동합니다.
Gradle 플러그인 포털을 위한 Android 에이전트 구성 방법
Android 에이전트는 아직 커뮤니티 플러그인으로 사용할 수 없으므로 에이전트가 Android 앱을 계측할 수 있도록 MavenCentral을 통해 클래스 경로를 제공해야 합니다. Gradle 플러그인 포털을 통해 플러그인을 찾도록 앱을 구성한 경우 settings.gradle(.kts)
파일에서 이 단계를 반복해야 합니다.
pluginManagement {}
블록을 통해settings.gradle(.kts)
파일에 이 스니펫을 추가합니다.pluginManagement {repositories {mavenCentral() // adds repo for NewRelic artifacts}resolutionStrategy {eachPlugin {if (requested.id.id.startsWith("newrelic")) {useModule("com.newrelic.agent.android:agent-gradle-plugin:${AGENT_VERSION}")}}}// optional: define as a community plugin here or in root level build file// for core Gradle plugins or plugins already available to the build scriptplugins {id("newrelic") version "${AGENT_VERSION}"}}뉴렐릭 플러그인을 선언합니다.
plugins {// for binary Gradle plugins that need to be resolvedid("newrelic") version "AGENT_VERSION" apply false}앱 레벨 빌드 파일에 플러그인을 적용합니다.
plugins {id("com.android.application")id("org.jetbrains.kotlin.android")id("newrelic")}
위 스니펫에서 AGENT_VERSION
은 에이전트 버전 번호를 나타냅니다. 최신 에이전트를 사용하여 설정하는 것이 좋습니다.
Android 4.x: 멀티덱스(multidex) 지원
Android 5.0(API 레벨 21) 이전 Android 버전에 대한 모바일 모니터링은 Dalvik 런타임을 사용하여 앱 코드를 실행합니다. 기본적으로 Dalvik은 앱을 APK당 단일 classes.dex
바이트 코드 파일로 제한합니다. 이 제한 사항을 해결하려면 multidex 지원을 활성화해야 합니다. 그러면 앱의 기본 DEX 파일의 일부가 되는 multidex 지원 라이브러리를 사용할 수 있습니다. 라이브러리는 추가 DEX 파일과 해당 파일이 포함된 코드에 대한 액세스를 관리합니다.
다음 단계는?
축하합니다. Android 에이전트 설치가 완료되었습니다. 다음 단계에는 몇 가지 옵션이 있습니다.
- 뉴렐릭 Gradle 플러그인을 사용하여 Gradle 빌드 중에 에이전트 동작을 구성합니다.
- Android 에이전트 SDK를 업그레이드하여 Android 에이전트를 최신 상태로 유지합니다.
- Android 설치에 문제가 있는 경우, 문제 해결 절차를 따르십시오.