Journalisation système sur un système à châssis unique

Pour enregistrer ou afficher les messages du journal système, vous devez inclure l’instruction au niveau de la syslog[edit system] hiérarchie. Spécifiez au moins une destination pour les messages, comme décrit à la section Tableau 1. Pour plus d’informations sur les instructions de configuration, reportez-vous à la section Présentation de la configuration de la journalisation système à châssis unique.

[edit system syslog]
file filename {
    facility severity;
}

[edit system syslog]
user (username | *) {
    facility severity;
}

[edit system syslog]
console {
    facility severity;
}

[edit system syslog]
host (hostname | other-routing-engine) {
    facility severity;
}

Vous pouvez consigner les messages dans un fichier au format de données structurées au lieu du format Junos OS standard. Le format de données structurées fournit plus d’informations sans ajouter de longueur significative et permet aux applications automatisées d’extraire plus facilement des informations d’un message.

Le format de données structurées est conforme à la norme Internet RFC 5424, The Syslog Protocol, qui est à https://tools.ietf.org/html/rfc5424. La RFC établit un format de message standard, quel que soit la source ou le protocole de transport des messages consignés.

Pour générer des messages dans un fichier au format de données structurées, incluez l’instruction structured-data au niveau de la [edit system syslog file filename] hiérarchie :

L’instruction facultative brief supprime le texte en anglais qui apparaît par défaut à la fin d’un message pour décrire l’erreur ou l’événement.

Le format structuré est utilisé pour tous les messages consignés dans le fichier et générés par un processus ou une bibliothèque logicielle Junos.

Pour éviter que les fichiers journaux ne deviennent trop volumineux, l’utilitaire de journalisation système de Junos OS écrit par défaut les messages dans une séquence de fichiers d’une taille définie. Les fichiers de la séquence sont appelés fichiers d’archive pour les distinguer du fichier actif dans lequel les messages sont en cours d’écriture. La taille maximale par défaut dépend du type de plate-forme :

• 128 kilo-octets (Ko) pour les commutateurs EX Series

• 1 mégaoctet (Mo) pour les routeurs M Series, MX Series et T Series

• 10 Mo pour les routeurs TX Matrix ou TX Matrix Plus

• 1 Mo pour la gamme QFX Series

Lorsqu’un fichier journal actif appelé logfile atteint sa taille maximale, l’utilitaire de journalisation ferme le fichier, le compresse et nomme le fichier logfile.0.gzd’archive compressé. L’utilitaire de journalisation s’ouvre et écrit dans un nouveau fichier actif appelé logfile. Ce processus est également connu sous le nom de rotation des fichiers. Lorsque le nouveau atteint la taille maximale configurée, il est renommé , et le nouveau logfilelogfile est fermé, compressé et renommé logfile.0.gzlogfile.1.gz. logfile.0.gz Par défaut, l’utilitaire de journalisation crée jusqu’à 10 fichiers d’archive de cette manière. Lorsque le nombre maximal de fichiers d’archive est atteint et que la taille du fichier actif atteint la taille maximale configurée, le contenu du dernier fichier archivé est écrasé par le fichier actif actuel. Par défaut, l’utilitaire de journalisation limite également les utilisateurs autorisés à lire les fichiers journaux à l’utilisateur et aux utilisateurs disposant de l’autorisation root Junos OS maintenance .

Junos OS fournit une instruction log-rotate-frequency de configuration qui configure la fréquence de rotation du fichier journal système en configurant l’intervalle de temps nécessaire à la vérification de la taille du fichier journal. La fréquence peut être réglée sur une valeur de 1 minute à 59 minutes. La fréquence par défaut est de 15 minutes.

Pour configurer la fréquence de rotation des journaux, incluez l’instruction log-rotate-frequency au niveau de la [edit system syslog] hiérarchie.

Vous pouvez inclure l’instruction permettant de modifier la taille maximale de chaque fichier, le nombre de fichiers d’archive archive créés et les personnes autorisées à lire les fichiers journaux.

Pour configurer des valeurs qui s’appliquent à tous les fichiers journaux, incluez l’instruction archive au niveau de la [edit system syslog] hiérarchie :

Pour configurer des valeurs qui s’appliquent à un fichier journal spécifique, incluez l’instruction archive au niveau de la [edit system syslog file filename] hiérarchie :

archive-sites site-name Spécifie une liste de sites d’archivage que vous souhaitez utiliser pour stocker des fichiers. La site-name valeur correspond à toute URL FTP valide vers une destination. Si plusieurs noms de site sont configurés, une liste de sites d’archivage pour les fichiers journaux système est créée. Lorsqu’un fichier est archivé, le routeur ou le commutateur tente de transférer le fichier vers la première URL de la liste et ne passe au site suivant que si le transfert échoue. Le fichier journal est stocké sur le site d’archivage avec le nom de fichier journal spécifié. Pour plus d’informations sur la spécification d’URL FTP valides, reportez-vous à la section Format de spécification des noms de fichiers et des URL dans les commandes CLI de Junos OS.

binary-data Marquez le fichier comme contenant des données binaires. Cela permet un archivage correct des fichiers binaires, tels que les fichiers WTMP (enregistrements de connexion pour les systèmes UNIX). Pour restaurer le paramètre par défaut, incluez l’instruction no-binary-data .

files number Spécifie le nombre de fichiers à créer avant que le fichier le plus ancien ne soit écrasé. La valeur peut être comprise entre 1 et 1000.

size size Spécifie la taille maximale de chaque fichier. La valeur peut aller de 64 Ko (64 ko) à 1 gigaoctet (1 g) ; Pour représenter des mégaoctets, utilisez la lettre m après l’entier. Il n’y a pas d’espace entre les chiffres et la lettre , mou g unitésk.

start-time "YYYY-MM-DD.hh:mm" Définit la date et l’heure dans le fuseau horaire local pour un transfert unique du fichier journal actif vers le premier site accessible dans la liste des sites spécifiés par l’instruction archive-sites .

transfer-interval interval Définit la durée pendant laquelle le fichier journal actuel reste ouvert (même s’il n’a pas atteint la taille maximale possible) et reçoit de nouvelles statistiques avant d’être fermé et transféré vers un site d’archivage. Cette valeur d’intervalle peut être comprise entre 5 et 2880 minutes.

world-readable Permet à tous les utilisateurs de lire les fichiers journaux. Pour restaurer les autorisations par défaut, incluez l’instruction no-world-readable .

La facilité et le niveau de gravité d’un message sont désignés ensemble comme sa priorité. Par défaut, les messages consignés au format standard Junos OS n’incluent pas d’informations sur la priorité. Pour inclure des informations de priorité dans les messages de format standard dirigés vers un fichier, incluez l’instruction explicit-priority au niveau de la [edit system syslog file filename] hiérarchie :

Pour inclure des informations de priorité dans les messages dirigés vers une machine distante ou l’autre moteur de routage, incluez l’instruction explicit-priority au niveau de la [edit system syslog host (hostname | other-routing-engine)] hiérarchie :

La priorité enregistrée dans un message indique toujours le nom de l’installation locale d’origine. Si l’instruction est incluse pour les messages dirigés vers une destination distante, l’utilitaire de journalisation système Junos OS utilise toujours le nom de fonctionnalité alternatif pour les messages eux-mêmes lorsqu’il facility-override les dirige vers la destination distante. Pour plus d’informations, reportez-vous à la section Modification du nom d’une autre ressource pour les messages du journal système dirigés vers une destination distante.

Lorsque l’instruction est incluse, l’utilitaire de journalisation Junos OS ajoute les codes du nom de l’installation explicit-priority et du niveau de gravité au nom de la balise de message, si le message en contient un :

(La balise est un identificateur unique attribué à certains messages de journal système Junos OS.)

Dans l’exemple suivant, le CHASSISD_PARSE_COMPLETE message appartient à la daemon ressource et se voit attribuer la gravité info (6) :

Lorsque l’instruction n’est explicit-priority pas incluse, la priorité n’apparaît pas dans le message :

Par défaut, l’horodatage enregistré dans un message de journal système au format standard spécifie le mois, la date, l’heure, la minute et la seconde lorsque le message a été enregistré, comme dans l’exemple suivant :

Pour inclure l’année, la milliseconde ou les deux dans l’horodatage, incluez l’instruction time-format au niveau de la [edit system syslog] hiérarchie ou [edit security log] :

Toutefois, l’horodatage des messages traceoption est spécifié en millisecondes par défaut et est indépendant de l’instruction [edit system syslog time-format] .

L’horodatage modifié est utilisé dans les messages dirigés vers chaque destination configurée par une instruction , ou user au niveau de la hiérarchie, consolemais pas vers les [edit system syslog] destinations configurées par une filehost instruction.

L’exemple suivant illustre le format d’un horodatage qui inclut à la fois la milliseconde (401) et l’année (2006) :

Les fonctionnalités prédéfinies regroupent les messages associés, mais vous pouvez également faire correspondre les messages avec des chaînes et des expressions régulières pour affiner les messages d’une ressource qui sont consignés dans un fichier, un terminal utilisateur ou une destination distante.

Les match-strings instructions de configuration et vous permettent de match faire correspondre les messages du journal système à une chaîne ou à une expression régulière, respectivement. Vous pouvez inclure ces instructions aux niveaux hiérarchiques suivants :

• [edit system syslog file filename] (pour un fichier)

• [edit system syslog user (username | *)] (pour une session utilisateur spécifique ou pour toutes les sessions utilisateur sur un terminal)

• [edit system syslog host (hostname | other-routing-engine)] (pour une destination éloignée)

Pour évaluer les messages par rapport à une expression régulière et consigner uniquement les messages correspondants à la destination donnée, incluez l’instruction et spécifiez l’expression match régulière :

À partir de Junos OS version 16.1, vous pouvez utiliser des comparaisons de chaînes simples pour filtrer les messages plus efficacement, car elles gourmandisent moins en ressources processeur que la mise en correspondance avec des expressions régulières complexes. Pour spécifier la chaîne de texte qui doit apparaître dans un message pour que le message soit consigné dans une destination, incluez l’instruction match-strings et spécifiez la chaîne ou la liste de chaînes correspondante :

Les match-strings instructions et sélectionnent les messages dont la fonction et la gravité sont configurées et match qui correspondent à la chaîne ou à l’expression régulière donnée. L’instruction match-strings effectue une simple comparaison de chaîne et, par conséquent, elle est moins gourmande en ressources CPU que l’utilisation de l’instruction pour faire correspondre des match expressions régulières complexes. Si vous configurez les match instructions et pour la même destination, Junos OS évalue d’abord la condition ; si le message inclut l’une des sous-chaînes configurées, le message est consigné et match-strings la condition n’est match-stringsmatch pas évaluée. Si la condition n’est pas remplie, le système compare le message à l’expression régulière de l’instruction match-stringsmatch de configuration.

Lorsque vous spécifiez des expressions régulières pour l’instruction match , utilisez la notation définie dans la norme POSIX 1003.2 pour les expressions rationnelles UNIX étendues (modernes). L’explication de la syntaxe des expressions rationnelles dépasse le cadre de ce document, mais les normes POSIX sont disponibles auprès du Institute of Electrical and Electronics Engineers (IEEE, http://www.ieee.org).

Tableau 4 Spécifie le ou les caractères qui sont mis en correspondance par certains des opérateurs d’expression régulière que vous pouvez utiliser dans l’instruction Match. Dans les descriptions, le terme terme fait référence soit à un seul caractère alphanumérique, soit à un ensemble de caractères entre crochets, parenthèses ou accolades.

Utilisation de chaînes de caractères et d’expressions régulières

Filtrez les messages qui appartiennent à la fonctionnalité, en dirigeant ceux qui incluent la interactive-commands chaîne configure vers le terminal de l’utilisateur root :

Des messages comme celui-ci s’affichent sur le terminal de l’utilisateur root lorsqu’un utilisateur exécute une configure commande pour passer en mode de configuration :

Filtrez les messages appartenant à l’installation daemon et ayant une gravité égale error ou supérieure, en les dirigeant vers le fichier /var/log/process-errors. Omettre les messages générés par le processus SNMP (snmpd) et les diriger vers le fichier /var/log/snmpd-errors:

Pour désactiver la journalisation des messages appartenant à une installation particulière, incluez l’instruction facility none dans la configuration. Cette instruction est utile lorsque, par exemple, vous souhaitez consigner des messages qui ont le même niveau de gravité et appartiennent à toutes les fonctionnalités, à l’exception de quelques-unes. Au lieu d’inclure une instruction pour chaque ressource que vous souhaitez enregistrer, vous pouvez inclure l’instruction any severity , puis une facility none instruction pour chaque ressource que vous ne souhaitez pas consigner. Par exemple, ce qui suit consigne tous les messages de niveau error ou supérieur dans la console, à l’exception des messages provenant des daemon installations et kernel . À la place, les messages provenant de ces installations sont consignés dans le fichier >/var/log/internals :

Enregistrez tous les messages générés sur la plate-forme de routage locale au niveau d’erreur ou supérieur à l’installation local0 sur la machine distante appelée monitor.mycompany.com:

Configurez les plates-formes de routage situées en Californie et les plates-formes de routage situées dans l’État de New York pour envoyer des messages à une seule machine distante appelée central-logger.mycompany.com. Les messages en provenance de Californie se voient attribuer une installation alternative et les messages en provenance de New York sont attribués à une installation local0local2alternative.

• Configurez les plates-formes de routage californiennes pour agréger les messages dans l’installation local0 :

• Configurez les plates-formes de routage de New York pour agréger les messages dans l’installation local2 :

Vous central-logger pouvez ensuite configurer l’utilitaire de journalisation système pour qu’il écrive des messages de l’installation dans le fichier et les messages de l’installation local0local2 dans le fichier california-confignew-york-config.