Skip to content
Bleemeo Bleemeo

FreeRADIUS

Auto-Detection
Exporter Metrics

Auto-Detection

Section titled “Auto-Detection”

Glouton automatically detects FreeRADIUS when it is running on the monitored host.

Exporter Metrics

Section titled “Exporter Metrics”

Detailed FreeRADIUS metrics are available through the third-party bvantagelimited/freeradius_exporter.

Prerequisites

Section titled “Prerequisites”
  • FreeRADIUS server installed and running
  • Glouton agent installed on the same host
  • Go toolchain (if building from source) or access to GitHub releases

Service Configuration

Section titled “Service Configuration”

Enable the status server in FreeRADIUS. Create or edit /etc/freeradius/sites-enabled/status:

server status {
    listen {
        type = status
        ipaddr = 127.0.0.1
        port = 18121
    }
    client admin {
        ipaddr = 127.0.0.1
        secret = adminsecret
    }
}

Restart FreeRADIUS to apply the change:

Terminal window
sudo systemctl restart freeradius

Verify the status server is accessible:

Terminal window
echo "Message-Authenticator = 0x00" | radclient 127.0.0.1:18121 status adminsecret

Installing the Exporter

Section titled “Installing the Exporter”

Download the latest release from the freeradius_exporter releases page, or install with Go:

Terminal window
go install github.com/bvantagelimited/freeradius_exporter@latest

Start the exporter:

Terminal window
freeradius_exporter --radius.address=127.0.0.1:18121 --radius.secret=adminsecret

The exporter listens on port 9812 by default. Verify it is working:

Terminal window
curl http://localhost:9812/metrics

For production use, create a systemd service unit to manage the exporter process.

Glouton Configuration

Section titled “Glouton Configuration”
Terminal window
sudo tee /etc/glouton/conf.d/99-freeradius.conf > /dev/null << 'EOF'
metric:
  prometheus:
    targets:
      - url: "http://localhost:9812/metrics"
        name: "freeradius"
        allow_metrics:
          - "freeradius_access_requests_total"
          - "freeradius_access_accepts_total"
          - "freeradius_access_rejects_total"
          - "freeradius_accounting_requests_total"
EOF
Metric Description
freeradius_access_requests_total Total number of Access-Request packets received
freeradius_access_accepts_total Total number of Access-Accept packets sent
freeradius_access_rejects_total Total number of Access-Reject packets sent
freeradius_accounting_requests_total Total number of Accounting-Request packets received