Naar hoofdinhoud gaan
🔐 Stuur geen Persoonlijk Identificeerbare Informatie (PII) naar AppSignal. Filter PII (bijv. namen, e-mailadressen) uit logs en gebruik in plaats daarvan een ID, hash of gepseudonimiseerde identificator.

Voor onder HIPAA vallende entiteiten vindt u meer informatie over het ondertekenen van een Business Associate Agreement (BAA) in onze documentatie over Business Add-Ons.
Het HTTP-endpoint is het meest flexibele endpoint om logs naar AppSignal te sturen. U kunt het bericht op meerdere manieren formatteren, zoals hieronder beschreven. Als u een taal gebruikt die een integratiebibliotheek voor AppSignal heeft, raden wij u aan een van de integratiebibliotheken te gebruiken in plaats van het HTTP-endpoint. Als u een aangepaste integratie maakt, raden wij u aan het HTTP-JSON-endpoint te gebruiken om te garanderen dat de berichten precies zo worden geformatteerd als bedoeld.

Endpoint

U kunt logs naar AppSignal POST-en. Uw logs moeten geformatteerd zijn in JSON, Logfmt of Plaintext en naar het volgende endpoint worden gestuurd:
Shell
https://appsignal-endpoint.net/logs?api_key=YOUR_LOG_SOURCE_API_KEY
Vervang YOUR_LOG_SOURCE_API_KEY door de sleutel die is verstrekt bij het aanmaken van een logbron. Wij gebruiken het tijdstip waarop onze servers het POST-verzoek ontvangen als de log-tijdstempel. De standaard severity is INFO. U kunt de parameters hostname, severity en group/appname versturen door ze aan de URL toe te voegen, bijvoorbeeld:
Shell
https://appsignal-endpoint.net/logs?group=app&hostname=frontend1&severity=debug&api_key=YOUR_LOG_SOURCE_API_KEY
U kunt meerdere logregels versturen door elke logregel te scheiden met een nieuwe regel: \n

Gestructureerde berichten

Om aanvullende metadata aan een logregel toe te voegen, kunt u een gestructureerd bericht versturen.

Plaintext

Standaard wordt de bron aangemaakt met de Plaintext-formatter geselecteerd, u kunt elke string als het berichtgedeelte van de logregel versturen, bijvoorbeeld:
This is a log message
And this is another message
Dit resulteert in twee logregels met respectievelijk het bericht This is a log message en And this is another message.

Logfmt

Wanneer Logfmt is geselecteerd als het berichtformaat, kunt u een logregel versturen met sleutel-waardeparen gescheiden door een spatie, bijvoorbeeld:
This is a log message user_id=123 action=login
This is another log message user_id=123 action=logout
Dit resulteert in twee logregels met respectievelijk het bericht This is a log message en This is another log message, en de volgende attributen:
{
  "user_id": 123,
  "action": "login"
}
{
  "user_id": 123,
  "action": "logout"
}

JSON

Wanneer JSON is geselecteerd als het berichtformaat, kunt u een logregel met een JSON-object versturen, bijvoorbeeld:
{"message": "This is a log message", "user_id": 123, "action": "login"}
{"msg": "This is another log message", "user_id": 123, "action": "logout"}
Wij verwachten een msg- of message-sleutel voor het logregelbericht, en alle andere sleutels worden toegevoegd als attributen. Als er geen msg- of message-sleutel wordt verstrekt, gebruiken wij het volledige (ongeparste) JSON-object als het bericht. Attributen worden nog steeds geparst en aan deze regel toegevoegd. U kunt meer lezen over de specifieke details van berichtformattering in onze formatterings-documentatie.