Skip to main content
🔐 Senden Sie keine personenbezogenen Daten (Personal Identifiable Information, PII) 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.

Für HIPAA-pflichtige Stellen finden Sie weitere Informationen zum Abschluss eines Business Associate Agreement (BAA) in unserer Business Add-Ons-Dokumentation.

​
Cedar-Anwendungen (Legacy-Plattform)

​
Alte Log Drains entfernen

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.
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: 
heroku drains -a myapp
Wenn aktive AppSignal-Log-Drains vorhanden sind, können Sie diese mit dem folgenden Befehl entfernen: 
heroku drains:remove -a myapp <url>
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. Nachdem Sie eine Log-Quelle erstellt haben, verwenden Sie den folgenden Befehl, um einen neuen Log Drain zu erstellen. 
heroku drains:add "https://appsignal-endpoint.net/logplex?api_key=YOUR_LOG_SOURCE_API_KEY"
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 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
[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
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. AppSignal nimmt automatisch Logs Ihrer Anwendung über OpenTelemetry-HTTP-Exporter auf, oder alle Logs aus stdout und stderr über einen Heroku Telemetry Drain.