> ## 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.

# Heroku-Logs

<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>

## Cedar-Anwendungen (Legacy-Plattform)

### Alte Log Drains entfernen

<Tip>
  Diese Heroku-Log-Drain-Einrichtung sendet sowohl Logs als auch Metriken an
  AppSignal. Um nur Metriken an AppSignal zu senden, folgen Sie stattdessen der
  Heroku-Log-Drain-Einrichtung in [unserer Heroku-Dokumentation](/heroku/setup).
</Tip>

Bevor Sie einen neuen Log Drain für AppSignal erstellen, müssen Sie alle bereits vorhandenen AppSignal-Log-Drains entfernen. Sie können mit dem folgenden Befehl auf aktive Log Drains prüfen, wobei `myapp` der Name Ihrer Heroku-Anwendung ist:

<CodeGroup>
  ```shell Shell theme={null}
  heroku drains -a myapp
  ```
</CodeGroup>

Wenn aktive AppSignal-Log-Drains vorhanden sind, können Sie diese mit dem folgenden Befehl entfernen:

<CodeGroup>
  ```shell Shell theme={null}
  heroku drains:remove -a myapp <url>
  ```
</CodeGroup>

*Ersetzen Sie `<url>` oben durch die URL des Log Drains, den Sie entfernen möchten.*

### Neuen Log Drain hinzufügen

Sobald alle aktiven Log Drains entfernt wurden, [folgen Sie den Anweisungen zum Erstellen einer Heroku-Log-Quelle](/logging/configuration#creating-a-log-source).

Nachdem Sie eine Log-Quelle erstellt haben, verwenden Sie den folgenden Befehl, um einen neuen Log Drain zu erstellen.

<CodeGroup>
  ```shell Shell theme={null}
  heroku drains:add "https://appsignal-endpoint.net/logplex?api_key=YOUR_LOG_SOURCE_API_KEY"
  ```
</CodeGroup>

Ersetzen Sie `YOUR_LOG_SOURCE_API_KEY` durch den Schlüssel, der beim Erstellen einer Log-Quelle bereitgestellt wurde.

Nach Herstellung der Verbindung sollten Logs in AppSignal erscheinen. Wenn Sie immer noch keine Logs sehen,
[kontaktieren Sie uns](mailto:support@appsignal.com) bitte für Support.

### Severity-Parsing

Standardmäßig sendet Heroku alle Logs mit dem Schweregrad INFO. Und da der Inhalt der Logdrain-Nachrichten je nach Quelle (Add-Ons, Anwendung, Heroku-Router etc.) variieren kann,
gibt es einige Möglichkeiten, den Standard-Schweregrad zu überschreiben.

#### Log-Format

Setzen Sie ein Log-Format und überschreiben Sie den Schweregrad.

Sie können das Format Ihrer Log-Zeilen in der Quelle auf „logfmt" setzen und folgende Zeichenfolge in Ihre Log-Zeile einfügen: `severity=warning`. Dies überschreibt den Standard-Schweregrad `INFO` mit `WARNING`.

#### Severity-Parsing

Beim Hinzufügen einer Heroku-Log-Quelle in AppSignal gibt es eine Checkbox, um „Severity parsing" zu aktivieren.

Wenn diese aktiviert ist, versuchen wir, jede gültige Schweregrad-Zeichenfolge aus der Log-Nachricht zu parsen. Wir tun dies nur, wenn die anderen Alternativen kein Ergebnis geliefert haben (z. B. wenn Sie das Quell-Log-Format auf logfmt setzen und ein severity-Attribut emittieren, wird dieses anstelle des geparsten Schweregrads verwendet).

Die folgenden Zeichenfolgen werden als gültige Schweregrade betrachtet; sie können in Groß-, Klein- oder gemischter Schreibweise sein:

* TRACE
* DEBUG
* INFO
* NOTICE
* WARNING
* WARN
* ERR
* ERROR
* CRIT
* CRITICAL
* ALERT
* EMERG
* PANIC
* FATAL

Wir betrachten diese Zeichenfolgen nicht als Schweregrad, wenn sie Teil eines Wortes sind.
Schweregrade, die in Blöcken eingeschlossen sind, werden als Schweregrade betrachtet, zum Beispiel:

Diese werden als Schweregrade geparst:

```shell Shell theme={null}
[oban] [error] invalid query
ERROR  - My app is broken
error something went wrong
[Error] this is a valid error severity
```

*Beachten Sie, dass dies bedeutet, dass jede Schweregrad-Zeichenfolge in Kleinbuchstaben (info/debug/warning/trace/etc) irgendwo in der Log-Zeile den Log-Schweregrad ändert.*

Diese werden nicht als Schweregrade geparst:

```shell Shell theme={null}
ErrorClass
error: something went wrong
The doctor was panicking just as much as the patient
```

## Fir-Anwendungen

Um Logs von Ihrer Heroku-Fir-Anwendung an AppSignal zu senden, folgen Sie den [Einrichtungsschritten für Heroku-Fir-Generationsanwendungen](/heroku/setup#fir-applications). AppSignal nimmt automatisch Logs Ihrer Anwendung über OpenTelemetry-HTTP-Exporter auf, oder alle Logs aus `stdout` und `stderr` über einen [Heroku Telemetry Drain](https://devcenter.heroku.com/articles/log-drains).