Модуль f5networks.f5_modules.bigip_monitor_snmp_dca – Управляет мониторами агента сбора данных SNMP (DCA) BIG-IP

Примечание

Этот модуль входит в состав коллекции f5networks.f5_modules (версия 1.31.0).

Эта коллекция может быть уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install f5networks.f5_modules.

Для использования в плейбуке укажите: f5networks.f5_modules.bigip_monitor_snmp_dca.

Новое в f5networks.f5_modules 1.0.0

Обзор
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

BIG-IP имеет агент сбора данных SNMP (DCA), который может запросить удалённые агенты SNMP различных типов, включая агент UC Davis (UCD) и агент Windows 2000 Server (WIN2000).

Параметры

Параметр	Комментарии
agent_type string	Указывает агент SNMP, работающий на контролируемом сервере. При создании нового монитора значение по умолчанию — `UCD` (UC-Davis). Варианты: `"UCD"` `"WIN2000"` `"GENERIC"`
community string	Указывает имя сообщества, которое система должна использовать для аутентификации с хост-сервером через SNMP. При создании нового монитора значение по умолчанию — `public`. Это значение чувствительно к регистру.
cpu_coefficient string	Указывает коэффициент, который система использует для вычисления веса порогового значения ЦП в алгоритме динамического балансировки нагрузки по соотношению. При создании нового монитора значение по умолчанию — `1.5`.
cpu_threshold integer	Указывает максимально допустимое использование ЦП на целевом сервере. При создании нового монитора значение по умолчанию — `80` процентов.
description string	Указывает описательный текст, идентифицирующий монитор.
disk_coefficient string	Указывает коэффициент, который система использует для вычисления веса порогового значения диска в алгоритме динамического балансировки нагрузки по соотношению. При создании нового монитора значение по умолчанию — `2.0`.
disk_threshold integer	Указывает максимально допустимое использование диска на целевом сервере. При создании нового монитора значение по умолчанию — `90` процентов.
interval integer	Указывает частоту, в секундах, с которой система выполняет проверку монитора, когда ресурс не работает или состояние ресурса неизвестно. При создании нового монитора значение по умолчанию — `10`.
memory_coefficient string	Указывает коэффициент, который система использует для вычисления веса порогового значения памяти в алгоритме динамического балансировки нагрузки по соотношению. При создании нового монитора значение по умолчанию — `1.0`.
memory_threshold integer	Указывает максимально допустимое использование памяти на целевом сервере. При создании нового монитора значение по умолчанию — `70` процентов.
name string / required	Имя монитора.
parent string	Родительский шаблон этого шаблона монитора. После установки это значение нельзя изменить. По умолчанию это значение — родительский `snmp_dca` в разделе `Common`. По умолчанию: `"/Common/snmp_dca"`
partition string	Раздел устройства для управления ресурсами. По умолчанию: `"Common"`
provider dictionary добавлено в f5networks.f5_modules 1.0.0	Объект dict, содержащий данные подключения.
auth_provider string	Настраивает поставщика авторизации для получения маркеров аутентификации от удаленного устройства. Этот параметр действительно используется при работе с устройствами BIG-IQ.
no_f5_teem boolean	Если `yes`, данные телеметрии TEEM не отправляются в F5. Вы можете опустить этот параметр, установив переменную среды `F5_TELEMETRY_OFF`. Прежде использовавшаяся переменная `F5_TEEM` устарела, поскольку её название было запутанным. Варианты: `false` ← (по умолчанию) `true`
password псевдонимы: pass, pwd string / required	Пароль для учетной записи пользователя, используемой для подключения к BIG-IP или BIG-IQ. Вы можете опустить этот параметр, установив переменную среды `F5_PASSWORD`.
server string / required	Хост BIG-IP или хост BIG-IQ. Вы можете опустить этот параметр, установив переменную среды `F5_SERVER`.
server_port integer	Порт сервера BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_SERVER_PORT`. По умолчанию: `443`

timeout целое число	Указывает время ожидания в секундах для связи с сетевым устройством при подключении или отправке команд. Если время ожидания истечёт до завершения операции, модуль вернёт ошибку.
transport строка	Настраивает транспортное соединение, используемое при подключении к удалённому устройству. Варианты: `"rest"` ← (по умолчанию)
user строка / обязательно	Имя пользователя для подключения к BIG-IP или BIG-IQ. Этот пользователь должен иметь административные права на устройстве. Этот параметр можно опустить, установив переменную окружения `F5_USER`.
validate_certs логическое значение	Если `no`, сертификаты SSL не проверяются. Используйте только на контролируемых вами сайтах, использующих самозаверяющие сертификаты. Этот параметр можно опустить, установив переменную окружения `F5_VALIDATE_CERTS`. Варианты: `false` `true` ← (по умолчанию)
state строка	При значении `present`, гарантирует существование монитора. При значении `absent`, гарантирует удаление монитора. Варианты: `"present"` ← (по умолчанию) `"absent"`
time_until_up целое число	Указывает количество секунд, которые нужно ждать после правильного ответа ресурса на мониторинг, прежде чем установить статус ресурса как «включен». Во время этого интервала все ответы от ресурса должны быть корректными. По истечении интервала ресурс помечается как «включен». Значение 0 означает, что ресурс помечается как «включен» сразу после получения первого правильного ответа. При создании нового монитора значение по умолчанию равно `0`.
timeout целое число	Указывает количество секунд, в течение которых целевой объект должен ответить на запрос мониторинга. При создании нового монитора значение по умолчанию равно `30` секундам. Если целевой объект отвечает в установленный период времени, он считается «включённым». Если целевой объект не отвечает в установленный период времени, он считается «выключенным». Если это значение равно 0 (ноль), система использует интервал от родительского монитора. Обратите внимание, что `timeout` и `time_until_up` комбинируются для управления временем, когда ресурс устанавливается в состояние «включен».
version строка	Указывает версию SNMP, используемую хост-сервером. При создании нового монитора значение по умолчанию равно `v1`. При значении `v1`, указывает, что хост-сервер использует SNMP версию 1. При значении `v2c`, указывает, что хост-сервер использует SNMP версию 2c. Варианты: `"v1"` `"v2c"`

Примечания

Примечание

Требуется версия ПО BIG-IP ≥ 12
Этот модуль не поддерживает параметр variables, так как он неисправен в REST API и не работает должным образом в tmsh; например, невозможно удалить параметры, определённые пользователем. Поэтому его нельзя автоматически настроить.
Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
Требуется версия ПО BIG-IP ≥ 12.
Модули F5 изменяют только текущую конфигурацию продукта F5. Чтобы убедиться, что конфигурация, специфичная для BIG-IP, сохраняется на диске, включите хотя бы одну задачу, использующую модуль f5networks.f5_modules.bigip_config для сохранения текущей конфигурации. Обратитесь к документации модуля для правильного использования модуля для сохранения текущей конфигурации.

Примеры

- name: Create SNMP DCS monitor
  bigip_monitor_snmp_dca:
    name: my_monitor
    state: present
    provider:
      server: lb.mydomain.com
      user: admin
      password: secret
  delegate_to: localhost

- name: Remove TCP Echo Monitor
  bigip_monitor_snmp_dca:
    name: my_monitor
    state: absent
    provider:
      server: lb.mydomain.com
      user: admin
      password: secret
  delegate_to: localhost

Возвращаемые значения

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

Ключ	Описание
agent_type string	Новый тип агента, который будет использоваться монитором. Возвращено: changed Пример: `"UCD"`
community string	Новое сообщество для монитора. Возвращено: changed Пример: `"foobar"`
cpu_coefficient float	Новый коэффициент CPU. Возвращено: changed Пример: `2.4`
cpu_threshold integer	Новый порог CPU. Возвращено: changed Пример: `85`
description string	Описание монитора. Возвращено: changed Пример: `"Important Monitor"`
disk_coefficient float	Новый коэффициент диска. Возвращено: changed Пример: `10.2`
disk_threshold integer	Новый порог диска. Возвращено: changed Пример: `34`
interval integer	Новый интервал для выполнения проверки монитора. Возвращено: changed Пример: `2`
memory_coefficient float	Новый коэффициент памяти. Возвращено: changed Пример: `6.4`
memory_threshold integer	Новый порог памяти. Возвращено: changed Пример: `50`
parent string	Новый родительский шаблон монитора. Возвращено: changed Пример: `"snmp_dca"`
time_until_up integer	Новое время, по истечении которого система будет помечена как активная после первого успешного ответа. Возвращено: changed Пример: `2`
timeout integer	Новое время ожидания, в течение которого удаленная система должна ответить на запрос монитора. Возвращено: changed Пример: `10`
version string	Новая версия SNMP, которая будет использоваться монитором. Возвращено: changed Пример: `"v2c"`

Авторы

Tim Rupp (@caphrim007)
Wojciech Wypior (@wojtek0806)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/f5networks/f5_modules/bigip_monitor_snmp_dca_module.html