Hey! These docs are for version 6.5, which is no longer officially supported. Click here for the latest version, 6.7!

## Description

Opsview Timeseries InfluxDB (`opsview-timeseries-influxdb`) provides a Timeseries storage framework. It consists of dedicated InfluxDB Updaters and Queries processes to maximize the throughput.

**Note:** This cannot be installed at the same time as `opsview-timeseries-rrd`.

Full details on setting up or migrating to the InfluxDB graphing engine can be found on [Timeseries Graphing Engine](🔗).

### InfluxDB Updaters

Opsview Timeseries InfluxDB Updaters launches a master management process that binds to the configured ports, for each port configured a worker process is started, each worker is responsible for handling the requests for the given port. That provides the guarantee that the data sent from Opsview Timeseries Enqueuer for a given host is handled by a single process only, thus removes the risk of processing the data out of order. The metadata (including the uoms) is stored in the SQlite3 database.

### InfluxDB Queries

Opsview Timeseries InfluxDB Queries provide a way of querying the gathered performance metrics and listing them.

## Dependencies

Opsview Timeseries InfluxDB can be installed on any supported platform. To reduce network traffic it is recommended to install it on the same host as the Opsview Timeseries Enqueuer component.

## Prerequisites

You must separately install InfluxDB, unlike RRD it is _not_ bundled with Opsview

You must use version 1.8.x or older for InfluxDB

## Installation

Refer to [Advanced Automated Installation](🔗).

## Configuration

If `opsview-timeseries-influxdb` was installed on other then Opsview Timeseries or Timeseries Enqueuer host, you need to update the `/opt/opsview/timeseriesinfluxdb/etc/timeseriesinfluxdb.yaml` file to listen other than loopback interface.

All configurable options are listed in the `/opt/opsview/timeseriesinfluxdb/etc/timeseriesinfluxdb.defaults.yaml` and `/opt/opsview/timeseriesinfluxdb/etc/timeseriesinfluxdb.yaml.example.`


#### To enable HTTPS for a remote InfluxDB server:

  • Modify `/opt/opsview/deploy/etc/opsview_deploy.yml` to include:

  • Run:

  • As indicated by the output of the previous command, now update `opsview_timeseries_influxdb_server_url` in `/opt/opsview/deploy/etc/user_vars.yml` which indicates to use the loadbalancer to communicate with InfluxDB:

  • Run

These steps will update the configuration of the InfluxDB server in `/etc/influxdb/influxdb.conf` to enforce HTTPS communication using the Opsview certificates.

Note: These steps do not apply when InfluxDB is running on the same host as the timeseries components.

#### To disable HTTPS for the InfluxDB server:

  • Remove `influxdb_hosts` from `/opt/opsview/deploy/etc/opsview_deploy.yml`

  • On the InfluxDB hosts, modify `/etc/influxdb/influxdb.conf`, to set

  • On the InfluxDB host, run

  • Update `opsview_timeseries_influxdb_server_url` in `/opt/opsview/deploy/etc/user_vars.yml`

  • Run

## Service Administration

As root, start, stop and restart the service using: