A lightweight network observer written in Go that monitors network interfaces, performs ICMP and DNS health checks, and exposes Prometheus metrics.
- Periodically samples DHCPv4 and DHCPv6 addresses on a specified interface.
- Performs ICMP pings to one or more target hosts.
- Performs DNS health checks for specified DNS servers and query names.
- Dynamically adds and removes IP addresses on the interface during checks.
- Exposes Prometheus metrics via an HTTP endpoint.
- Supports toggling IPv4 or IPv6 monitoring independently.
- Verbose logging for debugging and operational insight.
git clone git@github.com:dhtech/observer.git
cd observer
go build .
./observer| Flag | Default | Description |
|---|---|---|
-interface |
"" |
Network interface to operate on |
-icmp-targets |
"" |
Comma-separated list of ICMP targets |
-icmp-count |
3 |
Number of ICMP packets to send per target |
-interval |
5s |
Interval for collecting Prometheus metrics |
-verbose |
false |
Enable verbose logging |
-disable4 |
false |
Disable all IPv4 client behavior (DHCPv4 & ICMPv4) |
-disable6 |
false |
Disable all IPv6 client behavior (DHCPv6 & ICMPv6) |
-qname |
healthcheck.event.dreamhack.se. |
DNS health check query name |
-dns |
"" |
Comma-separated DNS servers to probe |
-host-port |
9023 |
HTTP port to serve Prometheus metrics |
example:
./observer \
-interface eth0 \
-icmp-targets 8.8.8.8,1.1.1.1 \
-icmp-count 5 \
-dns 8.8.8.8,1.1.1.1 \
-interval 10s \
-verbose