트레이스 및 트레이스 세부 정보 보기 - AWS X-Ray

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

트레이스 및 트레이스 세부 정보 보기

X-Ray 콘솔의 Traces 페이지를 사용하여 추적 요약에서 추적 기준URL, 응답 코드 또는 기타 데이터를 찾을 수 있습니다. 추적 목록에서 트레이스를 선택하면 트레이스 세부 정보 페이지에 선택한 트레이스와 관련된 서비스 노드의 맵과 트레이스 세그먼트의 타임라인이 표시됩니다.

추적 보기

CloudWatch console
CloudWatch 콘솔에서 트레이스를 보려면
  1. 에 AWS Management Console 로그인하고 CloudWatch 콘솔을 엽니다 https://console.aws.amazon.com/cloudwatch/.

  2. 왼쪽 탐색 창에서 X-Ra-traces를 선택한 다음 Traces를 선택합니다. 그룹별로 필터링하거나 필터 표현식을 입력할 수 있습니다. 이렇게 하면 페이지 하단의 추적 섹션에 표시되는 추적이 필터링됩니다.

    또는 서비스 맵을 사용하여 특정 서비스 노드로 이동한 다음 트레이스를 볼 수 있습니다. 그러면 쿼리가 이미 적용된 Traces 페이지가 열립니다.

  3. 쿼리 세분화 섹션에서 쿼리를 구체화하세요. 트레이스를 공통 속성으로 필터링하려면 쿼리 세분화 기준 옆의 아래쪽 화살표에서 옵션을 선택합니다. 옵션에는 다음 사항이 포함됩니다.

    • 노드 - 트레이스를 서비스 노드별로 필터링합니다.

    • 리소스 ARN - 추적과 연결된 리소스를 기준으로 트레이스를 필터링합니다. 이러한 리소스의 예로는 Amazon Elastic Compute Cloud (AmazonEC2) 인스턴스, AWS Lambda 함수 또는 Amazon DynamoDB 테이블이 있습니다.

    • 사용자 — 사용자 ID로 트레이스를 필터링합니다.

    • 오류 근본 원인 메시지 - 오류 근본 원인별로 트레이스를 필터링합니다.

    • URL— 애플리케이션에서 사용하는 URL 경로를 기준으로 트레이스를 필터링합니다.

    • HTTP상태 코드 — 애플리케이션에서 반환한 HTTP 상태 코드를 기준으로 트레이스를 필터링합니다. 사용자 지정 응답 코드를 지정하거나 다음 중에서 선택할 수 있습니다.

      • 200— 요청이 성공했습니다.

      • 401— 요청에 유효한 인증 자격 증명이 없었습니다.

      • 403— 요청에 유효한 권한이 없습니다.

      • 404— 서버가 요청된 리소스를 찾을 수 없습니다.

      • 500— 서버에 예상치 못한 상황이 발생하여 내부 오류가 발생했습니다.

    항목을 하나 이상 선택한 다음 쿼리에 추가를 선택하여 페이지 상단의 필터 표현식에 추가합니다.

  4. 단일 트레이스를 찾으려면 쿼리 필드에 트레이스 ID를 직접 입력합니다. X-Ray 형식 또는 월드 와이드 웹 컨소시엄 (W3C) 형식을 사용할 수 있습니다. 예를 들어 AWS 배포판을 사용하여 만든 트레이스는 W3C 형식입니다. OpenTelemetry

    참고

    W3C 형식 추적 ID로 만든 트레이스를 쿼리하면 콘솔에 일치하는 트레이스가 X-Ray 형식으로 표시됩니다. 예를 들어 W3C 형식으로 쿼리하면 4efaaf4d1e8720b39541901950019ee5 콘솔에 해당하는 X-Ray:가 표시됩니다. 1-4efaaf4d-1e8720b39541901950019ee5

  5. 페이지 하단의 트레이스 섹션에 일치하는 트레이스 목록을 표시하려면 언제든지 쿼리 실행을 선택하십시오.

  6. 단일 추적에 대한 추적 세부 정보 페이지를 표시하려면 목록에서 추적 ID를 선택합니다.

    다음 이미지는 트레이스와 관련된 서비스 노드가 포함된 트레이스 맵과 트레이스를 구성하는 세그먼트가 취한 경로를 나타내는 노드 사이의 에지를 보여줍니다. 트레이스 요약은 트레이스 맵 뒤에 표시됩니다. 요약에는 샘플 GET 작업, 응답 코드, 추적 실행 기간, 요청 기간에 대한 정보가 포함됩니다. 세그먼트 타임라인은 추적 세그먼트와 하위 세그먼트의 기간을 보여주는 추적 요약을 따릅니다.

    트레이스 맵, 요약 및 세그먼트 타임라인은 트레이스의 서비스 노드와 세그먼트에 대한 세부 정보를 제공합니다.

    Amazon 및 SQS Lambda를 사용하는 이벤트 기반 애플리케이션이 있는 경우 Trace 맵에서 각 요청의 추적에 대한 연결된 보기를 볼 수 있습니다. 맵에서 메시지 생산자의 트레이스는 AWS Lambda 소비자의 트레이스와 연결되며 점선 에지로 표시됩니다. 이벤트 기반 애플리케이션에 대한 자세한 내용은 을 참조하십시오. 이벤트 기반 애플리케이션 추적

    추적 및 추적 세부 정보 페이지는 추적 목록과 단일 추적 맵 내에 여러 계정의 흔적을 나열할 수 있는 교차 계정 추적도 지원합니다.

X-Ray console
X-Ray 콘솔에서 트레이스를 보려면
  1. X-Ray 콘솔의 트레이스 페이지를 엽니다. 추적 개요 패널에는 오류 근본 원인, 리소스 ARN 및 같은 일반적인 기능별로 그룹화된 추적 목록이 표시됩니다. InstanceId

  2. 공통 기능을 선택하여 그룹화된 추적 세트를 보려면 그룹화 기준 옆의 아래쪽 화살표를 펼치십시오. 다음 그림은 를 기준으로 URL 그룹화된 트레이스의 트레이스 개요와 관련 트레이스 목록을 보여줍니다. AWS X-Ray 샘플 애플리케이션

  3. 트레이스 목록에서 트레이스를 보려면 트레이스 ID를 선택하세요. 탐색 창에서 서비스 맵을 선택하여 특정 서비스 노드에 대한 트레이스를 볼 수도 있습니다. 그러면 해당 노드와 관련된 트레이스를 볼 수 있습니다.

    타임라인 탭에는 추적에 대한 요청 흐름이 표시되며, 여기에는 다음이 포함됩니다.

    • 트레이스에 있는 각 세그먼트의 경로 맵.

    • 세그먼트가 트레이스 맵의 노드에 도달하는 데 걸린 시간.

    • 추적 맵의 노드에 대한 요청 횟수

    다음 그림은 샘플 애플리케이션에 대한 GET 요청과 관련된 예제 Trace Map을 보여줍니다. 화살표는 각 세그먼트가 요청을 완료하는 데 걸린 경로를 보여줍니다. 서비스 노드는 요청 중에 이루어진 요청 수를 보여줍니다. GET

    트레이스 맵 뒤에는 세그먼트가 표시된 타임라인, 기간, 출발지, 종착지가 표시됩니다.

    타임라인 탭에 대한 자세한 내용은 다음 추적 타임라인 살펴보기 섹션을 참조하십시오.

    원시 데이터 탭에는 트레이스와 트레이스를 구성하는 세그먼트 및 하위 세그먼트에 대한 정보가 형식으로 표시됩니다. JSON 이 정보에는 다음이 포함될 수 있습니다.

    • 타임스탬프

    • 고유 IDs

    • 세그먼트 또는 하위 세그먼트와 관련된 리소스

    • 세그먼트 또는 하위 세그먼트의 출처 또는 출처

    • 애플리케이션에 대한 요청에 대한 추가 정보 (예: 요청의 응답) HTTP

트레이스 타임라인 살펴보기

타임라인 섹션에는 작업을 완료하는 데 사용한 시간에 해당하는 수평 막대 옆에 세그먼트와 하위 세그먼트의 계층 구조가 표시됩니다. 목록의 첫 번째 항목이 세그먼트인데, 단일 요청의 서비스에 의해 기록된 모든 데이터를 나타냅니다. 하위 세그먼트는 세그먼트 다음에 들여쓰여지고 나열됩니다. 열에는 각 세그먼트에 대한 정보가 포함됩니다.

CloudWatch console

CloudWatch 콘솔의 세그먼트 타임라인은 다음 정보를 제공합니다.

  • 첫 번째 열: 선택한 트레이스의 세그먼트와 하위 세그먼트를 나열합니다.

  • 세그먼트 상태 열: 각 세그먼트와 하위 세그먼트의 상태 결과를 나열합니다.

  • 응답 코드 열: 세그먼트나 하위 세그먼트에서 이루어진 브라우저 요청에 HTTP 대한 응답 상태 코드가 있는 경우 해당 세그먼트나 하위 세그먼트의 응답 상태 코드를 나열합니다.

  • 기간 열: 세그먼트 또는 하위 세그먼트가 실행된 시간을 나열합니다.

  • Hosted in 열: 해당하는 경우 세그먼트 또는 하위 세그먼트가 실행되는 네임스페이스나 환경을 나열합니다. 자세한 내용은 수집된 차원 및 차원 조합을 참조하십시오.

  • 마지막 열: 타임라인의 다른 세그먼트 또는 하위 세그먼트와 비교하여 세그먼트 또는 하위 세그먼트가 실행된 기간에 해당하는 가로 막대를 표시합니다.

세그먼트와 하위 세그먼트 목록을 서비스 노드별로 그룹화하려면 노드별 그룹화를 켜십시오.

X-Ray console

트레이스 세부 정보 페이지에서 타임라인 탭을 선택하면 트레이스를 구성하는 각 세그먼트와 하위 세그먼트의 타임라인을 볼 수 있습니다.

X-Ray 콘솔의 타임라인은 다음 정보를 제공합니다.

  • 이름 열: 트레이스에 있는 세그먼트와 하위 세그먼트의 이름을 나열합니다.

  • Res. 열: 세그먼트나 하위 세그먼트에서 이루어진 브라우저 요청에 HTTP 대한 응답 상태 코드가 있는 경우 해당 세그먼트나 하위 세그먼트의 응답 상태 코드를 나열합니다.

  • 기간 열: 세그먼트 또는 하위 세그먼트가 실행된 시간을 나열합니다.

  • 상태 열: 세그먼트 또는 하위 세그먼트 상태의 결과를 나열합니다.

  • 마지막 열: 타임라인의 다른 세그먼트 또는 하위 세그먼트와 비교하여 세그먼트 또는 하위 세그먼트가 실행된 기간에 해당하는 가로 막대를 표시합니다.

콘솔이 타임라인을 생성하는 데 사용하는 원시 트레이스 데이터를 보려면 원시 데이터 탭을 선택합니다. 원시 데이터에는 트레이스에 대한 정보와 트레이스를 구성하는 세그먼트와 하위 세그먼트에 대한 정보가 형식으로 표시됩니다. JSON 이 정보에는 다음이 포함될 수 있습니다.

  • 타임스탬프

  • 고유 IDs

  • 세그먼트 또는 하위 세그먼트와 관련된 리소스

  • 세그먼트 또는 하위 세그먼트의 출처 또는 출처

  • 요청에 대한 응답과 같은 애플리케이션에 대한 요청에 대한 추가 정보. HTTP

AWS SDKSQL인스트루먼트나 클라이언트를 사용하여 외부 리소스를 호출하면 X-Ray가 자동으로 하위 세그먼트를 SDK 기록합니다. HTTP 또한 SDK X-Ray를 사용하여 모든 함수 또는 코드 블록에 대한 사용자 지정 하위 세그먼트를 기록할 수 있습니다. 사용자 지정 하위 세그먼트가 열려 있는 동안 기록된 추가 하위 세그먼트는 사용자 지정 하위 세그먼트의 하위 세그먼트가 됩니다.

세그먼트 세부 정보 보기

추적 타임라인에서 세그먼트의 이름을 선택하여 세부 정보를 확인합니다.

세그먼트 세부 정보 패널에는 개요, 리소스, 주석, 메타데이터, 예외SQL탭이 표시됩니다. 다음이 적용됩니다.

  • 개요 탭에 요청 및 응답에 대한 정보가 표시됩니다. 정보에는 이름, 시작 시간, 종료 시간, 기간, 요청URL, 요청 작업, 요청 응답 코드, 오류 및 장애가 포함됩니다.

  • 세그먼트의 리소스 탭에는 SDK X-Ray의 정보와 애플리케이션을 실행하는 AWS 리소스에 대한 정보가 표시됩니다. 서비스별 리소스 EC2 정보를 AWS Elastic Beanstalk SDK 기록하려면 Amazon 또는 X-Ray용 Amazon ECS 플러그인을 사용하십시오. 플러그인에 대한 자세한 내용은 의 서비스 플러그인 섹션을 참조하십시오. SDK자바용 X-Ray 설정하기

  • 나머지 탭에는 세그먼트에 기록된 주석, 메타데이터예외가 표시됩니다. 계측 요청에서 예외가 생성되면 자동으로 캡처됩니다. 주석과 메타데이터에는 X-Ray에서 SDK 제공하는 작업을 사용하여 기록하는 추가 정보가 포함됩니다. 세그먼트에 주석이나 메타데이터를 추가하려면 SDK X-Ray를 사용하십시오. 자세한 내용은 응용 프로그램 인스트루먼트에 나열된 언어별 링크를 참조하십시오. AWS X-Ray SDKs 다음을 위한 애플리케이션 계측 AWS X-Ray

하위 세그먼트 세부 정보 보기

트레이스 타임라인에서 세부 정보를 보려는 하위 세그먼트 이름을 선택합니다.

  • 개요 탭에는 요청 및 응답에 대한 정보가 들어 있습니다. 여기에는 이름, 시작 시간, 종료 시간, 기간, 요청URL, 요청 작업, 요청 응답 코드, 오류 및 오류가 포함됩니다. 구성된 클라이언트에 의해 생성된 하위 세그먼트의 경우, 개요 탭에 애플리케이션 관점에서의 요청 및 응답에 대한 정보가 포함됩니다.

  • 하위 세그먼트의 리소스 탭에는 해당 하위 세그먼트를 실행하는 데 사용된 AWS 리소스에 대한 세부 정보가 표시됩니다. 예를 들어 리소스 탭에는 AWS Lambda 함수ARN, DynamoDB 테이블에 대한 정보, 호출된 모든 작업, 요청 ID가 포함될 수 있습니다.

  • 나머지 탭에는 하위 세그먼트에 기록된 주석, 메타데이터예외가 표시됩니다. 계측된 요청에서 예외가 생성되면 자동으로 캡처됩니다. 주석과 메타데이터에는 X-Ray에서 SDK 제공하는 작업을 사용하여 기록하는 추가 정보가 포함됩니다. SDKX-Ray를 사용하여 세그먼트에 주석 또는 메타데이터를 추가할 수 있습니다. 자세한 내용은 응용 프로그램 인스트루먼트에 나열된 언어별 링크를 참조하십시오. AWS X-Ray SDKs 다음을 위한 애플리케이션 계측 AWS X-Ray

사용자 지정 하위 세그먼트의 경우, 개요 탭에 하위 세그먼트의 이름이 표시됩니다. 이 이름은 이 하위 세그먼트가 기록하는 코드 영역이나 함수를 지정하는 데 설정할 수 있습니다. 자세한 내용은 응용 프로그램 인스트루먼트에 나열된 언어별 링크를 참조하십시오. AWS X-Ray SDKs Java용 X-Ray SDK를 사용하여 사용자 지정 하위 세그먼트 생성하기

다음 이미지는 사용자 지정 하위 세그먼트의 개요 탭을 보여줍니다. 개요에는 하위 세그먼트 ID, 상위 ID, 이름, 시작 및 종료 시간, 기간, 상태, 오류 또는 장애가 포함됩니다.

ID, 상위 ID, 이름, 시간, 오류 및 장애를 포함한 하위 세그먼트에 대한 개요 정보.

사용자 지정 하위 세그먼트의 메타데이터 탭에는 해당 하위 세그먼트에서 사용하는 리소스에 대한 JSON 형식 정보가 들어 있습니다.