Misthios/grafana-zabbix
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

Updated installation docs for version 3.0

Browse Source
This commit is contained in:
Alexander Zobnin
2016-04-04 23:04:35 +03:00
parent 1b7abd5d37
commit a864a676a2
8 changed files with 50 additions and 21 deletions
Download Patch File Download Diff File Expand all files Collapse all files

41
docs/sources/installation/configuration.md
View File

@@ -1,13 +1,21 @@
page_title: Grafana-Zabbix Configuration
page_description: Plugin configuration instructions for Grafana-Zabbix.
# Configuration
To add new Zabbix data source open _Data Sources_ in side panel, click _Add new_ and select Zabbix
from dropdown list.
## Enable plugin
Go to the plugins in Grafana side panel, select _Apps_ tab, then select _Zabbix_, open _Config_
tab and enable plugin.
![Add zabbix data source](../img/installation-add_datasource.png)
![Enable Zabbix App](../img/installation-enable_app.png)
Then configure a data source
## Configure Zabbix data source
After enabling plugin you can add Zabbix data source.
![Configure zabbix data source](../img/installation-datasource_config.png)
To add new Zabbix data source open _Data Sources_ in side panel, click _Add data source_ and
select _Zabbix_ from dropdown list.
![Configure Zabbix data source](../img/installation-datasource_config.png)
### Http settings
@@ -17,31 +25,32 @@ Then configure a data source
- **Basic Auth**:
- **With Credentials**:
### Zabbiz API details
### Zabbix 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](https://support.zabbix.com/browse/ZBXNEXT-1193)). This is
- **Trends**: enable if you use Zabbix 3.x or patch for trends
support in Zabbix 2.x ([ZBXNEXT-1193](https://support.zabbix.com/browse/ZBXNEXT-1193)). This option
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.
will 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.
- **Cache update interval**: plugin caches some api requests for increasing performance. Set this
value to desired cache lifetime (this option affect data like items list).
Then click _Add_ - datasource will be added and you can check connection using _Test Connection_ button.
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.
![Test Connection](../img/installation-test_connection.png)
This feature can help to find some mistakes like invalid user name or password, wrong api url.
![Test Connection - Error](../img/installation-test_connection_error.png)
## Import example dashboards
You can import dashboard examples from _Dashboards_ tab in plugin config.
![Import dashboards](../img/installation-plugin-dashboards.png)
## 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

10
docs/sources/installation/upgrade.md Normal file
View File

@@ -0,0 +1,10 @@
page_title: Grafana-Zabbix Upgrade
page_description: Upgrade instructions for Grafana-Zabbix.
# Upgrade
## Upgrade from 2.x
After [enabling](configuration.md#enable-plugin) Zabbix App go to _Data Sources_, open your configured Zabbix
data source end select _Zabbix_ from _Type_ list again. This is needed because plugin id was changed
in Grafana 3.0.