Spec-Zone.ru › Ansible 2.11

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

Примечание

Этот плагин входит в коллекцию f5networks.f5_modules (версия 1.7.1).

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

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

Новое в версии 1.0.0: of f5networks.f5_modules

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

Обзор

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

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
agent_type
строка
    Варианты:
  • UCD
  • WIN2000
  • GENERIC
Указывает агент SNMP, работающий на сервере, который отслеживается. При создании нового монитора значение по умолчанию — UCD (UC-Davis).
community
строка
Указывает имя сообщества, которое система должна использовать для проверки подлинности с хост-сервером через SNMP. Значение по умолчанию при создании нового монитора — public. Это значение чувствительно к регистру.
cpu_coefficient
строка
Указывает коэффициент, который система использует для расчёта веса порога CPU в алгоритме динамического балансирования нагрузки с коэффициентом. По умолчанию при создании нового монитора — 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 of f5networks.f5_modules
Объект словаря, содержащий сведения о подключении.
auth_provider
строка
Настраивает поставщика аутентификации для получения токенов аутентификации с удалённого устройства.
Этот параметр используется при работе с устройствами BIG-IQ.
no_f5_teem
логический
    Варианты:
  • no
  • yes
Если 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
строка
    Варианты:
  • rest ←
Настраивает транспортное соединение для использования при подключении к удалённому устройству.
user
строка / обязательно
Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные права на устройстве.
Вы можете опустить этот параметр, установив переменную окружения F5_USER.
validate_certs
логический
    Варианты:
  • no
  • yes ←
Если no, сертификаты SSL не проверяются. Используйте только на сайтах, контролируемых вами, использующих самозаверяющие сертификаты.
Вы можете опустить этот параметр, установив переменную окружения F5_VALIDATE_CERTS.
state
строка
    Варианты:
  • present ←
  • absent
Когда present, гарантирует, что монитор существует.
Когда absent, гарантирует, что монитор удалён.
time_until_up
целое число
Указывает количество секунд, которые нужно подождать после того, как ресурс впервые правильно отреагировал на монитор, прежде чем установить ресурс в состояние 'up'. В течение этого интервала все ответы от ресурса должны быть правильными. По истечении интервала ресурс помечается как 'up'. Значение 0 означает, что ресурс помечается как 'up' сразу после получения первого правильного ответа. По умолчанию при создании нового монитора — 0.
timeout
целое число
Указывает количество секунд, которые у цели есть для ответа на запрос монитора. По умолчанию при создании нового монитора — 30 секунды. Если цель отвечает в заданный период времени, она считается 'up'. Если цель не отвечает в заданный период времени, она считается 'down'. Когда это значение установлено в 0 (ноль), система использует интервал из родительского монитора. Обратите внимание, что timeout и time_until_up объединяются для управления тем, когда ресурс устанавливается в 'up'.
version
строка
    Варианты:
  • v1
  • v2c
Указывает версию 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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/f5networks/f5_modules/bigip_monitor_snmp_dca_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API