mirror of
https://github.com/librenms/librenms.git
synced 2024-10-07 16:52:45 +00:00
8f474dd4d4
* Rework documentation * Slightly adjust theme * wip * fixes * Remove unneeded header * Re-added Acknowledgement.md file * Added Acknowledgement.md to mkdocs.yml Co-authored-by: Neil Lathwood <gh+n@laf.io>
42 lines
1.2 KiB
Markdown
42 lines
1.2 KiB
Markdown
# 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
|
|
```
|