https://github.com/madnuttah/unbound-docker-stats

📊 Display Unbound statistics in Grafana using Zabbix without any additional tools.
https://github.com/madnuttah/unbound-docker-stats

docker grafana homelab log logfile logfile-analysis monitoring statistics unbound zabbix zabbix-active-agent zabbix-agent

Last synced: 1 day ago
JSON representation

📊 Display Unbound statistics in Grafana using Zabbix without any additional tools.

• Host: GitHub
• URL: https://github.com/madnuttah/unbound-docker-stats
• Owner: madnuttah
• License: mit
• Created: 2023-05-05T05:17:56.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-06-15T08:33:42.000Z (7 months ago)
• Last Synced: 2024-12-30T16:53:15.532Z (8 days ago)
• Topics: docker, grafana, homelab, log, logfile, logfile-analysis, monitoring, statistics, unbound, zabbix, zabbix-active-agent, zabbix-agent
• Language: Shell
• Homepage: https://hub.docker.com/r/madnuttah/unbound
• Size: 982 KB
• Stars: 11
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Unbound Statistics

I wanted to have the statistics of Unbound in Grafana and since I didn't want to modify my [`Unbound Docker Image`](https://github.com/madnuttah/unbound-docker) to use any third party tools like `Zabbix sender`, I found a way to get them into the Zabbix database and ship the stats to Grafana. 

Zabbix active agents can ingest files, so Unbound-Control creates a file with the statistics using a modified healthcheck script and an active Zabbix agent reads and processes the log and saves the values into the Zabbix database.

[`Screenshot`](https://raw.githubusercontent.com/madnuttah/unbound-docker-stats/main/unbound-stats/screenshots/Screenshot.png)

***

### Instructions:

Adapt the `unbound.conf` to enable extended statistics:

```

server:	

  extended-statistics: yes

  statistics-cumulative: no

  statistics-interval: 0	

```

Download the modified [`healthcheck.sh`](https://github.com/madnuttah/unbound-docker-stats/blob/main/unbound-stats/healthcheck.sh) script and place it in your persistent Unbound volume.

You also need to modify your unbound `compose` and add the following lines to the `volumes` section. 

```yaml

 unbound:

    container_name: unbound

    image: madnuttah/unbound:latest

    ...

    volumes:

    

      ...

      - ./unbound/healthcheck.sh:/usr/local/unbound/sbin/healthcheck.sh:rw

      - ./unbound/log.d/unbound-stats.log:/usr/local/unbound/log.d/unbound-stats.log:rw

      ...    

    healthcheck:

      test: /usr/local/unbound/sbin/healthcheck.sh

      interval: 60s

      retries: 5

      start_period: 15s

      timeout: 30s        

```

Create an Active Zabbix agent on the docker host where Unbound runs on.

Map the `unbound-stats.log` to the agent's volumes in it's `compose` like so:

```yaml

  zabbix-agent2:

    image: zabbix/zabbix-agent2:alpine-6.4-latest

    ...

    volumes: 

      ...  

      - ./unbound/log.d/unbound-stats.log:/var/log/unbound-stats.log:ro

      - /var/run/docker.sock:/var/run/docker.sock:ro	  

```

Download my Zabbix [`template`](https://raw.githubusercontent.com/madnuttah/unbound-docker-stats/main/unbound-stats/Zabbix%20Template%20Unbound%20Statistics.json) and import it into your host in Zabbix.

Zabbix should display values in `Latest Data` after a little while and you can now begin to configure your Grafana panels or Zabbix graphs as you like.

I guess there are many things to optimize or to make better, there are no graphs or such for Zabbix or completed panels for Grafana for example. If you like to contribute, you're most welcome.

**This was tested only with Zabbix 6.4 using [`madnuttah/unbound-docker`](https://github.com/madnuttah/unbound-docker).**