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)
<a name="CWL_HTTP_Endpoints_OTLP"></a>

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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-OTLPEndpoint.html). CloudWatch OpenTelemetry

Wenn Sie die Bearer-Token-Authentifizierung verwenden, schließen Sie die Einrichtungsschritte unter ab, [Einrichtung der Bearer-Token-Authentifizierung](CWL_HTTP_Endpoints_BearerTokenAuth.md) bevor Sie fortfahren.

## Anforderungsformat
<a name="CWL_OTLP_Format"></a>
+ Methode: `POST`
+ Inhaltstyp: oder `application/json` `application/x-protobuf`
+ Protokollgruppe: nur `x-aws-log-group` Header (Abfrageparameter nicht unterstützt)
+ Protokollstream: `x-aws-log-stream` Header

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

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

**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 lautet`application/x-protobuf`, wird die Antwort als serialisierte `ExportLogsServiceResponse` Protobuf-Nachricht mit denselben Feldern zurückgegeben.

## OTLP-spezifisches Verhalten
<a name="CWL_OTLP_Specific_Behaviors"></a>

Die folgenden Verhaltensweisen sind spezifisch für den OTLP-Endpunkt und nicht auf den anderen HTTP-Ingestion-Endpunkten vorhanden:
+ **Retry-After-Header** — In den Antworten 503 und 429 enthalten und gibt an, wann der Client es erneut versuchen sollte.