As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Enviando registros usando o endpoint OTLP (OpenTelemetry Logs)
<a name="CWL_HTTP_Endpoints_OTLP"></a>

O endpoint do OpenTelemetry Logs (`/v1/logs`) aceita dados de log do OpenTelemetry Protocolo (OTLP) na codificação JSON ou Protobuf. Para obter informações detalhadas sobre o endpoint OTLP, incluindo configuração e uso, consulte [Enviar métricas e rastreamentos para com CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-OTLPEndpoint.html). OpenTelemetry

Se você estiver usando a autenticação do token do portador, conclua as etapas de configuração [Configurando a autenticação do token do portador](CWL_HTTP_Endpoints_BearerTokenAuth.md) antes de continuar.

## Formato de solicitação
<a name="CWL_OTLP_Format"></a>
+ Método: `POST`
+ Tipo de conteúdo: ou `application/json` `application/x-protobuf`
+ Grupo de registros: somente `x-aws-log-group` cabeçalho (parâmetro de consulta não suportado)
+ Fluxo de log: `x-aws-log-stream` cabeçalho

## Exemplo de solicitação
<a name="CWL_OTLP_Example"></a>

```
curl -X POST "https://logs.<region>.amazonaws.com/v1/logs" \
  -H "Authorization: Bearer ACWL<token>" \
  -H "Content-Type: application/json" \
  -H "x-aws-log-group: MyLogGroup" \
  -H "x-aws-log-stream: MyLogStream" \
  -d '{
  "resourceLogs": [
    {
      "resource": {
        "attributes": [
          {
            "key": "service.name",
            "value": { "stringValue": "my-service" }
          }
        ]
      },
      "scopeLogs": [
        {
          "scope": {
            "name": "my-library",
            "version": "1.0.0"
          },
          "logRecords": [
            {
              "timeUnixNano": "1741900000000000000",
              "severityNumber": 9,
              "severityText": "INFO",
              "body": {
                "stringValue": "User logged in successfully"
              },
              "attributes": [
                {
                  "key": "user.id",
                  "value": { "stringValue": "12345" }
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}'
```

## Respostas
<a name="CWL_OTLP_Responses"></a>

**Sucesso (todos os eventos são aceitos):**

```
HTTP 200 OK
{}
```

**Sucesso parcial (alguns eventos foram rejeitados):**

```
{
  "partialSuccess": {
    "rejectedLogRecords": 5,
    "errorMessage": "{\"tooOldLogEventCount\": 3, \"tooNewLogEventCount\": 1, \"expiredLogEventCount\": 1}"
  }
}
```

Quando a solicitação Content-Type é`application/x-protobuf`, a resposta é retornada como uma mensagem `ExportLogsServiceResponse` protobuf serializada com os mesmos campos.

## Comportamentos específicos do OTLP
<a name="CWL_OTLP_Specific_Behaviors"></a>

Os comportamentos a seguir são específicos do endpoint OTLP e não estão presentes nos outros endpoints de ingestão HTTP:
+ **Cabeçalho Retry-After** — Incluído nas respostas 503 e 429 para indicar quando o cliente deve tentar novamente.