diff --git a/doc/config-reference/bk-config-ref.xml b/doc/config-reference/bk-config-ref.xml
index 70c1762553..9c0f1f800c 100644
--- a/doc/config-reference/bk-config-ref.xml
+++ b/doc/config-reference/bk-config-ref.xml
@@ -117,6 +117,8 @@
+
+
diff --git a/doc/config-reference/ch_telemetryconfigure.xml b/doc/config-reference/ch_telemetryconfigure.xml
new file mode 100644
index 0000000000..27cd70292c
--- /dev/null
+++ b/doc/config-reference/ch_telemetryconfigure.xml
@@ -0,0 +1,42 @@
+
+
+ Telemetry
+ The Telemetry service collects measurements within OpenStack. Its
+ various agents and services are configured in the
+ /etc/ceilometer/ceilometer.conf file.
+ To install Telemetry, see the OpenStack Installation
+ Guide for your distribution (docs.openstack.org).
+
+ The following tables provide a comprehensive list of the Telemetry
+ configuration options.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/doc/config-reference/telemetry/section_telemetry-sample-configuration-files.xml b/doc/config-reference/telemetry/section_telemetry-sample-configuration-files.xml
new file mode 100644
index 0000000000..cb6d5e3042
--- /dev/null
+++ b/doc/config-reference/telemetry/section_telemetry-sample-configuration-files.xml
@@ -0,0 +1,38 @@
+
+ Telemetry sample configuration files
+ All the files in this section can be found in the /etc/ceilometer/ directory.
+
+ ceilometer.conf
+ The configuration for the Telemetry services and agents is
+ found in the ceilometer.conf file.
+ This file must be modified after installation.
+
+
+
+ event_definitions.yaml
+ The event_definitions.yaml file defines how
+ events received from other OpenStack components should be translated
+ to Telemetry samples.
+ You should not need to modify this file.
+
+
+
+ pipeline.yaml
+ Pipelines describe a coupling between sources of samples and the
+ corresponding sinks for transformation and publication of these
+ data. They are defined in the pipeline.yaml
+ file.
+ You should not need to modify this file.
+
+
+
+ policy.json
+ The policy.json file defines additional
+ access controls that apply to the Telemetry service.
+
+
+
+