AdGuard Home is a network-wide ad blocking and tracking software. Once you've set it up, it will cover your devices without the need for any client-side software.

If you want to monitor your AdGuard Home instance with Zabbix, this template provides some useful monitoring items.
The monitoring is done via "REST-ish" API as AdGuard Home offers an OpenAPI specification.

The main focus is on monitoring statistics from AdGuard Home.

For more flexibility, the release includes templates that cover two monitoring methods, one for native HTTP data retrieval and another for Zabbix Agent Active. Both methods provide the same monitoring items, but with different item types. They are not intended to be used together on the same host.

There are also two independent template types. One is for HTTP AdGuard Home general status and statistics, and the other is for filter parameters discovery.
In total, the released yaml file contains four templates.

• AdGuard Home Stats by HTTP
• AdGuard Home Stats by Zabbix Agent Active
• AdGuard Home Filters by HTTP
• AdGuard Home Filters by Zabbix Agent Active

• AdGuard Home
  • Zabbix Agent required only for active monitoring

  • The template uses the system.run[*] key for active monitoring with the Zabbix Agent. The AllowKey=system.run[*] parameter must be enabled to allow the agent to collect data locally.
  • Accordingly, AdGuard Home must allow requests from itself when using an active Zabbix Agent.

This template has been tested with AdGuard Home version > 0.107 on an Asus RT-AX86U router running an Asus Merlin firmware and Mikrotik RouterOS. It should work with any recent version of AdGuard Home.

If the AdGuard Home web user is password protected, the client must use an authentication mechanism when sending requests to the server. Basic access authentication is the offered method. A client must include an Authorization HTTP header along with all requests:

Authorization: Basic BASE64_DATA

Where BASE64_DATA is a base64-encoded data for your username:password string.

1️⃣ After importing the template to Zabbix and creating AdGuard's host, encode your AdGuard Authorization string username:password to Base64. Examples:

• Shell

echo -n 'username:password' | base64

• Python

import base64
string = 'username:password'
base64.b64encode(bytes(string, 'utf-8'))

• PowerShell

$string = 'username:password'
[Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes($string))

2️⃣ Copy and paste the encoded string into your host's macro {$ADGUARD.AUTH}.