• EnglishEspañol日本語한국어Português
  • 로그인지금 시작하기

Android 에이전트 설치 방법

Android 에이전트를 설치하려면 안내 설치를 사용해야 합니다. Android 에이전트를 설정하려면 모니터링하려는 각 모바일 앱을 인증하는 애플리케이션 토큰이 필요합니다. 앱 토큰은 안내 설치를 통해서만 사용할 수 있습니다.

안내 설치를 통한 Android 에이전트 설치 방법

  1. one.newrelic.com > Add data > Mobile > Android로 이동합니다.
  2. 안내 설치의 단계에 따라 Android 에이전트를 설정합니다.
  3. 몇 분 정도 기다린 후 one.newrelic.com > All capabilities > Mobile > (앱 선택)으로 이동한 후 데이터를 확인합니다.

Android 에이전트 수동 설치 방법

이러한 절차는 안내 설치에 나와 있습니다. 문서를 통해 빌드 파일을 업데이트하는 경우에도 앱을 뉴렐릭에 추가하고 안내 설치에서 생성된 앱 토큰을 가져와야 한다는 점을 기억하시기 바랍니다. 그렇지 않으면 Android 앱에 대한 데이터를 캡처할 수 없습니다.

  1. Gradle & Android Studio 탭에 있는 build.gradle 파일에 다음 코드를 추가합니다. 계측하려는 최상위 빌드 스니펫과 각 하위 모듈을 업데이트해야 합니다.

  2. 앱 권한을 설정합니다. AndroidManifest.xml 파일에 다음 행을 추가하여 Android 앱이 INTERNETACCESS_NETWORK_STATE 권한을 요청하도록 합니다.

    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
  3. Android 에이전트를 시작합니다. 매니페스트에 있는 기본 활동에서 NewRelic 클래스를 가져옵니다.

    import com.newrelic.agent.android.NewRelic;

    예기치 않거나 불안정한 동작이 발생할 수 있으므로 다른 클래스에서 에이전트를 시작하는 것은 지원하지 않습니다.

  4. NewRelic 클래스를 가져온 후, 안내 설치에서 생성된 앱 토큰을 포함하는 추가 스니펫을 onCreate() 메서드에 추가해야 합니다. 스니펫은 다음과 같습니다.

    NewRelic.withApplicationToken("<GENERATED_TOKEN>").start(this.getApplicationContext());
  5. 축소를 사용하는 경우(예: ProGuard 또는 Dexguard 사용) 앱 레벨 디렉터리(projectname/app)에 newrelic.properties 파일을 추가해야 합니다. 이 단계는 ProGuard 및 DexGuard 사용자에게만 적용됩니다.

    com.newrelic.application_token=<GENERATED_TOKEN>

    축소 설정을 완료하려면 Android 앱용 ProGuard 또는 DexGuard 구성 단계를 따르십시오.

  6. 프로젝트를 삭제한 후 에뮬레이터 또는 디바이스에서 앱을 실행하여 트래픽을 생성합니다. 에이전트가 해당 데이터를 캡처하는 동안 몇 분 정도 기다립니다.

  7. Android 앱의 데이터를 확인합니다. one.newrelic.com > All capabilities > Mobile > (앱 선택)으로 이동합니다.

Gradle 플러그인 포털을 위한 Android 에이전트 구성 방법

Android 에이전트는 아직 커뮤니티 플러그인으로 사용할 수 없으므로 에이전트가 Android 앱을 계측할 수 있도록 MavenCentral을 통해 클래스 경로를 제공해야 합니다. Gradle 플러그인 포털을 통해 플러그인을 찾도록 앱을 구성한 경우 settings.gradle(.kts) 파일에서 이 단계를 반복해야 합니다.

  1. 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 script
plugins {
id("newrelic") version "${<AGENT_VERSION>}"
}
}
  1. 뉴렐릭 플러그인을 선언합니다.
plugins {
// for binary Gradle plugins that need to be resolved
id("newrelic") version "<AGENT_VERSION>" apply false
}
  1. 앱 레벨 빌드 파일에 플러그인을 적용합니다.
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 에이전트 설치가 완료되었습니다. 다음 단계에는 몇 가지 옵션이 있습니다.

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.