Utilitaire d’enregistrement Junos

RÉSUMÉ Utilisez l’utilitaire de journalisation Junos pour enregistrer des messages de journal système personnalisés ou générer des notifications d’événements afin de valider les stratégies d’événements dans un environnement de test.

Le logiciel Junos comprend un utilitaire d’enregistrement qui vous permet de :

Enregistrer des messages personnalisés dans le fichier journal système
Simuler des notifications d’événements Junos

Présentation de Junos Logger

L’enregistreur Junos est un utilitaire shell que vous pouvez utiliser pour consigner des messages personnalisés dans le fichier journal système et générer artificiellement des notifications d’événements. L’enregistreur vous permet de tester avec succès les stratégies d’événements et les scripts d’événements, même lorsque l’événement déclencheur est difficile à reproduire.

Vous pouvez configurer des stratégies d’événements sur les équipements Junos afin d’exécuter des actions spécifiques en réponse à un événement ou à une série d’événements. Il est important de tester une stratégie d’événements avant de la déployer dans un environnement de production pour vous assurer qu’elle se déclenche comme prévu et effectue les actions appropriées. Dans certains cas, il est difficile de simuler l’environnement qui génère les événements nécessaires au déclenchement d’une stratégie d’événements. Dans ce cas, vous pouvez utiliser l’utilitaire de journalisation Junos pour générer des notifications d’événements afin de déclencher la stratégie.

Note:

L’enregistreur d’événements Junos est un utilitaire shell non pris en charge qui ne doit pas être utilisé sur les périphériques d’un environnement de production. Toutefois, l’utilitaire est bien adapté à une utilisation dans des environnements de laboratoire où vous développez et vérifiez des stratégies d’événements et des scripts d’événements.

L’utilitaire d’enregistrement vous permet également d’enregistrer un message dans le journal système sans déclencher de notification d’événement. Ainsi, vous pouvez enregistrer des informations supplémentaires sur le système en plus des messages et des événements qui sont automatiquement enregistrés pendant le fonctionnement normal de l’appareil.

Lorsque vous utilisez l’utilitaire d’enregistrement pour générer des notifications d’événements ou enregistrer des messages de journal personnalisés, l’appareil utilise une version modifiée de l’utilitaire du logger système d’exploitation de base. L’utilitaire modifié accepte un ensemble spécialisé d’options conçues pour être utilisées avec le logiciel Junos.

Syntaxe de l’enregistreur Junos (générer un événement)

Syntaxe (Junos OS)
Syntaxe (Junos OS Evolved)
Description
Options

Syntaxe (Junos OS)

Syntaxe (Junos OS Evolved)

Description

Générez une notification d’événement et consignez également l’événement dans le journal système, à condition que l’appareil soit configuré pour consigner les événements avec la priorité spécifiée.

Options

Le Tableau 1 présente les arguments obligatoires et facultatifs de l’utilitaire de journalisation d’événements Junos.

Tableau 1 : Options de l’enregistreur (générer un événement)
Exemple	de description	d’option
`-a attribute=value`	(Facultatif) Attribut associé à l’événement. Le nom de l’attribut doit être en minuscules. Pour spécifier plusieurs attributs, incluez l’option `-a` pour chaque attribut. Pour plus d’informations sur les attributs associés à un événement Junos particulier, consultez les détails de l’événement dans l’outil Explorateur de journaux système .	`-a username=admin` `-a command=commit`
`-d process`	(Facultatif) Procédé Junos (démon) à utiliser comme processus source de l’événement. Si vous ne spécifiez pas de processus, Junos OS utilise `logger` pour le processus et Junos OS Evolved `EVENTD_LOGGER` utilise pour le processus.	`-d mgd`
`-e EVENT_ID`	Événement pour lequel générer la notification d’événement. L’identificateur d’événement doit être en majuscules.	`-e UI_COMMIT`
`-l logical-system-name`	(Facultatif) Générez et consignez une notification d’événement dans le fichier journal pour le système logique spécifié.	`-l ls-router1`
`-p priority`	(Facultatif) Enregistrez l’événement avec la priorité donnée, spécifiée numériquement ou sous la forme d’une paire syslog `facility.severity` . La priorité par défaut est `user.notice`.	`-p external.notice`
`message`	(Facultatif) Chaîne de message à enregistrer dans le journal système. Les citations ne sont pas obligatoires, mais elles sont recommandées pour plus de clarté.	« Il s’agit d’un événement de test généré manuellement. »

Syntaxe de l’enregistreur Junos (consignation d’un message)

Syntaxe (Junos OS)
Syntaxe (Junos OS Evolved)
Description
Options

Syntaxe (Junos OS)

Syntaxe (Junos OS Evolved)

Description

Consigner les entrées dans le journal système, à condition que l’appareil soit configuré pour consigner les messages avec la priorité spécifiée.

Note:

Sur les équipements exécutant Junos OS Evolved, vous pouvez également utiliser l’utilitaire de journalisation Linux dans l’interpréteur de commandes système pour enregistrer des messages dans le journal système.

Options

Lorsque vous utilisez l’utilitaire d’enregistrement Junos pour enregistrer des messages personnalisés dans le journal système, l’équipement appelle l’utilitaire logger du système d’exploitation de base sous-jacent. Seul un sous-ensemble des logger options est pris en charge sur les équipements Junos. Le tableau 2 présente les options prises en charge.

Tableau 2 : Options de l’enregistreur (consignation d’un message)
Description de	l’option
`(-4 \| -6)`	(Facultatif) Sous Junos OS, utilisez uniquement des adresses IPv4 ou IPv6.
`-A`	(Facultatif) Sous Junos OS, essayez d’envoyer le message à toutes les adresses.
`-f file`	(Facultatif) Copiez le contenu du fichier spécifié dans le fichier journal système.
`-h host`	(Facultatif) Sous Junos OS, envoyez le message à l’hôte distant spécifié au lieu de le consigner localement.
`-i`	(Facultatif) Enregistrez l’ID de processus du processus de l’enregistreur avec chaque ligne.
`-p priority`	(Facultatif) Générez l’événement avec la priorité donnée, spécifiée numériquement ou sous la forme d’une paire syslog `facility.severity` . La priorité par défaut est `user.notice`.
`-s`	(Facultatif) Consigner le message dans l’erreur standard, en plus du fichier journal système.
`-t tag`	(Facultatif) Enregistrez l’entrée avec la balise spécifiée au lieu de la balise par défaut, qui est le nom d’utilisateur actuel.
`message`	(Facultatif) Chaîne de message à enregistrer dans le journal système. Les citations ne sont pas obligatoires, mais elles sont recommandées pour plus de clarté.

Utiliser l’enregistreur Junos pour générer des événements

L’enregistreur d’événements Junos est un utilitaire de shell. Pour utiliser l’utilitaire, vous devez d’abord démarrer un shell système.

Pour générer une notification d’événement et l’enregistrer dans le fichier journal système :

Démarrez un shell système.
L’invite de l’interpréteur de commandes varie en fonction du système d’exploitation et du fait que l’utilisateur soit l’utilisateur root. Par exemple :
- Dans Junos OS :
- Dans Junos OS Evolved :
Générez un événement en appelant l’utilitaire de journalisation Junos et en spécifiant l’ID d’événement en majuscules ainsi que tout autre argument facultatif.
Par exemple, les commandes suivantes simulent un événement UI_COMMIT. L’événement est généré par le processus et a la mgd priorité de l’événement external.notice.
- Dans Junos OS :
- Dans Junos OS Evolved :

La notification d’événement eventd est envoyée au processus. L’appareil enregistre également les informations sur l’événement et le message spécifié dans le fichier journal système, à condition que vous ayez configuré l’appareil pour consigner les messages de l’installation et du niveau de gravité donnés.

Vous pouvez utiliser l’utilitaire de journalisation d’événements Junos pour générer une ou plusieurs notifications d’événements afin de déclencher et de tester une stratégie d’événements lorsqu’il est difficile de reproduire les événements dans un environnement de laboratoire donné. Dans l’exemple précédent, l’appareil exécutera toutes les stratégies qui se déclenchent lors de l’événement UI_COMMIT.

Utiliser l’enregistreur Junos pour consigner des messages

L’enregistreur Junos est un utilitaire shell. Pour utiliser l’utilitaire, vous devez d’abord démarrer un shell système.

Pour consigner des informations dans le fichier journal système :

Démarrez un shell système.
L’invite de l’interpréteur de commandes varie en fonction du système d’exploitation et du fait que l’utilisateur soit l’utilisateur root. Par exemple :
- Dans Junos OS :
- Dans Junos OS Evolved :
Consignez un message dans le journal système en appelant l’utilitaire de journalisation Junos et en spécifiant les informations à consigner ainsi que les arguments facultatifs.
Par exemple, les commandes suivantes consignent la chaîne de message donnée avec la balise et la CUSTOM_LOG priorité .external.notice
- Dans Junos OS :
- Dans Junos OS Evolved :

Dans cet exemple, la chaîne de message est enregistrée dans le journal système avec la balise CUSTOM_LOG, à condition que vous ayez configuré l’appareil pour consigner les messages de l’installation et du niveau de gravité donnés.