summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorJulien Danjou <julien@danjou.info>2018-09-18 11:11:44 +0200
committerJulien Danjou <julien@danjou.info>2018-09-18 11:18:17 +0200
commit8a0245a5b3e1357d35ad6653be37ca01176577e4 (patch)
treea6d270166e00a3d8a89afba4abf488dcef7bd260 /doc
parent42f6f68eb931b1089d46807f76693637f308a707 (diff)
downloadceilometer-8a0245a5b3e1357d35ad6653be37ca01176577e4.tar.gz
Deprecate event subsystem
This subsystem has never been finished and is not maintained. Deprecate it for future removal. Change-Id: I934696b8fc066adc2d9085c64dffb3759fa4489c
Diffstat (limited to 'doc')
-rw-r--r--doc/source/admin/telemetry-events.rst3
-rw-r--r--doc/source/contributor/events.rst18
2 files changed, 15 insertions, 6 deletions
diff --git a/doc/source/admin/telemetry-events.rst b/doc/source/admin/telemetry-events.rst
index 657378c2..ea1575ce 100644
--- a/doc/source/admin/telemetry-events.rst
+++ b/doc/source/admin/telemetry-events.rst
@@ -6,6 +6,9 @@ In addition to meters, the Telemetry service collects events triggered
within an OpenStack environment. This section provides a brief summary
of the events format in the Telemetry service.
+.. warning::
+ Events support is deprecated.
+
While a sample represents a single, numeric datapoint within a
time-series, an event is a broader concept that represents the state of
a resource at a point in time. The state may be described using various
diff --git a/doc/source/contributor/events.rst b/doc/source/contributor/events.rst
index 726d205f..882a4e65 100644
--- a/doc/source/contributor/events.rst
+++ b/doc/source/contributor/events.rst
@@ -23,12 +23,18 @@ Events vs. Samples
~~~~~~~~~~~~~~~~~~
In addition to Meters, and related Sample data, Ceilometer can also process
-Events. While a Sample represents a single numeric datapoint, driving a Meter
-that represents the changes in that value over time, an Event represents the
-state of an object in an OpenStack service (such as an Instance in Nova, or
-an Image in Glance) at a point in time when something of interest has occurred.
-This can include non-numeric data, such as an instance's flavor, or network
-address.
+Events.
+
+
+.. warning::
+ Events support is deprecated.
+
+
+While a Sample represents a single numeric datapoint, driving a Meter that
+represents the changes in that value over time, an Event represents the state
+of an object in an OpenStack service (such as an Instance in Nova, or an Image
+in Glance) at a point in time when something of interest has occurred. This can
+include non-numeric data, such as an instance's flavor, or network address.
In general, Events let you know when something has changed about an
object in an OpenStack system, such as the resize of an instance, or creation