bigip_monitor_snmp_dca – Управляет мониторами агента сбора данных SNMP (DCA) BIG-IP
Новая в версии 2.5.
Краткое описание
- 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 словарь добавлено в 2.5 | Объект словаря, содержащий сведения о подключении. | ||
| auth_provider строка | Настраивает поставщика аутентификации для получения маркеров аутентификации от удалённого устройства. Этот параметр используется при работе с устройствами BIG-IQ. | ||
| password строка / обязательно | Пароль для учётной записи пользователя, используемой для подключения к BIG-IP. Можно опустить этот параметр, установив переменную среды F5_PASSWORD.псевдонимы: pass, pwd | ||
| server строка / обязательно | Хост BIG-IP. Можно опустить этот параметр, установив переменную среды F5_SERVER. | ||
| server_port целое число | Значение по умолчанию: 443 | Порт сервера BIG-IP. Можно опустить этот параметр, установив переменную среды F5_SERVER_PORT. | |
| ssh_keyfile путь | Указывает SSH-ключевой файл для аутентификации подключения к удалённому устройству. Этот аргумент используется только для транспортов cli. Можно опустить этот параметр, установив переменную среды ANSIBLE_NET_SSH_KEYFILE. | ||
| timeout целое число | Указывает таймаут в секундах для связи с сетевым устройством при подключении или отправке команд. Если таймаут истечёт до завершения операции, модуль вернёт ошибку. | ||
| transport строка |
| Настраивает транспортное подключение для подключения к удалённому устройству. | |
| user строка / обязательно | Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Можно опустить этот параметр, установив переменную среды F5_USER. | ||
| validate_certs булево |
| Если no, сертификаты SSL не проверяются. Используйте только на контролируемых вами сайтах, использующих самозаверяющие сертификаты.Можно опустить этот параметр, установив переменную среды F5_VALIDATE_CERTS. | |
| state строка добавлено в 2.5 |
| Когда present, гарантирует, что монитор существует.Когда absent, гарантирует удаление монитора. | |
| time_until_up целое число | Указывает количество секунд, которые нужно подождать после того, как ресурс правильно ответил на запрос монитора, прежде чем установить состояние ресурса в 'включено'. В течение этого интервала все ответы от ресурса должны быть корректными. По истечении интервала ресурс отмечается как 'включен'. Значение 0 означает, что ресурс сразу отмечается как 'включен' после получения первого правильного ответа. При создании нового монитора значение по умолчанию — 0. | ||
| timeout целое число | Указывает количество секунд, которые у целевого объекта есть на ответ на запрос монитора. При создании нового монитора значение по умолчанию — 30 секунд. Если целевой объект отвечает в установленный период времени, он считается 'включённым'. Если целевой объект не отвечает в установленный период времени, он считается 'выключенным'. Когда это значение установлено в 0 (ноль), система использует интервал от родительского монитора. Обратите внимание, что timeout и time_until_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 сохраняется на диске, обязательно включите хотя бы одну задачу, использующую модуль 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 строка | изменённое | Новый тип агента, который будет использоваться монитором. Пример: UCD |
| community строка | изменённое | Новая общность для монитора. Пример: foobar |
| cpu_coefficient вещественное число | изменённое | Новый коэффициент ЦП. Пример: 2.4 |
| cpu_threshold целое число | изменённое | Новый порог ЦП. Пример: 85 |
| description строка | изменённое | Описание монитора. Пример: Важный монитор |
| disk_coefficient вещественное число | изменённое | Новый коэффициент диска. Пример: 10.2 |
| disk_threshold целое число | изменённое | Новый порог диска. Пример: 34 |
| interval целое число | изменённое | Новый интервал для проверки монитора. Пример: 2 |
| memory_coefficient вещественное число | изменённое | Новый коэффициент памяти. Пример: 6.4 |
| memory_threshold целое число | изменённое | Новый порог памяти. Пример: 50 |
| parent строка | изменённое | Новая родительская шаблон монитора. Пример: snmp_dca |
| time_until_up целое число | изменённое | Время, в течение которого система будет считаться активной после первого успешного ответа. Пример: 2 |
| timeout целое число | изменённое | Новый таймаут, в течение которого удалённая система должна ответить на монитор. Пример: 10 |
| version строка | изменённое | Новая версия SNMP, которая будет использоваться монитором. Пример: v2c |
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [предварительная версия]
- Этот модуль поддерживается партнером Ansible. [сертифицирован]
Авторы
- 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.9/modules/bigip_monitor_snmp_dca_module.html
