dns_exporter
dns_exporter is a multi-target Prometheus exporter with an exclusive focus on DNS monitoring. It is built on the excellent libraries dnspython and the Prometheus Python client library.
dns_exporter can be used to monitor availability and performance of DNS servers, and to validate the responses they return. It can monitor recursive and authoritative servers regardless of the software they run. You can use it to make sure your (or your providers) DNS servers are sending the replies you expect and configure Prometheus and Alertmanager to notify you if something stops working.
dns_exporter works similar to the Blackbox exporter where Prometheus asks the exporter to scrape the target, rather than the exporter itself being the target. This is called the Multi Target Exporter Pattern. It is typically used in black-box style exporters where 1) the thing you are monitoring is not under your control, or 2) you want to measure the path as well. Often when monitoring DNS both 1) and 2) are relevant.
This means that for each scrape Prometheus speaks HTTP to the dns_exporter which then speaks DNS with the target DNS server and returns the resulting metrics over HTTP to Prometheus. dns_exporter supports doing DNS queries over plain port 53 UDP and TCP, as well as DoT, DoH, DoH3, and DoQ.
Installation
dns_exporter is not yet in any OS package managers but installing dns_exporter can be done from pypi. This is the recommended way to install for now:
pip install dns_exporter
There is also a Docker image so you can get your container on:
docker run -p 15353:15353 tykling/dns_exporter:latest
There is also a Kubernetes Helm Chart (maintained by @christianhuth) available on ArtifactHUB.
Python Support
Python 3.10, 3.11, 3.12, 3.13 and 3.14 are fully supported. dns_exporter aims to follow the officially supported Python versions.
Documentation
The documentation is available on ReadTheDocs
Grafana Dashboard
There is a Grafana dashboard you can use as a starting point for your own dashboards.
1 maintainer
Metadata
1 maintainer
Release files for dns-exporter 1.2.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| dns_exporter-1.2.3.tar.gz | 76.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| dns_exporter-1.2.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 115.8 kB
Release files / dns_exporter-1.2.3.tar.gz
| Download URL | dns_exporter-1.2.3.tar.gz |
|---|---|
| Size | 76.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
25e7b1f16ab938e8e4695ccfbdf4fc6e3f3ed527336aade8949718535870fc96
|
|
BLAKE2b-256 checksum How to use checksums |
41e6f9eb679a8905e77325deead856344cf51e333f4b3b7d7a65cf0fa5108c6a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 1, 2026.
Transparency logRelease files / dns_exporter-1.2.3-py3-none-any.whl
| Download URL | dns_exporter-1.2.3-py3-none-any.whl |
|---|---|
| Size | 39.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0966632cd64ac8a5973f70a52682c2b6b10440f11fd31c2c2db77cf2b8f909e7
|
|
BLAKE2b-256 checksum How to use checksums |
b59ecc2be4ce3d5679fd3c773e73f65c1d88e538cda04b73ed3bfd8ff7a5c435
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 1, 2026.
Transparency log
