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

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

영문본과 번역본이 일치하지 않는 경우 영문본이 우선합니다. 보다 자세한 내용은 이 페이지를 방문하시기 바랍니다.

문제 신고

분산 추적을 통한 New Relic Android 모바일 모니터링

|View as Markdown (English)

뉴렐릭 안드로이드 에이전트는 분산 추적을 지원합니다. 이를 통해 모바일 앱 활동이 관련 서비스에 어떻게 연결되는지 확인할 수 있습니다.

이 짧은 비디오(약 2분 15초)를 보고 다음 방법을 배우십시오.

  • New Relic에서 모바일 분산 추적 데이터를 찾으십시오.
  • 표준 및 사용자 정의 속성으로 필터링합니다.

요구 사항

분산 추적을 사용하려면 Android 에이전트 버전 6.0.0 이상이 필요합니다. 최신 에이전트를 사용하는 것이 좋습니다.

분산 추적을 설정하는 방법

이 기능을 지원하는 모바일 에이전트의 경우 기본적으로 활성화됩니다. 이 기능이 작동하려면 AnalyticsEvents 도 켜야 합니다.

분산 추적을 끄려면 Android 기능 플래그 를 참조하세요.

분산 추적 헤더

안드로이드 에이전트 버전 7.8.3부터 에이전트는 발신 네트워크 requests에 W3C Trace Context 헤더인 traceparent 및 tracestate만 추가합니다. 더 이상 독점적인 newrelic 헤더를 전송하지 않습니다. 이전 에이전트 버전은 세 가지 헤더를 모두 전송합니다.

W3C Trace Context를 지원하는 뉴렐릭 APM 에이전트는 트레이스를 계속하기 위해 이 헤더를 사용하므로, 앱의 requests가 호출하는 백앤드 서비스에 계속 연결된 상태를 유지합니다. W3C Trace Context는 다음 APM 에이전트 버전 이상에서 지원됩니다:

APM 에이전트

최소 버전

가다

3.1.0

자바

5.10.0

.그물

8.27.0

노드.js

6.4.0

파이썬

5.6.0

중요

앱과 백앤드 사이의 서비스, 프록시 또는 게이트웨이에서 newrelic 헤더를 필요로 하는 경우, 대신 traceparent 및 tracestate를 허용하도록 업데이트하십시오. 위 버전보다 오래된 APM 에이전트는 newrelic 헤더만 인식하며, 앱의 요청에 연결하는 대신 새로운 트레이스를 시작합니다.

무한 추적 활성화

모바일 앱에 Infinite Tracing 이라는 꼬리 기반 분산 추적을 사용하는 일부 다운스트림 서비스가 있는 경우 모바일 앱에 대해 이 기능을 활성화해야 합니다.이렇게 하면 루트 범위(시작 모바일 앱)가 Infinite Tracing에서 추적하는 나머지 범위에 포함됩니다.

이를 설정하려면 추적 관찰자를 만들고 범위를 보고해야 하는 모바일 앱(데이터 원본)을 선택하는 무한 추적 단계 를 참조하세요.

데이터 찾기

모바일 스팬은 해당 스팬이 추적의 일부인 New Relic 분산 추적 UI 에 나타납니다.

다음은 데이터를 찾고 쿼리하기 위한 몇 가지 팁입니다.

  • New Relic 분산 추적 UI 에서 최종 사용자 시작 추적을 찾을 수 있습니다.

  • 분산 추적 UI에서 최종 사용자 스팬은 다음으로 표시됩니다New Relic distributed tracing mobile span icon아이콘입니다.

  • 스팬의 속성을 보려면 UI에서 스팬을 선택하세요.

  • 스팬은 스팬 데이터 로 보고되며 New Relic에서 쿼리 할 수 있습니다.

  • 쿼리 팁:

    • mobileApp.name 을 모바일 앱 이름으로 설정하여 이름으로 쿼리합니다.
    • mobileApp.name is not null 을 사용하여 모바일 앱 스팬이 하나 이상 포함된 추적을 쿼리합니다.
    • appName is not null가 있는 하나 이상의 백엔드 앱을 포함하는 트레이스를 쿼리합니다.
    • 이전 두 조건을 결합하여 모바일 및 백엔드 범위를 모두 포함하는 트레이스를 쿼리합니다.

문제점 해결

최종 사용자 범위가 표시되지 않거나 다른 분산 추적 문제가 있는 경우 문제 해결 을 참조하십시오.

Copyright © 2026 New Relic Inc.

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