mirror of
https://github.com/librenms/librenms.git
synced 2024-10-07 16:52:45 +00:00
1ee2e8e0e0
* Updated to use new theme for docs site * Updated theme location * Removed librenms.css * Updated index page + re-added librenms.css * Use built in theme modification * flexbox grid, dump bootstrap * tidy up things * Added path and updated deploy script + mkdocs config * Removed db schmea changes * Updated to install python/pip 3 * Removed pip3 install * Pip3 install * Updated deploy-docs * Updated deploy-docs
43 lines
1.5 KiB
Markdown
43 lines
1.5 KiB
Markdown
source: Extensions/metrics/Prometheus.md
|
|
path: blob/master/doc/
|
|
# Enabling support for Prometheus.
|
|
|
|
Please be aware Prometheus support is alpha at best, It hasn't been extensively tested and is still in development
|
|
All it provides is the sending of data to a a Prometheus PushGateway. Please be careful when enabling this support
|
|
you use it at your own risk!
|
|
|
|
### Requirements (Older versions may work but haven't been tested
|
|
- Prometheus >= 2.0
|
|
- PushGateway >= 0.4.0
|
|
- Grafana
|
|
- PHP-CURL
|
|
|
|
The setup of the above is completely out of scope here and we aren't really able to provide any help with this side
|
|
of things.
|
|
|
|
### What you don't get
|
|
- Pretty graphs, this is why at present you need Grafana. You need to build your own graphs within Grafana.
|
|
- Support for Prometheus or Grafana, we would highly recommend that you have some level of experience with these.
|
|
|
|
RRD will continue to function as normal so LibreNMS itself should continue to function as normal.
|
|
|
|
### Configuration
|
|
```php
|
|
$config['prometheus']['enable'] = true;
|
|
$config['prometheus']['url'] = 'http://127.0.0.1:9091';
|
|
$config['prometheus']['job'] = 'librenms'; # Optional
|
|
```
|
|
|
|
|
|
### Sample Prometheus Scrape Config (for scraping the Push Gateway)
|
|
```yml
|
|
- job_name: pushgateway
|
|
scrape_interval: 300s
|
|
honor_labels: true
|
|
static_configs:
|
|
- targets: ['127.0.0.1:9091']
|
|
```
|
|
|
|
The same data then stored within rrd will be sent to Prometheus and recorded. You can then create graphs within Grafana
|
|
to display the information you need.
|