https://github.com/msiebuhr/prometheus-mdns-sd
mDNS/ZeroConf/Bonjour service discovery for Prometheus
https://github.com/msiebuhr/prometheus-mdns-sd
mdns prometheus service-discovery
Last synced: 7 months ago
JSON representation
mDNS/ZeroConf/Bonjour service discovery for Prometheus
- Host: GitHub
- URL: https://github.com/msiebuhr/prometheus-mdns-sd
- Owner: msiebuhr
- Created: 2016-12-01T21:29:38.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2023-03-13T10:27:44.000Z (over 2 years ago)
- Last Synced: 2025-03-18T21:09:02.956Z (7 months ago)
- Topics: mdns, prometheus, service-discovery
- Language: Go
- Size: 11.7 KB
- Stars: 21
- Watchers: 2
- Forks: 11
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Prometheus mDNS service discovery
=================================
Discovers mDNS (a.k.a. ZeroConf, a.k.a. Bonjour) service announcements under
`_prometheus-http._tcp` and `_prometheus-https._tcp` for ad-hoc discovery of
devices on LAN networks.
Install & running
go install github.com/msiebuhr/prometheus-mdns-sd
Run it
prometheus-mdns-sd -out /etc/prometheus/mdns-sd.json
And in `prometheus.yml` something along these lines:
- job_name: mdns-sd
scrape_interval: 30s
scrape_timeout: 10s
metrics_path: /metrics
scheme: http
file_sd_configs:
- files:
- /etc/prometheus/mdns-sd.json
refresh_interval: 5m
It resolves the raw IP's (the Go DNS resolver doesn't always understand
RFC6762/RFC6763's `.local` names) and captures the port-number and hostname for
later re-labeling.
## Clients
Manually create service announcement (OS X):
dns-sd -R "My test server with metrics-endpoint" _prometheus-http._tcp. . 9000 path=/metrics
And there's some code for
[arduino/esp8266](https://github.com/msiebuhr/esp8266-promstuff/blob/e7e6a353db1b74450efbfb711f51077ba0df06be/esp8266-thermometer-ds18b20.ino#L60-L65).
## Related reading
* Initial PR to get mDNS SD into Prometheus: https://github.com/prometheus/prometheus/pull/1903