OTLP Endpoint
Note
CloudWatch currently only supports OpenTelemetry Protocol endpoint for traces.
OpenTelemetry Protocol (OTLP) is a general-purpose telemetry data delivery protocol designed for the OpenTelemetry project.
Traces endpoint
The traces endpoint follows the pattern https://xray.. For example,
for the US West (Oregon) (us-west-2) Region, the endpoint will be AWS Region.amazonaws.com/v1/traceshttps://xray.us-west-2.amazonaws.com/v1/traces.
You need to configure your OpenTelemetry collector to start sending traces to CloudWatch. To get started, see Getting started.
Endpoint limits and restrictions
The following are the endpoint limits and restrictions.
| Limit | Trace endpoint | Additional information |
|---|---|---|
|
Required collector extension |
To send traces to OTLP endpoint you must use sigv4authextension |
|
|
Supported protocol |
HTTP |
The endpoint supports only HTTP and doesn't support gRPC |
|
Supported OTLP versions |
OTLP 1.x |
|
|
Payload format |
binary, json |
The endpoint accepts requests using binary and json formats |
|
Compression methods |
gzip, none |
The endpoint only supports gzip and none compression methods |
|
Maximum uncompressed bytes / request |
5 MB |
The OTLP endpoint will reject requests larger than 5MB when payload is uncompressed; |
|
Maximum events / request |
10,000 spans |
The max allowed number of spans in one request is 10,000. Exceeding this limit will cause rejection of the API call. |
|
Single span maximum size |
200 KB |
Spans more than 200KB will rejected by the endpoint |
|
Span created timestamps |
2 hours in the future and 14 days in the past |
None of the spans in the batch can be more than two hours in the future or more than 14 days in the past. |
|
Maximum time gap in events / request |
24 |
