community.zabbix.zabbix_service – Create/update/delete Zabbix service

Note

This plugin is part of the community.zabbix collection (version 1.3.0).

To install it use: ansible-galaxy collection install community.zabbix.

To use it in a playbook, specify: community.zabbix.zabbix_service.

Synopsis

  • Create/update/delete Zabbix service.

Requirements

The below requirements are needed on the host that executes this module.

  • python >= 2.7

  • zabbix-api >= 0.5.4

Parameters

Parameter Choices/Defaults Comments
algorithm
string
    Choices:
  • no
  • one_child ←
  • all_children
Algorithm used to calculate the sla
no, sla is not calculated
one_child, problem if at least one child has a problem
all_children, problem if all children have problems
calculate_sla
boolean
    Choices:
  • no ←
  • yes
If yes, calculate the SLA value for this service, showsla in Zabbix API
http_login_password
string
Basic Auth password
http_login_user
string
Basic Auth login
login_password
string / required
Zabbix user password.
login_user
string / required
Zabbix user name.
name
string / required
Name of Zabbix service
parent
string
Name of Zabbix service parent
server_url
string / required
URL of Zabbix server, with protocol (http or https). url is an alias for server_url.

aliases: url
sla
float
Sla value (i.e 99.99), goodsla in Zabbix API
state
string
    Choices:
  • present ←
  • absent
State: present - create/update service; absent - delete service
timeout
integer
Default:
10
The timeout of API request (seconds).
trigger_host
string
Name of host linked to the service
trigger_name
string
Name of trigger linked to the service
validate_certs
boolean
    Choices:
  • no
  • yes ←
If set to False, SSL certificates will not be validated. This should only be used on personally controlled sites using self-signed certificates.

Notes

Note

  • If you use login_password=zabbix, the word “zabbix” is replaced by “****” in all module output, because login_password uses no_log. See this FAQ for more information.

Examples

---
# Creates a new Zabbix service
- name: Manage services
  local_action:
        module: community.zabbix.zabbix_service
        server_url: "https://192.168.1.1"
        login_user: username
        login_password: password
        name: apache2 service
        sla: 99.99
        calculate_sla: yes
        algorithm: one_child
        trigger_name: apache2 service status
        trigger_host: webserver01
        state: present

Authors

  • Emmanuel Riviere (@emriver)