O OpenTelemetry Protocol (OTLP) é um protocolo de entrega de dados de telemetria de uso geral projetado para o OpenTelemetry. Os endpoints do CloudWatch OpenTelemetry são endpoints HTTP 1.1. Você precisa configurar o coletor do OpenTelemetry para começar a enviar dados de telemetria aberta para o CloudWatch. Para ter mais informações, consulte Conceitos básicos. O endpoint autentica os chamadores usando a autenticação do Signature 4. Para obter mais informações, consulte AWS Signature Version 4 para solicitações de API.
Endpoint de rastreamentos
O endpoint de rastreamentos segue o padrão https://xray.. Por exemplo, para a região Oeste dos EUA (Oregon) (us-west-2), o endpoint será AWS Region.amazonaws.com/v1/traceshttps://xray.us-west-2.amazonaws.com/v1/traces.
Você precisa configurar o coletor do OpenTelemetry para começar a enviar rastreamentos para o CloudWatch. Para começar, consulte o Conceitos básicos.
Endpoint de logs
O endpoint de logs segue o padrão https://logs.. Por exemplo, para a Região da AWS.amazonaws.com/v1/logsUS West (Oregon) (us-west-2) Region, o endpoint será https://logs.us-west-2.amazonaws.com/v1/logs. Você pode usar o endpoint acima para encaminhar logs para um LogGroup e LogStream existentes. Para obter mais informações sobre a configuração de LogGroup para ingerir dados de log, consulte Amazon CloudWatch Logs concepts. Você deve configurar LogGroup e LogStream ao invocar o endpoint do CloudWatch Logs OpenTelemetry definindo os nomes dos cabeçalhos HTTP x-aws-log-group e x-aws-log-stream como LogGroup e LogStream, respectivamente. Para ter mais informações, consulte Conceitos básicos.
Limites e restrições de endpoints
A tabela lista os limites e restrições comuns de endpoints para rastreamentos e logs.
| Limite | Endpoint | Mais informações |
|---|---|---|
|
Extensão de coletor obrigatório |
Para enviar rastreamentos para o endpoint do OTLP, você deve usar sigv4authextension |
|
|
Protocolos compatíveis |
HTTP |
O endpoint é compatível somente com HTTP e não com gRPC |
|
Versões compatíveis com o OTLP |
OTLP 1.x |
|
|
Formato da carga |
binário, json |
O endpoint aceita solicitações usando os formatos binário e json |
|
Métodos de compactação |
gzip, none |
O endpoint é compatível apenas com os métodos de compactação gzip e none |
A tabela lista os limites e as restrições dos endpoints para rastreamentos.
| Limite | Endpoint de rastreamentos | Mais informações |
|---|---|---|
|
Máximo de solicitações e bytes não compactados |
5 MB |
O endpoint do OTLP rejeitará solicitações maiores que 5 MB quando a carga útil for descompactada. |
|
Máximo de eventos e solicitações |
10 mil extensões |
O número máximo permitido de extensões em uma solicitação é 10 mil. Exceder esse limite causará a rejeição da chamada de API. |
|
Tamanho individual do recurso e do escopo |
16 KB |
Cada recurso individual e seu escopo correspondente não devem exceder o tamanho de 16 KB. Exceder esse limite para qualquer recurso causará a rejeição da chamada de API inteira. |
|
Tamanho máximo individual de extensão |
200 KB |
Extensões com mais de 200 KB serão rejeitadas pelo endpoint. |
|
Carimbos de data e hora criados pela extensão |
2 horas no futuro e 14 dias no passado |
Nenhuma das extensões no lote pode durar mais de duas horas no futuro ou mais de 14 dias no passado. |
|
Intervalo de tempo máximo em eventos e solicitações |
24 horas |
A tabela lista os limites e as restrições de endpoints para logs.
| Limite | Endpoint de logs | Mais informações |
|---|---|---|
|
Máximo de solicitações e bytes não compactados |
1 MB |
O endpoint do OTLP rejeitará solicitações maiores que 1 MB quando a carga útil for descompactada. O tamanho máximo de uma solicitação é 1.048.576 bytes após a descompactação e desserialização de dados binários serializados por buffers de protocolo. Esse tamanho é calculado como a soma de todas as mensagens de eventos em UTF-8, mais 26 bytes para cada registro de log. |
Solicitação por segundo |
5000 |
5 mil transações por segundo por conta por região. Você pode solicitar um aumento na cota de controle de utilização por segundo usando o serviço do Service Quotas. |
|
Máximo de eventos e solicitações |
10.000 logs |
O número máximo permitido de extensões em uma solicitação é 10 mil. Exceder esse limite causará a rejeição da chamada de API. |
|
Tamanho individual do recurso e do escopo |
16 KB |
Cada recurso individual e seu escopo correspondente não devem exceder o tamanho de 16 KB. Exceder esse limite para qualquer recurso causará a rejeição da chamada de API inteira. |
|
Tamanho individual do LogEvent |
256 KB |
O tamanho do LogEvent é calculado como a soma dos tamanhos para cada LogRecord, Escopo e Recurso. Não é possível alterar esta cota. |
Carimbos de data e hora criados por logs |
2 horas no futuro e 14 dias no passado |
Os registros de logs no lote não precisam estar em ordem cronológica. No entanto, os registros de logs no lote não podem ser mais de 2 horas no futuro e mais de 14 dias no passado. Além disso, nenhum dos registros de logs pode ser anterior ao período de retenção do grupo de logs. |
|
Intervalo de tempo máximo em eventos e solicitações |
24 horas |
nota
Os limites de logs da conta são compartilhados entre o SDK e o novo endpoint de logs.
