junos_logging - Управление журналированием на сетевых устройствах Juniper

Новое в версии 2.4.

Обзор
- Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус
- Поддержка
- Автор

Обзор

Этот модуль предоставляет декларативное управление журналированием на устройствах Juniper JUNOS.

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

ncclient (>=v0.5.2)

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
active		Варианты: да ← нет Значение по умолчанию: да	Указывает, активна или деактивирована конфигурация
aggregate			Список определений журналирования.
dest		Варианты: консоль хост файл пользователь	Место назначения журналов.
facility			Установить уровень объекта журналирования.
files			Количество архивируемых файлов; это применимо, если значение dest равно `file`. Допустимое значение находится в диапазоне от 1 до 1000.
level			Установить уровни серьезности журналирования.
name			Если значение `dest` равно файл, это указывает имя файла; для пользователя — имя пользователя, а для хоста — имя хоста, которому необходимо направить уведомление.
provider		Значение по умолчанию: Нет	Устарело Начиная с Ansible 2.5, рекомендуем использовать `connection: network_cli` или `connection: netconf`. Дополнительную информацию можно найти в руководстве Junos OS Platform Options. Объект словаря, содержащий данные подключения.
	username		Настраивает имя пользователя для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации сессии SSH. Если значение не указано в задаче, используется значение переменной среды `ANSIBLE_NET_USERNAME`.
	host обязательно		Указывает имя DNS-хоста или адрес для подключения к удаленному устройству через указанный транспорт. Значение хоста используется в качестве адреса назначения для транспорта.
	ssh_keyfile		Указывает SSH-ключ для аутентификации подключения к удаленному устройству. Это путь к ключу, используемому для аутентификации сессии SSH. Если значение не указано в задаче, используется значение переменной среды `ANSIBLE_NET_SSH_KEYFILE`.
	timeout	Значение по умолчанию: 10	Указывает тайм-аут в секундах для связи с сетевым устройством при подключении или отправке команд. Если тайм-аут истекает до завершения операции, модуль возвратит ошибку.
	password	Значение по умолчанию: Нет	Указывает пароль для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации сессии SSH. Если значение не указано в задаче, используется значение переменной среды `ANSIBLE_NET_PASSWORD`.
	port	Значение по умолчанию: 22	Указывает порт для подключения к удаленному устройству. По умолчанию используется стандартный порт SSH 22 (для `transport=cli`) или порт 830 (для `transport=netconf`) устройства.
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 для устаревших playbooks.
Дополнительную информацию об использовании CLI и netconf см. в руководстве Junos OS Platform Options
Дополнительную информацию об использовании Ansible для управления сетевыми устройствами см. в руководстве Ansible по сетям
Дополнительную информацию об использовании 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 строка	при изменении конфигурации и включении опции diff.	Разница в конфигурации до и после применения изменений. Пример: [edit system syslog] + [edit system syslog] file interactive-commands { ... } + file test { + pfe critical; + }

Статус

Этот модуль помечен как превью, что означает отсутствие гарантии обратной совместимости интерфейса.

Поддержка

Дополнительную информацию о поддержке этого модуля 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.5/modules/junos_logging_module.html