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 |
| 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 |
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
digim Container verfügbar sein. Das mitgelieferteDockerfileinstalliert es nicht. Istdignicht vorhanden, endet der Check mitexit 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.