Grafana Dashboard

A pre-built Grafana dashboard is included for monitoring the bouncer and router health.

Screenshots

Dark theme:

Light theme:

Prerequisites

Before importing the dashboard, you need:

1. A running Grafana instance (v9.0+ recommended)
2. A running Prometheus instance scraping the bouncer
3. The bouncer running with metrics.enabled: true

Setup Guide

1. Configure the Bouncer for Metrics

Enable Prometheus metrics in your bouncer configuration:

config.yaml

metrics:
  enabled: true
  listen_addr: "0.0.0.0"
  listen_port: 2112
  routeros_poll_interval: 30s # Enables RouterOS system metrics

Verify the metrics endpoint is working:

curl -s http://<bouncer-host>:2112/metrics | head -20

2. Configure Prometheus to Scrape the Bouncer

Add a scrape job to your Prometheus configuration:

prometheus.yml

scrape_configs:
  - job_name: "cs-routeros-bouncer"
    static_configs:
      - targets: ["<bouncer-host>:2112"]
    scrape_interval: 15s

Replace <bouncer-host> with the IP or hostname where the bouncer is running.

Tip

If the bouncer runs on the same host as Prometheus, use localhost:2112. For Docker setups, use the container name or network IP.

After adding the scrape config, reload Prometheus:

# Reload via HTTP (if --web.enable-lifecycle is set)
curl -X POST http://localhost:9090/-/reload

# Or restart Prometheus
systemctl restart prometheus

Verify the target is healthy in Prometheus UI: Status → Targets — the cs-routeros-bouncer target should show UP.

3. Add Prometheus Data Source in Grafana

1. Open Data Sources

   In Grafana, navigate to Connections → Data sources → Add data source.

2. Select Prometheus

   Choose Prometheus from the list.

3. Configure the connection

   Set the Prometheus server URL to your Prometheus instance (e.g., http://localhost:9090 or http://prometheus:9090 for Docker).

4. Save & Test

   Click Save & Test — you should see “Successfully queried the Prometheus API.”

4. Import the Dashboard

1. Open Grafana import

   Navigate to Dashboards → New → Import.

2. Upload the dashboard JSON

   Upload grafana/dashboard.json from the repository.

3. Select Prometheus data source

   Choose the Prometheus data source you configured in step 3.

4. Click Import

   The dashboard will be created and immediately display data.

Note

If panels show “No data”, verify: (1) Prometheus is scraping the bouncer successfully, (2) the correct data source is selected, and (3) the bouncer has been running long enough to generate metrics.

Dashboard Panels

The dashboard contains 41 panels organized into 9 rows:

Row	Panels
Overview	RouterOS Connected, Active Decisions (IPv4/IPv6/Total), IPv4/IPv6 Ratio, Uptime, Bouncer Info
RouterOS System	RouterOS System, CPU Load Over Time, Memory Usage Over Time, CPU Temperature Over Time, RouterOS Uptime, RouterOS Info
Decisions	Active Decisions Over Time, Cumulative Decisions, Decisions Processed (Rate)
Decisions by Origin	Active Decisions by Origin, Decisions by Origin (Rate), Cumulative Decisions by Origin
Firewall Traffic	Processed Bytes, Processed Packets, Dropped Bytes, Dropped Packets, Drop Rate, Processed/Dropped Traffic Rate, Processed/Dropped Traffic by Protocol (Rate), Processed Traffic (Cumulative), Drop Rate Over Time
Errors & Reconciliation	Error Rate, RouterOS Connection, Reconciliation Duration, Last Reconciliation, Total Errors
Performance & Operations	Operation Latency (p50/p95/p99), Operation Rate
Process Resources	Memory Usage, CPU Usage, Goroutines & File Descriptors
Configuration	Bouncer Configuration

Tip

Use the time range selector to zoom into specific events. The “Decisions Processed” panel is useful for correlating ban spikes with specific incidents.

Related

Prometheus MetricsFull reference of all exported metrics

Health EndpointHTTP health check for uptime monitoring