Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Senden von Protokollen über den OTLP-Endpunkt (OpenTelemetry Logs)

Der OpenTelemetry Logs-Endpunkt (/v1/logs) akzeptiert OpenTelemetry Protokolldaten des Protokolls (OTLP) entweder in JSON- oder Protobuf-Kodierung. Ausführliche Informationen zum OTLP-Endpunkt, einschließlich Konfiguration und Verwendung, finden Sie unter Metriken und Traces an mit senden. CloudWatch OpenTelemetry

Wenn Sie die Bearer-Token-Authentifizierung verwenden, schließen Sie die Einrichtungsschritte unter ab, Einrichtung der Bearer-Token-Authentifizierung bevor Sie fortfahren.

Anforderungsformat

Beispielanforderung

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

Antworten

Erfolgreich (alle Ereignisse wurden akzeptiert):

HTTP 200 OK
{}

Teilweise erfolgreich (einige Ereignisse wurden abgelehnt):

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

Wenn die Anfrage Content-Type lautetapplication/x-protobuf, wird die Antwort als serialisierte ExportLogsServiceResponse Protobuf-Nachricht mit denselben Feldern zurückgegeben.

OTLP-spezifisches Verhalten

Die folgenden Verhaltensweisen sind spezifisch für den OTLP-Endpunkt und nicht auf den anderen HTTP-Ingestion-Endpunkten vorhanden: