librenms-librenms/doc/Extensions/metrics/Graphite.md

source: Extensions/metrics/Graphite.md
path: blob/master/doc/
# 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
```