Модуль community.network.netscaler_lb_monitor – Управление балансировщиками нагрузки
Примечание
Этот модуль входит в коллекцию community.network (версия 5.0.3).
Эта коллекция может быть уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install community.network. Для использования этого модуля необходимы дополнительные требования. Подробности см. в разделе Требования.
Для использования в книге задач укажите: community.network.netscaler_lb_monitor.
Обзор
- Управление балансировщиками нагрузки.
- Этот модуль предназначен для выполнения либо на узле управления Ansible, либо на бастионе (шлюзе) с доступом к фактическому экземпляру Netscaler.
Псевдонимы: network.netscaler.netscaler_lb_monitor
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- nitro python sdk
Параметры
Параметр | Комментарии |
|---|---|
acctapplicationid string | Список пар значений атрибута Acct-Application-Id (AVP) для сообщения Capabilities-Exchange-Request (CER), используемого для мониторинга серверов Diameter. В сообщении мониторинга поддерживается максимум восемь таких пар AVP. Минимальное значение = Максимальное значение = |
action string | Действие, выполняемое, когда ответ на встроенный монитор (монитор типа Доступные настройки работают следующим образом: * * * Варианты:
|
alertretries string | Количество последовательных сбоев зондирования, после которых устройство генерирует SNMP-ловушку monProbeFailed. Минимальное значение = Максимальное значение = |
application string | Имя приложения, используемого для определения состояния службы. Применимо к мониторам типа Минимальная длина = 1 |
attribute string | Атрибут для оценки, когда LDAP-сервер отвечает на запрос. Успех или неудача зондирования мониторинга зависит от того, существует ли атрибут в ответе. Необязательно. Минимальная длина = 1 |
authapplicationid string | Список пар значений атрибута Auth-Application-Id (AVP) для сообщения Capabilities-Exchange-Request (CER), используемого для мониторинга серверов Diameter. В сообщении мониторинга CER поддерживается максимум восемь таких пар AVP. Минимальное значение = Максимальное значение = |
basedn string | Базовое различающееся имя службы LDAP, с которого LDAP-сервер может начать поиск атрибутов в запросе мониторинга. Требуется для мониторинга службы Минимальная длина = 1 |
binddn string | Различающееся имя, с помощью которого монитор LDAP может выполнить операцию Bind на LDAP-сервере. Необязательно. Применимо к мониторам Минимальная длина = 1 |
customheaders string | Строка пользовательского заголовка для включения в зонды мониторинга. |
database string | Имя базы данных для подключения во время аутентификации. Минимальная длина = 1 |
destip string | IP-адрес службы, на которую следует отправлять зонды. Если параметр установлен в 0, IP-адрес сервера, к которому привязан монитор, считается целевым IP-адресом. |
destport string | TCP- или UDP-порт, на который следует отправлять зонд. Если параметр установлен в 0, номер порта службы, к которой привязан монитор, считается целевым портом. Однако для монитора типа |
deviation string | Значение времени, добавляемое к вычисленному среднему времени ответа в динамическом мониторинге времени ответа (DRTM). Когда указано отклонение, устройство узнает среднее время ответа привязанных служб и добавляет отклонение к среднему. Затем окончательное значение постоянно корректируется, чтобы учитывать изменения времени отклика во времени. Указывается в миллисекундах, секундах или минутах. Минимальное значение = Максимальное значение = |
dispatcherip string | IP-адрес диспетчера, на который следует отправлять зонд. |
dispatcherport string | Номер порта, на котором диспетчер прослушивает зонд мониторинга. |
domain string | Домен, в котором находятся серверы XenDesktop Desktop Delivery Controller (DDC) или серверы веб-интерфейса. Требуется мониторами |
downtime string | Продолжительность времени ожидания перед проверкой службы, помеченной как НЕРАБОЧАЯ. Выражается в миллисекундах, секундах или минутах. Минимальное значение = Максимальное значение = |
evalrule string | Выражение синтаксиса по умолчанию, которое оценивает ответ сервера базы данных на запрос мониторинга MYSQL-ECV или MSSQL-ECV. Должно давать логический результат. Результат определяет состояние сервера. Если выражение возвращает TRUE, зондирование завершается успешно. Например, если вы хотите, чтобы устройство оценивало сообщение об ошибке для определения состояния сервера, используйте правило |
failureretries string | Количество попыток, которые должны завершиться неудачей из числа, указанного для параметра «Попытки», чтобы служба была помечена как НЕРАБОЧАЯ. Например, если параметр «Попытки» установлен в 10, а параметр «Сбои при повторных попытках» — в 6, то из десяти отправленных зондов по крайней мере шесть зондов должны завершиться неудачей, чтобы служба была помечена как НЕРАБОЧАЯ. Значение по умолчанию 0 означает, что все повторные попытки должны завершиться неудачей, чтобы служба была помечена как НЕРАБОЧАЯ. Минимальное значение = Максимальное значение = |
filename string | Имя файла на FTP-сервере. Устройство отслеживает FTP-службу, периодически проверяя наличие файла на сервере. Применимо к мониторам Минимальная длина = 1 |
filter string | Критерии фильтрации для запроса LDAP. Необязательно. Минимальная длина = 1 |
firmwarerevision string | Значение Firmware-Revision для сообщения Capabilities-Exchange-Request (CER), используемого для мониторинга серверов Diameter. |
group string | Имя доступной в службе NNTP новостной группы, которую необходимо отслеживать. Устройство периодически формирует запрос NNTP для имени новостной группы и оценивает ответ. Если новостная группа найдена на сервере, служба помечается как РАБОЧАЯ. Если новостная группа не существует или поиск завершается неудачей, служба помечается как НЕРАБОЧАЯ. Применимо к мониторам NNTP. Минимальная длина = 1 |
hostipaddress string | Значение Host-IP-Address для сообщения Capabilities-Exchange-Request (CER), используемого для мониторинга серверов Diameter. Если Host-IP-Address не указан, устройство вставляет сопоставленный IP-адрес (MIP) или IP-адрес подсети (SNIP), с которого отправляется запрос CER (контрольный зонд). Минимальная длина = 1 |
hostname string | Имя хоста в формате FQDN (Пример: Минимальная длина = 1 |
httprequest string | HTTP-запрос для отправки на сервер (например, |
inbandsecurityid string | Inband-Security-Id для сообщения Capabilities-Exchange-Request (CER), используемого для мониторинга серверов Diameter. Варианты:
|
interval string | Временной интервал между двумя последовательными зондами. Должно быть больше, чем значение тайм-аута ответа. Минимальное значение = Максимальное значение = |
ipaddress string | Набор IP-адресов, ожидаемых в ответе мониторинга от DNS-сервера, если тип записи — A или AAAA. Применимо к мониторам Минимальная длина = 1 |
iptunnel boolean | Отправить контрольный зонд в службу через IP-туннель. Необходимо указать целевой IP-адрес. Варианты:
|
kcdaccount string | Учетная запись KCD, используемая монитором Минимальная длина = 1 Максимальная длина = 32 |
lasversion string | Номер версии агента входа Citrix Advanced Access Control Logon Agent. Требуется монитору |
logonpointname string | Имя точки входа, настроенной для программного обеспечения Citrix Access Gateway Advanced Access Control. Требуется, если вы хотите отслеживать связанную страницу входа или агент входа. Применимо к мониторам |
lrtm string | Вычислить минимальное время отклика для связанных служб. Если этот параметр не включен, устройство не узнает время отклика связанных служб. Также используется для балансировки нагрузки LRTM. Варианты:
|
maxforwards string | Максимальное количество переходов, которые может совершить запрос SIP, используемый для мониторинга, чтобы добраться до сервера. Применимо только к мониторам типа Минимальное значение = Максимальное значение = |
metrictable string | Таблица метрик, к которой необходимо привязать метрики. Минимальная длина = 1 Максимальная длина = 99 |
monitorname string | Имя для монитора. Должно начинаться с буквенно-цифрового символа ASCII или символа подчеркивания Минимальная длина = 1 |
mssqlprotocolversion string | Версия сервера MSSQL, который подлежит мониторингу. Варианты:
|
netprofile string | Имя сетевого профиля. Минимальная длина = 1 Максимальная длина = 127 |
nitro_pass string / обязательно | Пароль для аутентификации на узле netscaler. |
nitro_protocol string | Протокол для доступа к объектам API nitro. Варианты:
|
nitro_timeout float | Время в секундах до сбрасывания таймаута при установлении нового сеанса с Netscaler По умолчанию: |
nitro_user string / обязательно | Имя пользователя для аутентификации на узле netscaler. |
nsip string / обязательно | IP-адрес устройства netscaler, на котором будут выполняться вызовы API nitro. Порт можно указать с использованием двоеточия (:). Например, 192.168.1.1:555. |
oraclesid string | Имя идентификатора службы, используемого для подключения к базе данных Oracle во время аутентификации. Минимальная длина = 1 |
originhost string | Значение Origin-Host для сообщения Capabilities-Exchange-Request (CER) для мониторинга серверов Diameter. Минимальная длина = 1 |
originrealm string | Значение Origin-Realm для сообщения Capabilities-Exchange-Request (CER) для мониторинга серверов Diameter. Минимальная длина = 1 |
password string | Пароль, необходимый для входа на сервер Минимальная длина = 1 |
productname string | Значение Product-Name для сообщения Capabilities-Exchange-Request (CER) для мониторинга серверов Diameter. Минимальная длина = 1 |
query string | Имя домена для разрешения в рамках мониторинга службы DNS (например, |
querytype string | Тип записи DNS для отправки запросов мониторинга. Устанавливается в Варианты:
|
radaccountsession string | Идентификатор сеанса учетной записи RADIUS для использования в пакете запроса учетной записи. Применимо к мониторам типа Минимальная длина = 1 |
radaccounttype string | Тип учетной записи RADIUS для использования в пакете запроса учетной записи. Применимо к мониторам типа Минимальное значение = 0 Максимальное значение = 15 |
radapn string | Идентификатор вызывающей стороны для использования в пакете запроса учетной записи. Применимо к мониторам типа Минимальная длина = 1 |
radframedip string | Исходный IP-адрес, с которого пакет будет отправлен. Применимо к мониторам типа |
radkey string | Ключ аутентификации (текстовая строка общего секрета) для обмена между клиентами и серверами RADIUS. Применимо к мониторам типа Минимальная длина = 1 |
radmsisdn string | Идентификатор вызывающей стороны для использования в пакете запроса учетной записи. Применимо к мониторам типа Минимальная длина = 1 |
radnasid string | NAS-идентификатор для отправки в пакете Access-Request. Применимо к мониторам типа Минимальная длина = 1 |
radnasip string | IP-адрес сервера сетевого доступа (NAS), который будет использоваться в качестве исходного IP-адреса при мониторинге RADIUS-сервера. Применимо к мониторам типа |
recv string | Строка, ожидаемая от сервера для того, чтобы служба была помечена как UP. Применимо к мониторам |
respcode string | Коды ответов, при которых служба помечается как UP. Для любого другого кода ответа выполняемое действие зависит от типа монитора. Мониторы |
resptimeout string | Время, в течение которого устройство должно ждать, прежде чем пометить зонд как FAILED. Должно быть меньше значения, указанного для параметра Interval. Примечание: Для мониторов Минимальное значение = Максимальное значение = |
resptimeoutthresh string | Пороговое значение времени отклика, указанное в процентах от параметра Response Time-out. Если ответ на зондирование монитора не получен, когда достигается пороговое значение, устройство генерирует SNMP-ловушку monRespTimeoutAboveThresh. После того, как время отклика вернется к значению ниже порогового, устройство генерирует SNMP-ловушку monRespTimeoutBelowThresh. Для генерации ловушек также должна быть включена тревога «MONITOR-RTO-THRESHOLD». Минимальное значение = Максимальное значение = |
retries string | Максимальное количество зондов, которые необходимо отправить для установления состояния службы, для которой произошел сбой зондирования мониторинга. Минимальное значение = Максимальное значение = |
reverse boolean | Помечает службу как DOWN вместо UP, когда критерии зондирования выполнены, и как UP вместо DOWN, когда критерии зондирования не выполнены. Варианты:
|
rtsprequest string | RTSP-запрос для отправки на сервер (например, |
save_config boolean | Если Модуль не будет сохранять конфигурацию на узле NetScaler, если он не внес никаких изменений. Варианты:
|
scriptargs string | Строка аргументов для скрипта. Строка копируется дословно в запрос. |
scriptname string | Путь и имя скрипта для выполнения. Скрипт должен быть доступен на устройстве NetScaler в каталоге /nsconfig/monitors/. Минимальная длина = 1 |
secondarypassword string | Дополнительный пароль, который пользователям может потребоваться предоставить для входа на сервер Access Gateway. Применимо к мониторам |
secure boolean | Использовать защищенное SSL-соединение при мониторинге службы. Применимо только к мониторам на основе TCP. Опция secure не может использоваться с монитором Варианты:
|
send string | Строка для отправки службе. Применимо к мониторам |
sipmethod string | SIP-метод, который нужно использовать для запроса. Применимо только к мониторам типа Варианты:
|
sipreguri string | SIP-пользователь для регистрации. Применимо только в том случае, если монитор имеет тип Минимальная длина = 1 |
sipuri string | Строка SIP URI для отправки службе (например, Минимальная длина = 1 |
sitepath string | URL-адрес страницы входа. Для мониторов типа Минимальная длина = 1 |
snmpcommunity string | Имя сообщества для Минимальная длина = 1 |
Snmpoid string | SNMP OID для Минимальная длина = 1 |
snmpthreshold string | Пороговое значение для Минимальная длина = 1 |
snmpversion string | Версия SNMP, которая будет использоваться для Варианты:
|
sqlquery string | SQL-запрос для Минимальная длина = 1 |
state string | Состояние монитора. Настройка Варианты:
По умолчанию: |
storedb string | Сохранить список баз данных, заполненный ответами на зонды монитора. Используется в балансировке нагрузки, специфичной для базы данных, если настроен монитор Варианты:
|
storefrontacctservice boolean | Включить/Выключить зондирование для службы учетных записей. Применимо только к мониторам Store Front. Для конфигурации с несколькими клиентами пользователи могут пропустить службу учетных записей. Варианты:
|
storefrontcheckbackendservices boolean | Эта опция включит мониторинг служб, работающих на сервере StoreFront. Службы StoreFront контролируются путем зондирования службы Windows, которая работает на сервере StoreFront и предоставляет информацию о том, какие службы StoreFront работают. Варианты:
|
storename string | Имя хранилища. Для мониторов типа Минимальная длина = 1 |
successretries string | Количество последовательных успешных проверок, необходимых для перевода состояния службы из DOWN в UP. Минимальное значение = Максимальное значение = |
supportedvendorids string | Список пар значений атрибута Supported-Vendor-Id (AVP) для сообщения Capabilities-Exchange-Request (CER), используемого для мониторинга серверов Diameter. В сообщении мониторинга поддерживается максимум восемь таких AVP. Минимальное значение = Максимальное значение = |
tos boolean | Проверить службу, закодировав целевой IP-адрес в 6 битах IP TOS. Варианты:
|
tosid string | Идентификатор TOS указанного целевого IP-адреса. Применимо только тогда, когда установлен параметр TOS. Минимальное значение = Максимальное значение = |
transparent boolean | Монитор привязан к прозрачному устройству, такому как брандмауэр или маршрутизатор. Состояние прозрачного устройства зависит от быстродействия служб, находящихся за ним. Если контролируется прозрачное устройство, необходимо указать целевой IP-адрес. Зонд отправляется на указанный IP-адрес с использованием MAC-адреса прозрачного устройства. Варианты:
|
trofscode string | Код, ожидаемый, когда сервер находится на техническом обслуживании. |
trofsstring string | Строка, ожидаемая от сервера для того, чтобы служба была помечена как trofs. Применимо к мониторам HTTP-ECV/TCP-ECV. |
type string | Тип монитора, который вы хотите создать. Варианты:
|
units1 string | Единица измерения для параметра отклонения. Не может быть изменена после создания монитора. Варианты:
|
units2 string | Единица измерения для параметра времени простоя. Не может быть изменена после создания монитора. Варианты:
|
units3 string | Единицы интервала мониторинга. Варианты:
|
units4 string | Единицы времени ожидания ответа монитора. Варианты:
|
username string | Имя пользователя, с помощью которого нужно проверить Минимальная длина = 1 |
validate_certs boolean | Если Варианты:
|
validatecred boolean | Проверить учетные данные пользователя сервера Xen Desktop DDC. Применимо к мониторам типа Варианты:
|
vendorid string | Значение Vendor-Id для сообщения Capabilities-Exchange-Request (CER), используемого для мониторинга серверов Diameter. |
vendorspecificacctapplicationids string | Список пар значений атрибутов Vendor-Specific-Acct-Application-Id (AVP) для использования при мониторинге серверов Diameter. В сообщении мониторинга поддерживается максимум восемь таких AVP. Указанное значение объединяется со значением vendorSpecificVendorId для получения AVP Vendor-Specific-Application-Id в сообщении мониторинга CER. Минимальное значение = Максимальное значение = |
vendorspecificauthapplicationids string | Список пар значений атрибутов Vendor-Specific-Auth-Application-Id (AVP) для сообщения Capabilities-Exchange-Request (CER), используемого для мониторинга серверов Diameter. В сообщении мониторинга поддерживается максимум восемь таких AVP. Указанное значение объединяется со значением vendorSpecificVendorId для получения AVP Vendor-Specific-Application-Id в сообщении мониторинга CER. Минимальное значение = Максимальное значение = |
vendorspecificvendorid string | Vendor-Id для использования в группированной паре значений атрибутов Vendor-Specific-Application-Id (AVP) в сообщении мониторинга CER. Для указания Auth-Application-Id или Acct-Application-Id в Vendor-Specific-Application-Id используйте соответственно vendorSpecificAuthApplicationIds или vendorSpecificAcctApplicationIds. Поддерживается только один Vendor-Id для всех AVP Vendor-Specific-Application-Id в сообщении мониторинга CER. Минимальное значение = 1 |
Примечания
Примечание
- Для получения дополнительной информации об использовании Ansible для управления сетевыми устройствами Citrix NetScaler см. https://www.ansible.com/ansible-netscaler.
Примеры
- name: Set lb monitor
local_action:
nsip: 172.18.0.2
nitro_user: nsroot
nitro_pass: nsroot
validate_certs: false
module: netscaler_lb_monitor
state: present
monitorname: monitor_1
type: HTTP-INLINE
action: DOWN
respcode: ['400']
Значения возврата
Общие значения возврата документированы здесь, следующие поля уникальны для этого модуля:
Ключ | Описание |
|---|---|
diff словарь | Список различий между фактически настроенным объектом и конфигурацией, указанной в модуле Возвращается: при ошибке Пример: |
loglines список / элементы=строка | Список сообщений, записанных модулем Возвращается: всегда Пример: |
msg строка | Сообщение, описывающее причину ошибки Возвращается: при ошибке Пример: |
Ссылки на коллекцию
© 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/community/network/netscaler_lb_monitor_module.html