https://github.com/tykling/dns_exporter
A multi-target Prometheus exporter with an exclusive focus on DNS monitoring.
https://github.com/tykling/dns_exporter
Last synced: 5 months ago
JSON representation
A multi-target Prometheus exporter with an exclusive focus on DNS monitoring.
- Host: GitHub
- URL: https://github.com/tykling/dns_exporter
- Owner: tykling
- License: bsd-3-clause
- Created: 2022-12-23T21:28:26.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-07-15T16:55:21.000Z (9 months ago)
- Last Synced: 2024-11-18T22:01:22.426Z (5 months ago)
- Language: Python
- Homepage:
- Size: 334 KB
- Stars: 36
- Watchers: 3
- Forks: 5
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- jimsghstars - tykling/dns_exporter - A multi-target Prometheus exporter with an exclusive focus on DNS monitoring. (Python)
README
[](https://github.com/tykling/dns_exporter/actions/workflows/tox.yml)
[](https://dns-exporter.readthedocs.io/latest/)
[](https://github.com/astral-sh/ruff)
[](https://codecov.io/gh/tykling/dns_exporter)
[](https://pypi.org/project/dns-exporter/)
[](https://hub.docker.com/r/tykling/dns_exporter)# dns_exporter
`dns_exporter` is a [multi-target](https://prometheus.io/docs/guides/multi-target-exporter/) [Prometheus](https://prometheus.io/) exporter with an exclusive focus on DNS monitoring. It is built on the excellent libraries [dnspython](https://github.com/rthalley/dnspython) and [the Prometheus Python client library](https://github.com/prometheus/client_python).`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](https://prometheus.io/) and [Alertmanager](https://prometheus.io/docs/alerting/latest/alertmanager/) to notify you if something stops working.
`dns_exporter` works similar to the [Blackbox exporter](https://github.com/prometheus/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](https://prometheus.io/docs/guides/multi-target-exporter/). 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` 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`
# Documentation
The documentation is available on [ReadTheDocs](https://dns-exporter.readthedocs.io/latest/)# Grafana Dashboard
There is a [Grafana dashboard](https://grafana.com/grafana/dashboards/20617-dns-exporter/) you can use as a starting point for your own dashboards.# Fancy Repo Activity Graphics
