X-Ray를 사용하세요 API

X-Ray가 프로그래밍 언어를 SDK 지원하지 않는 경우 X-Ray를 APIs 직접 사용하거나 AWS Command Line Interface (AWS CLI) 를 사용하여 X-Ray API 명령을 호출할 수 있습니다. 다음 지침을 사용하여 상호 작용 방식을 선택하십시오API.

• 미리 형식이 AWS CLI 지정된 명령을 사용하거나 요청 내 옵션과 함께 사용하여 더 간단한 구문을 사용하십시오.

• X-Ray를 API 직접 사용하면 유연성이 극대화되고 X-Ray에 대한 요청을 사용자 지정할 수 있습니다.

대신 X-Ray를 API 직접 사용하는 경우 요청을 올바른 데이터 형식으로 매개변수화해야 하며 인증 및 오류 처리를 구성해야 할 수도 있습니다. AWS CLI

다음 다이어그램은 X-Ray와 상호 작용하는 방법을 선택하기 위한 지침을 보여줍니다API.

APIX-Ray를 사용하여 트레이스 데이터를 X-Ray로 직접 전송할 수 있습니다. APIX-Ray는 다음과 같은 일반적인 동작을 SDK 포함하여 X-Ray에서 사용할 수 있는 모든 기능을 지원합니다.

• PutTraceSegments— 세그먼트 문서를 X-Ray에 업로드합니다.

• BatchGetTraces— 추적 목록에서 추적 목록을 검색합니다. IDs 검색된 각 트레이스는 단일 요청의 세그먼트 문서 모음입니다.

• GetTraceSummaries— 트레이스를 IDs 검색하고 주석을 추가합니다. a를 FilterExpression 지정하여 추적 요약의 하위 집합을 검색할 수 있습니다.

• GetTraceGraph— 특정 추적 ID에 대한 서비스 그래프를 검색합니다.

• GetServiceGraph— 들어오는 요청을 처리하고 다운스트림 요청을 호출하는 서비스를 설명하는 JSON 서식이 지정된 문서를 검색합니다.

또한 애플리케이션 코드 내의 AWS Command Line Interface (AWS CLI) 를 사용하여 프로그래밍 방식으로 X-Ray와 상호 작용할 수 있습니다. 다른 기능을 SDK 포함하여 X-Ray에서 사용할 수 있는 모든 기능을 AWS CLI 지원합니다 AWS 서비스. 다음 함수는 앞서 나열한 API 작업을 보다 간단한 형식으로 변환한 버전입니다.

• put-trace-segments— 세그먼트 문서를 X-Ray에 업로드합니다.

• batch-get-traces— 추적 목록에서 추적 목록을 검색합니다. IDs 검색된 각 트레이스는 단일 요청의 세그먼트 문서 모음입니다.

• get-trace-summaries— 트레이스를 IDs 검색하고 주석을 추가합니다. a를 FilterExpression 지정하여 추적 요약의 하위 집합을 검색할 수 있습니다.

• get-trace-graph— 특정 추적 ID에 대한 서비스 그래프를 검색합니다.

• get-service-graph— 들어오는 요청을 처리하고 다운스트림 요청을 호출하는 서비스를 설명하는 JSON 서식이 지정된 문서를 검색합니다.

시작하려면 운영 체제에 맞게 AWS CLI를 설치해야 합니다. AWS 지원 Linux macOS 및 Windows 운영 체제. X-Ray 명령 목록에 대한 자세한 내용은 X-Ray용AWS CLI 명령 참조 안내서를 참조하십시오.

주제

• AWS CLI에서 AWS X-Ray API 사용하기
• AWS X-Ray로 추적 데이터 전송
• 에서 데이터 가져오기 AWS X-Ray
• AWS X-Ray API로 샘플링, 그룹 및 암호화 설정 구성
• X-Ray API에 샘플링 규칙 사용
• AWS X-Ray 세그먼트 문서