Watchdog: DNS

Prüft, ob ein Hostname per DNS auflöst, optional auf eine erwartete IPv4-Adresse und über einen eigenen Resolver. Typ dns, Runner Dashboard oder Agent.

English Version

Zurück zu den Check-Typen

Watchdog: DNS

Der Check löst einen Hostnamen auf und prüft optional, ob eine erwartete IPv4-Adresse unter den Antworten ist.

Eigenschaft	Wert
Typ-Kennung	`dns`
Runner	Dashboard oder Agent
Ziel in der E-Mail	`Hostname`

Felder

Feld	Schlüssel	Standard	Bedeutung
Hostname	`hostname`		Pflicht. Der aufzulösende Name
Expected IP	`expected_ip`	leer	Optional. `FAIL`, wenn diese Adresse nicht in der Antwort steht. Leer prüft nur, dass der Name auflöst
Custom resolver	`resolver`	leer	Optional. IP-Adresse eines DNS-Servers statt des System-Resolvers

Ablauf

Ohne eigenen Resolver fragt der Check den System-Resolver und erhält die IPv4-Adressen des Namens. Mit eigenem Resolver ruft er das Programm dig auf (dig +short +time=5 @<Resolver> <Hostname> A) und liest nur gültige IP-Adressen aus der Ausgabe.

Situation	Status	Meldung
Name löst auf, keine erwartete IP gesetzt oder enthalten	`OK`	`<Hostname> → <IP>, <IP>`
Erwartete IP fehlt in der Antwort	`FAIL`	`Expected IP <IP> not found for <Hostname> (resolved: ...)`
Name löst nicht auf	`FAIL`	`DNS resolution failed for <Hostname>: Name or service not known`
Antwort ohne Einträge	`FAIL`	`DNS returned no records for <Hostname>`
Resolver ist keine gültige IP	`FAIL`	`Invalid resolver "<Wert>": must be a valid IP address`
Resolver ist eine private oder reservierte Adresse	`FAIL`	`Resolver "<Wert>" is a private or reserved IP address and is not allowed`
`dig` schlägt fehl	`FAIL`	`DNS resolution via <Resolver> failed for <Hostname> (exit <Code>)`
Kein Hostname konfiguriert	`UNKNOWN`	`No hostname configured`

Für einen eigenen Resolver muss dig im Container verfügbar sein. Das mitgelieferte Dockerfile installiert es nicht. Ist dig nicht vorhanden, endet der Check mit exit 127.

Es werden nur A-Records (IPv4) ausgewertet, IPv6-Adressen erscheinen nicht in der Antwort. Private Resolver-Adressen wie 10.0.0.53 lehnt der Check bewusst ab.