Check and reports host names and port.
docker run -p 2112:2112 -e TARGET=<target-host> ghcr.io/bakito/dns-checker| Name | Description | Required | Default |
|---|---|---|---|
| TARGET | The DNS target hosts to check. ',' separated host(:port) list. Env variables can be used here with notation '${ENV_VAR_NAME}' | X | |
| INTERVAL | The check interval as duration | O | 30s |
| TIMEOUT | The check timeout as duration | O | 10s |
| WORKER | The number of workers to be used for the checks | O | 10 |
| METRICS_PORT | The port for the metrics service | O | 2112 |
| LOG_LEVEL | The log level (panic, fatal, error, warn, info, debug, trace) | O | info |
| LOG_JSON | Enables json log format if set to true | O | false |
| LOG_DURATION | log the duration of all check if set to true | O | false |
| ENABLED_CHECKS | ',' separated list of checks to enable (dns, probe-port, dig, nc, manual-dns) | O | "dns,probe-port" |
| MANUAL_DNS_HOST | dns host to be used form manual-dns check | O | |
| METRICS_NAME | set a custom metrics name | O | "dns_checker_check" |
| METRICS_HISTOGRAM_BUCKETS | Custom histogram metric buckets | O | "0.002,0.005,0.01,0.025,0.05,0.1,0.25,0.5,1,2.5,5,10,20" |
| METRICS_SUMMARY_OBJECTIVES | Custom summary metric objectives | O | "0.5:0.05,0.9:0.01,0.99:0.001" |
Exposes metrics under localhost:2112/metrics
| Key | Description |
|---|---|
| dns_checker_check_error | check resulted in an error 1 = error / 0 = OK |
| dns_checker_check_duration | The duration result of the check in milliseconds |
| dns_checker_check_summary | The summary metric of the duration |
| dns_checker_check_histogram | The histogram metric of the duration |
Each metric has the following labels
| Name | Description |
|---|---|
| target | The target of the checks |
| port | The port of the checks (may be empty) |
| check_name | The name of the check |
| version | The application version |