Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Envoi de journaux à l'aide du point de terminaison OTLP (OpenTelemetry Logs)

Le point de terminaison OpenTelemetry Logs (/v1/logs) accepte les données du journal OpenTelemetry du protocole (OTLP) au format JSON ou Protobuf. Pour obtenir des informations détaillées sur le point de terminaison OTLP, notamment sa configuration et son utilisation, voir Envoyer des métriques et des traces à CloudWatch with OpenTelemetry.

Si vous utilisez l'authentification par jeton porteur, suivez les étapes de configuration décrites Configuration de l'authentification par jeton porteur avant de continuer.

Format des demandes

Exemple de demande

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

Réponses

Succès (tous les événements sont acceptés) :

HTTP 200 OK
{}

Succès partiel (certains événements rejetés) :

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

Lorsque le type de contenu de la demande est définiapplication/x-protobuf, la réponse est renvoyée sous forme de message ExportLogsServiceResponse protobuf sérialisé avec les mêmes champs.

Comportements spécifiques à l'OTLP

Les comportements suivants sont spécifiques au point de terminaison OTLP et ne sont pas présents sur les autres points de terminaison d'ingestion HTTP :