Overview

This section describes InfluxDB retention policies used in Lumino.

Database Creation

The Lumino agent will attempt to create a new database called lumino on its initial connect to influx. The default database name is lumino. This value can be changed by setting 'nv.lumin.agent.influx.dbname' in data/robin/robin.conf. If the username you are using to connect to Influx does not have permissions to create a new database or the retention policies below, they must be created prior to launching the lumino agent. 

Default retention policies

Lumino uses InfluxDB time series database engine to store data. More about InfxluDB as a product can be found here. Lumino Agent collects two types of data from controlled/monitored systems:

1. Statistics data - this is the information collected from applications heartbeats (controlled by lumino_heartbeat_rp retention policy)
2. Trace logs - this is the output of XVMs (controlled by lumino_trace_rp retention policy)
3. Audit data - this is where commands executed by the agent are stored for audit purposes (controlled by lumino_audit_rp retention policy). 
4. Script Trace - this database is used to store output of robin scripts executed by the agent (controlled by lumino_script_trace_rp retention policy). 

All of the above policies are created by the agent with a retention policy duration of 1 week. Based on the amount of traffic being monitored by the agent and your business needs, you may want to tweak these values based on the storage space that is available to your influx instance. 

Making changes to default retention policies

If your setup has access to significant amount of disk space, InfluxDB provides UI for administration and access to it is not restricted by default. It's available at http://lumino_host:8083/.

First of all select lumino database in the top right corner of the page. Then execute a query to alter a retention policy (refer to InfluxDB query syntax documentation).

When finished use Query Templates dropdown to show existing retention policies and make sure your changes were applied as expected.