Модуль community.zabbix.zabbix_trigger – Создание/удаление триггеров Zabbix

Примечание

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

У вас возможно уже установлена эта коллекция, если вы используете пакет ansible. Она не входит в ansible-core. Для проверки её установки выполните ansible-galaxy collection list.

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

Для использования в плейбуке укажите: community.zabbix.zabbix_trigger.

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

Описание

Создаёт триггеры, если они не существуют.
Удаляет существующие триггеры, если они есть.

Требования

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

python >= 2.6

Параметры

Параметр	Комментарии
dependencies список / элементы=словарь	список триггеров, от которых зависит этот триггер
host_name строка	Имя хоста, содержащего зависимый триггер. Требуется, когда не используется template_name. Взаимоисключающее с template_name.
name строка / требуется	Имя зависимого триггера.
template_name строка	Имя шаблона, содержащего зависимый триггер. Требуется, когда не используется host_name. Взаимоисключающее с host_name.
desc псевдонимы: описание строка	Дополнительное описание триггера. Переопределяет «комментарии» в документации API.
host_name строка	Имя хоста, к которому нужно добавить триггер. Требуется, когда не используется template_name. Взаимоисключающее с template_name.
http_login_password строка	Пароль Basic Auth
http_login_user строка	Логин Basic Auth
name строка / требуется	Имя триггера для создания или удаления. Переопределяет «описание» в документации API. Не может быть изменено. Если нужно изменить имя триггера, его необходимо удалить и создать заново
params словарь	Параметры для создания/обновления триггера. Требуется, если состояние «present». Параметры, как определено в https://www.zabbix.com/documentation/current/en/manual/api/reference/trigger/object Дополнительные поддерживаемые параметры указаны ниже.
correlation_mode строка	Закрывает событие OK. Переопределяет «correlation_mode» в документации API. Варианты: `"all"` `"tag"`
enabled логическое	Статус триггера. Переопределяет «статус» в документации API. Варианты: `false` `true`
generate_multiple_events логическое	Может ли триггер генерировать несколько событий о проблеме. Псевдоним для «type» в документации API. Варианты: `false` `true`
manual_close логическое	Разрешить закрытие вручную. Переопределяет «manual_close» в документации API. Варианты: `false` `true`
recovery_mode строка	Режим генерации события OK. Переопределяет «recovery_mode» в документации API. Варианты: `"expression"` `"recovery_expression"` `"none"`
severity псевдонимы: priority строка	Степень серьезности триггера. Псевдоним для «priority» в документации API. Варианты: `"not_classified"` `"information"` `"warning"` `"average"` `"high"` `"disaster"`
status строка	Статус триггера. Варианты: `"enabled"` `"disabled"`
state строка	Создать или удалить триггер. Варианты: `"present"` ← (по умолчанию) `"absent"`
template_name строка	Имя шаблона, к которому нужно добавить триггер. Требуется, когда не используется host_name. Взаимоисключающее с host_name.

Примеры

# 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

# Create ping trigger on example_host
- name: create ping trigger
  # 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_trigger:
    name: agent_ping
    host_name: example_host
    params:
        severity: high
        expression: 'nodata(/example_host/agent.ping,1m)=1'
        manual_close: True
        enabled: True
    state: present

# Create ping trigger on example_template
- name: create ping trigger
  # 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_trigger:
    name: agent_ping
    host_name: example_template
    params:
        severity: high
        expression: 'nodata(/example_template/agent.ping,1m)=1'
        manual_close: True
        enabled: True
    state: present

# Add tags to the existing Zabbix trigger
- name: update ping trigger
  # 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_trigger:
    name: agent_ping
    host_name: example_template
    params:
        severity: high
        expression: 'nodata(/example_template/agent.ping,1m)=1'
        manual_close: True
        enabled: True
        tags:
          - tag: class
            value: application
    state: present

# delete Zabbix trigger
- name: delete ping trigger
  # 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_trigger:
    name: agent_ping
    host_name: example_template
    state: absent

Авторы

Andrew Lathrop (@aplathrop)

Ссылки на сборку

© 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_trigger_module.html