X-Ray API 사용
X-Ray SDK에서 프로그래밍 언어를 지원하지 않는 경우 X-Ray API를 직접 사용하거나 AWS Command Line Interface(AWS CLI)를 사용하여 X-Ray API 명령을 직접 호출할 수 있습니다. 다음 지침에 따라 API와 상호 작용하는 방법을 선택하세요.
-
미리 형식이 지정된 명령을 사용하거나 요청에 옵션을 추가하여 더 간단한 구문을 사용하려면 AWS CLI를 사용합니다.
-
X-Ray에 대한 요청의 유연성과 사용자 지정을 극대화하려면 X-Ray API를 직접 사용합니다.
AWS CLI 대신 X-Ray API를 직접 사용하는 경우 요청을 올바른 데이터 형식으로 파라미터화해야 하며 인증 및 오류 처리도 구성해야 할 수 있습니다.
다음 다이어그램은 X-Ray API와 상호 작용하는 방법을 선택하는 지침을 보여줍니다.
X-Ray API를 사용하여 트레이스 데이터를 X-Ray로 직접 전송합니다. X-Ray API는 다음과 같은 일반 작업을 포함하여 X-Ray SDK에서 사용할 수 있는 모든 함수를 지원합니다.
-
PutTraceSegments - 세그먼트 문서를 X-Ray에 업로드합니다.
-
BatchGetTraces - 트레이스 ID 목록에서 트레이스 목록을 검색합니다. 검색된 각 트레이스는 단일 요청의 세그먼트 문서 모음입니다.
-
GetTraceSummaries - 트레이스에 대한 ID와 주석을 검색합니다.
FilterExpression을 지정하여 트레이스 요약의 하위 집합을 검색할 수 있습니다. -
GetTraceGraph - 특정 트레이스 ID에 대한 서비스 그래프를 검색합니다.
-
GetServiceGraph - 수신 요청을 처리하고 다운스트림 요청을 직접 호출하는 서비스를 설명하는 JSON 형식의 문서를 검색합니다.
또한 애플리케이션 코드 내에서 AWS Command Line Interface(AWS CLI)를 사용하여 X-Ray와 프로그래밍 방식으로 상호 작용할 수도 있습니다. AWS CLI는 다른 AWS 서비스용 기능을 포함하여 X-Ray SDK에서 사용할 수 있는 모든 기능을 지원합니다. 다음 함수는 앞에 나열된 API 작업의 간단한 형식 버전입니다.
-
put-trace-segments
- X-Ray에 세그먼트 문서를 업로드합니다. -
batch-get-traces
- 트레이스 ID 목록에서 트레이스 목록을 검색합니다. 검색된 각 트레이스는 단일 요청의 세그먼트 문서 모음입니다. -
get-trace-summaries
- 트레이스에 대한 ID와 주석을 검색합니다. FilterExpression을 지정하여 트레이스 요약의 하위 집합을 검색할 수 있습니다. -
get-trace-graph
- 특정 트레이스 ID에 대한 서비스 그래프를 검색합니다. -
get-service-graph
- 수신 요청을 처리하고 다운스트림 요청을 직접 호출하는 서비스를 설명하는 JSON형식의 문서를 검색합니다.
시작하려면 운영 체제에 맞는 AWS CLI를 설치해야 합니다. AWS는 Linux, macOS, Windows 운영 체제를 지원합니다. X-Ray 명령 목록에 대한 자세한 내용은 X-Ray용 AWS CLI 명령 참조 안내서
주제
