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)

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 . 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 antes de continuar.

Formato de solicitação

Exemplo de solicitação

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

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

Os comportamentos a seguir são específicos do endpoint OTLP e não estão presentes nos outros endpoints de ingestão HTTP: