# OTLP 엔드포인트
OpenTelemetry Protocol(OTLP)은 OpenTelemetry를 위해 설계된 범용 원격 측정 데이터 전송 프로토콜입니다. CloudWatch OpenTelemetry 엔드포인트는 HTTP 1.1 엔드포인트입니다. OpenTelemetry Collector를 구성하여 열려 있는 원격 측정 데이터를 CloudWatch로 전송하기 시작해야 합니다. 자세한 내용은 [시작하기](CloudWatch-OTLPGettingStarted.md) 섹션을 참조하세요.
## 로그 엔드포인트
로그 엔드포인트는 `https://logs.AWS 리전.amazonaws.com/v1/logs` 패턴을 따릅니다. 예를 들어 `US West (Oregon) (us-west-2) Region`의 경우 엔드포인트는 `https://logs.us-west-2.amazonaws.com/v1/logs`입니다. 위의 엔드포인트를 사용하여 기존 `LogGroup` 및 `LogStream`에 로그를 전달할 수 있습니다. 로그 데이터를 수집하기 위한 `LogGroup` 설정에 대한 자세한 내용은 [Amazon CloudWatch Logs concepts](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatchLogsConcepts.html) 섹션을 참조하세요.
`x-aws-log-group` 및 `x-aws-log-stream` HTTP 헤더를 각각 `LogGroup` 및 `LogStream` 이름으로 설정하여 CloudWatch Logs OpenTelemetry 엔드포인트를 간접적으로 호출할 경우 `LogGroup` 및 `LogStream`을 구성해야 합니다. 자세한 내용은 [시작하기](CloudWatch-OTLPGettingStarted.md) 섹션을 참조하세요. 엔드포인트는 서명 4 인증을 사용하여 호출자를 인증합니다. 자세한 내용은 [API 요청용 AWS Signature Version 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) 섹션을 참조하세요.
로그 이벤트 크기가 1MB를 초과하면 CloudWatch Logs는 가장 큰 필드부터 시작하여 최대 10개의 필드를 자동으로 잘라냅니다. 총 이벤트 크기를 가능한 1MB에 가깝게 유지하기 위해 필요한 경우 각 필드가 잘립니다. 초과 부분은 대형 로그 객체(LLO)로 저장되고 LLO 참조 시스템 필드가 추가됩니다. 선택적으로 `x-aws-truncatable-fields `HTTP 헤더를 설정하여 잘라야 하는 필드 경로를 지정할 수 있습니다. `GetLogObject` API를 사용하여 LLO를 검색하고 다시 스트리밍할 수 있습니다. 자세한 내용은 [GetLogObject](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetLogObject.html)를 참조하세요. 1MB 이상의 로그 이벤트 및 LLO 경험은 미국 동부(버지니아 북부), 미국 서부(오리건), 유럽(프랑크푸르트), 아시아 태평양(시드니), 아시아 태평양(뭄바이), 미국 동부(오하이오), 유럽(아일랜드), 아시아 태평양(도쿄), 아시아 태평양(싱가포르)에서 지원됩니다.
## 지표 엔드포인트
지표 엔드포인트는 `https://monitoring.AWS Region.amazonaws.com/v1/metrics` 패턴을 따릅니다. 예를 들어 미국 서부(오리건)(us-west-2) 리전의 경우, 엔드포인트는 `https://monitoring.us-west-2.amazonaws.com/v1/metrics`입니다.
OpenTelemetry Collector를 구성하여 지표를 CloudWatch로 전송하기 시작해야 합니다. 엔드포인트는 서명 4 인증을 사용하여 호출자를 인증합니다. 자세한 내용은 [API 요청용 AWS Signature Version 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) 섹션을 참조하세요.
## 트레이스 엔드포인트
트레이스 엔드포인트는 `https://xray.AWS Region.amazonaws.com/v1/traces` 패턴을 따릅니다. 예를 들어 미국 서부(오리건)(us-west-2) 리전의 경우, 엔드포인트는 `https://xray.us-west-2.amazonaws.com/v1/traces`입니다.
OpenTelemetry Collector를 구성하여 트레이스를 CloudWatch로 전송하기 시작해야 합니다. 엔드포인트는 서명 4 인증을 사용하여 호출자를 인증합니다. 자세한 내용은 [API 요청용 AWS Signature Version 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) 섹션을 참조하세요.
## RUM 엔드포인트
RUM 엔드포인트는 `https://dataplane.rum.{AWS Region}.amazonaws.com/v1/rum` 패턴을 따릅니다. 예를 들어 미국 서부(오리건) 리전의 경우 엔드포인트는 `https://dataplane.rum.us-west-2.amazonaws.com/v1/rum`입니다. 이 엔드포인트는 CloudWatch RUM 애플리케이션에 대한 *클라이언트 측 원격 분석 데이터*(`eventName`가 있는 추적 및 로그 레코드만 해당)를 처리합니다.
이 엔드포인트를 사용하려면 모바일 플랫폼(Android/iOS)을 사용하여 [RUM 앱 모니터](CloudWatch-RUM-get-started-create-app-monitor.md)를 생성한 후, 생성된 코드 조각을 사용하여 애플리케이션을 계측해야 합니다. 코드 조각은 이 엔드포인트로 구성된 RUM Mobile SDK를 가져옵니다. 그에 따라 원격 분석을 수집하도록 RUM에 대한 SDK를 추가로 구성할 수 있습니다.
엔드포인트는 인증된 요청과 인증되지 않은 요청을 둘 다 지원합니다. 인증된 요청에 AWS Signature Version 4(SigV4)를 사용하거나, 모바일 애플리케이션에서 인증되지 않은 액세스를 허용하는 리소스 기반 정책을 사용할 수 있습니다.
SDK에 정의된 인증 모델을 자세히 알아보려면 아래 내용을 참조하세요.
+ iOS 애플리케이션 - [AWS Distro for OpenTelemetry(ADOT) iOS SDK](https://github.com/aws-observability/aws-otel-swift).
+ Android 애플리케이션 - [AWS Distro for OpenTelemetry(ADOT) Android SDK](https://github.com/aws-observability/aws-otel-android).
## 엔드포인트 제한 및 제약 조건
아래 표에는 지표, 트레이스 및 로그에 대한 공통 엔드포인트 한도 및 제한 사항이 나열되어 있습니다.
| Limit | 엔드포인트 | 추가 정보 |
| --- | --- | --- |
| 필수 수집기 확장 | [sigv4authextension](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/extension/sigv4authextension) | 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 | 지표 엔드포인트 | 추가 정보 | 오류 코드 |
| --- | --- | --- | --- |
| 최대 TPS | 500 | 계정당 허용되는 초당 최대 요청 횟수입니다. | 429 |
| 최대 새 시리즈 생성 속도 | 1,000,000 | 10분 기간 동안 생성할 수 있는 새 시리즈의 최대 수입니다. 이 한도는 기존 지표에 대한 데이터 포인트를 수집하지 않고 새 지표 이름을 생성하는 경우에만 적용됩니다. | 429 - 요청의 모든 지표가 스로틀링됨, 200 - 요청의 지표가 부분적으로 스로틀링됨 |
| 최대 요청 크기 | 1MB | 요청의 압축되지 않은 최대 크기입니다. | 400 |
| 최대 데이터 포인트 수 | 1,000 | 단일 요청으로 전송된 최대 데이터 포인트 수입니다. 이 숫자는 ResourceMetrics, ScopeMetrics 및 Metrics의 합계입니다. | 400 |
| 최대 메타데이터 크기 | 40KB | 데이터 포인트당 시리즈에 허용되는 모든 레이블 및 레이블 값을 합친 최대 크기입니다. | 400 - 요청의 모든 지표가 유효하지 않음, 200 - 요청의 지표가 부분적으로 유효하지 않음 |
| 최대 레이블 수 | 150 | 데이터 포인트당 Resource/Scope/Datapoint 속성의 최대 레이블 수입니다. | 400 - 요청의 모든 지표가 유효하지 않음, 200 - 요청의 지표가 부분적으로 유효하지 않음 |
아래 표에는 로그에 대한 엔드포인트 한도 및 제한 사항이 나열되어 있습니다.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/AmazonCloudWatch/latest/monitoring/CloudWatch-OTLPEndpoint.html)
**참고**
로그에 대한 계정 한도는 SDK 및 새 로그 엔드포인트에서 공유됩니다.