community.zabbix.zabbix_service модуль – Создание/обновление/удаление службы Zabbix

Примечание

Этот модуль входит в коллекцию community.zabbix (версия 2.5.1).

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

Для установки используйте: ansible-galaxy collection install community.zabbix. Для использования этого модуля требуются дополнительные условия, см. Требования для получения подробной информации.

Для использования в книге задач укажите: community.zabbix.zabbix_service.

Описание
Требования
Параметры
Примеры

Описание

Создание/обновление/удаление службы Zabbix.

Требования

Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.

python >= 3.9

Параметры

Параметр	Комментарии
алгоритм строка	Правило расчета состояния. Применимо только если существуют дочерние службы. `status_to_ok`, установить состояние в OK `most_crit_if_all_children`, наибольшая критическая, если все дочерние имеют проблемы `most_crit_of_child_serv`, наибольшая критическая из дочерних служб с Варианты: `"status_to_ok"` ← (по умолчанию) `"most_crit_if_all_children"` `"most_crit_of_child_serv"`
дочерние список / элементы=строка	Дочерние службы, которые будут связаны со службой.
описание строка	Описание службы.
http_login_password строка	Пароль аутентификации Basic
http_login_user строка	Логин аутентификации Basic
название строка / обязательно	Имя службы Zabbix
родители список / элементы=строка	Родительские службы, которые будут связаны со службой.
метки_проблем список / элементы=словарь	Метки проблем, которые будут созданы для службы.
оператор строка	Оператор условия сопоставления. `equals` `like` Варианты: `"equals"` ← (по умолчанию) `"like"`
метка строка / обязательно	Имя метки проблемы.
значение строка	Значение метки проблемы. По умолчанию: `""`
правило_распространения строка	Значение распространения состояния. Должно быть задано вместе с propagation_rule. `as_is` распространить состояние службы как есть - без изменений `increase` увеличить распространяемое состояние на заданное propagation_value (на 1-5 уровней серьезности) `decrease` уменьшить распространяемое состояние на заданное propagation_value (на 1-5 уровней серьезности) `ignore` игнорировать эту службу - состояние не распространяется на родительскую службу вообще `fixed` установить фиксированное состояние службы с использованием заданного propagation_value Требуется с `propagation_value` По умолчанию: `"as_is"`
значение_распространения строка	Значение распространения состояния. Должно быть задано вместе с propagation_rule. Возможные значения при propagation_rule=as_is или ignore: `not_classified` Возможные значения при propagation_rule=increase или decrease: `information` `warning` `average` `high` `disaster` Возможные значения при propagation_rule=fixed: `ok` `not_classified` `information` `warning` `average` `high` `disaster` Требуется с `propagation_rule`
порядок_сортировки строка / обязательно	Позиция службы, используемая для сортировки.
состояние строка	Состояние: present - создать/обновить службу; absent - удалить службу. Варианты: `"present"` ← (по умолчанию) `"absent"`
правила_состояния список / элементы=словарь	Правила состояния для службы.
предел_состояния строка / обязательно	Предельное состояние. `ok` OK `not_classified` Не классифицировано `information` Информация `warning` Предупреждение `average` Среднее `high` Высокое `disaster` Катастрофа
предел_значение целое / обязательно	Предельное значение: N, N% или W Возможные значения: 1-100000 для N и W, 1-100 для N%
новое_состояние строка / обязательно	Новое значение состояния. `not_classified` Не классифицировано `information` Информация `warning` Предупреждение `average` Среднее `high` Высокое `disaster` Катастрофа

END_OF_DOCUMENT_MARKER

тип строка / обязательно	Условие для установки состояния (Новое состояние). `at_least_n_child_services_have_status_or_above` если у хотя бы (N) дочерних сервисов есть состояние (Статус) или выше `at_least_npct_child_services_have_status_or_above` если у хотя бы (N%) дочерних сервисов есть состояние (Статус) или выше `less_than_n_child_services_have_status_or_below` если у меньше чем (N) дочерних сервисов есть состояние (Статус) или ниже `less_than_npct_child_services_have_status_or_below` если у меньше чем (N%) дочерних сервисов есть состояние (Статус) или ниже `weight_child_services_with_status_or_above_at_least_w` если вес дочерних сервисов со статусом (Статус) или выше составляет по крайней мере (W) `weight_child_services_with_status_or_above_at_least_npct` если вес дочерних сервисов со статусом (Статус) или выше составляет по крайней мере (N%) `weight_child_services_with_status_or_below_less_w` если вес дочерних сервисов со статусом (Статус) или ниже меньше чем (W) `weight_child_services_with_status_or_below_less_npct` если вес дочерних сервисов со статусом (Статус) или ниже меньше чем (N%)
метки список / элементы=словарь	Метки сервиса, которые должны быть созданы для сервиса.
метка строка / обязательно	Название метки сервиса.
значение строка	Значение метки сервиса.
вес строка	Вес сервиса. По умолчанию: `"0"`

Примеры

---
# If you want to use Username and Password to be authenticated by Zabbix Server
- name: Set credentials to access Zabbix Server API
  ansible.builtin.set_fact:
    ansible_user: Admin
    ansible_httpapi_pass: zabbix

# If you want to use API token to be authenticated by Zabbix Server
# https://www.zabbix.com/documentation/current/en/manual/web_interface/frontend_sections/administration/general#api-tokens
- name: Set API token
  ansible.builtin.set_fact:
    ansible_zabbix_auth_key: 8ec0d52432c15c91fcafe9888500cf9a607f44091ab554dbee860f6b44fac895

# Creates a new Zabbix service
- name: Create Zabbix service monitoring Apache2 in DCs in Toronto area
  # set task level variables
  vars:
    ansible_network_os: community.zabbix.zabbix
    ansible_connection: httpapi
    ansible_httpapi_port: 443
    ansible_httpapi_use_ssl: true
    ansible_httpapi_validate_certs: false
    ansible_zabbix_url_path: "zabbixeu"  # If Zabbix WebUI runs on non-default (zabbix) path ,e.g. http://<FQDN>/zabbixeu
    ansible_host: zabbix-example-fqdn.org
  community.zabbix.zabbix_service:
    name: "apache2 service Toronto"
    description: Apache2 services in Toronto area
    sortorder: 0
    propagation_rule: increase
    propagation_value: warning
    weight: 1
    state: present
    tags:
      - tag: zabbix_service
        value: apache2
      - tag: area
        value: Toronto
    problem_tags:
      - tag: service_name
        value: httpd
      - tag: area
        operator: like
        value: toronto
    status_rules:
      - type: at_least_n_child_services_have_status_or_above
        limit_value: 4242
        limit_status: ok
        new_status: average

- name: Create Zabbix service monitoring all Apache2 services
  # set task level variables as we change ansible_connection plugin here
  vars:
    ansible_network_os: community.zabbix.zabbix
    ansible_connection: httpapi
    ansible_httpapi_port: 443
    ansible_httpapi_use_ssl: true
    ansible_httpapi_validate_certs: false
    ansible_zabbix_url_path: "zabbixeu"  # If Zabbix WebUI runs on non-default (zabbix) path ,e.g. http://<FQDN>/zabbixeu
    ansible_host: zabbix-example-fqdn.org
  community.zabbix.zabbix_service:
    name: apache2 service
    description: Apache2 services
    tags:
      - tag: zabbix_service
        value: apache2
      - tag: area
        value: global
    children:
      - "apache2 service Toronto"

Авторы

Emmanuel Riviere (@emriver)
Evgeny Yurchenko (@BGmot)

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

© 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/zabbix/zabbix_service_module.html