콘텐츠로 이동

트레이스 상세


트레이스 탐색기에서 트레이스를 클릭하면 상대 시간, 지속 시간, HTTP 메서드, URL, 상태 코드, TraceId, 플레임 그래프, 스팬 목록, 서비스 호출 관계 및 관련 로그, 호스트, 메트릭, 네트워크 정보를 확인할 수 있습니다. 프런트엔드 애플리케이션(예: 브라우저)의 경우 요청 시간 분포(큐, 첫 바이트, 다운로드 시간 비율 포함)도 확인할 수 있습니다.

트레이스 상세를 열면 시스템은 환경 설정의 "트레이스 상세 기본 보기" 설정에 따라 워터폴 차트 또는 플레임 그래프를 우선 표시합니다.

참고
  • 실제 사용자 모니터링(RUM) SDK는 2.2.10 이상이어야 이 데이터가 표시됩니다. 교차 출처 상황이 있는 경우 헤더 구성을 조정해야 합니다.

자세한 내용은 웹 애플리케이션 연동을 참조하세요.

  • 플레임 그래프/스팬 목록/워터폴 차트는 최대 10,000개의 스팬을 표시합니다. 오프셋을 설정하여 표시되지 않은 스팬을 확인할 수 있습니다.

플레임 그래프

플레임 그래프는 각 스팬의 흐름과 실행 시간을 명확하게 보여주며, 오른쪽에서 서비스 목록 및 응답 시간을 확인할 수 있습니다. 스팬을 클릭하면 트레이스 상세에서 JSON 내용을 확인할 수 있으며, 마우스 스크롤로 확대/축소하여 세부 정보를 볼 수 있습니다.

자세한 내용은 플레임 그래프를 활용한 트레이스 성능 분석을 참조하세요.

위 플레임 그래프에서 이번 호출 트레이스에 CloudCare와 Mysql 두 개의 서비스가 포함되어 있음을 알 수 있습니다. 트레이스는 CloudCare 서비스에 대한 POST 요청 전송으로 시작하여 ActionResource.executeAction을 실행한 후 Mysql 구문을 실행합니다. ActionResource.executeAction을 실행하는 전체 과정에서 Mysql 구문이 여러 번 실행됩니다. CloudCare와 Mysql의 실행 시간 계산 방식은 각각 다음과 같습니다.

  • CloudCare 서비스 실행 시간 = D1+D2+D3+D4+D5+D6+D7+D8+D9+D10+D11
  • Mysql 서비스 실행 시간 = span2+span3+......+span11

실행된 구문 및 실행 시간에 대한 자세한 내용은 스팬 목록을 참조하세요.


플레임 그래프에서 서비스 실행 시간 비율은 이번 호출 트레이스에서 각 서비스가 차지하는 전체 시간 대비 비율을 의미합니다. 아래 그림을 예로 들면, 이번 호출 트레이스에는 CloudCare와 Mysql 두 개의 서비스가 포함되어 있으며, 실행 시간 비율은 각각 42.37%와 57.63%입니다. CloudCare 서비스에는 2개의 스팬, Mysql 서비스에는 10개의 스팬이 있습니다.

  • Mysql 서비스 실행 시간 비율 계산 방식: 모든 스팬 실행 시간 합계 / 현재 호출 트레이스 총 시간

계산 방식 설명: 아래 그림에서 Mysql 서비스에는 총 10개의 스팬이 있습니다. 각 스팬을 클릭하여 현재 스팬의 실행 시간을 확인할 수 있습니다. 그림에서 해당 스팬의 실행 시간은 5.08ms이며, 같은 방식으로 나머지 9개 스팬의 실행 시간을 가져와 합산합니다.

  • CloudCare 서비스 실행 시간 비율 계산 방식: (현재 호출 트레이스 총 시간 - Mysql 서비스 실행 시간) / 현재 호출 트레이스 총 시간

계산 방식 설명: 아래 그림에서 CloudCare 서비스는 현재 전체 호출 트레이스에 걸쳐 있습니다. Mysql 서비스의 실행 시간을 제외한 나머지 시간이 CloudCare 서비스의 실행 시간입니다(빨간색 선으로 표시된 실행 시간 참조). 실행 시간 비율은 스팬 목록을 통해 각 스팬의 실행 시간과 실행 시간 비율을 직접 확인할 수도 있습니다.


플레임 그래프에서는 서비스가 동기식이든 비동기식이든 관계없이 각 트레이스 성능 데이터의 세부 사항을 명확하게 추적할 수 있습니다. 예를 들어 플레임 그래프를 통해 어떤 요청이 비동기로 실행되었는지, 시작 시간, 종료 시간 및 총 소요 시간을 명확하게 확인할 수 있습니다.


스팬 목록

  • 해당 트레이스의 모든 스팬에 대한 리소스 이름, 개수, 지속 시간, 실행 시간 및 비율을 표시합니다.
  • 리소스 이름 또는 스팬 ID를 입력하여 검색 및 일치시킬 수 있습니다.
  • 스팬을 클릭하면 트레이스 상세에서 JSON 내용을 확인할 수 있으며, 플레임 그래프로 전환하여 동시에 표시됩니다.
  • 오류가 있는 경우 오류 프롬프트가 표시됩니다.
  • Error Spans를 클릭하면 필터링 결과를 직접 표시합니다.

워터폴 차트

각 리소스 간의 부모-자식 관계를 확인할 수 있습니다.

워터폴 차트는 시작 시간 순서대로 스팬 데이터를 표시합니다. 왼쪽 목록에는 각 리소스의 실행 시간 비율을 포함한 스팬 데이터가 표시됩니다. 오른쪽에는 시간 순서대로 워터폴 차트가 표시됩니다.

  • 스팬에 해당하는 리소스 이름 또는 스팬 ID를 입력하여 검색 및 일치시킵니다.
  • 왼쪽 리소스를 한 번에 접거나 펼칠 수 있습니다.
  • 을 클릭하면 실행 시간 형식을 전환할 수 있습니다.

  • Error Spans를 클릭하면 필터링 결과를 직접 표시합니다.

서비스 호출 관계

서로 다른 서비스 간의 호출 관계 및 호출 횟수, 그리고 개별 서비스의 실행 시간, 평균 소요 시간 및 호출 수를 종합적으로 표시합니다.

서비스 노드를 클릭하면 세부 정보를 확인할 수 있습니다.

  • 서비스 작업 및 리소스: 해당 서비스에 포함된 특정 작업(예: API 인터페이스, 메서드 등) 및 관련 리소스를 나열합니다.

  • 오류 상태 추적:

    • 해당 서비스에 오류가 있는 경우 오류 세부 정보를 직접 표시합니다.

    • 클릭하면 서비스의 상위 스팬을 확인하여 상위 호출 출처를 추적할 수 있습니다.

참고

시스템은 트레이스 상세 > 플레임 그래프에서 집계된 서비스별 error 결과를 기반으로 여기서 서비스의 색상을 표시합니다.

빠른 작업

작업
설명
전체 화면 보기/기본 크기로 복원 트레이스 상세 오른쪽 상단의 전체 화면 보기 아이콘 을 클릭하여 가로로 확장하여 트레이스 플레임 그래프를 볼 수 있습니다. 기본 크기로 복원 아이콘 을 클릭하면 상세 페이지로 복원됩니다.
현재 스팬으로 이동 클릭하면 보기를 확대하여 현재 스팬으로 이동합니다.
미니맵 펼치기/접기 트레이스 상세 왼쪽의 미니맵 펼치기/접기 아이콘 을 클릭하고, 미니맵에서 구간 선택, 드래그, 스크롤을 통해 플레임 그래프를 빠르게 확인할 수 있습니다.
전체 Trace 보기 트레이스 상세 왼쪽의 전체 Trace 보기 아이콘 을 클릭하면 플레임 그래프에서 전체 트레이스를 확인할 수 있습니다.
스팬 더블 클릭 플레임 그래프 중간에 해당 스팬을 확대하여 표시하며, 컨텍스트 관련 스팬을 빠르게 찾아볼 수 있습니다.
서비스 이름 클릭 해당 스팬을 강조 표시하고, 서비스 이름을 다시 클릭하면 기본값인 모든 스팬 선택으로 복원됩니다. 서비스 이름을 클릭하여 해당 서비스의 스팬을 빠르게 필터링하여 확인할 수 있습니다.

확장 속성

  • 검색창에서 필드 이름 또는 값을 입력하여 빠르게 검색하고 찾을 수 있습니다.

  • 필드 별칭을 선택하면 필드 이름 뒤에 표시됩니다. 필요에 따라 선택할 수 있습니다.

  • 트레이스 상세 페이지의 확장 속성에서 현재 트레이스의 관련 필드 속성을 확인할 수 있습니다.

필드
속성
필드 값 필터링 해당 필드를 탐색기에 추가하여 해당 필드와 관련된 모든 데이터를 확인합니다. 트레이스 탐색기에서 이 필드와 관련된 트레이스 목록을 필터링하여 확인할 수 있습니다.
그림 1 참조
필드 값 역필터링 해당 필드를 탐색기에 추가하여 해당 필드 이외의 데이터를 확인합니다.
표시 열에 추가 해당 필드를 탐색기 목록에 추가하여 확인합니다.
복사 해당 필드를 클립보드에 복사합니다.

일부 필드는 필터링 및 집계 관련 로직을 지원하지 않습니다.

Guance에는 전체 텍스트 인덱스를 사용하는 일부 필드가 있으며, 이러한 필드는 필터링 및 집계 관련 로직을 지원하지 않습니다. 전체 텍스트 인덱스 필드 범위는 다음과 같습니다.

분류 필드
객체, 리소스 카탈로그 message
로그, 백업 로그 message
보안 message / title
네트워크 message
트레이스 error_message / error_stack
이벤트 message / title / df_message / df_title
RUM 오류 error_message / error_stack
RUM 긴 작업 long_task_message / long_task_stack

그림 1

오류 상세

트레이스 상세 페이지에서 현재 트레이스에 오류가 있는 경우 사이드바의 error span 필터 옵션을 선택할 수 있습니다. 시스템이 자동으로 모든 오류 스팬을 강조 표시하며, 강조 표시된 스팬을 클릭하면 관련 오류 스택, 로그 등의 세부 정보를 확인할 수 있습니다.

자세한 내용은 오류 추적을 참조하세요.

서비스 컨텍스트

인프라스트럭처 리소스 카탈로그의 객체 분류를 가져오고 create_time을 기준으로 최신 객체를 선택하여 표시합니다. 현재 서비스의 실행 정보, 서비스 종속 관계 및 통합 정보를 빠르게 확인할 수 있습니다.

관련 분석

로그를 통해 전체 트레이스의 모든 서비스와 관련된 로그 데이터를 확인할 수 있습니다(연결 필드: trace_id). 표시 열을 사용자 정의할 수 있으며, 더 자세한 로그 내용이 필요한 경우 로그 내용을 클릭하여 로그 상세 페이지로 이동하거나 로그 페이지로 이동 버튼을 클릭하여 열 수 있습니다.

시스템은 현재 트레이스의 service, env, version 등 필드를 기반으로 로그 인덱스 매핑을 일치시키고 해당 로그 인덱스를 자동으로 선택합니다. 원래 인덱스의 "서비스 매칭" 구성은 service 필드 매핑에 따라 계속 적용됩니다.

관리자 이상의 권한이 있는 경우 연결 필드를 사용자 정의할 수 있습니다. 연결 필드 오른쪽의 설정 버튼을 클릭하고 팝업 대화상자에서 연결할 필드를 선택합니다. 수동 입력, 순서 드래그 등이 가능하며, 확인하면 구성이 완료됩니다.

참고: 관련 로그 사용자 정의 필드와 서비스 목록 관련 분석 구성 사용자 정의 필드는 서로 영향을 미칩니다. 서비스 목록에서 사용자 정의 필드를 구성한 경우 여기에도 동기화되어 표시됩니다.

애플리케이션이 ddtrace 수집기를 사용하여 APM 분산 추적 및 Profile 성능 추적 데이터 수집을 동시에 활성화한 경우, 시스템은 스팬 수준의 관련 코드 핫스팟을 제공합니다. 여기에는 실행 시간, 메서드 및 실행 시간 비율이 포함됩니다.

Profile 상세 보기를 클릭하면 Profile 상세 페이지로 이동하여 더 많은 관련 코드를 확인할 수 있습니다.

트레이스 상세 페이지에서 호스트를 통해 관련 호스트의 메트릭 뷰와 속성 뷰를 확인할 수 있습니다(연결 필드: host).

  • 메트릭 뷰: 해당 트레이스 종료 30분 전부터 종료 후 30분까지의 관련 호스트 성능 메트릭 상태를 확인할 수 있습니다. 여기에는 관련 호스트의 CPU, 메모리 등의 성능 메트릭 뷰가 포함됩니다.

  • 속성 뷰: 트레이스 발생 시 호스트 객체의 실제 상황을 추적하는 데 도움이 됩니다. 해당 시간 내에 생성된 가장 최근 객체 데이터 한 개를 확인할 수 있습니다. 여기에는 호스트의 기본 정보, 통합 실행 상태가 포함됩니다. 클라우드 호스트 수집이 활성화된 경우 클라우드 공급업체 정보도 확인할 수 있습니다.

참고: Guance는 호스트 객체의 최근 48시간 기록 데이터를 기본 저장합니다. 현재 트레이스 시간에 해당하는 호스트 기록 데이터를 찾을 수 없는 경우 관련 호스트의 속성 뷰를 볼 수 없습니다.

트레이스 상세 페이지에서 컨테이너를 통해 관련 컨테이너의 메트릭 뷰와 속성 뷰를 확인할 수 있습니다(연결 필드: container_name).

  • 메트릭 뷰: 관련 컨테이너의 해당 트레이스 종료 30분 전부터 종료 후 30분까지의 성능 메트릭 상태를 확인할 수 있습니다. 여기에는 컨테이너 CPU, 메모리 등의 성능 메트릭 뷰가 포함됩니다.

  • 속성 뷰: 트레이스 발생 시 컨테이너 객체의 실제 상황을 추적하는 데 도움이 됩니다. 관련 컨테이너의 해당 시간 내에 생성된 가장 최근 객체 데이터 한 개를 확인할 수 있습니다. 여기에는 컨테이너의 기본 정보, 속성 정보가 포함됩니다.

트레이스 상세 페이지에서 Pod를 통해 관련 Pod의 속성 뷰와 메트릭 뷰를 확인할 수 있습니다(연결 필드: pod_name).

  • 메트릭 뷰: 관련 컨테이너 Pod의 해당 트레이스 종료 30분 전부터 종료 후 30분까지의 성능 메트릭 상태를 확인할 수 있습니다. 여기에는 컨테이너 CPU, 메모리 등의 성능 메트릭 뷰가 포함됩니다.

  • 속성 뷰: 트레이스 발생 시 컨테이너 Pod 객체의 실제 상황을 추적하는 데 도움이 됩니다. 관련 컨테이너 Pod의 해당 시간 내에 생성된 가장 최근 객체 데이터 한 개를 확인할 수 있습니다. 여기에는 컨테이너의 기본 정보, 속성 정보가 포함됩니다.

Guance는 네트워크에서 Host, Pod, Deployment, Service의 다차원 네트워크 토폴로지 맵 및 요약 데이터를 확인할 수 있도록 지원합니다.

일치 필드:

상세 페이지에서 관련 네트워크를 확인하려면 해당 연결 필드를 일치시켜야 합니다. 즉, 데이터 수집 시 해당 필드 태그를 구성해야 합니다. 그렇지 않으면 상세 페이지에서 관련 네트워크 뷰를 일치시켜 확인할 수 없습니다.

  • Host: 일치 필드 host.

  • Pod:

일치 필드 우선순위
namespace, pod_name
namespace, pod
pod_name
pod
  • Deployment:
일치 필드 우선순위
namespace, deployment_name
namespace, deployment
deployment_name
deployment
  • Service:
일치 필드 우선순위
namespace, service_name
namespace, service

참고:

  • Host, Pod, Deployment, Service의 연결 필드가 모두 조회될 경우 상세 페이지 진입 시 이 순서대로 네트워크 데이터를 표시합니다.
  • 연결 필드가 조회되지 않으면 끝에 회색으로 표시되며, 클릭 시 네트워크 뷰를 찾을 수 없음이 표시됩니다.

문서 평가

이 페이지가 도움이 되었나요?