무엇입니까 AWS X-Ray?

AWS X-Ray 다음을 포함하여 인스트루먼트된 애플리케이션이 보내는 모든 수신 응답 및 호출에 대한 추적 정보를 제공합니다.

추적 데이터 및 시각화를 사용하여 애플리케이션 성능에 대한 통찰력을 얻고, 문제를 식별하고, 최적화 기회를 찾을 수 있습니다. X-Ray의 분석 도구를 사용하여 애플리케이션에 대한 추적된 요청의 세부 정보를 보고, 필터링하고, 조사할 수 있습니다.

X-Ray의 작동 방식

X-Ray를 사용하려면 먼저 애플리케이션을 계측하여 X-Ray가 애플리케이션이 요청을 처리하는 방식을 추적할 수 있도록 해야 합니다. 애플리케이션에 계측을 추가하면 X-Ray가 애플리케이션 내의 수신 및 아웃바운드 요청과 기타 이벤트에 대한 추적 데이터와 메타데이터를 전송할 수 있습니다. 예를 들어 Java 애플리케이션이 보내는 모든 수신 HTTP 요청과 다운스트림 호출을 AWS 서비스 계측할 수 있습니다. 애플리케이션을 자동으로 계측할 수도 있습니다. 자세한 내용은 애플리케이션 계측을 참조하십시오.

X-Ray는 계측 애플리케이션이 수신하는 모든 요청에 추적 ID를 할당합니다. 응용 프로그램이 다른 구성 요소와 상호 작용하는 경우 X-Ray는 세그먼트를 만듭니다. 이 세그먼트는 원래 추적 ID와 연결되며 해당 구성 요소와의 상호 작용 품질을 추적합니다.

X-Ray는 전체 애플리케이션 워크플로우에서 추적 ID 및 세그먼트를 추적합니다. 전체 워크플로를 분석하거나 세부 분석을 위해 일부를 분리할 수 있습니다. 세그먼트에 대한 자세한 내용은 다음 개념 섹션을 참조하십시오.

X-Ray는 서비스 노드 또는 구성 요소와 상호 작용하는 애플리케이션을 추적하여 다음과 같이 들어오는 요청을 처리합니다.

이전 단계는 다음 다이어그램에 나와 있습니다.

X-Ray가 계측 애플리케이션과 상호 작용하는 방식

계측 애플리케이션이 요청을 받으면 X-Ray는 다음을 수행합니다.

X-Ray는 애플리케이션이 상호 작용하는 AWS 리소스의 추적 데이터를 사용하여 상세한 추적 맵을 생성합니다. 추적 맵은 프런트 엔드 서비스가 단일 요청으로 호출하는 클라이언트, 프런트 엔드 서비스 및 백엔드 서비스를 보여줍니다. 추적 맵을 사용하여 ID 병목 현상, 지연 시간 급증 및 기타 문제를 해결하여 애플리케이션의 성능을 해결하거나 개선할 수 있습니다.

또한 X-Ray는 애플리케이션이 서비스 노드와 상호 작용하는 방식을 전체적으로 볼 수 있는 서비스 맵을 생성합니다. 서비스 맵의 에지는 서비스 노드를 연결합니다. 노드가 서로 통신하는 빈도와 해당 통신의 대기 시간을 보여줍니다.

다음 이미지는 애플리케이션이 다양한 구성 요소와 상호 작용하는 방식을 보여주는 서비스 맵의 예를 보여줍니다. 콘솔에서 서비스 맵을 볼 수 있습니다. 이 이미지는 클라이언트로부터 요청을 받는 애플리케이션을 보여줍니다. 그런 다음 이 이미지는 애플리케이션이 두 DynamoDB 테이블 및 Amazon SNS와 상호 작용하는 방식을 보여줍니다.

다음 이미지는 추적의 단일 세그먼트에 대해 콘솔에서 사용할 수 있는 데이터의 예입니다. 이 이미지는 여러 세그먼트를 나열한 타임라인과 각 세그먼트를 다른 세그먼트와 비교하여 실행한 시작 시간 및 기간을 보여줍니다. 이 이미지는 세그먼트 상태와 HTTP 응답 코드도 보여줍니다.

개념

AWS X-Ray 서비스에서 데이터를 세그먼트로 수신합니다. X-Ray는 공통 요청이 있는 세그먼트를 트레이스로 그룹화합니다. X-Ray는 트레이스를 처리하여 애플리케이션을 시각적으로 표현하는 서비스 그래프를 생성합니다.

세그먼트

애플리케이션 로직을 실행하는 컴퓨팅 리소스는 작업에 대한 데이터를 세그먼트의 형식으로 전송합니다. 세그먼트는 리소스의 이름, 요청의 세부 정보, 완료된 작업의 세부 정보를 제공합니다. 예를 들어 HTTP 요청이 애플리케이션에 도달하면 세그먼트가 다음 데이터를 기록할 수 있습니다.

다음 이미지는 세그먼트에 대해 반환된 개요 정보의 예시입니다. 이 이미지는 ID, 시작 및 종료 시간, 오류 또는 장애, HTTP 요청의 요청 및 응답 코드에 대한 정보를 보여줍니다.

SDK 또는 API로 구성된 추적 프레임워크는 요청 및 응답 헤더, 애플리케이션의 코드, 애플리케이션이 실행되는 AWS 리소스에 대한 메타데이터에서 정보를 수집합니다. 들어오는 요청, 다운스트림 요청 및 AWS 서비스를 계측하도록 애플리케이션 구성 또는 코드를 수정하여 X-Ray에서 수집하는 데이터를 선택합니다.

SDK 또는 API와 같은 추적 프레임워크를 사용하여 주석 및 메타데이터를 포함한 추가 정보를 기록할 수 있습니다. 세그먼트 및 하위 세그먼트 구조와 기록된 정보에 대한 자세한 내용은 을 참조하십시오. X-Ray 세그먼트 문서 세그먼트 문서의 크기는 최대 64kB까지 가능합니다.

하위 세그먼트

세그먼트를 하위 세그먼트로 나눌 수 있습니다. 하위 세그먼트는 애플리케이션이 원래 요청을 처리하기 위해 수행하는 다운스트림 호출에 대한 보다 세분화된 타이밍 정보와 세부 정보를 제공합니다. 하위 세그먼트에는 외부 HTTP API 또는 SQL 데이터베이스 호출에 대한 추가 세부 정보가 포함됩니다. AWS 서비스또한 서브세그먼트를 정의하여 애플리케이션의 특정 함수 또는 코드 라인을 계측할 수 있습니다.

X-Ray는 Amazon DynamoDB와 같이 자체 세그먼트를 전송하지 않는 서비스의 추적 맵에서 하위 세그먼트를 사용하여 추론된 세그먼트와 다운스트림 노드를 생성합니다. 하위 세그먼트를 사용하면 종속성이 추적을 지원하지 않거나 외부에 있더라도 모든 다운스트림 종속성을 확인할 수 있습니다. AWS

하위 세그먼트는 다운스트림 호출의 애플리케이션 보기를 클라이언트로 표현합니다. 다운스트림 서비스도 인스트루먼트된 경우 해당 세그먼트는 업스트림 클라이언트의 하위 세그먼트에서 추론된 세그먼트를 대체합니다. 서비스 그래프의 노드는 가능한 경우 서비스 세그먼트의 정보를 사용합니다. 두 노드 사이의 에지는 업스트림 서비스의 하위 세그먼트를 사용합니다.

예를 들어 AWS 계측 SDK 클라이언트를 사용하여 DynamoDB를 호출하면 X-Ray SDK는 해당 호출에 대한 하위 세그먼트를 기록합니다. DynamoDB는 세그먼트를 전송하지 않으므로 하위 세그먼트에는 다음에 대한 정보가 포함됩니다.

다음 다이어그램은 샘플 애플리케이션의 서비스 맵을 보여줍니다. 이미지에서 클라이언트는 샘플 Scorekeep 애플리케이션을 요청합니다. 스코어킵 애플리케이션은 DynamoDB를 두 번 호출합니다. 서비스 맵의 엣지는 이러한 각 호출을 나타냅니다. Edge를 선택하면 DynamoDB 테이블에 대한 호출 상태, 횟수, 빈도를 확인할 수 있습니다. 다음 이미지는 응답 시간을 기준으로 필터링된 엣지에 해당하는 트레이스를 보여줍니다.

계측 애플리케이션으로 다른 계측 서비스를 호출하면 다운스트림 서비스가 자체 세그먼트를 전송합니다. 이 세그먼트는 업스트림 서비스가 하위 세그먼트에 기록한 것과 동일한 통화의 뷰를 기록합니다. 서비스 그래프에서 두 서비스의 노드 모두 해당 세그먼트의 타이밍 및 오류 정보를 포함합니다. 이들 사이의 경계에는 업스트림 서비스 하위 세그먼트의 정보가 포함됩니다. 다운스트림 서비스는 요청 작업을 시작하고 종료한 시간을 기록합니다. 업스트림 서비스는 요청이 두 서비스 사이를 이동하는 데 소요된 시간을 포함하여 왕복 지연 시간을 기록합니다.

다음 이미지는 업스트림 Lambda 함수에 해당하는 엣지에서 응답 시간을 기준으로 필터링된 추적 정보를 보여줍니다.

서비스 그래프

X-Ray는 애플리케이션이 전송하는 데이터를 사용하여 서비스 그래프를 생성합니다. X-Ray로 데이터를 보내는 각 AWS 리소스는 그래프에서 서비스 노드로 나타납니다. 에지는 함께 작동하는 서비스를 연결하여 요청을 처리하고, 클라이언트를 애플리케이션에 연결하고, 애플리케이션을 애플리케이션이 사용하는 다운스트림 서비스 및 리소스에 연결합니다.

서비스 그래프는 애플리케이션을 구성하는 서비스 및 리소스에 대한 정보를 담고 있는 JSON 문서입니다. X-Ray 콘솔은 서비스 그래프를 사용하여 시각화 또는 서비스 맵을 생성합니다.

다음 이미지는 서비스 맵을 보여줍니다. 서비스 맵은 애플리케이션에 대한 클라이언트의 요청과 애플리케이션이 요청을 처리하기 위해 상호 작용하는 서비스 간의 관계를 표시합니다. 다음 이미지에서 샘플 Scorekeep 애플리케이션은 두 개의 DynamoDB 테이블 및 Amazon SNS와 상호 작용합니다.

분산 애플리케이션에서 X-Ray는 동일한 추적 ID로 요청을 처리하는 모든 서비스의 노드를 단일 서비스 그래프로 결합합니다. 요청이 상호 작용하는 첫 번째 서비스는 프런트 엔드와 해당 서비스가 호출하는 서비스 간에 전파되는 추적 헤더를 추가합니다.

예를 들어 Scorekeep은 AWS Lambda 함수를 호출하여 임의의 이름을 생성하는 웹 API를 실행합니다. 그런 다음, X-Ray SDK는 추적 ID를 생성하고 Lambda 함수에 대한 호출을 추적합니다. AWS Lambda 추적 데이터와 추적 ID를 Lambda 함수에 전달합니다. 또한 X-Ray SDK는 동일한 추적 ID를 사용하여 에이전트나 수집기에 데이터를 전송합니다. 따라서 API, AWS Lambda 서비스 및 Lambda 함수의 노드는 모두 별개이지만 연결된 노드로 추적 맵에 나타납니다.

서비스 그래프 데이터는 30일 동안 보관됩니다.

트레이스

트레이스는 단일 요청에 의해 생성된 모든 세그먼트를 수집합니다. 트레이스는 트레이스 ID를 사용하여 애플리케이션을 통한 요청 경로를 추적합니다. 이 요청은 일반적으로 로드 밸런서를 통과하여 애플리케이션 코드와 상호 작용하고 다른 AWS 서비스 또는 외부 웹 API에 대한 다운스트림 호출을 생성하는 HTTP GET 또는 POST 요청입니다. HTTP 요청과 상호 작용하는 첫 번째 지원 서비스는 요청에 추적 ID 헤더를 추가합니다. 그러면 서비스가 추적 ID를 다운스트림으로 전파하여 지연 시간, 처리 및 기타 요청 데이터를 추적합니다.

다음 이미지는 요청을 처리하는 애플리케이션의 예를 보여줍니다. HTTP 추적 요약에는 HTTP 응답 코드, 요청 처리 시간, 애플리케이션이 요청을 처리한 시간이 포함됩니다. 다음 이미지는 각 추적 세그먼트의 타임라인도 보여줍니다. 타임라인에는 상태, HTTP 응답 코드, 세그먼트를 완료하는 데 걸린 시간이 표시됩니다. 차트는 트레이스에 있는 각 세그먼트의 지속 시간, 시작 및 종료 시간을 다른 세그먼트와 비교하여 보여줍니다.

X-Ray Bills Trace 징수 방식에 대한 자세한 내용은 AWS X-Ray 가격 책정에서 X-Ray Trace의 청구 방식에 대한 정보를 참조하십시오. 트레이스 데이터는 30일 동안 보관됩니다.

샘플링

X-Ray SDK는 샘플링 알고리즘을 적용하여 효율적인 추적을 보장하고 애플리케이션이 처리하는 요청의 대표적인 샘플을 제공합니다. 이 알고리즘은 추적되는 요청을 결정합니다. 기본적으로 X-Ray SDK는 1초가 시작될 때 수신된 첫 번째 요청과 모든 추가 요청의 5% 를 기록합니다.

시작할 때 서비스 요금이 발생하지 않도록 하려는 경우 기본 샘플링 비율은 보수적입니다. 기본 샘플링 비율을 변경하도록 X-Ray를 구성하고 서비스 또는 요청의 속성에 따라 샘플링을 적용하는 추가 규칙을 구성할 수 있습니다.

예를 들어, 샘플링을 비활성화하고 상태를 수정하거나 사용자 또는 트랜잭션을 처리하는 호출에 대한 모든 요청을 트레이스하고자 할 수 있습니다. 백그라운드 폴링, 상태 확인 또는 연결 유지 관리와 같은 대용량 읽기 전용 통화의 경우.

자세한 내용은 샘플링 규칙을 구성합니다. 및 API를 참조하십시오. CreateSamplingRule

추적 헤더

모든 요청은 구성할 수 있는 최소 수까지 추적됩니다. 이 최소값에 도달하면 X-Ray는 요청의 일부만 추적하므로 추가 비용이 발생하지 않습니다. X-Ray는 로 시작하는 추적 헤더의 HTTP 요청에 샘플링 결정 및 추적 ID를 추가합니다. X-Amzn-Trace-Id 요청이 X-Ray와 통합된 첫 번째 AWS 서비스와 상호 작용할 때 X-Ray는 이러한 헤더를 추가합니다. X-Ray SDK는 이러한 헤더를 읽고 응답에 포함합니다.

X-Amzn-Trace-Id: Root=1-5759e988-bd862e3fe1be46a994272793;Sampled=1

또한 요청이 구성된 애플리케이션에서 생성된 경우 트레이스 헤더에 상위 세그먼트 ID가 포함될 수 있습니다. 예를 들어 애플리케이션이 구성된 HTTP 클라이언트를 사용하여 다운스트림 HTTP 웹 API를 호출하는 경우 X-Ray SDK가 원래 요청에 대한 세그먼트 ID를 다운스트림 요청의 트레이스 헤더에 추가합니다. 다운스트림 요청을 처리하는 계측 애플리케이션은 상위 세그먼트 ID를 사용하여 두 요청을 연결합니다.

X-Amzn-Trace-Id: Root=1-5759e988-bd862e3fe1be46a994272793;Parent=53995c3f42cd8ad8;Sampled=1

Lambda 또는 AWS 서비스 다른 업체는 처리 메커니즘의 일부로 Lineage 시작하는 헤더의 일부를 추가할 수 있습니다. 추적 헤더의 추가된 부분을 직접 사용해서는 안 됩니다.

X-Amzn-Trace-Id: Root=1-5759e988-bd862e3fe1be46a994272793;Sampled=1;Lineage=a87bd80c:1|68fd508a:5|c512fbe3:2

필터 표현식

소량의 데이터를 샘플링하더라도 복잡한 응용 프로그램에서는 많은 추적 데이터가 생성될 수 있습니다. 필터 표현식을 사용하면 개별 요청, 특정 경로 또는 사용자에 대한 트레이스를 비롯한 특정 트레이스를 찾을 수 있습니다.

다음 이미지는 정의한 그룹을 기준으로 필터링하는 데 사용할 수 있는 X-Ray 콘솔의 텍스트 상자를 보여줍니다. 그룹에 대한 자세한 내용은 다음 섹션 그룹을 참조하십시오.

그룹

필터 표현식 내의 그룹을 사용하여 추적 데이터의 양을 줄이고 그룹 기준에 맞는 데이터에 집중할 수 있습니다.

그룹을 사용하여 해당 그룹과 관련된 서비스 그래프, 추적 요약 및 CloudWatch 메트릭을 생성할 수 있습니다. 이름 또는 Amazon 리소스 이름 (ARN) 으로 호출할 수 있습니다. X-Ray는 들어오는 트레이스가 X-Ray 서비스에 저장될 때 그룹 필터 표현식과 비교하여 확인합니다. CloudWatch그룹 기준과 일치하는 트레이스에 대한 메트릭을 1분마다 게시합니다.

그룹의 필터 표현식을 업데이트해도 이미 기록한 데이터는 변경되지 않습니다. 업데이트는 후속 추적에만 적용됩니다. 이렇게 하면 새 표현식과 이전 표현식의 그래프를 병합할 수 있습니다. 연결되지 않은 그룹이 단일 그래프 내에 병합되지 않도록 하려면 현재 그룹을 삭제하고 https://docs.aws.amazon.com/xray/latest/api/API_CreateGroup.html 새 그룹을 만드십시오.

그룹에 대한 자세한 정보는 그룹 구성 섹션을 참조하세요.

주석 및 메타데이터

애플리케이션을 계측할 때, X-Ray SDK는 수신 및 발신 요청에 대한 정보를 기록합니다. SDK는 사용된 AWS 리소스 및 애플리케이션 자체에 대한 정보도 기록합니다. 세그먼트 문서에 주석 및 메타데이터로 다른 정보를 추가할 수 있습니다. 주석과 메타데이터는 추적 수준에서 결합됩니다. 모든 세그먼트나 하위 세그먼트에 추가할 수 있습니다.

주석은 필터 표현식에 사용하기 위해 인덱싱되는 키-값 쌍입니다. 주석은 콘솔의 트레이스를 그룹화할 때 사용할 데이터를 기록하거나 GetTraceSummaries API를 호출할 때 사용하십시오.

X-Ray가 트레이스당 최대 50개의 주석까지 인덱싱합니다.

메타데이터는 객체와 목록을 포함하여 인덱싱되지 않은 모든 유형의 값을 포함하는 키-값 쌍입니다. 메타데이터를 사용하여 트레이스에 저장하고 싶지만 트레이스 검색에는 사용하지 않을 데이터를 기록합니다.

콘솔의 트레이스 세부 정보 페이지에 있는 세그먼트 또는 하위 세그먼트 세부 정보 창에서 주석과 메타데이터를 볼 수 있습니다. CloudWatch 자세한 내용은 에서 추적 및 추적 세부 정보 보기를 참조하십시오. X-Ray 콘솔 살펴보기

오류, 결함 및 예외

X-Ray는 애플리케이션 코드의 오류와 다운스트림 서비스에서 반환된 오류를 추적합니다. X-Ray는 요청에서 다음과 같은 HTTP 응답 코드를 추적합니다.

애플리케이션이 계측된 요청을 처리하는 동안 예외가 발생하는 경우, X-Ray SDK는 스택 추적 ID (사용 가능한 경우) 를 포함하여 예외에 대한 세부 정보를 기록합니다. X-Ray 콘솔의 세그먼트 세부 정보에서 예외를 볼 수 있습니다.