mirror of
				https://github.com/librenms/librenms.git
				synced 2024-10-07 16:52:45 +00:00 
			
		
		
		
	* 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
		
			
				
	
	
		
			41 lines
		
	
	
		
			1.6 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
			
		
		
	
	
			41 lines
		
	
	
		
			1.6 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
source: Extensions/metrics/InfluxDB.md
 | 
						|
path: blob/master/doc/
 | 
						|
# Enabling support for InfluxDB.
 | 
						|
 | 
						|
Before we get started it is important that you know and understand that InfluxDB support is currently alpha at best.
 | 
						|
All it provides is the sending of data to a InfluxDB install. Due to the current changes that are constantly being
 | 
						|
made to InfluxDB itself then we cannot guarantee that your data will be ok so enabling this support is at your own
 | 
						|
risk!
 | 
						|
 | 
						|
### Requirements
 | 
						|
 - InfluxDB >= 0.94
 | 
						|
 - Grafana
 | 
						|
 - PHP 5.5 for InfluxDB-PHP
 | 
						|
 | 
						|
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 InfluxDB 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['influxdb']['enable'] = true;
 | 
						|
$config['influxdb']['transport'] = 'http'; # Default, other options: https, udp
 | 
						|
$config['influxdb']['host'] = '127.0.0.1';
 | 
						|
$config['influxdb']['port'] = '8086';
 | 
						|
$config['influxdb']['db'] = 'librenms';
 | 
						|
$config['influxdb']['username'] = 'admin';
 | 
						|
$config['influxdb']['password'] = 'admin';
 | 
						|
$config['influxdb']['timeout'] = 0; # Optional
 | 
						|
$config['influxdb']['verifySSL'] = false; # Optional
 | 
						|
```
 | 
						|
 | 
						|
No credentials are needed if you don't use InfluxDB authentication.
 | 
						|
 | 
						|
The same data then stored within rrd will be sent to InfluxDB and recorded. You can then create graphs within Grafana
 | 
						|
to display the information you need.
 |