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