mirror of
https://github.com/librenms/librenms.git
synced 2024-10-07 16:52:45 +00:00
33 lines
1.2 KiB
Markdown
33 lines
1.2 KiB
Markdown
|
source: Extensions/metrics/Graphite.md
|
||
|
|
# Enabling support for Graphite.
|
||
|
|
|
||
|
|
This module sends all metrics to a remote graphite service. You need something like Grafana for graphing.
|
||
|
|
|
||
|
|
### What you don't get
|
||
|
|
- Pretty graphs, this is why at present you need Grafana. You need to build your own graphs within Grafana.
|
||
|
|
|
||
|
|
RRD will continue to function as normal so LibreNMS itself should continue to function as normal.
|
||
|
|
|
||
|
|
### Configuration
|
||
|
|
```php
|
||
|
|
$config['graphite']['enable'] = true;
|
||
|
|
$config['graphite']['host'] = 'your.graphite.server';
|
||
|
|
$config['graphite']['port'] = 2003; // this defaults to 2003 and is usually not needed
|
||
|
|
$config['graphite']['prefix'] = 'your.metric.prefix';
|
||
|
|
```
|
||
|
|
|
||
|
|
Your metric path can be prefixed if required, otherwise the metric path for Graphite will be in the form of
|
||
|
|
`hostname.measurement.fieldname`, interfaces will be stored as `hostname.ports.ifName.fieldname`.
|
||
|
|
|
||
|
|
The same data then stored within rrd will be sent to Graphite and recorded. You can then create graphs within Grafana
|
||
|
|
to display the information you need.
|
||
|
|
|
||
|
|
### Graphite Configuration
|
||
|
|
As LibreNMS updates its metrics every 5 minutes, the following addition to your storage-schemas.conf is suggested.
|
||
|
|
|
||
|
|
```
|
||
|
|
[network]
|
||
|
|
pattern = your\.metric\.prefix\..*
|
||
|
|
retentions = 5m:30d,15m:90d,1h:1y
|
||
|
|
```
|