freeradius

README

FreeRADIUS monitoring with Netdata

FreeRADIUS is a modular, high performance free RADIUS suite.

This module will monitor one or more FreeRADIUS servers, depending on your configuration.

Requirements

• FreeRADIUS with enabled status feature.

The configuration for the status server is automatically created in the sites-available directory. By default, server is enabled and can be queried from every client.

To enable status feature do the following:

• cd sites-enabled
• ln -s ../sites-available/status status
• restart FreeRADIUS server

Charts

It produces following charts:

• Authentication in pps
• Authentication Responses in pps
• Bad Authentication Requests in pps
• Proxy Authentication in pps
• Proxy Authentication Responses in pps
• Proxy Bad Authentication Requests in pps
• Accounting in pps
• Bad Accounting Requests in pps
• Proxy Accounting in pps
• Proxy Bad Accounting Requests in pps

Configuration

Edit the go.d/freeradius.conf configuration file using edit-config from the your agent's config directory, which is typically at /etc/netdata.

cd /etc/netdata # Replace this path with your Netdata config directory
sudo ./edit-config go.d/freeradius.conf

Here is an example for 2 servers:

jobs:
  - name: local
    host: 127.0.0.1

  - name: remote
    host: 203.0.113.10
    secret: secret 

For all available options please see module configuration file.

Troubleshooting

Check the module debug output. Run the following command as netdata user:

./go.d.plugin -d -m freeradius

Documentation

Index

• type Charts
• type Config
• type Dims
• type FreeRADIUS
  • func New() *FreeRADIUS
  • func (FreeRADIUS) Charts() *Charts
  • func (f FreeRADIUS) Check() bool
  • func (FreeRADIUS) Cleanup()
  • func (f *FreeRADIUS) Collect() map[string]int64
  • func (f *FreeRADIUS) Init() bool

Types

type Charts

type Charts = module.Charts

Charts is an alias for module.Charts

type Config

type Config struct {
	Address string
	Port    int
	Secret  string
	Timeout web.Duration
}

type Dims

type Dims = module.Dims

Dims is an alias for module.Dims

type FreeRADIUS

type FreeRADIUS struct {
	module.Base
	Config `yaml:",inline"`
	// contains filtered or unexported fields
}

func New

func New() *FreeRADIUS

func (FreeRADIUS) Charts

func (FreeRADIUS) Charts() *Charts

func (FreeRADIUS) Check

func (f FreeRADIUS) Check() bool

func (FreeRADIUS) Cleanup

func (FreeRADIUS) Cleanup()

func (*FreeRADIUS) Collect

func (f *FreeRADIUS) Collect() map[string]int64

func (*FreeRADIUS) Init

func (f *FreeRADIUS) Init() bool