PRTG Custom Whois Monitoring Script
Dieses Skript ermöglicht es, Domains in PRTG zu überwachen. Es nutzt whois.exe
, um den Status einer Domain zu überprüfen und optional das Erstellungsdatum (Created) sowie das letzte Aktualisierungsdatum (Updated) auszugeben.
📌 Funktionen
✅ Überwachung von Domains in PRTG (Status: registriert/frei)
✅ Erkennt das "Creation Date" und "Updated Date" für .com
, .net
, .org
uvm.
✅ PRTG-kompatible JSON-Ausgabe für einfache Integration
✅ Fehlermeldungen und Debugging über Log-Dateien
🛠 Einrichtung in PRTG
1️⃣ Skript speichern
Speichere die Datei als CustomWhoisCheck.ps1
unter:
C:\Program Files (x86)\PRTG Network Monitor\Custom Sensors\EXEXML\
2️⃣ whois.exe installieren
Lade whois.exe von Microsoft Sysinternals herunter und speichere sie z. B. in:
C:\Apps\WhoIs\whois.exe
🔗 Download: Whois von Sysinternals
🔧 Nutzung in PRTG
1️⃣ Neuen Sensor in PRTG erstellen
-
Neuen Sensor hinzufügen
-
Sensor-Typ:
EXE/Script Advanced
-
Skript auswählen:
CustomWhoisCheck.ps1
-
Parameter hinzufügen:
-Domain "techniverse.net"
-
Sensor speichern & testen
2️⃣ Alternative: Domain als PRTG-Parameter setzen
Falls du Domains direkt über das Gerät in PRTG definieren möchtest:
-Domain "%host"
🚦 Wann wird der Sensor rot?
🔴 Sensor wird rot, wenn:
- Die Domain frei ist → Gefahr von Domaingrabbing!
whois.exe
keine Antwort liefert (z. B. Netzwerkproblem)- Der Whois-Server nicht erreichbar ist
🟢 Sensor bleibt grün, wenn:
- Die Domain registriert ist
- Whois-Abfrage erfolgreich war
📌 .de
-Domains zeigen nur "registriert", da DENIC keine Creation/Updated-Daten über Whois bereitstellt.
🔴 1️⃣ PRTG so einstellen, dass der Sensor auf "Fehler" geht (rot)
Standardmäßig zeigt PRTG den Sensor als "OK" an, auch wenn der Wert 2 ist. Damit PRTG dies als Fehler erkennt, müssen wir eine Einstellung anpassen:
- Gehe in PRTG zu deinem Sensor
- Klicke auf "Kanäle"
- Wähle den Kanal "Domain Status" aus
- Scrolle nach unten zu "Erweiterte Kanal-Einstellungen"
- Setze bei "Fehler, wenn Wert größer als" den Wert auf 1
- Speichern & testen
📌 Ergebnis:
- 0 = OK (🟢 grün) → Domain ist registriert
- 2 = Fehler (🔴 rot) → Domain ist frei und kann registriert werden!
Jetzt sollte der Sensor auf rot springen, wenn die Domain frei wird. ✅
Autor: Patrick Asmus
Lizenz: MIT