cClaude.rocks: Le blog - 🐧 « journalctl

avr.

2023

🐧 « journalctl » et JSON

Par défaut l’affichage de journalctl est difficilement exploitable par un script, cependant journalctl propose plusieurs façons d’obtenir une sortie au format JSON.

Le paramètre -o ou --output= permet de contrôler le formatage des entrées de journal qui sont montrés.

Attention, ce paramètre ne s’applique que lorsque la commande journalctl est utilisée pour afficher tout ou partie du journal.

ඏ

les options possibles pour « -o », « --output= »

Option	Description
`short`	C’est la valeur par défaut et génère une sortie principalement identique au formatage des fichiers syslog classiques, montrant une ligne par entrée de journal.
`short-full`	Très proche de `short`, elle affiche les horodatages au format accepté par les options `--since=` et `--until=`. Contrairement aux informations d’horodatage affichées en mode de sortie court, ce mode inclut des informations sur le jour de la semaine, l’année et le fuseau horaire dans la sortie et est indépendant des paramètres régionaux.
`short-iso`	Très proche de `short`, elle affiche les horodatages d'horloge au format ISO 8601.
`short-iso-precise`	comme pour `short-iso` mais inclut une précision à la microseconde.
`short-precise`	Très similaire, mais affiche les horodatages syslog classiques avec une précision totale de la microseconde.
`short-monotonic`	Très similaire, mais affiche des horodatages monotones au lieu d’horodatages d’horloge murale.
`short-delta`	comme pour monotone court mais inclut la différence de temps avec l’entrée précédente. Peut-être que les différences de temps non fiables sont marquées par un `*`.
`short-unix`	Très similaire, mais affiche les secondes écoulées depuis le 1er janvier 1970 UTC au lieu des horodatages d’horloge (heure UNIX). L’heure est affichée avec une précision de l’ordre de la microseconde.
`verbose`	Affiche les éléments d’entrée entièrement structurés avec tous les champs.
`export`	Sérialise le journal en un flux binaire (mais principalement basé sur du texte) adapté aux sauvegardes et au transfert réseau (voir Journal Export Format [2] pour plus d’informations). Pour réimporter le flux binaire au format journald natif, utilisez systemd-journal-remote(8).
`json`	Formate les entrées en tant qu'objets JSON, séparés par des caractères de retour à la ligne (voir Journal JSON Format[3] pour plus d’informations).
`json-pretty`	Formate les entrées en tant que structures de données JSON, mais les formate sur plusieurs lignes afin de les rendre plus lisibles par les humains.
`json-sse`	Formate les entrées en tant que structures de données JSON, mais les enveloppe dans un format adapté aux événements envoyés par le serveur[4].
`json-seq`	Formate les entrées en tant que structures de données JSON, mais les préfixe avec un caractère « ASCII Record Separator » (0x1E) et les suffixe avec un caractère ASCII Line Feed (0x0A), conformément aux séquences de texte JavaScript Object Notation (JSON)[5](`application/ json-seq`).
`cat`	Génère une sortie très concise, ne montrant que le message réel de chaque entrée de journal sans métadonnées, pas même un horodatage. Si elle est combinée avec l’option `--output-fields=`, les champs répertoriés seront affichés pour chaque enregistrement de journal, au lieu du message.
`with-unit`	Similaire à short-full, mais préfixe les noms d’unité et d’unité utilisateur au lieu de l’identifiant syslog traditionnel. Utile lors de l’utilisation d’instances basées sur un modèle, car il inclura les arguments dans les noms d’unité.

ඏ

Le cas des sorties au format JSON.

Les valeurs de champ sont généralement encodées sous forme de chaînes JSON, à trois exceptions près :

Les champs supérieurs à 4096 octets sont codés comme des valeurs nulles. (Cela peut être désactivé en passant --all, mais sachez que cela peut allouer des objets JSON trop longs pour être par la suite traité.)
Les entrées de journal autorisent des champs non uniques dans la même entrée de journal. JSON n’autorise pas les champs non uniques dans les objets. Pour cette raison, si un champ non unique est rencontré, un tableau JSON est utilisé comme valeur de champ, répertoriant toutes les valeurs de champ en tant qu’éléments.
Les champs contenant des octets non imprimables ou non UTF8 sont encodés sous forme de tableaux contenant les octets bruts formatés individuellement en tant que nombres non signés.

Notez que cet encodage est réversible (à l’exception de la limite de taille).

ඏ

Exemples

Nous ne traiterons que des deux sorties JSON de base, considérant que si vous avez besoin des autres formats c’est que vos compétences dépassent le cadre de ce billet.

Les deux formats JSON qui nous intéressent sont donc :

journalctl -o json …

Et la version plus lisible par un humain :

journalctl -o json-pretty …

Qui correspond aux couleurs près à :

journalctl -o json … | jq '.'

journalctl --no-pager -o json --since=yesterday

journalctl --no-pager -o json -p emerg..err

journalctl --no-pager -o json -p emerg..err --boot

journalctl --no-pager -o json -ex

journalctl --no-pager -o json UNIT=systemd-logind.service

journalctl --no-pager -o json UNIT=cron.service

ඏ

Liens

🐧 Guide d’introduction au journal système

ᦿ

Vos commentaires

Pas encore de commentaire - ajouter le votre.
Ajouter votre commentaire

cClaude.rocks ☕ Le blog

les options possibles pour « -o », « --output= »

Le cas des sorties au format JSON.

Exemples

Liens