iosxr_logging – Управление конфигурацией системных служб регистрации на сетевых устройствах
Новая в версии 2.4.
Описание
- Этот модуль предоставляет декларативное управление конфигурацией системной регистрации (syslog) на устройствах Cisco IOS XR.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- ncclient >= 0.5.3 при использовании netconf
- lxml >= 4.1.1 при использовании netconf
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| aggregate - | Список определений конфигурации регистрации syslog. | ||
| dest - |
| Назначение для сообщений системной регистрации (syslog). | |
| facility - | Значение по умолчанию: "local7" | Для настройки типа системной службы регистрации, в которую отправляются сообщения системной регистрации (syslog) на серверы syslog. Необязательная настройка для dest = host.
| |
| hostnameprefix - добавлено в 2.5 | Для добавления префикса имени хоста к сообщениям системной регистрации (syslog), записываемым на серверы syslog. Необязательная конфигурация для dest = host
| ||
| level - | Значение по умолчанию: "debugging" | Указывает уровень серьезности для регистрации. Псевдонимы: severity | |
| name - | Когда dest = file, имя указывает имя файла.Когда dest = host, имя указывает имя хоста или IP-адрес сервера syslog. | ||
| provider - | Устарело Начиная с Ansible 2.5, рекомендуется использовать connection: network_cli.
Для получения дополнительной информации см. Руководство по сети. Объект словаря, содержащий сведения о подключении. | ||
| host - / обязательно | Указывает имя DNS-хоста или адрес для подключения к удаленному устройству по указанному транспорту. Значение параметра host используется в качестве адреса назначения для транспорта. | ||
| password - | Указывает пароль для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации сессии SSH. Если значение не указано в задаче, будет использовано значение переменной окружения ANSIBLE_NET_PASSWORD.
| ||
| port - | Значение по умолчанию: 22 | Указывает порт для подключения к удаленному устройству. | |
| ssh_keyfile - | Указывает SSH-ключ для аутентификации подключения к удаленному устройству. Это значение — путь к ключу, используемому для аутентификации сессии SSH. Если значение не указано в задаче, будет использовано значение переменной окружения ANSIBLE_NET_SSH_KEYFILE.
| ||
| timeout - | Значение по умолчанию: 10 | Указывает время ожидания в секундах для связи с сетевым устройством при подключении или отправке команд. Если время ожидания истечет до завершения операции, модуль вернет ошибку. | |
| username - | Указывает имя пользователя для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации сессии SSH. Если значение не указано в задаче, будет использовано значение переменной окружения ANSIBLE_NET_USERNAME.
| ||
| size - | Размер буфера при dest = buffered. Допустимое значение находится в диапазоне от 307200 до 125000000 байт. Значение по умолчанию 307200Размер файла при dest = file. Допустимое значение находится в диапазоне от 1 до 2097152 КБ. Значение по умолчанию 2 ГБ | ||
| state - |
| Существующее состояние конфигурации регистрации на узле. | |
| vrf - добавлено в 2.5 | Значение по умолчанию: "default" | Имя vrf при конфигурации сервера syslog, dest = host
| |
Примечания
Примечание
- Проверено на IOS XRv 6.1.2
- Дополнительную информацию об использовании Ansible для управления сетевыми устройствами см. в Руководстве по сети Ansible
- Дополнительную информацию об использовании Ansible для управления устройствами Cisco см. на странице интеграции Cisco.
Примеры
- name: configure logging for syslog server host
iosxr_logging:
dest: host
name: 10.10.10.1
level: critical
state: present
- name: add hostnameprefix configuration
iosxr_logging:
hostnameprefix: host1
state: absent
- name: add facility configuration
iosxr_logging:
facility: local1
state: present
- name: configure console logging level
iosxr_logging:
dest: console
level: debugging
state: present
- name: configure monitor logging level
iosxr_logging:
dest: monitor
level: errors
state: present
- name: configure syslog to a file
iosxr_logging:
dest: file
name: file_name
size: 2048
level: errors
state: present
- name: configure buffered logging with size
iosxr_logging:
dest: buffered
size: 5100000
- name: Configure logging using aggregate
iosxr_logging:
aggregate:
- { dest: console, level: warning }
- { dest: buffered, size: 4800000 }
- { dest: file, name: file3, size: 2048}
- { dest: host, name: host3, level: critical}
- name: Delete logging using aggregate
iosxr_logging:
aggregate:
- { dest: console, level: warning }
- { dest: buffered, size: 4800000 }
- { dest: file, name: file3, size: 2048}
- { dest: host, name: host3, level: critical}
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны здесь, а ниже приведены поля, уникальные для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| commands список | всегда (пустой список, если нет команд для отправки) | Список команд конфигурации режима для отправки на устройство Пример: ['logging 10.10.10.1 vrf default severity debugging', 'logging facility local7', 'logging hostnameprefix host1', 'logging console critical', 'logging buffered 2097153', 'logging buffered warnings', 'logging monitor errors', 'logging file log_file maxfilesize 1024 severity info'] |
| xml список добавлено в 2.5 | всегда (пустой список, если нет xml rpc для отправки) | NetConf rpc xml, отправленный на устройство с транспортом netconf
Пример: ['<config xmlns:xc="urn:ietf:params:xml:ns:netconf:base:1.0"> <syslog xmlns="http://cisco.com/ns/yang/Cisco-IOS-XR-infra-syslog-cfg"> <files> <file xc:operation="delete"> <file-name>file1</file-name> <file-log-attributes> <max-file-size>2097152</max-file-size> <severity>2</severity> </file-log-attributes> </file> </files> </syslog> </config>'] |
Статус
- Гарантии обратной совместимости интерфейса данного модуля нет. [превью]
- Этот модуль поддерживается командой Ansible по сетевым технологиям. [сеть]
Поддержка Red Hat
Дополнительная информация о поддержке данного модуля Red Hat доступна в этой статье базы знаний Red Hat.
Авторы
- Trishna Guha (@trishnaguha)
- Kedar Kekan (@kedarX)
Подсказка
Если вы обнаружите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/iosxr_logging_module.html