dellos-logging

Роль логирования

Эта роль упрощает настройку глобальных параметров логирования и поддерживает конфигурацию серверов логирования. Эта роль абстрагирована для dellos6, dellos9 и dellos10.

Роль логирования требует SSH-соединения для подключения к устройству Dell EMC Networking. Вы можете использовать любые встроенные переменные подключения ОС.

Установка

ansible-galaxy install Dell-Networking.dellos-logging

Переменные роли

  • Роль абстрагируется с использованием переменной ansible_network_os, которая может принимать значения dellos9, dellos6 и dellos10
  • Если переменная dellos_cfg_generate установлена в true, то она генерирует команды конфигурации роли в файл
  • Любая переменная роли с соответствующей переменной состояния, установленной в отсутствующий(отсутствует), отменяет конфигурацию этой переменной
  • Установка пустого значения для любой переменной отменяет соответствующую конфигурацию
  • Переменные и значения чувствительны к регистру

Ключи dellos_logging

Ключ Тип Описание Поддержка
logging список Настраивает сервер логирования (см. logging.*) dellos6, dellos9, dellos10
logging.ip строка (обязательно) Настраивает IPv4-адрес для сервера логирования (формат A.B.C.D) dellos6, dellos9, dellos10
logging.secure_port целое число Указывает порт TLS для логирования dellos9
logging.tcp_port целое число Указывает TCP-порт для логирования, если secure_port не определен dellos9
logging.udp_port целое число Указывает UDP-порт для логирования, если не определены оба TCP и ключ secure_port dellos9
logging.vrf словарь Указывает экземпляр VRF для доступа к хосту dellos9
logging.vrf.name строка Указывает имя VRF dellos9
logging.vrf.secure_port целое число Указывает порт TLS для логирования dellos9
logging.vrf.tcp_port целое число Указывает TCP-порт для логирования, если secure_port не определен dellos9
logging.vrf.udp_port целое число Указывает UDP-порт для логирования, если не определены оба TCP и ключ secure_port dellos9
logging.vrf.state строка: absent,present* Удаляет экземпляр VRF сервера логирования, если установлено в absent dellos9
logging.state строка: absent,present* Удаляет сервер логирования, если установлено в absent dellos6, dellos9, dellos10
console словарь Настраивает логирование в консоль (см. console.*) dellos10
console.enable булево Включает/выключает логирование в консоль dellos10
console.severity строка Настраивает минимальный уровень серьезности для логирования в консоль dellos10
log_file словарь Настраивает логирование в файл (см. log_file.*) dellos10
log_file.enable булево Включает/выключает логирование в файл dellos10
log_file.severity строка Настраивает минимальный уровень серьезности для логирования в файл dellos10
buffer целое число Указывает уровень серьезности буферизированного логирования (от 0 до 7) dellos9
console_level целое число Настраивает уровень логирования в консоли (от 0 до 7) dellos9
trap_level целое число Настраивает уровень серьезности сервера syslog (от 0 до 7) dellos9
syslog_version целое число Настраивает версию syslog (0/1) dellos9
monitor целое число Настраивает уровень логирования линий терминала (от 0 до 7) dellos9
history целое число Настраивает таблицу истории syslog (от 0 до 7) dellos9
history_size целое число Указывает размер таблицы истории dellos9
on булево Включает логирование во все поддерживаемые направления, если установлено в true dellos9
extended булево Включает расширенное логирование, если установлено в true dellos9
coredump словарь Настраивает логирование дампов памяти dellos9
coredump.server словарь Указывает все детали сервера dellos9
coredump.server.server_ip строка (обязательно) Указывает IPv4/IPv6 адрес сервера логирования dellos9
coredump.server.username строка Указывает имя пользователя для настроек dellos9
coredump.server.password строка Указывает пароль для настроек dellos9
coredump.server.state строка: present,absent* Удаляет сервер дампов памяти, если установлен в absent dellos9
coredump.stackunit словарь Указывает детали для включения дампа памяти на стек-юните dellos9
coredump.stackunit.all булево Включает дамп для всех стек-юнитов dellos9
coredump.stackunit.unit_num целое число Указывает номер стек-юнита (от 0 до 5) dellos9
coredump.stackunit.state строка: present,absent* Удаляет дамп стек-юнита, если установлен в absent dellos9
source_interface строка Настраивает исходный интерфейс для логирования dellos6, dellos9, dellos10

ПРИМЕЧАНИЕ: Знак астериска (*) обозначает значение по умолчанию, если не указано другое.

Переменные подключения

Роли Ansible Dell EMC Networking требуют информации о подключении для установления связи с узлами в вашей инвентаризации. Эта информация может находиться в директориях group_vars или host_vars, инвентаризации или непосредственно в плейбуке.

Ключ Обязательно Выборы Описание
ansible_host да Указывает имя хоста или адрес для подключения к удаленному устройству по указанному транспорту
ansible_port нет Указывает порт, используемый для построения соединения с удаленным устройством; если значение не указано, используется значение параметра ANSIBLE_REMOTE_PORT, по умолчанию это 22
ansible_ssh_user нет Указывает имя пользователя для аутентификации CLI при подключении к удаленному устройству; если значение не указано, используется значение переменной окружения ANSIBLE_REMOTE_USER
ansible_ssh_pass нет Указывает пароль для аутентификации подключения к удаленному устройству
ansible_become нет да, нет* Указывает модулю перейти в привилегированный режим на удаленном устройстве перед отправкой любых команд; если значение не указано, используется значение переменной окружения ANSIBLE_BECOME, и устройство пытается выполнять все команды в непривилегированном режиме
ansible_become_method нет enable, sudo* Указывает модулю, чтобы разрешить указание метода повышения привилегий; если значение не указано, используется значение переменной окружения ANSIBLE_BECOME_METHOD
ansible_become_pass нет Указывает пароль, который требуется для входа в привилегированный режим на удаленном устройстве; если ansible_become установлено в no, этот ключ не применяется
ansible_network_os да dellos6/dellos9/dellos10, null* Загружает правильные плагины терминала и cliconf для связи с удаленным устройством

ПРИМЕЧАНИЕ: Знак астериска (*) обозначает значение по умолчанию, если не указано.

Зависимости

Роль dellos-logging построена на модулях, включенных в основной код Ansible. Эти модули были добавлены в версии Ansible 2.2.0.

Пример плейбука

Этот пример использует роль dellos-logging для полной настройки серверов логирования. Он создает файл hosts с деталями переключателя и соответствующими переменными. Файл хостов должен определять переменную ansible_network_os с соответствующим именем операционной системы сети Dell EMC. Когда dellos_cfg_generate установлено в true, переменная генерирует команды конфигурации в файл .part в пути build_dir. По умолчанию переменная установлена в false.

Пример файла hosts

leaf1 ansible_host= <ip_address> 

Пример 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"

Простой плейбук для настройки логирования - leaf.yaml

- hosts: leaf1
  roles:
     - Dell-Networking.dellos-logging

Запуск

ansible-playbook -i hosts leaf.yaml

(c) 2017 Dell Inc. или ее дочерние компании. Все права защищены.

О проекте

The dellos-logging role facilitates the configuration of logging attributes in devices running Dell EMC Networking Operating Systems.

Установить
ansible-galaxy install Dell-Networking/ansible-role-dellos-logging
Лицензия
apache-2.0
Загрузки
68200
Владелец