기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # 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](https://docs.aws.amazon.com/xray/latest/api/Welcome.html)를 직접 사용하는 경우 요청을 올바른 데이터 형식으로 파라미터화해야 하며 인증 및 오류 처리도 구성해야 할 수 있습니다. 다음 다이어그램은 X-Ray API와 상호 작용하는 방법을 선택하는 지침을 보여줍니다. ![\[X-Ray는 애플리케이션 요청에 대한 자세한 정보를 표시합니다.\]](http://docs.aws.amazon.com/ko_kr/xray/latest/devguide/images/api-vs-cli.png) X-Ray API를 사용하여 트레이스 데이터를 X-Ray로 직접 전송합니다. X-Ray API는 다음과 같은 일반 작업을 포함하여 X-Ray SDK에서 사용할 수 있는 모든 함수를 지원합니다. + [PutTraceSegments](https://docs.aws.amazon.com/xray/latest/api/API_PutTraceSegments.html) - 세그먼트 문서를 X-Ray에 업로드합니다. + [BatchGetTraces](https://docs.aws.amazon.com/xray/latest/api/API_BatchGetTraces.html) - 트레이스 ID 목록에서 트레이스 목록을 검색합니다. 검색된 각 트레이스는 단일 요청의 세그먼트 문서 모음입니다. + [GetTraceSummaries](https://docs.aws.amazon.com/xray/latest/api/API_GetTraceSummaries.html) - 트레이스에 대한 ID와 주석을 검색합니다. `FilterExpression`을 지정하여 트레이스 요약의 하위 집합을 검색할 수 있습니다. + [GetTraceGraph](https://docs.aws.amazon.com/xray/latest/api/API_GetTraceGraph.html) - 특정 트레이스 ID에 대한 서비스 그래프를 검색합니다. + [GetServiceGraph](https://docs.aws.amazon.com/xray/latest/api/API_GetServiceGraph.html) - 수신 요청을 처리하고 다운스트림 요청을 직접 호출하는 서비스를 설명하는 JSON 형식의 문서를 검색합니다. 또한 애플리케이션 코드 내에서 AWS Command Line Interface(AWS CLI)를 사용하여 X-Ray와 프로그래밍 방식으로 상호 작용할 수도 있습니다. AWS CLI는 다른 AWS 서비스용 기능을 포함하여 X-Ray SDK에서 사용할 수 있는 모든 기능을 지원합니다. 다음 함수는 앞에 나열된 API 작업의 간단한 형식 버전입니다. + [put-trace-segments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/xray/put-trace-segments.html) - X-Ray에 세그먼트 문서를 업로드합니다. + [batch-get-traces](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/xray/batch-get-traces.html) - 트레이스 ID 목록에서 트레이스 목록을 검색합니다. 검색된 각 트레이스는 단일 요청의 세그먼트 문서 모음입니다. + [get-trace-summaries](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/xray/get-trace-summaries.html) - 트레이스에 대한 ID와 주석을 검색합니다. `FilterExpression`을 지정하여 트레이스 요약의 하위 집합을 검색할 수 있습니다. + [get-trace-graph](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/xray/get-trace-graph.html) - 특정 트레이스 ID에 대한 서비스 그래프를 검색합니다. + [get-service-graph](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/xray/get-service-graph.html) - 수신 요청을 처리하고 다운스트림 요청을 직접 호출하는 서비스를 설명하는 `JSON` 형식의 문서를 검색합니다. 시작하려면 운영 체제에 맞는 [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)를 설치해야 합니다. AWS는 Linux, macOS, Windows 운영 체제를 지원합니다. X-Ray 명령 목록에 대한 자세한 내용은 [X-Ray용 AWS CLI 명령 참조 안내서](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/xray/index.html)를 참조하세요. **Topics** + [AWS CLI에서 AWS X-Ray API 사용하기](xray-api-tutorial.md) + [로 추적 데이터 전송 AWS X-Ray](xray-api-sendingdata.md) + [AWS X-Ray에서 데이터 가져오기](xray-api-gettingdata.md) + [AWS X-Ray API를 사용하여 샘플링, 그룹 및 암호화 설정 구성](xray-api-configuration.md) + [X-Ray API에 샘플링 규칙 사용](xray-api-sampling.md) + [AWS X-Ray 세그먼트 문서](xray-api-segmentdocuments.md)