OTLP 엔드포인트
OpenTelemetry Protocol(OTLP)은 OpenTelemetry를 위해 설계된 범용 원격 측정 데이터 전송 프로토콜입니다. CloudWatch OpenTelemetry 엔드포인트는 HTTP 1.1 엔드포인트입니다. OpenTelemetry Collector를 구성하여 열려 있는 원격 측정 데이터를 CloudWatch로 전송하기 시작해야 합니다. 자세한 내용은 시작 섹션을 참조하세요. 엔드포인트는 서명 4 인증을 사용하여 호출자를 인증합니다. 자세한 내용은 API 요청용 AWS Signature Version 4 섹션을 참조하세요.
트레이스 엔드포인트
트레이스 엔드포인트는 https://xray. 패턴을 따릅니다. 예를 들어 미국 서부(오리건)(us-west-2) 리전의 경우, 엔드포인트는 AWS Region.amazonaws.com/v1/traceshttps://xray.us-west-2.amazonaws.com/v1/traces입니다.
OpenTelemetry Collector를 구성하여 트레이스를 CloudWatch로 전송하기 시작해야 합니다. 시작하려면 시작 섹션을 참조하세요.
로그 엔드포인트
로그 엔드포인트는 https://logs. 패턴을 따릅니다. 예를 들어 AWS 리전.amazonaws.com/v1/logsUS West (Oregon) (us-west-2) Region의 경우 엔드포인트는 https://logs.us-west-2.amazonaws.com/v1/logs입니다. 위의 엔드포인트를 사용하여 기존 LogGroup 및 LogStream에 로그를 전달할 수 있습니다. 로그 데이터를 수집하기 위한 LogGroup 설정에 대한 자세한 내용은 Amazon CloudWatch Logs concepts 섹션을 참조하세요. x-aws-log-group 및 x-aws-log-stream HTTP 헤더를 각각 LogGroup 및 LogStream 이름으로 설정하여 CloudWatch Logs OpenTelemetry 엔드포인트를 간접적으로 호출할 경우 LogGroup 및 LogStream을 구성해야 합니다. 자세한 내용은 시작 섹션을 참조하세요.
엔드포인트 제한 및 제약 조건
아래 표에는 트레이스 및 로그에 대한 일반적인 엔드포인트 한도 및 제한 사항이 나열되어 있습니다.
| Limit | 엔드포인트 | 추가 정보 |
|---|---|---|
|
필수 수집기 확장 |
OTLP 엔드포인트로 트레이스를 전송하려면 sigv4authextension을 사용해야 합니다. |
|
|
지원되는 프로토콜 |
HTTP |
엔드포인트는 HTTP만 지원하며 gRPC는 지원하지 않습니다. |
|
지원되는 OTLP 버전 |
OTLP 1.x |
|
|
페이로드 형식 |
이진수, json |
엔드포인트는 바이너리 및 json 형식을 사용하여 요청을 수락합니다. |
|
압축 방법 |
gzip, 없음 |
엔드포인트는 gzip만 지원하며 압축 방법은 지원하지 않습니다. |
아래 표에는 트레이스에 대한 엔드포인트 한도 및 제한 사항이 나열되어 있습니다.
| Limit | 트레이스 엔드포인트 | 추가 정보 |
|---|---|---|
|
압축되지 않은 최대 바이트/요청 |
5MB |
페이로드가 압축되지 않은 경우 OTLP 엔드포인트는 5MB를 초과하는 요청을 거부합니다. |
|
최대 이벤트/요청 |
스팬 10,000개 |
한 요청에서 허용되는 최대 스팬 수는 10,000개입니다. 이 한도를 초과하면 API 직접 호출이 거부됩니다. |
|
단일 리소스 및 범위 크기 |
16KB |
각각의 고유한 리소스 및 해당 범위는 16KB 크기를 초과해서는 안 됩니다. 리소스에서 이 제한을 초과하면 전체 API 직접 호출이 거부됩니다. |
|
단일 스팬 최대 크기 |
200KB |
200KB를 초과하는 스팬은 엔드포인트에서 거부합니다. |
|
스팬 생성된 타임스탬프 |
향후 2시간 및 과거 14일 |
배치의 어떤 스팬도 향후 2시간 또는 과거 14일을 초과할 수 없습니다. |
|
이벤트/요청에 있는 최대 시간 간격 |
24시간 |
아래 표에는 로그에 대한 엔드포인트 한도 및 제한 사항이 나열되어 있습니다.
| Limit | 로그 엔드포인트 | 추가 정보 |
|---|---|---|
|
압축되지 않은 최대 바이트/요청 |
1MB |
페이로드가 압축되지 않은 경우 OTLP 엔드포인트는 1MB를 초과하는 요청을 거부합니다. 프로토콜 버퍼로 직렬화된 이진 데이터의 압축 해제 및 역직렬화 후 최대 요청 크기는 1,048,576바이트입니다. 이 크기는 UTF-8에서 모든 이벤트 메시지를 합한 값에 각 로그 레코드마다 26바이트를 추가하여 계산한 값입니다. |
1초당 1개의 요청 |
5000 |
리전별 계정당 초당 5,000개의 트랜잭션. Service Quotas 서비스를 사용하여 초당 스로틀링 할당량 증가를 요청할 수 있습니다. |
|
최대 이벤트/요청 |
로그 10,000개 |
한 요청에서 허용되는 최대 스팬 수는 10,000개입니다. 이 한도를 초과하면 API 직접 호출이 거부됩니다. |
|
단일 리소스 및 범위 크기 |
16KB |
각각의 고유한 리소스 및 해당 범위는 16KB 크기를 초과해서는 안 됩니다. 리소스에서 이 제한을 초과하면 전체 API 직접 호출이 거부됩니다. |
|
단일 LogEvent 크기 |
1MB |
LogEvent 크기는 각 LogRecord, 범위, 리소스의 크기 합계로 계산됩니다. 이 할당량은 변경할 수 없습니다. |
로그 생성된 타임스탬프 |
향후 2시간 및 과거 14일 |
배치의 로그 레코드는 시간순으로 정렬하지 않아도 됩니다. 단, 배치의 로그 레코드는 향후 2시간을 초과할 수 없으며 과거 14일을 초과할 수 없습니다. 로그 그룹의 보존 기간보다 이전으로 거슬러 내려갈 수 있는 로그 레코드도 없습니다. |
|
이벤트/요청에 있는 최대 시간 간격 |
24시간 |
참고
로그에 대한 계정 한도는 SDK 및 새 로그 엔드포인트에서 공유됩니다.
