From 4cf7ff9fa22fa4f38ddde5df1b8ad17c7475f0a2 Mon Sep 17 00:00:00 2001
From: Will Szumski <will@stackhpc.com>
Date: Fri, 14 Feb 2020 15:24:06 +0000
Subject: Introduce influxdb_datadir_volume

This allows you to tune the performance of InfluxDB by locating the
volume on a drive that is separate to the default docker storage.

Change-Id: Iea555a2702b225b30f5d7035b8a703d4f3376ee7
---
 .../reference/logging-and-monitoring/index.rst     |  1 +
 .../logging-and-monitoring/influxdb-guide.rst      | 28 ++++++++++++++++++++++
 2 files changed, 29 insertions(+)
 create mode 100644 doc/source/reference/logging-and-monitoring/influxdb-guide.rst

(limited to 'doc')

diff --git a/doc/source/reference/logging-and-monitoring/index.rst b/doc/source/reference/logging-and-monitoring/index.rst
index 9d14ac36c..a2cfbd0c9 100644
--- a/doc/source/reference/logging-and-monitoring/index.rst
+++ b/doc/source/reference/logging-and-monitoring/index.rst
@@ -9,6 +9,7 @@ logging and monitoring services available in kolla.
    :maxdepth: 1
 
    central-logging-guide
+   influxdb-guide
    monasca-guide
    osprofiler-guide
    prometheus-guide
diff --git a/doc/source/reference/logging-and-monitoring/influxdb-guide.rst b/doc/source/reference/logging-and-monitoring/influxdb-guide.rst
new file mode 100644
index 000000000..6bb460d0c
--- /dev/null
+++ b/doc/source/reference/logging-and-monitoring/influxdb-guide.rst
@@ -0,0 +1,28 @@
+.. _influxdb-guide:
+
+===============================
+InfluxDB - Time Series Database
+===============================
+
+Overview
+~~~~~~~~
+
+InfluxDB is a time series database developed by InfluxData. It is
+possible to deploy a single instance without charge. To use the
+clustering features you will require a commercial license.
+
+InfluxDB
+~~~~~~~~
+
+The `recommendation <https://docs.influxdata.com/influxdb/v1.7/guides/hardware_sizing/#what-kind-of-storage-do-i-need>`_
+is to use flash storage for InfluxDB. If docker is configured to use
+spinning disks by default, or you have some higher performance drives
+available, it may be desirable to control where the docker volume is
+located. This can be achieved by setting a path for
+``influxdb_datadir_volume`` in ``/etc/kolla/globals.yml``:
+
+.. code-block:: yaml
+
+    influxdb_datadir_volume: /mnt/ssd/influxdb/
+
+The default is to use a named volume, ``influxdb``.
-- 
cgit v1.2.3