🔐 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. JSON
Als u JSON als uw logformaat opgeeft, parseert AppSignal het binnenkomende log-message als sleutel-waardeparen. Elk sleutel-waardepaar wordt opgeslagen als een attribuut op de logregel, waardoor u kunt filteren op en zoeken naar specifieke logregels op basis van hun attributen.
Voorbeelden
Het volgende voorbeeld laat zien hoe AppSignal een log-message in het JSON-formaat parseert.
{
"timestamp": "2022-06-02T04:17:25.783Z",
"group": "organisations",
"severity": "warn",
"hostname": "frontend1",
"message": "This is a test message",
"org": "appsignal",
"step": 1,
"seen_terms": true,
"entries": 10.01,
"user": { "id": 1, "remote_id": "123" }
}
Bericht
De bovenstaande JSON wordt geparst met het bericht "this is a test message".
U kunt de sleutel msg of message gebruiken om het bericht te overschrijven.
Als er geen msg- of message-sleutel beschikbaar is, wordt de volledige logregel als bericht gebruikt.
Overschrijvingen
De log-attributen van het platform of de integratie (zoals hostname, timestamp en group, ingesteld door bijvoorbeeld het Heroku-platform) kunnen worden overschreven door de waarden uit het JSON-bericht.
| Attribuutsleutel | Type |
|---|
| group | String |
| severity | Severity |
| hostname | String |
| message | String |
severity kan een van de volgende waarden bevatten: unknown, trace, debug, info, notice, warn, error, critical, alert en fatal.
Dit is een uitstekende manier om de severity van uw logregels vanuit de applicatie te beheren, ongeacht de (meestal standaard info) severity die door het platform of de integratie wordt ingesteld.
Attributen
Elk ander sleutel-waardepaar wordt toegevoegd als doorzoekbaar attribuut:
| Attribuutsleutel | Type | Waarde |
|---|
| org | String | ”appsignal” |
| step | Int | 1 |
| seen_terms | Bool | true |
| entries | Double | 10.01 |
| user.id | Int | 1 |
| user.remote_id | String | ”123” |
Sleutels moeten alfanumerieke strings zijn. Array-waarden worden niet
ondersteund.
- Als een sleutel-waardepaar een sleutel heeft met de naam
msg of message, wordt de waarde van deze sleutel geparst als het logbericht.
- Als er geen message/msg-sleutel beschikbaar is, wordt de volledige logregel als het bericht beschouwd.
- Sleutels moeten alfanumeriek zijn.
- Sleutels mogen geen spaties bevatten, maar mogen wel punten (
.), underscores (_) en koppeltekens (-) bevatten.
- Sleutels mogen niet meer dan 50 tekens bevatten
Gedrag van waarden:
- Waarden mogen niet langer zijn dan 255 tekens
- Niet meer dan 25 attributen per logbericht.
- Waarden mogen geneste Objects bevatten, maar geen Arrays.
- Waarden kunnen van de volgende typen zijn:
- String
- Integer (bijv.
10)
- Double (bijv.
10.01)
- Boolean (
true/false)
- Object (bijv.
{ "foo": "bar" })
Voor geneste objecten worden de attributen afgevlakt, gescheiden door een .-teken.
Sleutel-waardeparen die niet aan deze regels voldoen, worden aan het bericht van een log toegevoegd, tenzij een message- of msg-sleutel wordt verstrekt.