Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/arthurcadore/zbx-grafana-appliance
This repository structure a deployment of Zabbix Components Grafana and Database (PostgreSQL 13.5) service for network monitoring
https://github.com/arthurcadore/zbx-grafana-appliance
grafana grafana-dashboard pgsql zabbix zabbix-agent zabbix-server-pgsql zabbix-web-nginx-pgsql
Last synced: 27 days ago
JSON representation
This repository structure a deployment of Zabbix Components Grafana and Database (PostgreSQL 13.5) service for network monitoring
- Host: GitHub
- URL: https://github.com/arthurcadore/zbx-grafana-appliance
- Owner: arthurcadore
- License: mit
- Created: 2024-05-23T02:16:41.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2024-06-04T11:14:55.000Z (5 months ago)
- Last Synced: 2024-06-04T12:37:19.445Z (5 months ago)
- Topics: grafana, grafana-dashboard, pgsql, zabbix, zabbix-agent, zabbix-server-pgsql, zabbix-web-nginx-pgsql
- Language: Shell
- Homepage: https://www.zabbix.com/
- Size: 902 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Zabbix / Grafana Docker Appliance
**This repository structure a deployment of Zabbix Components (6.0.28), Grafana (9.3.2) and Database (PostgreSQL 13.5) service for network monitoring**
Prerequisites
Before you begin, ensure you have the following packages installed on your system:- Git version 2.34.1
- Docker version 24.0.6, build ed223bc
- Docker Compose version v2.21.0---
### Getting Started:First, copy the line below and paste on your prompt to clone the repository:
```
git clone https://github.com/arthurcadore/zbx-grafana-appliance
```
If you don't have installed the package Git yet, do it before try to clone the respository!Navigate to the project directory:
```
cd ./zbx-grafana-appliance
```If you don't have Docker (and Docker-compose) installed on your system yet, it can be installed by run the following commands (Script for Ubuntu 22.04):
```
./docker/installDocker.sh
```**If you had to install docker, please remember to reboot you machine to grant user privileges for docker application.**
In sequence, configure the environment variables for the application container, you can do this by edditing the files in the `.env_vars`:
```
.POSTGRES_USER -> Change database User
.POSTGRES_PASSWORD -> Change database Password
.env_grafana -> Change Grafana Default 'Admin' password
```### Start Application's Container:
Run the command below to start docker-compose file:```
docker compose up &
```The "&" character creates a process id for the command inputed in, with means that the container will not stop when you close the terminal.
---
### Access Application:
Once the container is up and running, you can access the applications web interface at the following addresses:
- Zabbix Web Interface:
```
http://localhost:8080/index.php
```- Zabbix Server/Agent Interfaces:
```
localhost:10050
localhost:10051
```- Grafana:
```
http://localhost:3000/login
```- Database:
```
pgsql://localhost:5432
```---
### Configuring Grafana Dashboard:
- First, access the Grafana web interface at `3000/TCP` port:
![accessGrafana](./pictures/GrafanaAccess.png)
The default user is "admin", the password was configured in `.env_grafana` file.
- In the `plugin` section, enable the "Zabbix" plugin for use it.
- In sequence, create a new `data-source` using "Zabbix Data Source", in the configuration of it, insert the Zabbix-Web container API access:
![grafanaAPI](./pictures/GrafanaAPI.png)
On the "Zabbix Connection" parameters, input the user and password of zabbix interface access, which is the following as default:
```
User: Admin
Password: zabbix
```- Finally, use the `save and test` button to verify if the parameters configurated have allowed the Grafana to consult the Zabbix API, the zabbix will show the following log if the connection was successfully:
![grafanaSuccess](./pictures/GrafanaSuccess.png)
---
### Accessing the Zabbix Interface:
To access the Zabbix web interface, use the `8080/TCP` port, with the following credentials:
```
User: Admin
Password: zabbix
```![zabbixSuccess](./pictures/zabbix.png)
---
### Stop Container:
To stop the running container, use the following command:```
docker-compose down
```This command stops and removes the containers, networks, defined in the docker-compose.yml file.
## References:
- [Docker Compose For Zabbix (mpolinowski)](https://github.com/mpolinowski/zabbix-server-compose)
- [Zabbix Docker Containers](https://hub.docker.com/u/zabbix)
- [Instalation for Containers](https://www.zabbix.com/documentation/current/en/manual/installation/containers)