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을 구성해야 합니다. 자세한 내용은 시작 섹션을 참조하세요.
로그 이벤트 크기가 1MB를 초과하면 CloudWatch Logs는 가장 큰 필드부터 시작하여 최대 10개의 필드를 자동으로 잘라냅니다. 총 이벤트 크기를 가능한 1MB에 가깝게 유지하기 위해 필요한 경우 각 필드가 잘립니다. 초과 부분은 대형 로그 객체(LLO)로 저장되고 LLO 참조 시스템 필드가 추가됩니다. 선택적으로 x-aws-truncatable-fields HTTP 헤더를 설정하여 잘라야 하는 필드 경로를 지정할 수 있습니다. GetLogObject API를 사용하여 LLO를 검색하고 다시 스트리밍할 수 있습니다. 자세한 내용은 GetLogObject를 참조하세요. 1MB보다 큰 로그 이벤트 및 LLO 경험 지원은 미국 동부(버지니아 북부), 미국 서부(오리건), 유럽(프랑크푸르트) 및 아시아 태평양(시드니)에서 사용할 수 있습니다.
엔드포인트 제한 및 제약 조건
아래 표에는 트레이스 및 로그에 대한 일반적인 엔드포인트 한도 및 제한 사항이 나열되어 있습니다.
| 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바이트를 추가하여 계산한 값입니다. |
|
20MB 미국 동부(버지니아 북부), 미국 서부(오리건), 유럽(프랑크푸르트) 및 아시아 태평양(시드니)에서만 사용할 수 있습니다. |
OTLP 페이로드가 압축 해제되고 JSON 형식에서 디코딩된 후 최대 요청 크기는 20MB(20,971,520바이트)입니다. 최대 1MB 로그의 경우 - 이러한 로그는 쿼리 및 라이브 테일을 포함한 모든 CloudWatch Logs 기능에 대한 전체 액세스 권한을 보유합니다. 1MB보다 큰 로그의 경우 - 초과 부분은 대형 로그 객체(LLO)로 처리됩니다. |
|
1초당 1개의 요청 |
5000 |
리전별 계정당 초당 5,000개의 트랜잭션. Service Quotas 서비스를 사용하여 초당 스로틀링 할당량 증가를 요청할 수 있습니다. |
|
단일 리소스 및 범위 크기 |
16KB |
각각의 고유한 리소스 및 해당 범위는 16KB 크기를 초과해서는 안 됩니다. 리소스에서 이 제한을 초과하면 전체 API 직접 호출이 거부됩니다. |
|
단일 LogEvent 크기 |
1MB |
LogEvent 크기는 각 LogRecord, 범위, 리소스의 크기 합계로 계산됩니다. 이 할당량은 변경할 수 없습니다. |
로그 생성된 타임스탬프 |
향후 2시간 및 과거 14일 |
배치의 로그 레코드는 시간순으로 정렬하지 않아도 됩니다. 단, 배치의 로그 레코드는 향후 2시간을 초과할 수 없으며 과거 14일을 초과할 수 없습니다. 로그 그룹의 보존 기간보다 이전으로 거슬러 내려갈 수 있는 로그 레코드도 없습니다. |
|
이벤트/요청에 있는 최대 시간 간격 |
24시간 |
|
|
최대 이벤트/요청 |
로그 10,000개 |
한 배치에서 최대 로그 이벤트 수는 최대 10,000개입니다. 이 한도를 초과하면 API 직접 호출이 거부됩니다. |
|
요청당 최대 대형 로그 객체 수 |
1개의 로그 레코드 미국 동부(버지니아 북부), 미국 서부(오리건), 유럽(프랑크푸르트) 및 아시아 태평양(시드니)에서 사용할 수 있습니다. |
로그 이벤트에서 1MB를 초과하는 콘텐츠의 경우 초과 콘텐츠는 LLO로 저장됩니다. 요청당 1개의 로그 레코드로 제한됩니다. |
|
레코드당 최대 대형 로그 객체 수 |
10개의 LLO 미국 동부(버지니아 북부), 미국 서부(오리건), 유럽(프랑크푸르트) 및 아시아 태평양(시드니)에서 사용할 수 있습니다. |
단일 로그 레코드는 최대 10개의 LLO를 포함할 수 있습니다. |
참고
로그에 대한 계정 한도는 SDK 및 새 로그 엔드포인트에서 공유됩니다.
