setup docs hirearchy

2023-12-20 11:32:04 +00:00
parent a6b91bbd86
commit ef24d1fcb4
14 changed files with 13 additions and 13 deletions
--- a/docs/sources/configuration/direct-db-datasource.md
+++ b/docs/sources/configuration/direct-db-datasource.md
@@ -0,0 +1,46 @@
+---
+title: Direct DB Data Source Configuration
+menuTitle: Direct DB Data Source Configuration
+description: Direct DB Data Source Configuration
+aliases:
+keywords:
+  - data source
+  - zabbix
+labels:
+  products:
+    - oss
+    - grafana cloud
+weight: 310
+---
+
+## Security notes
+
+Grafana-Zabbix plugin can use MySQL, Postgres or InfluxDB (if Zabbix configured to store history data in InfluxDB) data sources to query history and trend data directly from Zabbix database. In order to execute queries, plugin needs only read access to the `history`, `history_uint`, `trends` and `trends_uint` tables. To make connection more secure and prevent unnecessary data disclosure, it's highly recommended to grant read access to only that tables. But if you want to use this data source for querying another data, you can
+grant `SELECT` privileges to entire zabbix database. Also, all queries are invoked by grafana server, so you can restrict connection to only grafana host. Here's MySQL example:
+
+```sql
+GRANT SELECT ON zabbix.* TO 'grafana'@'grafana-host' identified by 'password';
+```
+
+## MySQL
+
+In order to use _Direct DB Connection_ feature you should configure SQL data source first.
+
+![Configure MySQL data source](https://raw.githubusercontent.com/grafana/alexanderzobnin-zabbix-app/main/docs/images/installation-mysql_ds_config.png)
+
+Select _MySQL_ data source type and provide your database host address and port (3306 is default for MySQL). Fill
+database name (usually, `zabbix`) and specify credentials.
+
+## PostgreSQL
+
+Select _PostgreSQL_ data source type and provide your database host address and port (5432 is default). Fill
+database name (usually, `zabbix`) and specify credentials.
+
+![Configure PostgreSQL data source](https://raw.githubusercontent.com/grafana/alexanderzobnin-zabbix-app/main/docs/images/installation-postgres_ds_config.png)
+
+## InfluxDB
+
+Select _InfluxDB_ data source type and provide your InfluxDB instance host address and port (8086 is default). Fill
+database name you configured in the [effluence](https://github.com/i-ky/effluence) module config (usually, `zabbix`) and specify credentials.
+
+![Configure InfluxDB data source](https://raw.githubusercontent.com/grafana/alexanderzobnin-zabbix-app/main/docs/images/configuration-influxdb_ds_config.png)