분산 추적 UI 이해 및 사용

분산 추적 은 분산 시스템의 동작을 모니터링하고 분석하는 데 도움이 됩니다. 분산 추적을 활성화한 후 UI 도구를 사용하여 추적을 검색하고 분석할 수 있습니다.

예를 들어 여러분이 많은 서비스에 걸쳐 있는 복잡한 트랜잭션에서 오류를 해결하는 엔지니어라고 가정해 보겠습니다. UI에서 수행할 수 있는 작업은 다음과 같습니다.

분산 추적 UI 페이지 를 엽니다.
필터를 사용 하여 추적을 정렬 하여 해당 특정 요청을 찾고 오류가 포함된 추적만 표시합니다.
추적 세부정보 페이지 에서 오류가 발생한 요청 경로를 따라 범위를 검토합니다.
오류 클래스 및 메시지를 확인하고 추적의 해당 범위에서 서비스로 이동하여 오류가 높은 비율로 발생하고 있음을 확인할 수 있습니다.

분산 추적 UI의 옵션을 살펴보려면 계속 읽으십시오.

분산 추적 UI 열기

수행하려는 검색 유형에 따라 분산 추적 UI에 액세스하는 방법은 다음과 같습니다.

New Relic Explorer 및 APM 은 특정 서비스를 탐색하는 데 도움이 되는 두 가지 메뉴 옵션이므로 해당 서비스가 포함된 추적을 볼 수 있습니다.

one.newrelic.com 으로 이동합니다.
상단 메뉴바에서 Explorer 또는 APM 을 클릭합니다.
서비스 이름을 입력하여 분산 추적에 대해 활성화한 서비스로 필터링한 다음 Enter 키를 누릅니다.
왼쪽 탐색의 모니터 섹션에서 분산 추적 을 클릭하십시오.

유용한 추적 찾기

문제를 해결할 수 있도록 추적 및 범위를 찾는 데 도움이 되는 다양한 도구가 있습니다. 열리는 분산 추적 페이지는 기본 추적 목록으로 채워지며 다음 도구를 사용하여 이 목록을 빠르게 구체화할 수 있습니다.

쿼리 바
추적 그룹
산점도 차트
필터
대화형 히스토그램

팁

이러한 도구 외에도 분산 추적 데이터 쿼리 에 언급된 다른 옵션을 사용할 수도 있습니다.

쿼리 표시줄을 사용하여 필터링

추적 찾기 쿼리 표시줄은 추적 검색 범위를 좁힐 수 있는 빠른 방법입니다. 쿼리 표시줄에서 입력을 시작하거나 드롭다운을 사용하여 복합 쿼리를 만들 수 있습니다.

쿼리 반환은 추적 속성이 아닌 범위 속성을 기반으로 합니다. 특정 기준이 있는 범위를 정의하면 해당 범위가 포함된 추적이 검색에 표시됩니다.

다중 속성 필터를 사용하는 경우 선택한 첫 번째 속성의 영향을 받습니다. 분산 추적은 두 가지 유형의 데이터(트랜잭션 이벤트 및 범위)에 대해 보고합니다. 필터에서 속성을 선택하면 속성이 연결된 데이터 유형에 따라 사용 가능한 속성이 결정됩니다. 예를 들어, 트랜잭션 이벤트에 첨부된 속성을 필터링하는 경우 추가 속성 값에 대한 필터를 추가하려고 할 때 트랜잭션 이벤트 속성만 사용할 수 있습니다.

추적에 대한 쿼리는 NRQL (우리의 쿼리 언어)과 유사합니다. 다음은 주요 예외 사항입니다.

문자열 값에는 따옴표가 필요하지 않습니다(예: appName = MyApp 또는 appName = 'MyApp' 사용 가능)
like 연산자에는 % 이 필요하지 않습니다(예: appName like product 또는 appName like %product% 사용 가능).

팁

많은 수의 결과를 반환하는 일부 쿼리는 가양성을 반환할 수 있습니다. 추적 목록은 이러한 잘못된 결과를 반환된 결과의 10%로 제한합니다. 가양성으로 인해 추적 목록에 표시되지 않는 히스토그램 차트 결과가 나타날 수도 있습니다.

다음은 두 개의 쿼리 표시줄 예입니다.

아래 이미지의 쿼리는 다음과 같은 추적을 찾습니다.

WebPortal 응용 프로그램을 통과하고 WebPortal 응용 프로그램의 범위에서 오류가 발생한 범위를 포함합니다.
customer_user_email 속성에 추적의 아무 곳에서나 hotmail.com 로 끝나는 값이 포함된 범위를 포함합니다.
one.newrelic.com > Apps > Distributed tracing 으로 이동합니다.

추적 그룹

분산 추적의 기본 보기는 동일한 루트 항목 범위로 그룹화된 추적을 표시합니다. 즉, 추적은 New Relic이 요청 기록을 시작한 범위별로 그룹화됩니다. 그룹 유사 트레이스 토글을 밀어 켜고 끌 수 있습니다.

추적 그룹을 사용하면 유사한 추적 그룹에 대한 요청 동작을 이해할 수 있도록 추적에 대한 상위 수준 보기를 얻을 수 있습니다. 이렇게 하면 추적 수, 기간 및 오류의 급감 또는 급증을 이해하는 데 도움이 됩니다.

추적 그룹 중 하나를 클릭하면 선택한 특정 추적 그룹의 컨텍스트에서 모든 표준 세부 정보를 얻을 수 있습니다.

산점도를 사용하여 필터링

추적 산점도는 외부 추적을 검색하는 빠른 방법입니다. 페이지 상단에서 그룹 유사 추적 토글을 끄면 분산 추적의 시작 페이지에서 사용할 수 있습니다.

산점도에서 차트에서 커서를 이동하여 추적 세부 정보를 볼 수 있고 개별 포인트를 클릭하여 세부 정보를 얻을 수 있습니다.

산점도에 표시되는 내용을 제어하는 방법은 다음과 같습니다.

보기 기준 드롭다운에서 기간 유형을 선택합니다.
- 백엔드 기간
- 루트 스팬 기간
- 추적 기간
Group traces by 에서 다음 옵션 중 하나를 선택합니다.
- 오류 : 추적에 오류가 포함되어 있는지 여부를 기준으로 그룹화합니다.
- 루트 서비스 : 추적에서 첫 번째 서비스의 이름으로 그룹화합니다. 서비스 A가 서비스 B를 호출하고 서비스 B가 서비스 C를 호출하는 추적에서 루트 서비스는 서비스 A가 됩니다.
- 루트 진입 범위 : 루트 서비스의 끝점인 루트 트랜잭션을 기준으로 그룹화합니다. 서비스 A가 서비스 B를 호출하고 서비스 B가 서비스 C를 호출하는 추적에서 루트 항목 범위는 서비스 A의 끝점입니다. 예: "서비스 A - GET /user/%".
- 서비스 항목 범위 : 현재 APM에서 보고 있는 서비스의 범위 이름으로 그룹화합니다. 예를 들어 서비스 A가 서비스 B를 호출하고 서비스 B가 서비스 C를 호출하는 추적의 경우 APM에서 서비스 B를 보고 이 그룹화를 선택하면 추적은 서비스 B 범위 이름으로 표시됩니다. 서비스에 추적에 여러 범위가 있는 경우 이 그룹화 옵션은 해당 서비스의 첫 번째 진입점을 사용합니다.

필터

왼쪽 창에서 다중 범위 추적, 특정 엔터티 또는 오류 유형별로 추적을 필터링할 수 있습니다. 필터를 선택하면 해당 특정 유형과 관련된 추적만 표시됩니다. 이렇게 하면 가장 관심 있는 추적을 훨씬 쉽게 볼 수 있으므로 문제를 더 빨리 찾고 수정할 수 있습니다.

추적 히스토그램

히스토그램 차트를 사용하면 기간과 같은 중요한 값에 대한 추적 분포를 빠르게 이해할 수 있습니다. 왼쪽 창 하단에 있는 필터 표시 를 클릭하여 히스토그램을 표시합니다. 히스토그램 슬라이더를 이동하면 산점도 또는 추적 그룹 차트에 표시되는 데이터가 변경됩니다.

예를 들어 아래 히스토그램 예와 같이 추적 기간 차트 슬라이더를 끌어 500ms를 초과하는 추적만 표시할 수 있습니다.

중요

많은 결과를 생성하는 일부 쿼리는 히스토그램에서 잘못된 긍정을 초래할 수 있습니다. 이는 추적 목록에 없는 추적 결과를 보여주는 히스토그램으로 나타날 수 있습니다.

추적 세부정보 UI 페이지

추적 목록에서 추적을 선택하면 서비스 맵 (사용 가능한 경우)과 해당 추적 범위의 "폭포" 표시가 표시됩니다.

추적 목록에서 추적을 선택하면 추적에 대한 세부 정보가 표시됩니다.

추적 지도

추적에 둘 이상의 엔터티가 포함되어 있고 해당 엔터티에 대한 정보가 있는 경우 추적 페이지에는 지도가 포함됩니다. 그 방법에 대한 자세한 내용 은 컨텍스트의 지도를 참조하세요.

스팬 속성

UI는 다음 아이콘으로 범위 속성을 나타냅니다.

스팬 속성	지시자	설명
서비스		이 아이콘은 서비스의 진입점인 범위를 나타냅니다.
과정에서		이 아이콘은 프로세스 내에서 발생하는 범위인 in-process 범위를 나타냅니다(프로세스 간 범위와 반대). 예: 미들웨어 계측, 사용자 생성 범위.
데이터 저장소		이 아이콘은 데이터 저장소에 대한 범위 호출을 나타냅니다.
외부		이 아이콘은 HTTP를 통해 이루어진 외부 서비스에 대한 호출을 나타내는 범주를 나타냅니다.
브라우저 앱		이 아이콘은 브라우저 애플리케이션 범위 를 나타냅니다.
람다		이 아이콘은 Lambda 함수 의 범위를 나타냅니다.

일부 스팬에는 추가 표시기가 있습니다.

스팬 속성	지시자	설명
연결 유형		실선은 직접적인 부모-자식 관계를 나타냅니다. 즉, 한 프로세스나 함수가 다른 프로세스나 함수를 직접 호출합니다. 점선은 비직접 관계를 나타냅니다. 범위 간의 관계에 대한 자세한 내용은 구조 추적 을 참조하세요.
오류		오류가 있는 범위입니다. 범위 오류를 이해하는 방법을 참조하십시오.
변칙		이 아이콘은 비정상적인 범위 의 감지를 나타냅니다.
분리된 범위		일부 범위는 추적에서 "고아"이거나 분리될 수 있습니다. 이 범위는 트레이스 하단에 나타납니다. 자세한 내용은 조각난 추적 을 참조하세요.
여러 앱 이름		스팬 이름 옆에 있으면 여러 앱 이름이 설정된 엔터티를 나타냅니다. 보고하는 모든 앱 이름을 보려면 이 옵션을 선택합니다. 대체 앱 이름으로 추적 데이터를 검색하려면 `appName` 속성을 사용하세요.
클라이언트/서버 시차		범위의 지속 시간 표시기가 이 예와 같이 완전히 색칠되지 않은 경우 해당 활동에 대한 서버 측 지속 시간과 클라이언트 측 지속 시간 사이에 시간 불일치가 있음을 의미합니다. 이에 대한 자세한 내용은 클라이언트/서버 시간 차이 를 참조하십시오.

추적 구조 및 범위 속성이 결정되는 방법에 대한 자세한 내용은 추적 구조 를 참조하세요.

스팬 세부 정보 창

범위를 선택하면 범위 세부 정보가 포함된 창이 열립니다. 이러한 세부 정보는 성능 문제를 해결하는 데 도움이 될 수 있습니다. 세부 정보는 다음과 같습니다.

성능 차트
스팬 속성
범위의 데이터 소스
비정상적인 범위 세부정보
스팬의 전체 이름

범위가 표시하는 내용은 해당 범위 유형을 기반으로 합니다. 예를 들어 데이터 저장소 범위의 name 속성에는 데이터 저장소 쿼리가 포함됩니다.

추가 UI 세부정보

다음은 몇 가지 추가 분산 추적 UI 세부 정보, 규칙 및 제한입니다.

스팬 수준 오류는 프로세스에서 오류가 발생한 위치, 버블링된 방법 및 처리된 위치를 보여줍니다. 오류로 끝나는 모든 범위는 UI에 오류와 함께 표시되고 해당 추적의 총 오류 수에 기여합니다.

다음은 스팬 오류 이해에 대한 몇 가지 일반적인 팁입니다.

오류가 있는 스팬은 분산 추적 UI에서 빨간색으로 강조 표시됩니다. 각 범위에 대한 오류 세부 정보 창에서 자세한 정보를 볼 수 있습니다.
오류와 함께 종료되는 모든 스팬은 스팬 오류 수에 포함됩니다.

동일한 범위에서 여러 오류가 발생하면 다음 우선 순위에 따라 하나만 범위에 기록됩니다.

ㅏ noticeError
해당 범위 내에서 가장 최근의 범위 오류

다음 표에서는 다양한 범위 오류가 처리되는 방식을 설명합니다.

오류 유형	설명
오류로 끝나는 스팬	범위의 경계를 벗어나는 오류는 오류가 포착되거나 트랜잭션을 종료할 때까지 해당 범위 및 오류와 함께 종료되는 모든 상위 범위에서 오류를 발생시킵니다. 상위 범위에서 오류가 포착되었는지 확인할 수 있습니다.
주의 오류	에이전트 `noticeError` API 호출 또는 자동 에이전트 계측에 의해 발견된 오류는 현재 실행 중인 범위에 연결됩니다.
응답 코드 오류	응답 코드 오류는 다음과 같이 연결된 범위에 첨부됩니다. 클라이언트 범위: `http` 또는 `db` 접두사가 붙은 외부 트랜잭션 입력 범위: 응답 코드 오류로 끝나는 트랜잭션의 경우. 이러한 범위에 대한 응답 코드는 `http.statusCode` 속성으로 캡처되어 해당 범위에 연결됩니다.
OpenTelemetry 오류	오른쪽 창의 오류 세부정보 상자는 `otel.status_code = ERROR` 을 포함하는 범위로 채워지고 `otel.status_description` 의 내용을 표시합니다. 팁 앱/서비스에서 처리하는 OpenTelemetry 범위 이벤트는 범위 오류 상태와 독립적으로 표시되며 반드시 범위 오류 상태와 연관되지는 않습니다. 오른쪽 창에서 범위 이벤트 보기 를 클릭하여 범위 이벤트 예외 및 비예외를 볼 수 있습니다.

프로세스가 다른 프로세스를 호출하고 두 프로세스가 New Relic에 의해 계측되면 추적에는 호출의 클라이언트 측 표현과 서버 측 표현이 모두 포함됩니다. 클라이언트 범위 (프로세스 호출)는 서버 범위(프로세스라고 함)와 비교할 때 시간 관련 차이가 있을 수 있습니다. 이러한 차이는 다음으로 인해 발생할 수 있습니다.

시스템 클럭 시간 차이로 인한 클럭 스큐
네트워크 지연 또는 DNS 확인 지연 등으로 인한 기간의 차이
UI는 서버 범위와 동일한 공간에 클라이언트 범위의 개요를 표시하여 이러한 시간 관련 차이점을 보여줍니다. 이 범위는 클라이언트 범위의 기간을 나타냅니다.
이러한 시간 관련 불일치에 기여하는 모든 요소를 결정할 수는 없지만 다음은 몇 가지 일반적인 스팬 패턴과 이를 이해하기 위한 팁입니다.
A. 클라이언트 범위가 서버 범위보다 길면 네트워크 시간, 대기열 시간, DNS 확인 시간 또는 볼 수 없는 로드 밸런서와 같은 여러 영역의 대기 시간 때문일 수 있습니다. B. 서버 범위가 시작되기 전에 클라이언트 범위가 시작되고 끝나는 경우 이는 클럭 스큐 때문이거나 서버가 응답을 보낸 후 계속되는 비동기 작업을 수행하기 때문일 수 있습니다. C. 클라이언트 범위가 서버 범위 이후에 시작되면 이것은 클럭 스큐일 가능성이 높습니다.

조각난 트레이스는 스팬이 누락된 트레이스입니다. 범위가 누락되었거나 잘못된 상위 범위 ID가 있는 경우 해당 하위 범위가 나머지 추적과 분리되며 이를 "고아"라고 합니다. 분리된 범위는 트레이스의 맨 아래에 나타나며 나머지 트레이스에 대한 연결선이 부족합니다. UI에 표시된 분리된 범위 속성 유형:

루트 스팬이 없습니다. 요청의 첫 번째 작업인 루트 범위가 누락되었습니다. 이 경우 가장 빠른 타임스탬프가 있는 범위가 루트로 표시됩니다.
분리된 범위입니다. 상위 범위가 누락된 단일 범위입니다. 이는 하위 범위와 일치하지 않는 ID를 가진 상위 범위 때문일 수 있습니다.
분리된 추적 조각입니다. 그룹의 첫 번째 범위가 고아 범위인 연결된 범위의 그룹입니다.
이는 다음을 포함한 여러 가지 이유로 발생할 수 있습니다.
수집 한도. 처리량이 많은 일부 응용 프로그램은 수집 제한(예: APM 에이전트 수집 제한 또는 API 제한)을 초과할 수 있습니다. 이 경우 추적에 스팬이 누락될 수 있습니다. 이 문제를 해결하는 한 가지 방법은 제한에 도달하지 않도록 일부 보고 기능을 해제하는 것입니다.
잘못된 계측. 응용 프로그램이 잘못 계측되면 추적 컨텍스트를 올바르게 전달하지 못하여 조각화된 추적이 발생합니다. 이 문제를 해결하려면 고아 범위를 생성하는 데이터 소스를 검사하여 계측이 올바르게 수행되었는지 확인하십시오. 범위의 데이터 원본을 검색하려면 해당 원본을 선택하고 해당 범위 세부정보를 검사합니다.
스팬이 아직 도착하고 있습니다. 일부 상위 범위가 아직 수집되지 않은 경우 전체 추적이 보고될 때까지 일시적인 간격이 발생할 수 있습니다.
UI 표시 제한. 추적이 10K 범위 표시 제한 을 초과하는 경우 분리된 범위가 발생할 수 있습니다.

다른 서비스를 모니터링하는 New Relic 계정에 대한 액세스 권한이 없는 경우 일부 범위 및 서비스 세부 정보가 UI에서 난독화됩니다. 난독화에는 다음이 포함될 수 있습니다.

별표로 숨겨진 스팬 이름
서비스 이름이 New Relic 계정 ID 및 앱 ID로 대체됨
계정 액세스에 영향을 미치는 요소에 대한 자세한 내용은 계정 액세스 를 참조하십시오.

추적에 때때로 누락된 스팬 또는 서비스가 있을 수 있습니다(또는 있는 것처럼 보일 수 있음). 이는 추적 목록 에 표시되는 추적 범위 또는 서비스의 수와 추적 세부 정보 페이지에 표시되는 수 사이의 불일치로 나타날 수 있습니다.

누락된 범위 및 개수 불일치에 대한 이유는 다음과 같습니다.

APM 에이전트가 1K 범위 수집 제한 에 도달했을 수 있습니다.
범위는 처음에 계산될 수 있지만 네트워크 대기 시간 또는 쿼리 문제와 같은 이유로 추적 표시에 포함되지 않습니다.
UI가 10K 범위 표시 제한 에 도달했을 수 있습니다.
표시되지 않은 범위를 포함하여 수집된 모든 범위 는 NRQL을 사용하여 쿼리 할 수 있습니다.

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

분산 추적 UI 열기

특정 서비스에 대한 추적 보기

모든 계정의 추적 보기

팁