Zum Hauptinhalt springen
🔐 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.
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 anstelle des HTTP-Endpunkts zu verwenden. Wenn Sie eine benutzerdefinierte Integration erstellen, empfehlen wir den 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:
Shell
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 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:
Shell
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: 
This is a log message
And this is another message
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: 
This is a log message user_id=123 action=login
This is another log message user_id=123 action=logout
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: 
{
  "user_id": 123,
  "action": "login"
}

{
  "user_id": 123,
  "action": "logout"
}

​
JSON

Wenn JSON als Nachrichtenformat ausgewählt ist, können Sie eine Log-Zeile mit einem JSON-Objekt senden, zum Beispiel: 
{"message": "This is a log message", "user_id": 123, "action": "login"}
{"msg": "This is another log message", "user_id": 123, "action": "logout"}
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 nachlesen.