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
FreeRADIUSwith 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-enabledln -s ../sites-available/status status- restart FreeRADIUS server
Metrics
All metrics have "freeradius." prefix.
| Metric | Scope | Dimensions | Units |
|---|---|---|---|
| authentication | global | requests, responses | packets/s |
| authentication_access_responses | global | accepts, rejects, challenges | packets/s |
| bad_authentication | global | dropped, duplicate, invalid, malformed, unknown-types | packets/s |
| proxy_authentication | global | requests, responses | packets/s |
| proxy_authentication_access_responses | global | accepts, rejects, challenges | packets/s |
| proxy_bad_authentication | global | dropped, duplicate, invalid, malformed, unknown-types | packets/s |
| accounting | global | requests, responses | packets/s |
| bad_accounting | global | dropped, duplicate, invalid, malformed, unknown-types | packets/s |
| proxy_accounting | global | requests, responses | packets/s |
| proxy_bad_accounting | global | dropped, duplicate, invalid, malformed, unknown-types | packets/s |
Configuration
Edit the go.d/freeradius.conf configuration file using edit-config from the
Netdata 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
To troubleshoot issues with the freeradius collector, run the go.d.plugin with the debug option enabled. The output
should give you clues as to why the collector isn't working.
-
Navigate to the
plugins.ddirectory, usually at/usr/libexec/netdata/plugins.d/. If that's not the case on your system, opennetdata.confand look for thepluginssetting under[directories].cd /usr/libexec/netdata/plugins.d/ -
Switch to the
netdatauser.sudo -u netdata -s -
Run the
go.d.pluginto debug the collector:./go.d.plugin -d -m freeradius
Documentation
¶
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type FreeRADIUS ¶ added in v0.16.0
type FreeRADIUS struct {
module.Base
Config `yaml:",inline"`
// contains filtered or unexported fields
}
func New ¶
func New() *FreeRADIUS
func (FreeRADIUS) Charts ¶ added in v0.16.0
func (FreeRADIUS) Charts() *Charts
func (FreeRADIUS) Check ¶ added in v0.16.0
func (f FreeRADIUS) Check() bool
func (FreeRADIUS) Cleanup ¶ added in v0.16.0
func (FreeRADIUS) Cleanup()
func (*FreeRADIUS) Collect ¶ added in v0.16.0
func (f *FreeRADIUS) Collect() map[string]int64
func (*FreeRADIUS) Init ¶ added in v0.16.0
func (f *FreeRADIUS) Init() bool
Source Files
Directories