View a markdown version of this page

트레이스 검색 - Amazon OpenSearch Service
추적 페이지에 액세스하려면추적 데이터 세트 구성데이터 추적 탐색특정 범위 보기추적 세부 정보 페이지추적과 로그 상호 연결PPL을 사용하여 추적 쿼리

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

트레이스 검색

추적 검색 페이지는 OpenSearch Service 관찰성 워크스페이스에서 분산 추적 데이터를 탐색하기 위한 전용 인터페이스를 제공합니다. 서비스에 대한 RED 지표(속도, 오류율, 기간)를 보고, 패싯 필터링으로 트레이스 스팬을 탐색하고, 개별 스팬과 트레이스를 드릴링하여 성능 문제를 진단할 수 있습니다. 또한이 페이지에서는 추적을 관련 로그 데이터와 상호 연관시킬 수 있습니다.

추적 페이지에 액세스하려면

관찰성 워크스페이스의 왼쪽 탐색 창에서 검색을 확장하고 추적을 선택합니다.

추적 데이터 세트 구성

추적 데이터를 탐색하려면 먼저 추적 데이터 세트를 구성해야 합니다. 데이터 세트를 자동으로 또는 수동으로 생성할 수 있습니다.

자동 데이터 세트 생성

추적 검색 페이지로 처음 이동하여 도메인에 추적 데이터가 있는 경우 페이지에 데이터 세트를 자동으로 생성하라는 메시지가 표시됩니다. 기본 구성을 수락하려면 데이터 세트 생성을 선택합니다.

수동 데이터 세트 생성

트레이스 데이터 세트를 수동으로 생성하려면의 단계를 따릅니다트레이스 데이터 세트를 생성하려면. 수동으로 생성하면 인덱스 패턴, 타임스탬프 필드 및 데이터 세트 이름을 제어할 수 있습니다.

데이터 추적 탐색

추적 검색 페이지에서는 추적 데이터를 탐색하기 위한 다음 구성 요소를 제공합니다.

  • 빨간색 지표 - 선택한 데이터 세트에 대한 비율(초당 요청 수), 오류율(실패한 요청의 백분율) 및 기간(지연 백분위수)을 봅니다. 이러한 지표는 시간 필터에 따라 업데이트됩니다.

  • 패싯 필드 - 서비스 이름, 작업, 상태 코드 및 기타 스팬 속성을 기준으로 트레이스 스팬을 필터링합니다. 패싯 필드 패널에서 값을 선택하여 결과의 범위를 좁힙니다.

  • 스팬 테이블 - 트레이스 ID, 스팬 ID, 서비스 이름, 작업, 기간 및 상태에 대한 열이 있는 개별 스팬을 검색합니다. 열을 기준으로 정렬하고 행을 확장하여 범위 세부 정보를 볼 수 있습니다.

특정 범위 보기

특정 스팬에 대한 세부 정보를 보려면 스팬 테이블에서 스팬 행을 선택합니다. 스팬 속성, 리소스 속성 및 이벤트 정보와 함께 플라이아웃 패널이 열립니다.

추적 세부 정보 페이지

전체 트레이스를 보려면 스팬 테이블 또는 플라이아웃 패널에서 트레이스 ID 링크를 선택합니다. 추적 세부 정보 페이지에는 추적의 모든 범위, 타이밍 관계 및 전체 추적 기간을 보여주는 워터폴 차트가 표시됩니다. 개별 범위를 확장하여 속성을 보고 병목 현상을 식별할 수 있습니다.

추적과 로그 상호 연결

추적 데이터 세트와 로그 데이터 세트 간의 상관 관계를 구성할 때 추적 검색 페이지에서 관련 로그 항목을 직접 볼 수 있습니다. 상관관계 생성에 대한 자세한 내용은 섹션을 참조하세요상관관계.

스팬 세부 정보 플라이아웃 또는 추적 세부 정보 페이지에서 관련 로그 탭을 선택하여 스팬의 추적 ID, 서비스 이름 및 시간 범위와 일치하는 로그 항목을 봅니다. 이 상관관계는 스팬 실행 중에 애플리케이션에서 발생한 일을 이해하는 데 도움이 됩니다.

컨텍스트를 사용한 로그 리디렉션

추적 범위에서 관련 컨텍스트가 보존된 로그 검색 페이지로 직접 이동할 수 있습니다. 관련 로그 패널에서 로그에서 보기를 선택하여 스팬의 트레이스 ID 및 시간 범위를 기준으로 필터링하도록 쿼리가 미리 채워진 로그 검색 페이지를 엽니다.

PPL을 사용하여 추적 쿼리

PPL을 사용하여 추적 데이터를 직접 쿼리할 수 있습니다. PPL은 파이프 문자를 사용하여 스팬 데이터를 필터링, 변환 및 집계하는 명령을 연결합니다.

다음 예제에서는 가장 느린 트레이스 10개를 찾습니다.

source = otel-v1-apm-span-*
| where durationInNanos > 5000000000
| fields traceId, serviceName, name, durationInNanos
| sort - durationInNanos
| head 10

다음 예제에서는 서비스별로 오류를 계산합니다.

source = otel-v1-apm-span-*
| where status.code = 2
| stats count() as errorCount by serviceName
| sort - errorCount

다음 예제에서는 특정 서비스에 대한 추적을 찾습니다.

source = otel-v1-apm-span-*
| where serviceName = 'checkout-service'
| where parentSpanId = ''
| sort - startTime
| head 20