diff --git a/doc/source/reference/logging-and-monitoring/index.rst b/doc/source/reference/logging-and-monitoring/index.rst
index 2ab7bd4a4c..9d14ac36ca 100644
--- a/doc/source/reference/logging-and-monitoring/index.rst
+++ b/doc/source/reference/logging-and-monitoring/index.rst
@@ -11,4 +11,5 @@ logging and monitoring services available in kolla.
    central-logging-guide
    monasca-guide
    osprofiler-guide
+   prometheus-guide
    skydive-guide
diff --git a/doc/source/reference/logging-and-monitoring/prometheus-guide.rst b/doc/source/reference/logging-and-monitoring/prometheus-guide.rst
new file mode 100644
index 0000000000..282f9089ee
--- /dev/null
+++ b/doc/source/reference/logging-and-monitoring/prometheus-guide.rst
@@ -0,0 +1,32 @@
+.. _prometheus-guide:
+
+=====================================================
+Prometheus - Monitoring System & Time Series Database
+=====================================================
+
+Overview
+~~~~~~~~
+
+Kolla can deploy a full working Prometheus setup in either a **all-in-one** or
+**multinode** setup.
+
+Preparation and deployment
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+To enable Prometheus, modify the configuration file ``/etc/kolla/globals.yml``
+and change the following:
+
+.. code-block:: yaml
+
+   enable_prometheus: "yes"
+
+Extending the default command line options
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+It is possible to extend the default command line options for Prometheus by
+using a custom variable. As an example, to set remote timeouts to 30 seconds
+and data retention period to 2 days:
+
+.. code-block:: yaml
+
+   prometheus_cmdline_extras: "-storage.remote.timeout 30s -storage.local.retention 48h"