Nerd For Tech
Published in

Nerd For Tech

Monitoring & Alerting for WireGuard VPN


WireGuard is a fast, modern, and secure VPN tunnel software by Jason A. Donenfeld. It aims to be faster, simpler, leaner, and more useful than IPsec or considerably more performant than OpenVPN.

Wireguard is “work of art” — Linus Torvalds

When you have a WireGuard VPN tunnel powering critical services, it’s important to monitor the VPN tunnel's health and set up an alert.

In this article, we’ll set up the Prometheus WireGuard exporter, Grafana Dashboard, and Alerts Manager.

WireGuard Prometheus Exporter

Firstly, we’ll install WireGuard Prometheus exporter on the WireGuard instance. Basically, the exporter exposes wg show all dump results in a format Prometheus understands.

The exporter is written in Rust and is very light on server resources, both in terms of memory and CPU usage.

For the moment, there are no pre-built binaries for the exporter. Thus, we’ll have to build it. Since it’s written in Rust, it’s fairly straightforward.

NOTE: yum is used, you can any package manager.

1. Build and install wireguard prometheus exporter

$ yum install cargo  # RedHat-based
$ cargo install prometheus_wireguard_exporter
$ install -m755 /root/.cargo/bin/prometheus_wireguard_exporter /usr/local/bin/
$ yum remove cargo

2. Install systemd service for the exporter

NOTE: If you’re using custom WireGuard configuration, specify that in-place of /etc/wireguard/wg0.conf

$ cat <<EOF  > /etc/systemd/system/prometheus-wireguard-exporter.service
Description=Prometheus WireGuard Exporter

ExecStart=/usr/local/bin/prometheus_wireguard_exporter -n /etc/wireguard/wg0.conf


And enable the exporter service by running the following command:

$ systemctl enable --now prometheus-wireguard-exporter.service

3. Verify exporter service is running

$ curl localhost:9586/metrics

Configure Prometheus

Next, we’ll configure Prometheus to scrape the Wireguard exporter metrics.

Add the following scape config job to /etc/prometheus/prometheus.yaml

- job_name: wireguard-exporter
- labels:
instance: my-wireguard-tunnel

And reload the prometheus service

$ systemctl reload prometheus

Wireguard Grafana Dashboard

  1. Login to your Grafana UI
  2. Download the following JSON file and import dashboard as JSON file

Fig: Import dashboard button screen
Fig: Import from file screen

3. Finally, hit import.

Fig: Import dashboard screen

Now, duplicate the“Last Handshake” panel and customize it so we can create alerts on it.

  1. Create a duplicate panel of “Last Handshake”
Fig: Duplicate Last Handshake” panel

2. Edit the duplicate panel

3. Modify the metrics to the following:

time() - wireguard_latest_handshake_seconds

3. Set the Legend to {{instance}}

4. Turn off the Instant metrics.

3. Choose the Graph Visualization from the Panel tab

4. From theField tab and change Unit to short from From Now

Fig: Unit change screen

5. Finally, click Save

Fig: Customized panel

Alert Manager

Now, let’s create alerts if the WireGuard connection is lost.

  1. Edit the panel
Fig: Edit panel screen

2. Click on the Alerts tab and click “Create Alert”

Fig: Create alert screen

3. Set the condition as WHEN avg() OF query(A, 1m, now) IS ABOVE 180

NOTICE: Alert threshold bar should appear in the dashboard.

Fig: Alert condition screen

4. Create Pagerduty alert or Slack alert

Fig: Send to screen

5. Finally click “Save”

NOTE: Normally WireGuard sends a health check every 2 minutes, so it’s safe to keep 3 minutes, i.e, 180 seconds as alerting threshold.


Alongside WireGuard tunnel monitoring, it’s important to monitor WireGuard tunnel instances as well, which is not covered in this article.

I hope you found this article helpful — Stay safe👋





NFT is an Educational Media House. Our mission is to bring the invaluable knowledge and experiences of experts from all over the world to the novice. To know more about us, visit

Recommended from Medium

Making your first API callout from Mulesoft

Our Approach to Pull Requests

Controlling screen orientation in Flutter apps on a per-screen basis

Review: Clean Code

Package GitHub Actions automatically with GitHub Actions

5 Projects you should do to improve your Resume.

Great Software Developers Never Look at Their Hands

Learn CSS Selectors While Preparing Bento Boxes

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store
Puru Tuladhar

Puru Tuladhar

Make Complex Simple (

More from Medium

Integrating a Microk8s cluster in GitLab

[k8s] How to mount local directory (persistent volume) to Kubernetes pods of Docker Desktop for Mac?

An update on the Stock Trader cloud-native application

kubeadm init: wait-control-pane timeout on Ubuntu 20.04