🔐 N’envoyez pas d’informations personnelles identifiables (PII) à AppSignal. Filtrez les PII (par exemple, noms, e-mails) des journaux et utilisez un identifiant, un hash ou un identifiant pseudonymisé à la place.
Pour les entités couvertes par la HIPAA, plus d’informations sur la signature d’un Business Associate Agreement (BAA) sont disponibles dans notre documentation Business Add-Ons. JSON
Si vous spécifiez JSON comme format de journal, AppSignal analysera le message de journal entrant comme des paires clé-valeur. Chaque paire clé-valeur sera stockée comme attribut sur la ligne de journal, vous permettant de filtrer et rechercher des lignes de journal spécifiques en fonction de leurs attributs.
Exemples
L’exemple suivant montre comment AppSignal analyse un message de journal au format JSON.
{
"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" }
}
Message
Le JSON ci-dessus sera analysé avec le message "this is a test message".
Vous pouvez utiliser la clé msg ou message pour remplacer le message.
Si aucune clé msg ou message n’est disponible, l’ensemble de la ligne de journal sera utilisé comme message.
Remplacements
Les attributs de journal de la plateforme ou de l’intégration (tels que hostname, timestamp et group définis par exemple par la plateforme Heroku) peuvent être remplacés par les valeurs du message JSON.
| Clé d’attribut | Type |
|---|
| group | String |
| severity | Severity |
| hostname | String |
| message | String |
severity peut contenir l’une des valeurs suivantes : unknown, trace, debug, info, notice, warn, error, critical, alert et fatal.
C’est une excellente façon de contrôler la sévérité de vos lignes de journal depuis l’application, indépendamment de la sévérité (généralement par défaut info) définie par la plateforme ou l’intégration.
Attributs
Toute autre paire clé/valeur est ajoutée comme attribut interrogeable :
| Clé d’attribut | Type | Valeur |
|---|
| org | String | ”appsignal” |
| step | Int | 1 |
| seen_terms | Bool | true |
| entries | Double | 10.01 |
| user.id | Int | 1 |
| user.remote_id | String | ”123” |
Les clés doivent être des chaînes alphanumériques. Les valeurs sous forme de tableau ne sont pas prises en charge.
- Si une paire clé-valeur a une clé portant le nom de
msg ou message, la valeur de cette clé sera analysée comme le message de journal.
- Si aucune clé message/msg n’est disponible, l’ensemble de la ligne de journal sera considéré comme le message.
- Les clés doivent être alphanumériques.
- Les clés ne peuvent pas contenir d’espaces, mais peuvent contenir des points (
.), des tirets bas (_) et des traits d’union (-).
- Les clés ne peuvent pas contenir plus de 50 caractères
Comportement des valeurs :
- Les valeurs ne doivent pas dépasser 255 caractères
- Pas plus de 25 attributs par message de journal.
- Les valeurs peuvent contenir des objets imbriqués, mais pas des tableaux.
- Les valeurs peuvent être des types suivants :
- String
- Integer (par exemple
10)
- Double (par exemple
10.01)
- Boolean (
true/false)
- Object (par exemple
{ "foo": "bar" })
Pour les objets imbriqués, les attributs seront aplatis, séparés par un caractère ..
Les paires clé-valeur qui ne suivent pas ces règles sont ajoutées au message d’un journal, sauf si une clé message ou msg est fournie.