Zabbix Plugin for Confluence is used to add valuable Zabbix information – graphs, items and triggers – to your Confluence pages.
There are many of us sysadmins out there who use Confluence as a primary source of information about their 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 Nagios or Zabbix. This plugin is used to add Zabbix charts (or graphs) to your Confluence pages to illustrate your configuration details and reports with online visual information. It is also possible to import text information from Zabbix – such as Zabbix items and alerts (or triggers).
Before using the plugin you have to setup access from Confluence to your Zabbix server.
- In Zabbix, create "confluence" account in a "confluence" user group and grant the group read-only permissions to whatever hosts you choose to be available to your Confluence server.
- In Confluence, install the plugin and configure Zabbix connection
When you press Save button the plugin will test connection to your Zabbix server. It will notify you of the result of the test and save your connection details only if connection was successful.
Certain operations, such as macro setup, require a user to be a member of one of the following groups:
After you are done with adding Zabbix graphs, items and triggers to your page, consider restricting view permissions to that page.
Zabbix Graph macro
Drop Zabbix Graph macro on page and specify graph id, period in seconds, width and height in pixels.
You may lookup graph id by selecting appropriate host and clicking the graph name.
You can put as many Zabbix graphs on a single page as you like and size them to meet your formatting requirements.
Zabbix Item macro
In Zabbix an item is an individual metric that gathers data from a monitored host. Drop Zabbix Item macro on page and specify item id and format.
You may find item id by clicking Lookup Zabbix Item Id...
There are three different item formats supported:
- short – only value and units, if any
- medium – value, units and value date and time
- long (default) – item name and key, value, units and value date and time
You may as many Zabbix items on a single page as you wish.
Zabbix Triggers macro
In Zabbix a trigger is defined as a logical expression and represents system state. When a trigger signals a problem, typically an action is required from a system administrator.
To list active triggers for a host drop Zabbix Triggers macro on your Confluence page and specify a host id.
You may find host id by clicking Lookup Zabbix Host Id...
There is a number of limitations that apply to non-licensed plugins:
- a user will not be able to view more than one Zabbix item per page
- a user will not be able to view more than one Zabbix trigger per host
There are no limitations that apply to graphs.
It is very easy to style of highlight the data, that you receive from Zabbix. All Zabbix objects – items, triggers and graphs have zabbix style class. Other classes – zabbix-graph, zabbix-item, and zabbix-trigger apply to their respective objects.
Live demo is at This Server Monitoring page.
If you have found a bug please report at the Issue Tracker.