Endpoints do OTLP
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 obter mais informações, consulte Começar. 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 Começar.
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 obter mais informações, consulte Começar.
Quando o tamanho do evento de logs excede 1 MB, o CloudWatch Logs trunca automaticamente até dez campos, começando pelos maiores. Cada campo é truncado conforme necessário para manter o tamanho total do evento o mais próximo possível de 1 MB. As partes excedentes são armazenadas como objetos de logs grandes (LLOs) e campos de referência do sistema LLO são adicionados. Opcionalmente, você pode especificar os caminhos de campo que precisam ser truncados definindo o cabeçalho HTTP x-aws-truncatable-fields . Os LLOs podem ser recuperadas e transmitidos de volta usando a API GetLogObject. Para obter mais informações, consulte GetLogObject. O suporte para eventos de logs maiores que 1 MB e a experiência com LLOs estão disponíveis nas regiões Leste dos EUA (Norte da Virgínia), Oeste dos EUA (Oregon), Europa (Frankfurt) e Ásia-Pacífico (Sydney).
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 de extensões em um lote é 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. |
|
20 MB Disponível somente nas regiões Leste dos EUA (Norte da Virgínia), Oeste dos EUA (Oregon), Europa (Frankfurt) e Ásia-Pacífico (Sydney). |
O tamanho máximo da solicitação é de 20 MB (20.971.520 bytes) após a carga útil do OTLP ser descompactada e decodificada do formato JSON. Para logs de até 1 MB: esses logs têm acesso total a todos os recursos do CloudWatch Logs, incluindo consultas e live tail. Para logs maiores que 1 MB: a parte excedente é processada como objetos de logs grandes (LLOs). |
|
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. |
|
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 |
1 MB |
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 |
|
|
Máximo de eventos e solicitações |
10.000 logs |
O número máximo de eventos de logs em um lote é 10 mil. Exceder esse limite causará a rejeição da chamada de API. |
|
Máximo de objetos de logs grandes/solicitações |
1 registro de log Disponível nas regiões Leste dos EUA (Norte da Virgínia), Oeste dos EUA (Oregon), Europa (Frankfurt) e Ásia-Pacífico (Sydney). |
Para conteúdo que exceda 1 MB em um evento de logs, o conteúdo em excesso é armazenado como LLOs. Limitado a 1 registro de log por solicitação. |
|
Máximo de objetos de logs grandes/registros |
10 LLOs Disponível nas regiões Leste dos EUA (Norte da Virgínia), Oeste dos EUA (Oregon), Europa (Frankfurt) e Ásia-Pacífico (Sydney). |
Um único registro de log pode conter até 10 LLOs. |
nota
Os limites de logs da conta são compartilhados entre o SDK e o novo endpoint de logs.
