vyos_logging — Управление журналированием на сетевых устройствах
Введено в версии 2.4.
Описание
- Этот модуль обеспечивает декларативное управление журналированием на устройствах Vyatta Vyos.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| aggregate | Список определений журналирования. |
||
| dest |
|
Место назначения журналов. |
|
| facility | Установить уровень журналирования. |
||
| level | Установить уровни серьезности журналирования. |
||
| name | Если значение dest равно file, оно указывает имя файла; для user — имя пользователя, а для host — имя хоста, которому нужно сообщить. |
||
| provider | Устарело Начиная с Ansible 2.5, рекомендуется использовать connection: network_cli.Для получения дополнительной информации, см. Руководство по сети. Объект словаря, содержащий сведения о соединении. |
||
| host обязательно |
Указывает имя хоста DNS или адрес для подключения к удаленному устройству по указанному протоколу. Значение параметра host используется в качестве адреса назначения для протокола. |
||
| port | По умолчанию: 22 |
Указывает порт, который нужно использовать при построении соединения с удаленным устройством. |
|
| username | Настраивает имя пользователя для аутентификации соединения с удаленным устройством. Это значение используется для аутентификации сеанса SSH. Если значение не указано в задаче, используется значение переменной окружения ANSIBLE_NET_USERNAME. |
||
| password | Указывает пароль для аутентификации соединения с удаленным устройством. Это значение используется для аутентификации сеанса SSH. Если значение не указано в задаче, используется значение переменной окружения ANSIBLE_NET_PASSWORD. |
||
| timeout | По умолчанию: 10 |
Указывает таймаут в секундах для связи с сетевым устройством для подключения или отправки команд. Если таймаут истекает до завершения операции, модуль сообщит об ошибке. |
|
| ssh_keyfile | Указывает SSH-ключ для аутентификации соединения с удаленным устройством. Это значение — путь к ключу, используемому для аутентификации сеанса SSH. Если значение не указано в задаче, используется значение переменной окружения ANSIBLE_NET_SSH_KEYFILE. |
||
| state |
|
Состояние конфигурации журналирования. |
|
Примечания
Примечание
- Тестировался на VYOS 1.1.7
- Дополнительную информацию об использовании Ansible для управления сетевыми устройствами см. в Руководстве по Ansible для работы с сетью
Примеры
- name: configure console logging
vyos_logging:
dest: console
facility: all
level: crit
- name: remove console logging configuration
vyos_logging:
dest: console
state: absent
- name: configure file logging
vyos_logging:
dest: file
name: test
facility: local3
level: err
- name: Add logging aggregate
vyos_logging:
aggregate:
- { dest: file, name: test1, facility: all, level: info }
- { dest: file, name: test2, facility: news, level: debug }
state: present
- name: Remove logging aggregate
vyos_logging:
aggregate:
- { dest: console, facility: all, level: info }
- { dest: console, facility: daemon, level: warning }
- { dest: file, name: test2, facility: news, level: debug }
state: absent
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| commands список |
всегда | Список команд конфигурации в режиме конфигурации для отправки на устройство Пример: ['set system syslog global facility all level notice'] |
Статус
Этот модуль помечен как preview, что означает, что его интерфейс не гарантируется как обратная совместимость.
Техническое обслуживание
Этот модуль помечен как сетевой, что означает, что он поддерживается командой Ansible по работе с сетями. Подробнее о поддержке модулей см. в разделе поддержки модулей.
Список других модулей, которые также поддерживаются командой Ansible по работе с сетями, см. здесь.
Поддержка
Дополнительную информацию о поддержке этого модуля компанией Red Hat см. в этой статье базы знаний
Автор
- Trishna Guha (@trishnaguha)
Подсказка
Если вы заметили какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/vyos_logging_module.html
