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

Примечание

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

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

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

Чтобы использовать модуль в плейбуке, укажите: community.zabbix.zabbix_trigger.

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

Краткое описание

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

Требования

Следующие требования должны быть выполнены на узле, на котором запускается этот модуль.

python >= 2.6

Параметры

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

- name: Rename Zabbix 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
    template_name: example_template
    params:
      new_name: new_agent_ping
    state: present

Авторы

Andrew Lathrop (@aplathrop)

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

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/zabbix/zabbix_trigger_module.html