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

## Description

Opsview Timeseries (opsview-timeseries) provides a Web Service that manages the timeseries data in Opsview. Opsview Timeseries component can be installed on a remote server (OS independent), thus reducing the load on Opsview Master Server. Due to the use of multiple processes, it also allows to utilize available resources on the server.

### Adding new data

On Opsview Master server the Opsview Results-Performance component reads the collected service check outputs from the MessageQueue and passes them to the Opsview Timeseries Web Service. One of the Workers parses the raw data and extracts from it the performance metrics - this operation is very CPU intensive. The parsed data is then dispatched in CBOR format to configurable storage providers based on the host name - so given host's servicechecks metrics are always send to the same Enqueuer.

### Timeseries queries

Performance data graphs in Opsview UI query the Opsview Timeseries Web Service which dispatches the request to the storage providers that handle given host servicechecks metrics. The returned information is in JSON format and can be cached by reverse-proxies.

## Dependencies

Opsview Timeseries can be installed on any supported platform.

## Installation

Refer to [Advanced Automated Installation](🔗).

## Configuration

If `opsview-timeseries` was installed on other than Opsview Master host, you need to update the `/opt/opsview/coreutils/etc/opsview.conf` file to be able to query the graphs, eg.:

And Results Performance configuration file `/opt/opsview/resultsperformance/etc/resultsperformance.yaml`, so it knows where to send the tests results:

As Opsview Timeseries by default listens only on loopback interface, so you need to update its configuration located in `/opt/opsview/timeseries/etc/timeseries.yaml:`

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

### Service Administration

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

## Troubleshooting

### Performance data isn't being generated or it isn't interpreted correctly

Some Servicechecks do not provide performance data. Other checks do provide it but the data isn't interpreted correctly. In both cases a change can be made via a 'map' file `/opt/opsview/timeseries/etc/map.local`; this file is used to read the plugin output and (if a match is found) generate performance data for use in graphs (if no match is found then any performance data output by the plugin is used).

This file is a series of perl regular expressions which matches Servicecheck output. You can see examples within the file `/opt/opsview/timeseries/etc/map` but you should only ever make changes to `/opt/opsview/timeseries/etc/map`; this is because `map` will be overwritten on an upgrade whereas `map.local` will not.

Any changes should be followed by a

to ensure there are no grammatical errors in the file.

After making a change, the `opsview-timeseries` daemon will need to be restarted.