f5networks.f5_modules.bigip_monitor_snmp_dca – Управляет мониторами агента сбора данных SNMP (DCA) BIG-IP
Примечание
Этот плагин входит в коллекцию f5networks.f5_modules (версия 1.6.0).
Для его установки используйте: ansible-galaxy collection install f5networks.f5_modules.
Для использования в playbook, укажите: f5networks.f5_modules.bigip_monitor_snmp_dca.
Новое в версии 1.0.0: модуля f5networks.f5_modules
Обзор
- BIG-IP имеет агента сбора данных SNMP (DCA), который может запросить удаленных агентов SNMP различных типов, включая агента UC Davis (UCD) и агента Windows 2000 Server (WIN2000).
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| agent_type строка |
| Указывает агента SNMP, работающего на сервере, который контролируется. При создании нового монитора значение по умолчанию — UCD (UC-Davis). | |
| community строка | Указывает имя сообщества, которое система должна использовать для аутентификации с сервером-хостом через SNMP. По умолчанию при создании нового монитора — public. Это значение чувствительно к регистру. | ||
| cpu_coefficient строка | Указывает коэффициент, используемый системой для расчета веса порога ЦП в алгоритме динамического балансирования нагрузки с соотношением. По умолчанию при создании нового монитора — 1.5. | ||
| cpu_threshold целое число | Указывает максимальное допустимое использование ЦП на целевом сервере. По умолчанию при создании нового монитора — 80 процентов. | ||
| description строка | Указывает описательный текст, идентифицирующий монитор. | ||
| disk_coefficient строка | Указывает коэффициент, используемый системой для расчета веса порога диска в алгоритме динамического балансирования нагрузки с соотношением. По умолчанию при создании нового монитора — 2.0. | ||
| disk_threshold целое число | Указывает максимальное допустимое использование диска на целевом сервере. По умолчанию при создании нового монитора — 90 процентов. | ||
| interval целое число | Указывает частоту, в секундах, с которой система выполняет проверку мониторинга, когда ресурс недоступен или статус ресурса неизвестен. По умолчанию при создании нового монитора — 10. | ||
| memory_coefficient строка | Указывает коэффициент, используемый системой для расчета веса порога памяти в алгоритме динамического балансирования нагрузки с соотношением. По умолчанию при создании нового монитора — 1.0. | ||
| memory_threshold целое число | Указывает максимальное допустимое использование памяти на целевом сервере. По умолчанию при создании нового монитора — 70 процентов. | ||
| name строка / обязательно | Имя монитора. | ||
| parent строка | По умолчанию: "/Common/snmp_dca" | Родительская шаблон монитора. После установки этого значения его нельзя изменить. По умолчанию — родительский элемент snmp_dca на разбиении Common. | |
| partition строка | По умолчанию: "Common" | Разбиение устройства для управления ресурсами. | |
| provider словарь добавлен в 1.0.0 версии f5networks.f5_modules | Объект словаря, содержащий сведения о подключении. | ||
| auth_provider строка | Настраивает поставщика аутентификации для получения маркеров аутентификации от удаленного устройства. Этот параметр действительно используется при работе с устройствами BIG-IQ. | ||
| no_f5_teem булево |
| Если yes, данные телеметрии TEEM не отправляются на F5.Этот параметр можно опустить, задав переменную среды F5_TEEM. | |
| password строка / обязательно | Пароль учетной записи пользователя, используемой для подключения к BIG-IP. Этот параметр можно опустить, задав переменную среды F5_PASSWORD.псевдонимы: pass, pwd | ||
| server строка / обязательно | Хост BIG-IP. Этот параметр можно опустить, задав переменную среды F5_SERVER. | ||
| server_port целое число | По умолчанию: 443 | Порт сервера BIG-IP. Этот параметр можно опустить, задав переменную среды F5_SERVER_PORT. | |
| timeout целое число | Указывает таймаут в секундах для связи с сетевым устройством для подключения или отправки команд. Если таймаут истекает до завершения операции, модуль выдаст ошибку. | ||
| transport строка |
| Настраивает транспортное подключение для использования при подключении к удаленному устройству. | |
| user строка / обязательно | Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные права на устройстве. Этот параметр можно опустить, задав переменную среды F5_USER. | ||
| validate_certs булево |
| Если no, сертификаты SSL не проверяются. Используйте только на сайтах, контролируемых лично, которые используют самоподписанные сертификаты.Этот параметр можно опустить, задав переменную среды F5_VALIDATE_CERTS. | |
| state строка |
| Если present, гарантирует, что монитор существует.Если absent, гарантирует удаление монитора. | |
| time_until_up целое число | Указывает количество секунд, которые нужно подождать после того, как ресурс правильно ответит на запрос монитора, прежде чем установить ресурс в 'up'. В течение этого интервала все ответы от ресурса должны быть корректными. По истечении интервала ресурс помечается как 'up'. Значение 0 означает, что ресурс помечается как 'up' сразу после получения первого правильного ответа. При создании нового монитора значение по умолчанию — 0. | ||
| timeout целое число | Указывает количество секунд, в течение которых цель должна ответить на запрос монитора. По умолчанию при создании нового монитора — 30 секунд. Если цель отвечает в установленный период времени, она считается 'up'. Если цель не отвечает в течение установленного периода времени, она считается 'down'. При установке значения 0 (ноль), система использует интервал от родительского монитора. Обратите внимание, что timeout и time_until_up совместно управляют моментом установки ресурса в состояние 'up'. | ||
| version строка |
| Указывает версию SNMP, используемую сервером-хостом. По умолчанию при создании нового монитора — v1.. При v1, указывает, что сервер-хост использует версию SNMP 1. При v2c, указывает, что сервер-хост использует версию SNMP 2c. | |
Примечания
Примечание
- Требуется версия ПО 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 | изменённое | Новый тип агента, который будет использоваться монитором. Пример: UCD |
| community string | изменённое | Новая община для монитора. Пример: foobar |
| cpu_coefficient float | изменённое | Новый коэффициент процессора. Пример: 2.4 |
| cpu_threshold integer | изменённое | Новый порог процессора. Пример: 85 |
| description string | изменённое | Описание монитора. Пример: Важный монитор |
| disk_coefficient float | изменённое | Новый коэффициент диска. Пример: 10.2 |
| disk_threshold integer | изменённое | Новый порог диска. Пример: 34 |
| interval integer | изменённое | Новый интервал, через который выполняется проверка монитора. Пример: 2 |
| memory_coefficient float | изменённое | Новый коэффициент памяти. Пример: 6.4 |
| memory_threshold integer | изменённое | Новый порог памяти. Пример: 50 |
| parent string | изменённое | Новая родительская шаблон монитора. Пример: snmp_dca |
| time_until_up integer | изменённое | Новое время, в течение которого система будет считаться активной после первого успешного ответа. Пример: 2 |
| timeout integer | изменённое | Новый тайм-аут, в течение которого удалённая система должна ответить монитору. Пример: 10 |
| version string | изменённое | Новая версия SNMP, которая будет использоваться монитором. Пример: v2c |
Авторы
- Tim Rupp (@caphrim007)
- Wojciech Wypior (@wojtek0806)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/f5networks/f5_modules/bigip_monitor_snmp_dca_module.html
