Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Invio di log utilizzando l'endpoint OTLP (Logs) OpenTelemetry

L'endpoint OpenTelemetry Logs (/v1/logs) accetta i dati di log del OpenTelemetry protocollo (OTLP) con codifica JSON o Protobuf. Per informazioni dettagliate sull'endpoint OTLP, inclusi configurazione e utilizzo, consulta Inviare metriche e tracce a with. CloudWatch OpenTelemetry

Se utilizzi l'autenticazione con token al portatore, completa i passaggi di configurazione prima di procedere. Configurazione dell'autenticazione con token al portatore

Formato della richiesta

Richiesta di esempio

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" }
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}'

Risposte

Operazione riuscita (tutti gli eventi sono accettati):

HTTP 200 OK
{}

Successo parziale (alcuni eventi rifiutati):

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

Quando la richiesta Content-Type èapplication/x-protobuf, la risposta viene restituita come messaggio ExportLogsServiceResponse protobuf serializzato con gli stessi campi.

Comportamenti specifici di OTLP

I seguenti comportamenti sono specifici dell'endpoint OTLP e non sono presenti negli altri endpoint di ingestione HTTP: