Try SpotterCreate/update/delete Zabbix screens
Authors: Cove (@cove), Tony Minfei Ding (!UNKNOWN), Harrison Gu (@harrisongu)
preview | supported by community
Install with ansible-galaxy collection install community.general:==0.1.1
collections:
- name: community.general
version: 0.1.1This module allows you to create, modify and delete Zabbix screens and associated graph data.
# Create/update a screen.
- name: Create a new screen or update an existing screen's items 5 in a row
local_action:
module: zabbix_screen
server_url: http://monitor.example.com
login_user: username
login_password: password
screens:
- screen_name: ExampleScreen1
host_group: Example group1
state: present
graph_names:
- Example graph1
- Example graph2
graph_width: 200
graph_height: 100
graphs_in_row: 5
# Create/update multi-screen
- name: Create two of new screens or update the existing screens' items
local_action:
module: zabbix_screen
server_url: http://monitor.example.com
login_user: username
login_password: password
screens:
- screen_name: ExampleScreen1
host_group: Example group1
state: present
graph_names:
- Example graph1
- Example graph2
graph_width: 200
graph_height: 100
- screen_name: ExampleScreen2
host_group: Example group2
state: present
graph_names:
- Example graph1
- Example graph2
graph_width: 200
graph_height: 100
# Limit the Zabbix screen creations to one host since Zabbix can return an error when doing concurrent updates
- name: Create a new screen or update an existing screen's items
local_action:
module: zabbix_screen
server_url: http://monitor.example.com
login_user: username
login_password: password
state: present
screens:
- screen_name: ExampleScreen
host_group: Example group
state: present
graph_names:
- Example graph1
- Example graph2
graph_width: 200
graph_height: 100
when: inventory_hostname==groups['group_name'][0]
screens:
description:
- List of screens to be created/updated/deleted (see example).
elements: dict
required: true
suboptions:
graph_height:
description:
- Graph height will be set in graph settings.
type: int
graph_names:
description:
- Graph names will be added to a screen. Case insensitive.
- Required if I(state=present).
elements: str
type: list
graph_width:
description:
- Graph width will be set in graph settings.
type: int
graphs_in_row:
default: 3
description:
- Limit columns of a screen and make multiple rows.
type: int
host_group:
description:
- Host group will be used for searching hosts.
- Required if I(state=present).
type: str
screen_name:
description:
- Screen name will be used.
- If a screen has already been added, the screen name won't be updated.
required: true
type: str
sort:
default: false
description:
- Sort hosts alphabetically.
- If there are numbers in hostnames, leading zero should be used.
type: bool
state:
choices:
- absent
- present
default: present
description:
- I(present) - Create a screen if it doesn't exist. If the screen already exists,
the screen will be updated as needed.
- I(absent) - If a screen exists, the screen will be deleted.
type: str
type: list
timeout:
default: 10
description:
- The timeout of API request (seconds).
type: int
login_user:
description:
- Zabbix user name.
required: true
type: str
server_url:
aliases:
- url
description:
- URL of Zabbix server, with protocol (http or https). C(url) is an alias for C(server_url).
required: true
type: str
login_password:
description:
- Zabbix user password.
required: true
type: str
validate_certs:
default: true
description:
- If set to False, SSL certificates will not be validated. This should only be used
on personally controlled sites using self-signed certificates.
type: bool
http_login_user:
description:
- Basic Auth login
type: str
http_login_password:
description:
- Basic Auth password
type: str