From 6fe7f0f019a01694f971a5367a28501cf4eab9f1 Mon Sep 17 00:00:00 2001
From: gord chung <gord@live.ca>
Date: Mon, 29 May 2017 13:33:59 +0000
Subject: [PATCH] deprecate ceilometer api

we've officially deprecated Ceilometer's API and storage after many
cycles working on the derived aodh, gnocchi, panko storage services.
mark ceilometer api deprecated so users don't start working with deprecated
stuff

Change-Id: Ia9c0c0e562ff16b021ccb7a2c83b79fd78ecb7e8
---
 doc/admin-guide/source/telemetry-data-retrieval.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/doc/admin-guide/source/telemetry-data-retrieval.rst b/doc/admin-guide/source/telemetry-data-retrieval.rst
index 308eb95272..39a88ea205 100644
--- a/doc/admin-guide/source/telemetry-data-retrieval.rst
+++ b/doc/admin-guide/source/telemetry-data-retrieval.rst
@@ -2,6 +2,16 @@
 Data retrieval
 ==============
 
+.. warning::
+
+   Accessing meters through the v2 API of Ceilometer is deprecated in Ocata and
+   has been unmaintained for a few cycles prior. We recommend storing metric
+   data in a time-series optimized database such as Gnocchi_ and event data in
+   Panko_.
+
+.. _Gnocchi: http://gnocchi.xyz/
+.. _Panko: https://docs.openstack.org/developer/panko
+
 The Telemetry service offers several mechanisms from which the persisted
 data can be accessed. As described in :ref:`telemetry-system-architecture` and
 in :ref:`telemetry-data-collection`, the collected information can be stored in