Skip to main content
Vous souhaitez tirer le meilleur parti de vos journaux ? Lisez notre article du Learning Center sur les bonnes pratiques de journalisation pour plus d’informations sur la bonne utilisation des journaux de votre application.
Les meilleurs journaux sont descriptifs, contextuels et concis. Les attributs vous permettent de stocker, interroger et filtrer rapidement les informations contextuelles clés des journaux de votre application. Les attributs sont pris en charge avec les formats de journal Logfmt, JSON et NDJSON.

​
Formatage

AppSignal analysera les journaux reçus de votre source en se basant sur des paires clé-valeur, en stockant chaque clé et valeur comme attributs sur la ligne de journal, vous permettant de filtrer les lignes de journal sur ces attributs. Formatage des attributs avec :

​
Logfmt

En Logfmt, les attributs peuvent être ajoutés aux lignes de journal :
Text
Par exemple, la ligne de journal ci-dessus sera analysée comme une ligne de journal avec le message "I am a message", et les attributs suivants :
En savoir plus sur le formatage des journaux Logfmt.

​
JSON et NDJSON

En JSON, les attributs peuvent être ajoutés dans un hash sous la clé attributes :
Text
Par exemple, la ligne de journal ci-dessus sera analysée comme une ligne de journal avec le message "This is a test message", et les attributs suivants :
En savoir plus sur le formatage des journaux JSON/NDJSON.

​
Interrogation des attributs dans AppSignal

Dans AppSignal, vous pouvez rechercher des journaux qui correspondent à des conditions d’attribut spécifiques. Par exemple, la requête suivante renverrait tous les journaux avec un attribut article_id contenant la valeur 7 :
Text
Consultez notre documentation sur la gestion des journaux pour une explication complète de notre syntaxe de recherche de journalisation. Lorsqu’un journal est développé, les attributs seront répertoriés sous le message de journal : Ligne de journal développée avec tableau d'attributs

​
Règles de formatage

Les valeurs d’attribut peuvent être de l’un des types suivants :
  • string
  • integer (par exemple 10)
  • double (par exemple 10.01)
  • boolean (true/false)
Les clés d’attribut doivent respecter les règles suivantes :
  • 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
  • Les valeurs ne doivent pas dépasser 255 caractères
  • Pas plus de 25 attributs par message de journal.
Si les clés et les valeurs d’attribut ne respectent pas les règles ci-dessus, le comportement suivant peut être attendu :
  • Si une clé n’a pas de valeur, elle sera ajoutée au champ message.
  • 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.