grafana-zabbix/docs/sources/installation/index.md

page_title: Grafana-Zabbix Installation page_description: Installation instructions for Grafana-Zabbix.

Installation

Download latest release for relative Grafana version or just clone a repo:

git clone https://github.com/alexanderzobnin/grafana-zabbix.git

Copy into plugins directory

Copy content of plugins into your grafana plugins directory (default /var/lib/grafana/plugins if your installing grafana with package). Restart grafana-server and the plugin should be automatically detected and used.

git clone https://github.com/alexanderzobnin/grafana-zabbix.git
cp -r ./grafana-zabbix/plugins/* /your/grafana/plugins/directory/
sudo service grafana-server restart

Use directory of your choice

By this way you can update plugin by simple git pull command.

Edit your grafana.ini config file (Default location is at /etc/grafana/grafana.ini) and add paths to plugins:

[plugin.zabbix]
path = /home/your/clone/dir/plugins/datasource-zabbix

[plugin.triggers]
path = /home/your/clone/dir/plugins/panel-triggers

Note that if you copy it into the grafana plugins directory you do not need to add the above config option. That is only if you want to place the plugin in a directory outside the standard plugins directory. Be aware that grafana-server needs read access to the directory.

Configuration

To add new Zabbix data source open Data Sources in side panel, click Add new and select Zabbix from dropdown list.

Then configure a data source

Http settings

• Url: set Zabbix API url (full path with api_jsonrpc.php).
• Access: can be either proxy or direct.
• Http Auth: configure if you use proxy authentication.
  • Basic Auth:
  • With Credentials:

Zabbiz API details

• User and Password: setup login for access to Zabbix API. Also check user's permissions in Zabbix if you can't get any groups and hosts in Grafana.
• Trends: enable if you use patch for trends support in Zabbix 2.x (ZBXNEXT-1193). This is strictly recommended for displaying long time periods (more than few days, depending of your item's updating interval in Zabbix) because few days of item history contains tons of points. Using trends can increase Grafana performance.
  • Use trends from: time after which trends will be used. Default is 7d (7 days). You can set the time in Grafana format. Valid time specificators are:
    • h - hours
    • d - days
    • M - months
• Metrics limit: maximum items number which can be returned by one request. Helps to prevent Grafana slowdown due wrong request.

Then click Add - datasource will be added and you can check connection using Test Connection button.

This feature can help to find some mistakes like invalid user name or password, wrong api url.

Note about Zabbix 2.2 or less

Zabbix API (api_jsonrpc.php) before zabbix 2.4 don't allow cross-domain requests (CORS). And you can get HTTP error 412 (Precondition Failed). To fix it add this code to api_jsonrpc.php immediately after the copyright:

header('Access-Control-Allow-Origin: *');
header('Access-Control-Allow-Headers: Content-Type');
header('Access-Control-Allow-Methods: POST');
header('Access-Control-Max-Age: 1000');

if ($_SERVER['REQUEST_METHOD'] === 'OPTIONS') {
	return;
}

before

require_once dirname(__FILE__).'/include/func.inc.php';
require_once dirname(__FILE__).'/include/classes/core/CHttpRequest.php';

Full fix listing. For more details see zabbix issues ZBXNEXT-1377 and ZBX-8459.

Note about Browser Cache

After updating plugin, clear browser cache and reload application page. See details for Chrome, Firefox. You need to clear cache only, not cookies, history and other data.