> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# HTTP-Konfiguration

<Warning>
  🔐 Senden Sie keine <strong>personenbezogenen Daten (Personal Identifiable Information, PII)</strong> an AppSignal. Filtern Sie PII (z. B. Namen, E-Mail-Adressen) aus Logs und verwenden Sie stattdessen eine ID, einen Hash oder einen pseudonymisierten Bezeichner. <br /> <br /> Für **HIPAA-pflichtige Stellen** finden Sie weitere Informationen zum Abschluss eines Business Associate Agreement (BAA) in unserer [Business Add-Ons-Dokumentation](/support/business-add-ons).
</Warning>

Der HTTP-Endpunkt ist der flexibelste Endpunkt zum Senden von Logs an AppSignal.
Sie können die Nachricht auf verschiedene Weisen formatieren, wie unten beschrieben.

Wenn Sie eine Sprache verwenden, für die es eine Integrationsbibliothek für AppSignal gibt, empfehlen wir, eine der [Integrationsbibliotheken](/logging/integrations) anstelle des HTTP-Endpunkts zu verwenden.

Wenn Sie eine benutzerdefinierte Integration erstellen, empfehlen wir den [HTTP-JSON](/logging/endpoints/http-json)-Endpunkt zu verwenden, um sicherzustellen, dass die Nachrichten genau wie vorgesehen formatiert sind.

## Endpunkt

Sie können Logs per `POST` an AppSignal senden. Ihre Logs müssen in `JSON`, `Logfmt` oder `Plaintext` formatiert und an den folgenden Endpunkt gesendet werden:

```sh Shell theme={null}
https://appsignal-endpoint.net/logs?api_key=YOUR_LOG_SOURCE_API_KEY
```

*Ersetzen Sie `YOUR_LOG_SOURCE_API_KEY` durch den Schlüssel, der beim [Erstellen einer Log-Quelle](/logging/configuration#creating-a-log-source) bereitgestellt wurde.*

Wir verwenden den Zeitpunkt, zu dem unsere Server die `POST`-Anfrage empfangen, als Log-Zeitstempel. Die Standard-Severity ist `INFO`. Sie können die Parameter `hostname`, `severity` und `group/appname` senden, indem Sie sie an die URL anhängen, zum Beispiel:

```sh Shell theme={null}
https://appsignal-endpoint.net/logs?group=app&hostname=frontend1&severity=debug&api_key=YOUR_LOG_SOURCE_API_KEY
```

Sie können mehrere Log-Zeilen senden, indem Sie jede Log-Zeile mit einem Newline-Zeichen trennen: `\n`

## Strukturierte Nachrichten

Um einer Log-Zeile zusätzliche Metadaten hinzuzufügen, können Sie eine strukturierte Nachricht senden.

### Plaintext

Standardmäßig wird die Quelle mit dem Formatter `Plaintext` ausgewählt erstellt,
sodass Sie eine beliebige Zeichenkette als Nachrichtenteil der Log-Zeile senden können, zum Beispiel:

<CodeGroup>
  ```shell Shell theme={null}
  This is a log message
  And this is another message
  ```
</CodeGroup>

Dies führt zu zwei Log-Zeilen mit den Nachrichten `This is a log message` bzw. `And this is another message`.

### Logfmt

Wenn `Logfmt` als Nachrichtenformat ausgewählt ist, können Sie eine Log-Zeile mit durch Leerzeichen getrennten Schlüssel-Wert-Paaren senden, zum Beispiel:

<CodeGroup>
  ```shell Shell theme={null}
  This is a log message user_id=123 action=login
  This is another log message user_id=123 action=logout
  ```
</CodeGroup>

Dies führt zu zwei Log-Zeilen mit den Nachrichten `This is a log message` bzw. `This is another log message` und den folgenden Attributen:

<CodeGroup>
  ```json JSON theme={null}
  {
    "user_id": 123,
    "action": "login"
  }
  ```
</CodeGroup>

<CodeGroup>
  ```json JSON theme={null}
  {
    "user_id": 123,
    "action": "logout"
  }
  ```
</CodeGroup>

### JSON

Wenn `JSON` als Nachrichtenformat ausgewählt ist, können Sie eine Log-Zeile mit einem JSON-Objekt senden, zum Beispiel:

<CodeGroup>
  ```shell Shell theme={null}
  {"message": "This is a log message", "user_id": 123, "action": "login"}
  {"msg": "This is another log message", "user_id": 123, "action": "logout"}
  ```
</CodeGroup>

Wir erwarten entweder einen `msg`- oder einen `message`-Schlüssel für die Log-Nachricht, und alle anderen Schlüssel werden als Attribute hinzugefügt. Wenn kein `msg`- oder `message`-Schlüssel angegeben wird, verwenden wir das gesamte (unparsed) JSON-Objekt als Nachricht. Attribute werden weiterhin geparst und zu dieser Zeile hinzugefügt.

Mehr über die Besonderheiten der Nachrichtenformatierung können Sie in unserer [Formatierungs-Dokumentation](/logging/formatting) nachlesen.