You are here
InfluxDB Monitoring
[BETA] InfluxDB Opspack
Please note that this Opspack has been made available as early release beta software and is not officially supported for production use. Beta releases are provided on an “as is” and “as available” basis. Opsview does not give any warranties, whether express or implied, as to the suitability or usability of these releases.
InfluxDB is an open-source time series database developed by InfluxData. It is written in Go and optimized for fast, high-availability storage and retrieval of time series data, providing real-time visibility into stacks, sensors and systems. InfluxDB allows more granual data to be captured over a longer period of time, enabling improved analytics and allowing IT teams to collect and store detailed performance data that can be used to make more informed decisions. InfluxDB works with InfluxQL, a SQL-like query language with support for regular expressions, arithmetic expressions and time series specific operations to speed up processing.
What You Can Monitor
This application monitoring Opspack allows you to monitor all the metrics you need to efficiently run an InfluxDB database, providing service checks to monitor queries, databases, runtime statistics and more.
Service Checks
| Service Check | Description |
|---|---|
| CQ - Summary | The total number of continuous queries that failed and executed successfully |
| Database | The current series cardinality of the specified database |
| HTTPD - Queries Bytes Rate | The total number of bytes returned in query responses |
| HTTPD - Queries Duration Rate | The total query request duration, in nanoseconds (ns) |
| HTTPD - Writes Bytes Rate | The total number of bytes of line protocol data received by write requests, using the HTTP /write endpoint |
| HTTPD - Writes Duration Rate | The duration (wall time), in nanoseconds (ns), of write requests served using the /write HTTP endpoint |
| Queries - Active | The number of active queries currently being handled |
| Queries - Rate | The number of queries executed (started) |
| Runtime Stats | A subset of MemStats records statistics about the Go memory allocator |
| Runtime Stats - GC Cycles | The number of completed GC (Garbage Collection) cycles |
| Runtime Stats - GC Pause Total | The total duration, in nanoseconds, of total GC (Garbage Collection) pauses |
| Runtime Stats - Goroutines | The total number of Go routines |
| Runtime Stats - Heap Objects | The number of allocated heap objects |
| Runtime Stats - Heap Summary | Heap memory statistics |
| Writes - Datapoints | The total number of point requests that have been attempted to be written into a shard on the same (local) node |
| Writes - Rate | The total number of batches of points requested to be written to this node |
| Writes - Summary | The total number of batches of points written, failed, timed out and dropped |
Prerequisites
- InfluxDB 1.1 or InfluxDB 1.2, other versions may be compatible but are not officially supported.
Setup and Configuration
To configure and utilize this Opspack, you simply need to add the 'Application - InfluxDB' Opspack to your Opsview Monitor system.
Step 1: Add the host template
Add the Application - InfluxDB Host Template to your Opsview Monitor host.
For more information, refer to Opsview Knowledge Center - Adding Host Templates to Hosts.
Step 2: Add and configure variables required for this host
| Variable | Description |
|---|---|
| INFLUXDB_CREDENTIALS | The authentication details for your InfluxDB database. The Value is not used and therefore can be set to anything. Ensure you override the Username, Password, Scheme and Port with your configuration details. |
| INFLUXDB_DATABASE | The Value is the name of the InfluxDB database you want to monitor. You can add multiple variables to check the status of each database individually. |
| INFLUXDB_OPTIONS | Any additional options to pass to the plugin. The Value is not used and therefore can be set to anything. The TLS Options can be set to --ignore-ssl-errors to connect to an https server with an unknown/private certificate authority. |
For more information, refer to Opsview Knowledge Center - Adding Variables to Hosts.
Step 3: Apply changes and the system will now be monitored
