vmware_host_snmp – Настройка SNMP на системе ESXi хоста

Новая версия 2.8.

Описание
Требования
Параметры
Примечания
Примеры
Значения возврата
Статус

Описание

Этот модуль может быть использован для настройки встроенного агента SNMP на хосте ESXi.

Требования

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

python >= 2.6
PyVmomi

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
community список		Список строк сообщества SNMP.
hostname строка		Имя хоста или IP-адрес сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_HOST`. Поддержка переменных окружения добавлена в Ansible 2.6.
hw_source строка	Варианты: indications ← sensors	Источник аппаратных событий из датчиков IPMI или CIM-указаний. Встроенный агент SNMP получает аппаратные события либо от датчиков IPMI `sensors` либо от CIM-указаний `indications`.
log_level строка	Варианты: debug info ← warning error	Уровень ведения журнала Syslog.
password строка		Пароль сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PASSWORD`. Поддержка переменных окружения добавлена в Ansible 2.6. псевдонимы: pass, pwd
port целое число добавлено в 2.5	По умолчанию: 443	Номер порта сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PORT`. Поддержка переменных окружения добавлена в Ansible 2.6.
send_trap булево значение	Варианты: нет ← да	Отправить тестовый запрос для проверки конфигурации.
snmp_port целое число	По умолчанию: 161	Порт, используемый агентом SNMP.
state строка	Варианты: отключено ← включено сброс	Включить, отключить или сбросить агент SNMP.
trap_filter список		Список oids ловушек, которые не должны отправляться агентом, например [ 1.3.6.1.4.1.6876.4.1.1.0, 1.3.6.1.4.1.6876.4.1.1.1 ] Используйте значение `reset`, чтобы очистить настройки.
trap_targets -	По умолчанию: []	Список целевых адресов ловушек. Для каждого целевого адреса ловушки необходимо использовать `hostname`, `port`, и `community`.
username строка		Имя пользователя сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_USER`. Поддержка переменных окружения добавлена в Ansible 2.6. псевдонимы: admin, user
validate_certs булево значение	Варианты: нет да ←	Разрешает подключение, когда сертификаты SSL недействительны. Установите значение `false` , когда сертификаты ненадёжны. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_VALIDATE_CERTS`. Поддержка переменных окружения добавлена в Ansible 2.6. Если установлено значение `yes`, убедитесь, что на данном компьютере установлен Python >= 2.7.9.

Примечания

Примечание

Тестировалось на vSphere 6.5
Необходимо сбросить агент (до заводских настроек), если требуется очистить все строки сообщества, целевые адреса ловушек или фильтры
Конфигурация SNMP v3 еще не реализована

Примеры

- name: Enable and configure SNMP community
  vmware_host_snmp:
    hostname: '{{ esxi_hostname }}'
    username: '{{ esxi_username }}'
    password: '{{ esxi_password }}'
    community: [ test ]
    state: enabled
    validate_certs: no
  delegate_to: localhost

- name: Configure SNMP traps and filters
  vmware_host_snmp:
    hostname: '{{ esxi_hostname }}'
    username: '{{ esxi_username }}'
    password: '{{ esxi_password }}'
    community: [ test ]
    trap_targets:
      - hostname: 192.168.1.100
        port: 162
        community: test123
      - hostname: 192.168.1.101
        port: 162
        community: test1234
    trap_filter:
      - 1.3.6.1.4.1.6876.4.1.1.0
      - 1.3.6.1.4.1.6876.4.1.1.1
    state: enabled
    validate_certs: no
  delegate_to: localhost

- name: Disable SNMP
  vmware_host_snmp:
    hostname: '{{ esxi_hostname }}'
    username: '{{ esxi_username }}'
    password: '{{ esxi_password }}'
    state: disabled
    validate_certs: no
  delegate_to: localhost

Значения возврата

Общие значения возврата описаны здесь, следующие поля уникальны для этого модуля:

Ключ	Возвращаемое значение	Описание
results словарь	всегда	метаданные о конфигурации SNMP системы хоста Пример: {'esxi01': {'изменён': False, 'community': ['test'], 'hw_source': 'indications', 'сообщение': 'SNMP уже правильно настроен', 'порт': 161, 'состояние': 'включено', 'trap_targets': []}}

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

Christian Kotte (@ckotte)

Подсказка

Если вы обнаружите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/vmware_host_snmp_module.html