트레이스 및 트레이스 세부 정보 보기 - AWS X-Ray
추적 보기트레이스 타임라인 살펴보기세그먼트 세부 정보 보기하위 세그먼트 세부 정보 보기

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

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

추적 보기

CloudWatch console
CloudWatch 콘솔에서 트레이스를 보려면

  1. AWS Management Console에 로그인하고 https://console.aws.amazon.com/cloudwatch/에서 CloudWatch 콘솔을 엽니다.

  2. 왼쪽 탐색 창에서 X-Ray 트레이스를 선택한 다음 트레이스를 선택합니다. 그룹으로 필터링하거나 필터 표현식을 입력할 수 있습니다. 이 경우 페이지 하단의 트레이스 섹션에 표시되는 트레이스가 필터링됩니다.

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

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

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

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

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

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

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

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

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

      • 401 - 요청에 유효한 인증 자격 증명이 부족합니다.

      • 403 – 요청에 유효한 권한이 부족합니다.

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

      • 500 - 서버에서 예기치 않은 조건이 발생하여 내부 오류가 발생했습니다.

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

  4. 단일 트레이스를 찾으려면 쿼리 필드에 트레이스 ID를 직접 입력합니다. X-Ray 형식 또는 W3C(World Wide Web Consortium) 형식을 사용할 수 있습니다. 예를 들어 AWS Distro for OpenTelemetry를 사용하여 생성된 트레이스는 W3C 형식입니다.

    참고

    W3C 형식의 트레이스 ID로 생성된 트레이스를 쿼리하면 일치하는 트레이스가 콘솔에 X-Ray 형식으로 표시됩니다. 예를 들어 4efaaf4d1e8720b39541901950019ee5를 W3C 형식으로 쿼리하면 동등한 X-Ray 형식인 1-4efaaf4d-1e8720b39541901950019ee5가 콘솔에 표시됩니다.

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

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

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

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

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

    트레이스 및 트레이스 세부 정보 페이지에서는 교차 계정 추적을 지원합니다. 이를 통해 트레이스 목록과 단일 트레이스 맵 내에서 여러 계정의 트레이스를 나열할 수 있습니다.

X-Ray console
X-Ray 콘솔에서 트레이스를 보려면

  1. X-Ray 콘솔의 트레이스 페이지를 엽니다. 트레이스 개요 패널에는 오류 근본 원인, ResourceARN, InstanceId를 포함한 일반적인 기능별로 그룹화된 트레이스 목록이 표시됩니다.

  2. 공통 기능을 선택해 그룹화된 트레이스를 보려면 그룹화 기준 옆의 아래쪽 화살표를 확장합니다. 다음 그림은 AWS X-Ray 샘플 애플리케이션의 URL별로 그룹화된 트레이스의 트레이스 개요와 관련 트레이스 목록을 보여줍니다.

    URL별로 그룹화된 트레이스 개요 및 ID, 메서드, 응답 등의 세부 정보가 포함된 트레이스 목록 예시입니다.

  3. 트레이스 목록에서 확인할 트레이스의 ID를 선택합니다. 탐색 창에서 서비스 맵을 선택하여 특정 서비스 노드에 대한 트레이스를 볼 수도 있습니다. 그런 다음 해당 노드와 연관된 트레이스를 볼 수 있습니다.

    타임라인 탭에는 트레이스에 대한 요청 흐름이 표시되며 다음 정보가 포함됩니다.

    • 트레이스의 각 세그먼트에 대한 경로 맵

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

    • 트레이스 맵의 노드에 대한 요청 횟수

    다음 그림은 샘플 애플리케이션에 대한 GET 요청과 관련된 트레이스 맵의 예시를 보여줍니다. 화살표는 각 세그먼트가 요청을 완료하기 위해 이동한 경로를 표시합니다. 서비스 노드에는 GET 요청 중에 이루어진 요청 횟수가 표시됩니다.

    트레이스 맵 아래에는 타임라인이 표시되며 세그먼트, 기간, 시작점, 종료점이 서로의 관계에 따라 나타납니다.

    타임라인 탭에 대한 자세한 내용은 아래의 트레이스 타임라인 살펴보기 단원을 참조하세요.

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

    • 타임스탬프

    • 고유 ID

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

    • 세그먼트 또는 하위 세그먼트의 소스 또는 오리진

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

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

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

CloudWatch console

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

  • 첫 번째 열: 선택한 트레이스의 세그먼트 및 하위 세그먼트가 나열됩니다.

  • 세그먼트 상태 열: 각 세그먼트 및 하위 세그먼트의 상태 결과가 나열됩니다.

  • 응답 코드 열: 세그먼트 또는 하위 세그먼트의 브라우저 요청에 대한 HTTP 응답 상태 코드가 나열됩니다(제공되는 경우).

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

  • 호스팅 위치 열: 세그먼트 또는 하위 세그먼트가 실행되는 네임스페이스 또는 환경이 나열됩니다(해당되는 경우). 자세한 내용은 수집된 측정기준 및 측정기준 조합을 참조하세요.

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

서비스 노드별로 세그먼트 및 하위 세그먼트 목록을 그룹화하려면 노드별 그룹화를 켭니다.

X-Ray console

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

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

  • 이름 열: 트레이스의 세그먼트 및 하위 세그먼트의 이름이 나열됩니다.

  • 응답 열: 세그먼트 또는 하위 세그먼트의 브라우저 요청에 대한 HTTP 응답 상태 코드가 나열됩니다(제공되는 경우).

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

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

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

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

  • 타임스탬프

  • 고유 ID

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

  • 세그먼트 또는 하위 세그먼트의 소스 또는 오리진

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

계측된 AWS SDK, HTTP 또는 SQL 클라이언트를 사용하여 외부 리소스를 호출하는 경우 X-Ray SDK는 하위 세그먼트를 자동으로 기록합니다. 또한 X-Ray SDK를 사용하여 함수 또는 코드 블록에 대해 사용자 지정 하위 세그먼트를 기록할 수도 있습니다. 사용자 지정 하위 세그먼트가 열려 있는 동안 기록된 추가 하위 세그먼트는 사용자 지정 하위 세그먼트의 하위 항목이 됩니다.

세그먼트 세부 정보 보기

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

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

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

  • 세그먼트의 리소스 탭에는 X-Ray SDK의 정보 및 애플리케이션을 실행하는 AWS 리소스에 대한 정보가 표시됩니다. Amazon EC2, AWS Elastic Beanstalk 또는 X-Ray SDK용 Amazon ECS 플러그인을 사용하면 서비스별 리소스 정보를 기록할 수 있습니다. 플러그인에 대한 자세한 내용은 Java용 X-Ray SDK 구성에서 서비스 플러그인 단원을 참조하세요.

  • 나머지 탭에는 세그먼트에 대해 기록된 주석, 메타데이터 및 예외가 표시됩니다. 계측된 요청에서 발생하는 예외는 자동으로 캡처됩니다. 주석 및 메타데이터에는 X-Ray SDK에서 제공하는 작업을 사용하여 기록되는 추가 정보가 포함됩니다. 세그먼트에 주석 또는 메타데이터를 추가하려면 X-Ray SDK를 사용합니다. 자세한 내용은 AWS X-Ray용 애플리케이션 계측에서 AWS X-Ray SDK로 애플리케이션 계측 아래에 나열된 언어별 링크를 참조하세요.

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

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

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

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

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

사용자 지정 하위 세그먼트의 경우, 개요 탭에 하위 세그먼트의 이름이 표시됩니다. 이 이름은 이 하위 세그먼트가 기록하는 코드 영역이나 함수를 지정하는 데 설정할 수 있습니다. 자세한 내용은 Java용 X-Ray SDK를 사용하여 사용자 지정 하위 세그먼트 생성하기에서 AWS X-Ray SDK로 애플리케이션 계측 아래에 나열된 언어별 링크를 참조하세요.

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

ID, 상위 ID, 이름, 시간, 오류, 결함을 포함한 하위 세그먼트에 대한 개요 정보입니다.

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