Core Concepts
DNS Monitor
Validate DNS records against expected values
DNS monitors query records for a host and compare returned values to your expected values.
Minimum setup
Configure:
hostlookupRecord(defaultA)matchType(ANYorALL, defaultANY)- at least one expected value in
values
nameServer is optional (leave blank for resolver defaults).
Configuration fields
| Field | Type | Default | Notes |
|---|---|---|---|
host |
string |
— | Required |
nameServer |
string |
"" |
Optional override |
lookupRecord |
string |
A |
Required |
matchType |
ANY|ALL |
ANY |
Required |
values |
string[] |
[] |
Required (non-empty values) |
Match behavior
ANY: monitor is UP when at least one expected value is presentALL: monitor is UP only when all expected values are present
Normalization rules
Before comparison, values are normalized by runtime logic:
- lowercased
- trailing
.removed - trimmed whitespace
Example
{
"type": "DNS",
"type_data": {
"host": "example.com",
"lookupRecord": "A",
"matchType": "ANY",
"values": ["93.184.216.34"]
}
}
Troubleshooting
- Unexpected DOWN: copy exact record output (after normalization rules)
- No response: check
lookupRecordtype and resolver reachability - Partial mismatches: use
ANYfor multi-value dynamic DNS setups