# 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 [Introdução](CloudWatch-OTLPGettingStarted.md). ## Endpoint de logs O endpoint de logs segue o padrão `https://logs.{{Região da AWS}}.amazonaws.com/v1/logs`. Por exemplo, para a `US 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatchLogsConcepts.html). 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 [Introdução](CloudWatch-OTLPGettingStarted.md). 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html). 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](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetLogObject.html). Compatibilidade com eventos de log com mais de 1 MB e a experiência de LLO estão disponíveis no Leste dos EUA (Norte da Virgínia), Oeste dos EUA (Oregon), Europa (Frankfurt), Ásia-Pacífico (Sydney), Ásia-Pacífico (Mumbai), Leste dos EUA (Ohio), Europa (Irlanda), Ásia-Pacífico (Tóquio) e Ásia-Pacífico (Singapura). ## Endpoint de métricas O endpoint de métricas segue o padrão `https://monitoring.{{AWS Region}}.amazonaws.com/v1/metrics`. Por exemplo, para a região Oeste dos EUA (Oregon) (us-west-2), o endpoint será `https://monitoring.us-west-2.amazonaws.com/v1/metrics`. Você precisa configurar o OpenTelemetry Collector para começar a enviar métricas para o CloudWatch. 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html). ## Endpoint de rastreamentos O endpoint de rastreamentos segue o padrão `https://xray.{{AWS Region}}.amazonaws.com/v1/traces`. Por exemplo, para a região Oeste dos EUA (Oregon) (us-west-2), o endpoint será `https://xray.us-west-2.amazonaws.com/v1/traces`. Você precisa configurar o coletor do OpenTelemetry para começar a enviar rastreamentos para o CloudWatch. 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html). ## Endpoint do RUM O endpoint do RUM segue o padrão `https://dataplane.rum.{AWS Region}.amazonaws.com/v1/rum`. Por exemplo, na região Oeste dos EUA (Oregon), o endpoint é `https://dataplane.rum.us-west-2.amazonaws.com/v1/rum`. Esse endpoint lida com os *dados de telemetria do lado do cliente* (somente rastros e registros de log com `eventName`) para aplicações do CloudWatch RUM. Para usar esse endpoint, você deve criar um [monitor de aplicação do RUM](CloudWatch-RUM-get-started-create-app-monitor.md) com uma plataforma móvel (Android/iOS) e usar o trecho de código gerado para instrumentar as aplicações. O trecho de código extrairá os SDKs móveis do RUM que estão configurados com esse endpoint. Você pode configurar ainda mais os SDKs para que o RUM colete telemetria adequadamente. O endpoint é compatível com solicitações autenticadas e não autenticadas. Você pode usar o AWS Signature Version 4 (SigV4) para solicitações autenticadas ou políticas baseadas em recursos para permitir acesso não autenticado de aplicações móveis. Para saber mais sobre os modelos de autenticação definidos nos SDKs, consulte o seguinte: + Aplicações iOS: [SDK do AWS Distro for OpenTelemetry (ADOT) para iOS](https://github.com/aws-observability/aws-otel-swift). + Aplicações Adroid: SDK do [AWS Distro for OpenTelemetry (ADOT) para Android](https://github.com/aws-observability/aws-otel-android). ## Limites e restrições de endpoints A tabela lista os limites e as restrições comuns de endpoints para métricas, rastreamentos e logs. | Limite | Endpoint | Mais informações | | --- | --- | --- | | Extensão de coletor obrigatório | [sigv4authextension](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/extension/sigv4authextension) | Para enviar métricas e 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 dos endpoints para métricas. | Limite | Endpoint de métricas | Mais informações | Código de erro | | --- | --- | --- | --- | | Máximo de TPS | 500 | O número máximo de solicitações por segundo permitido por conta. | 429 | | Taxa máxima de criação de novas séries | 1.000.000 | Número máximo de novas séries que podem ser criadas em uma janela de 10 minutos. Esse limite se aplica somente à criação de novos nomes de métricas, não à ingestão de pontos de dados para métricas existentes. | 429: todas as métricas nas solicitações têm controle de utilização; 200: as métricas nas solicitações têm controle parcial de utilização | | Tamanho máximo de solicitação | 1 MB | O tamanho máximo da solicitação não compactada. | 400 | | Contagem máxima de pontos de dados | 1.000 | O número máximo de pontos de dados enviados em uma única solicitação. Esse número é uma soma de ResourceMetrics, ScopeMetrics e Metrics. | 400 | | Tamanho máximo dos metadados | 40 KB | O tamanho máximo combinado de todos os rótulos e valores de rótulos aceitos para uma série por ponto de dados. | 400: todas as métricas nas solicitações são inválidas; 200: as métricas nas solicitações são parcialmente inválidas | | Contagem máxima de rótulos | 150 | Número máximo de rótulos nos atributos de recurso/escopo/ponto de dados por ponto de dados. | 400: todas as métricas nas solicitações são inválidas; 200: as métricas nas solicitações são parcialmente inválidas | A tabela lista os limites e as restrições de endpoints para logs. - ** Máximo de solicitações e bytes não compactados** - **Endpoint de logs:** 1 MB / **Mais informações:** 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. - **Endpoint de logs:** 20 MB
Disponível somente nas regiões Leste dos EUA (Norte da Virgínia), Oeste dos EUA (Oregon), Europa (Frankfurt), Ásia-Pacífico (Sydney), Ásia-Pacífico (Mumbai), Leste dos EUA (Ohio), Europa (Irlanda), Ásia-Pacífico (Tóquio) e Ásia-Pacífico (Singapura). / **Mais informações:** 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** - **Endpoint de logs:** 5000 - **Mais informações:** 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** - **Endpoint de logs:** 16 KB - **Mais informações:** 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 ** - **Endpoint de logs:** 1 MB - **Mais informações:** 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** - **Endpoint de logs:** 2 horas no futuro e 14 dias no passado - **Mais informações:** 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** - **Endpoint de logs:** 24 horas - **Mais informações:** - ** Máximo de eventos e solicitações** - **Endpoint de logs:** 10.000 logs - **Mais informações:** 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** - **Endpoint de logs:** 1 registro de log
Disponível nas regiões Leste dos EUA (Norte da Virgínia), Oeste dos EUA (Oregon), Europa (Frankfurt), Ásia-Pacífico (Sydney), Ásia-Pacífico (Mumbai), Leste dos EUA (Ohio), Europa (Irlanda), Ásia-Pacífico (Tóquio) e Ásia-Pacífico (Singapura). - **Mais informações:** 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** - **Endpoint de logs:** 10 LLOs
Disponível nas regiões Leste dos EUA (Norte da Virgínia), Oeste dos EUA (Oregon), Europa (Frankfurt), Ásia-Pacífico (Sydney), Ásia-Pacífico (Mumbai), Leste dos EUA (Ohio), Europa (Irlanda), Ásia-Pacífico (Tóquio) e Ásia-Pacífico (Singapura). - **Mais informações:** 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.