There are many of us sysadmins out there who use Confluence as primary source of information about managed systems’ hardware and software – the type of information that would likely contain installation instructions, configuration files, performance reports and other valuable bits and pieces of information. This is usually accompanied by network monitoring tools such as Zabbix.
This plugin is used to add Zabbix Graphs and Zabbix Maps to your Confluence pages to supplement configuration details and reports with online graphical information. It is also possible to import text information such as Zabbix Items and Zabbix Triggers.
Before using the plugin you have to provide Zabbix server connection details to your Confluence instance.
Create a new Zabbix server connection by providing Zabbix server address and credentials.
You may share your connection descriptor with other Confluence users by selecting a user or a user group in Grantees field.
You may also set the connection as Default. This option is maintained for compatibility only.
Drop Zabbix Graph macro on a page and specify Server, Host and Graph parameters. You may also set the Period (in seconds), Width and Height of the graph in pixels.
Save the page and you will see the selected Zabbix graph:
You can put as many Zabbix graphs on a Confluence page as you need.
In Zabbix an ‘item’ is an individual metric that gathers data from a monitored host.
Drop Zabbix Item macro on page and specify Server, Host and Item parameters.
Save the page and you will see the item details:
It is possible to modify the item format. Zabbix Plugin comes with three predefined named formats:
You can create custom named formats using the plugin configuration page:
Item format components are defined as follows:
You may also include arbitrary text in single or double quotes.
In Zabbix a ‘trigger’ is defined as a logical expression and represents system state. Typically when a trigger signals a problem an action is required from a system administrator.
To list active triggers for a host drop Zabbix Triggers macro on your page and specify Server and Host parameters.
Save the page and you will see active triggers for the host:
In case there are no active triggers to display:
In Zabbix you can create a ‘map’ with one or more hosts.
To get your Zabbix map in Confluence drop Zabbix Map macro on page and specify the Server and Map parameters.
Save the page and you will have your Zabbix map on it.
Suppose you have a report page template that you would like to apply to multiple Zabbix hosts. Instead of duplicating a page and updating host details in each and every graph / item on the page you can use a Host Selector macro to share server / host parameter values with other zabbix- macros.
Drop Host Selector macro on a page and specify the Server and Host parameters.
When you save the page the macro will print the selected Zabbix host name:
Now you can use Zabbix Graph or Zabbix Item macros without specifying a server or host:
This plugin is available for download from Atlassian Marketplace.
The plugin can be used in Atlassian Data Center environment.
To report a bug please use the issue tracker.