Dell-Networking.dellos-logging
Rôle de journalisation
Ce rôle facilite la configuration des attributs de journalisation globaux et prend en charge la configuration des serveurs de journalisation. Ce rôle est abstrait pour dellos6, dellos9 et dellos10.
Le rôle de journalisation nécessite une connexion SSH pour se connecter à un appareil de réseau Dell EMC. Vous pouvez utiliser n'importe laquelle des variables de connexion intégrées au système d'exploitation.
Installation
ansible-galaxy install Dell-Networking.dellos-logging
Variables du rôle
- Le rôle est abstrait en utilisant la variable ansible_network_os qui peut prendre les valeurs dellos9, dellos6 et dellos10.
- Si la variable dellos_cfg_generate est définie sur true, elle génère les commandes de configuration du rôle dans un fichier.
- Toute variable de rôle avec une variable d'état correspondante définie sur absent annule la configuration de cette variable.
- Définir une valeur vide pour une variable annule la configuration correspondante.
- Les variables et valeurs sont sensibles à la casse.
Clés dellos_logging
Clé | Type | Description | Support |
---|---|---|---|
logging |
liste | Configure le serveur de journalisation (voir logging.* ) |
dellos6, dellos9, dellos10 |
logging.ip |
chaîne (obligatoire) | Configure l'adresse IPv4 pour le serveur de journalisation (format A.B.C.D) | dellos6, dellos9, dellos10 |
logging.secure_port |
entier | Spécifie les messages de journalisation sur le port TLS | dellos9 |
logging.tcp_port |
entier | Spécifie les messages de journalisation sur le port TCP si secure_port n'est pas défini | dellos9 |
logging.udp_port |
entier | Spécifie les messages de journalisation sur le port UDP si les ports TCP et secure n'ont pas été définis | dellos9 |
logging.vrf |
dictionnaire | Spécifie une instance VRF à utiliser pour atteindre l'hôte | dellos9 |
logging.vrf.name |
chaîne | Spécifie le nom de la VRF | dellos9 |
logging.vrf.secure_port |
entier | Spécifie les messages de journalisation sur le port TLS | dellos9 |
logging.vrf.tcp_port |
entier | Spécifie les messages de journalisation sur le port TCP si secure_port n'est pas défini | dellos9 |
logging.vrf.udp_port |
entier | Spécifie les messages de journalisation sur le port UDP si les ports TCP et secure_port ne sont pas définis | dellos9 |
logging.vrf.state |
chaîne: absent, présent* | Supprime l'instance VRF du serveur de journalisation si définie sur absent | dellos9 |
logging.state |
chaîne: absent, présent* | Supprime le serveur de journalisation si définie sur absent | dellos6, dellos9, dellos10 |
console |
dictionnaire | Configure la journalisation sur la console (voir console.* ) |
dellos10 |
console.enable |
booléen | Active/désactive la journalisation sur la console | dellos10 |
console.severity |
chaîne | Configure le niveau de gravité minimum pour la journalisation sur la console | dellos10 |
log_file |
dictionnaire | Configure la journalisation dans un fichier journal (voir log_file.* ) |
dellos10 |
log_file.enable |
booléen | Active/désactive la journalisation dans un fichier journal | dellos10 |
log_file.severity |
chaîne | Configure le niveau de gravité minimum pour la journalisation dans un fichier journal | dellos10 |
buffer |
entier | Spécifie le niveau de gravité de journalisation mis en mémoire (0 à 7) | dellos9 |
console_level |
entier | Configure le niveau de journalisation de la console (0 à 7) | dellos9 |
trap_level |
entier | Configure le niveau de gravité du serveur syslog (0 à 7) | dellos9 |
syslog_version |
entier | Configure la version syslog (0/1) | dellos9 |
monitor |
entier | Configure le niveau de journalisation de la ligne terminale (0 à 7) | dellos9 |
history |
entier | Configure la table d'historique syslog (0 à 7) | dellos9 |
history_size |
entier | Spécifie la taille de la table d'historique | dellos9 |
on |
booléen | Active la journalisation vers toutes les destinations prises en charge si définie sur true | dellos9 |
extended |
booléen | Active la journalisation étendue si définie sur true | dellos9 |
coredump |
dict | Configure la journalisation des coredumps | dellos9 |
coredump.server |
dict | Spécifie tous les détails du serveur | dellos9 |
coredump.server.server_ip |
chaîne (obligatoire) | Spécifie l'adresse IPv4/IPv6 du serveur de journalisation | dellos9 |
coredump.server.username |
chaîne | Spécifie le nom d'utilisateur à configurer | dellos9 |
coredump.server.password |
chaîne | Spécifie le mot de passe à configurer | dellos9 |
coredump.server.state |
chaîne: présent, absent* | Supprime le serveur de coredump si défini sur absent | dellos9 |
coredump.stackunit |
dict | Spécifie les détails pour activer un coredump sur l'unité de pile | dellos9 |
coredump.stackunit.all |
booléen | Active un coredump sur toutes les unités de pile | dellos9 |
coredump.stackunit.unit_num |
entier | Spécifie le numéro de l'unité de pile (0 à 5) | dellos9 |
coredump.stackunit.state |
chaîne: présent, absent* | Supprime le coredump de l'unité de pile si défini sur absent | dellos9 |
source_interface |
chaîne | Configure l'interface source pour la journalisation | dellos6, dellos9, dellos10 |
NOTE : L'astérisque (*) indique la valeur par défaut si aucune valeur n'est spécifiée.
Variables de connexion
Les rôles Ansible pour le réseau Dell EMC nécessitent des informations de connexion pour établir la communication avec les nœuds de votre inventaire. Ces informations peuvent se trouver dans les répertoires group_vars ou host_vars d'Ansible, ou dans le playbook lui-même.
Clé | Obligatoire | Choix | Description |
---|---|---|---|
ansible_host |
oui | Spécifie le nom d'hôte ou l'adresse pour se connecter à l'appareil distant via le transport spécifié | |
ansible_port |
non | Spécifie le port utilisé pour établir la connexion à l'appareil distant ; si aucune valeur n'est spécifiée, l'option ANSIBLE_REMOTE_PORT est utilisée, par défaut à 22 | |
ansible_ssh_user |
non | Spécifie le nom d'utilisateur qui authentifie la connexion CLI à l'appareil distant ; si aucune valeur n'est spécifiée, la valeur de la variable d'environnement ANSIBLE_REMOTE_USER est utilisée | |
ansible_ssh_pass |
non | Spécifie le mot de passe qui authentifie la connexion à l'appareil distant | |
ansible_become |
non | oui, non* | Instruire le module à entrer en mode privilégié sur l'appareil distant avant d'envoyer des commandes ; si aucune valeur n'est spécifiée, la valeur de la variable d'environnement ANSIBLE_BECOME est utilisée et l'appareil tente d'exécuter toutes les commandes en mode non privilégié |
ansible_become_method |
non | enable, sudo* | Instruire le module pour permettre de spécifier la méthode de privilège ; si aucune valeur n'est spécifiée, la valeur de la variable d'environnement ANSIBLE_BECOME_METHOD est utilisée |
ansible_become_pass |
non | Spécifie le mot de passe à utiliser si nécessaire pour entrer en mode privilégié sur l'appareil distant ; si ansible_become est défini sur non, cette clé n'est pas applicable |
|
ansible_network_os |
oui | dellos6/dellos9/dellos10, null* | Charge les plugins de terminal et cliconf corrects pour communiquer avec l'appareil distant |
NOTE : L'astérisque (*) indique la valeur par défaut si aucune valeur n'est spécifiée.
Dépendances
Le rôle dellos-logging est basé sur des modules inclus dans le code Ansible de base. Ces modules ont été ajoutés dans la version 2.2.0 d'Ansible.
Exemple de playbook
Cet exemple utilise le rôle dellos-logging pour configurer complètement les serveurs de journalisation. Il crée un fichier hosts avec les détails du switch et les variables correspondantes. Le fichier hosts doit définir la variable ansible_network_os avec le nom correspondant du système d'exploitation de réseau Dell EMC. Lorsque dellos_cfg_generate est défini sur true, la variable génère les commandes de configuration au format .part dans le chemin build_dir. Par défaut, la variable est définie sur false.
Exemple de fichier hosts
leaf1 ansible_host= <ip_address>
Exemple de host_vars/leaf1
hostname: leaf1
ansible_become: yes
ansible_become_method: xxxxx
ansible_become_pass: xxxxx
ansible_ssh_user: xxxxx
ansible_ssh_pass: xxxxx
ansible_network_os: dellos9
build_dir: ../temp/dellos9
dellos_logging:
logging:
- ip : 1.1.1.1
state: present
- ip: 2.2.2.2
secure_port: 1025
tcp_port: 1024
udp_port: 2000
state: present
- ip: 3.3.3.3
vrf:
name: test
secure_port: 1024
tcp_port: 1025
udp_port: 2000
state: present
secure_port: 1025
tcp_port: 2000
udp_port: 1025
state: present
buffer: 5
console_level: 7
trap_level: 5
syslog_version: 5
history: 4
history_size: 3
monitor: 5
on: true
extended: true
coredump:
server:
server_ip: 2.2.2.2
username: u1
password: pwd
state: present
stackunit:
all: true
unit_num: 5
state: present
source_interface: "fortyGigE 1/9"
Playbook simple pour configurer la journalisation - leaf.yaml
- hosts: leaf1
roles:
- Dell-Networking.dellos-logging
Exécution
ansible-playbook -i hosts leaf.yaml
(c) 2017 Dell Inc. ou ses filiales. Tous droits réservés.
The dellos-logging role facilitates the configuration of logging attributes in devices running Dell EMC Networking Operating Systems.
ansible-galaxy install Dell-Networking.dellos-logging