junos_logging - Управление журналированием на сетевых устройствах
Новое в версии 2.4.
Обзор
- Этот модуль обеспечивает декларативное управление журналированием на устройствах Juniper JUNOS.
Требования
Ниже приведены требования к хосту, на котором выполняется этот модуль.
- ncclient (>=v0.5.2)
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| active bool |
| Указывает, активна или деактивирована конфигурация | |
| aggregate | Список определений журналирования. | ||
| dest |
| Место назначения логов. | |
| facility | Настройка объекта журналирования. | ||
| files | Количество архивируемых файлов, это применимо, если значение dest равно file. Допустимое значение находится в диапазоне от 1 до 1000. | ||
| level | Настройка уровней серьезности журналирования. | ||
| name | Если значение dest равно file, это указывает имя файла, для user - имя пользователя, а для host - имя хоста, которому нужно уведомить. | ||
| provider | Устарело Начиная с Ansible 2.5, рекомендуется использовать connection: network_cli или connection: netconf. Для получения дополнительной информации см. руководство Junos OS Platform Options. Объект словаря, содержащий данные подключения. | ||
| host обязательно | Указывает имя хоста DNS или адрес для подключения к удаленному устройству по указанному транспорту. Значение параметра host используется в качестве адреса назначения для транспорта. | ||
| port | Значение по умолчанию: 22 | Указывает порт, который необходимо использовать при построении подключения к удаленному устройству. Значение порта по умолчанию — хорошо известный порт SSH 22 (для transport=cli) или порт 830 (для transport=netconf) устройства. | |
| username | Настраивает имя пользователя для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации сеанса SSH. Если значение не указано в задаче, используется значение переменной среды ANSIBLE_NET_USERNAME. | ||
| password | Указывает пароль для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации сеанса SSH. Если значение не указано в задаче, используется значение переменной среды ANSIBLE_NET_PASSWORD. | ||
| timeout | Значение по умолчанию: 10 | Указывает таймаут в секундах для связи с сетевым устройством для подключения или отправки команд. Если таймаут истекает до завершения операции, модуль выдаст ошибку. | |
| ssh_keyfile | Указывает SSH-ключ для аутентификации подключения к удаленному устройству. Это значение — путь к ключу, используемому для аутентификации сеанса SSH. Если значение не указано в задаче, используется значение переменной среды ANSIBLE_NET_SSH_KEYFILE. | ||
| rotate_frequency | Частота вращения логов в минутах, это применимо, если значение dest равно file. Допустимое значение находится в диапазоне от 1 до 59. Это управляет частотой вращения файла журнала. | ||
| size | Размер файла в архиве, это применимо, если значение dest равно file. Допустимое значение находится в диапазоне от 65536 до 1073741824 байтов. | ||
| state |
| Состояние конфигурации журналирования. | |
Примечания
Примечание
- Этот модуль требует включения службы netconf на удаленном управляемом устройстве.
- Проверено на vSRX JUNOS версии 15.1X49-D15.4, vqfx-10000 JUNOS версии 15.1X53-D60.4.
- Рекомендуемое подключение —
netconf. См. Junos OS Platform Options. - Этот модуль также работает с подключениями
localдля устаревших плейбуков. - Дополнительная информация по использованию CLI и netconf содержится в руководстве Junos OS Platform Options
- Дополнительная информация об использовании Ansible для управления сетевыми устройствами см. в руководстве Ansible Network
- Дополнительная информация об использовании Ansible для управления сетевыми устройствами Juniper см. в https://www.ansible.com/ansible-juniper.
Примеры
- name: configure console logging
junos_logging:
dest: console
facility: any
level: critical
- name: remove console logging configuration
junos_logging:
dest: console
state: absent
- name: configure file logging
junos_logging:
dest: file
name: test
facility: pfe
level: error
- name: configure logging parameter
junos_logging:
files: 30
size: 65536
rotate_frequency: 10
- name: Configure file logging using aggregate
junos_logging:
dest: file
aggregate:
- name: test-1
facility: pfe
level: critical
- name: test-2
facility: kernel
level: emergency
active: True
- name: Delete file logging using aggregate
junos_logging:
aggregate:
- { dest: file, name: test-1, facility: pfe, level: critical }
- { dest: file, name: test-2, facility: kernel, level: emergency }
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны в данном разделе, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| diff.prepared string | при изменении конфигурации и включенном параметре diff. | Разница в конфигурации до и после применения изменений. Пример: [edit system syslog] + [edit system syslog] file interactive-commands { ... } + file test { + pfe critical; + } |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантирует обратную совместимость.
Техническое обслуживание
Этот модуль помечен как сетевой, что означает, что он поддерживается командой Ansible Network. Подробности см. в разделе "Поддержка и техническое обслуживание модулей".
Список других модулей, которые также поддерживаются командой Ansible Network, см. в данном разделе.
Поддержка
Дополнительную информацию о поддержке этого модуля компанией Red Hat см. в этой статье базы знаний
Автор
- Ganesh Nalawade (@ganeshrn)
Подсказка
Если вы обнаружите какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.
© 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/junos_logging_module.html
