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

Примечание

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

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

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

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

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

Обзор

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

Требования

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

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/triggerprototype/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 trigger prototype on example_host using example_rule
- name: create trigger prototype
  # 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_triggerprototype:
    name: '{% raw %}Free disk space is less than 20% on volume {#FSNAME}{% endraw %}'
    host_name: example_host
    params:
      severity: high
      expression: "{% raw %}last(/example_host/vfs.fs.size[{#FSNAME}, pused])>80{% endraw %}"
      recovery_mode: none
      manual_close: True
      enabled: True
    state: present

# Create trigger prototype on example_template using example_rule
- name: create trigger prototype
  # 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_triggerprototype:
    name: '{% raw %}Free disk space is less than 20% on volume {#FSNAME}{% endraw %}'
    template_name: example_template
    params:
      severity: high
      expression: "{% raw %}last(/example_host/vfs.fs.size[{#FSNAME}, pused])>80{% endraw %}"
      recovery_mode: none
      manual_close: True
      enabled: True
    state: present

# Add tags to the existing Zabbix trigger prototype
- name: update trigger prototype
  # 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_triggerprototype:
    name: '{% raw %}Free disk space is less than 20% on volume {#FSNAME}{% endraw %}'
    template_name: example_template
    params:
      severity: high
      expression: "{% raw %}last(/example_host/vfs.fs.size[{#FSNAME}, pused])>80{% endraw %}"
      recovery_mode: none
      manual_close: True
      enabled: True
      tags:
          - tag: class
            value: application
    state: present

# Delete Zabbix trigger prototype
- name: delete trigger prototype
  # 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_triggerprototype:
    name: '{% raw %}Free disk space is less than 20% on volume {#FSNAME}{% endraw %}'
    template_name: example_template
    state: absent

- name: Rename Zabbix trigger prototype
  # 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_triggerprototype:
    name: '{% raw %}Free disk space is less than 20% on volume {#FSNAME}{% endraw %}'
    template_name: example_template
    params:
      new_name: '{% raw %}New Free disk space is less than 20% on volume {#FSNAME}{% endraw %}'
    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_triggerprototype_module.html