Einige der in diesem Beitrag geteilten Links sind Affiliate-Links. Wenn du auf den Link klickst und etwas kaufst, erhalten wir eine Affiliate-Provision ohne zusätzliche Kosten für dich.
Überblick #
AdGuard-Exporter ist ein Docker-Container, der speziell entwickelt wurde, um Metriken aus deiner AdGuard Home-Instanz zu extrahieren und sie für die Überwachung und Analyse in Tools wie Prometheus oder Grafana bereitzustellen. Mit AdGuard-Exporter kannst du wichtige Daten wie blockierte DNS-Anfragen, gefilterte Werbung, durchgeleitete Anfragen und viele andere Statistiken sammeln. Diese Daten kannst du anschließend in Prometheus speichern und in Grafana visuell aufbereiten, um ein umfassendes Monitoring deiner AdGuard Home-Instanz zu ermöglichen.
Hauptfunktionen #
- export von AdGuard Home Metriken: AdGuard-Exporter sammelt und exportiert Metriken von deiner AdGuard Home-Instanz, die in Überwachungswerkzeugen weiterverarbeitet werden können.
- Integration mit Prometheus: Die App ist speziell dafür entwickelt, mit Prometheus zusammenzuarbeiten, was dir ermöglicht, deine Metriken zu speichern und zu analysieren.
- Visualisierung mit Grafana: Du kannst die gesammelten Daten in Grafana visualisieren und detaillierte Dashboards erstellen, um den Zustand und die Performance deines AdGuard Home-DNS-Servers zu überwachen.
- Leichte Konfiguration: Der Exporter lässt sich einfach in unRAID als Docker-Container installieren und erfordert nur minimale Konfiguration.
Voraussetzungen #
Um AdGuard-Exporter auf deinem unRAID-Server zu installieren, brauchst du:
- Einen laufenden unRAID-Server (Version 6.8 oder höher).
- Docker muss auf deinem unRAID-Server aktiviert sein.
- Eine AdGuard Home-Instanz, deren Daten du exportieren möchtest.
- Das Community Applications Plugin, um den Docker-Container einfach zu installieren.
- Prometheus und optional Grafana, um die exportierten Daten zu speichern und zu visualisieren.
Installation von AdGuard-Exporter über das Community Applications Plugin #
Um AdGuard-Exporter auf deinem unRAID-Server zu installieren, nutzt du am besten das Community Applications Plugin, das die Installation von Docker-Containern stark vereinfacht.
Schritt 1: Installation des Community Applications Plugins #
Falls du das Community Applications Plugin noch nicht installiert hast, folge diesen Schritten:
- Öffne das unRAID Webinterface.
- Navigiere zu Plugins und klicke auf Install Plugin.
- Füge die folgende URL in das Feld ein:
https://raw.githubusercontent.com/Squidly271/community.applications/master/plugins/community.applications.plg - Klicke auf Install, um das Plugin zu installieren.
Schritt 2: AdGuard-Exporter über Community Applications installieren #
- Öffne den Apps-Reiter im unRAID-Webinterface, um das Community Applications Plugin zu starten.
- Suche nach AdGuard-Exporter in der Suchleiste.
- Wähle die App aus den Suchergebnissen und klicke auf Installieren.
Schritt 3: Konfiguration des AdGuard-Exporter Docker-Containers #
- API-Verbindung herstellen: Gib während der Installation die URL und den API-Schlüssel deiner AdGuard Home-Instanz an, damit der Exporter auf die Daten zugreifen kann.
ADGUARD_URL: Die URL deiner AdGuard Home-Instanz (z. B.http://192.168.1.100:3000).ADGUARD_API_KEY: Der API-Schlüssel deiner AdGuard Home-Instanz, den du im AdGuard Home-Webinterface findest.
- Prometheus konfigurieren: AdGuard-Exporter ist dafür ausgelegt, die Metriken direkt an Prometheus zu senden. Stelle sicher, dass du die Prometheus-Server-Adresse korrekt in den Docker-Container-Einstellungen angibst.
- Standardmäßig werden die Metriken unter dem Port 9617 bereitgestellt.
- Netzwerk- und Port-Einstellungen: Du kannst den Port und die Netzwerkeinstellungen des Containers anpassen, falls nötig. Normalerweise läuft der Exporter im Bridge-Modus und nutzt den Port 9617 für Prometheus.
Schritt 4: Prometheus und Grafana einrichten #
Prometheus-Server: Stelle sicher, dass dein Prometheus-Server korrekt läuft und du die Scrape-Config für den AdGuard-Exporter in der prometheus.yml-Datei hinzufügst: “`yaml
- job_name: 'adguard-exporter'
static_configs:
- targets: ['192.168.1.100:9617']
Grafana Dashboard: In Grafana kannst du ein neues Dashboard erstellen und Prometheus als Datenquelle hinzufügen. Du kannst dann Metriken wie blockierte Anfragen, gefilterte Werbung und DNS-Statistiken in Grafana visualisieren.
Schritt 5: Überwachung und Visualisierung #
- Sobald die Metriken in Prometheus erfasst werden, kannst du mit Grafana ein Dashboard erstellen, um die Daten grafisch darzustellen. Erstelle Diagramme für Metriken wie blockierte Anfragen, DNS-Antwortzeiten und die Anzahl durchgeleiteter DNS-Anfragen.
- Du kannst dein Dashboard so konfigurieren, dass du Alarme erhältst, wenn ungewöhnliche Aktivität erkannt wird (z. B. eine plötzliche Zunahme an DNS-Anfragen oder blockierten Domains).
Zusammenfassung #
Mit AdGuard-Exporter kannst du die Leistung und Sicherheit deines AdGuard Home-DNS-Servers effektiv überwachen, indem du Metriken exportierst und sie in Tools wie Prometheus und Grafana visualisierst. Die Installation auf unRAID erfolgt einfach über das Community Applications Plugin, und mit Prometheus kannst du sicherstellen, dass alle wichtigen DNS-Daten aufgezeichnet und analysiert werden. Dies hilft dir dabei, ein besseres Verständnis über die Nutzung und den Schutz deines Netzwerks zu gewinnen und Probleme frühzeitig zu erkennen.
