openstack
/
openstack-manuals
Code Issues Proposed changes
openstack-manuals/doc/admin-guide/source/telemetry-measurements.rst

1414 lines
95 KiB
ReStructuredText
Raw Blame History

.. _telemetry-measurements:
============
Measurements
============
The Telemetry service collects meters within an OpenStack deployment.
This section provides a brief summary about meters format and origin and
also contains the list of available meters.
Telemetry collects meters by polling the infrastructure elements and
also by consuming the notifications emitted by other OpenStack services.
For more information about the polling mechanism and notifications see
:ref:`telemetry-data-collection`. There are several meters which are collected
by polling and by consuming. The origin for each meter is listed in the tables
below.
.. note::
You may need to configure Telemetry or other OpenStack services in
order to be able to collect all the samples you need. For further
information about configuration requirements see the `Telemetry chapter
<https://docs.openstack.org/project-install-guide/telemetry/ocata/>`__
in the Installation Tutorials and Guides. Also check the `Telemetry manual
installation <https://docs.openstack.org/developer/ceilometer/install/manual.html>`__
description.
Telemetry uses the following meter types:
+--------------+--------------------------------------------------------------+
| Type | Description |
+==============+==============================================================+
| Cumulative | Increasing over time (instance hours) |
+--------------+--------------------------------------------------------------+
| Delta | Changing over time (bandwidth) |
+--------------+--------------------------------------------------------------+
| Gauge | Discrete items (floating IPs, image uploads) and fluctuating |
| | values (disk I/O) |
+--------------+--------------------------------------------------------------+
|
Telemetry provides the possibility to store metadata for samples. This
metadata can be extended for OpenStack Compute and OpenStack Object
Storage.
In order to add additional metadata information to OpenStack Compute you
have two options to choose from. The first one is to specify them when
you boot up a new instance. The additional information will be stored
with the sample in the form of ``resource_metadata.user_metadata.*``.
The new field should be defined by using the prefix ``metering.``. The
modified boot command look like the following:
.. code-block:: console
$ openstack server create --property metering.custom_metadata=a_value my_vm
The other option is to set the ``reserved_metadata_keys`` to the list of
metadata keys that you would like to be included in
``resource_metadata`` of the instance related samples that are collected
for OpenStack Compute. This option is included in the ``DEFAULT``
section of the ``ceilometer.conf`` configuration file.
You might also specify headers whose values will be stored along with
the sample data of OpenStack Object Storage. The additional information
is also stored under ``resource_metadata``. The format of the new field
is ``resource_metadata.http_header_$name``, where ``$name`` is the name of
the header with ``-`` replaced by ``_``.
For specifying the new header, you need to set ``metadata_headers`` option
under the ``[filter:ceilometer]`` section in ``proxy-server.conf`` under the
``swift`` folder. You can use this additional data for instance to distinguish
external and internal users.
Measurements are grouped by services which are polled by
Telemetry or emit notifications that this service consumes.
.. note::
The Telemetry service supports storing notifications as events. This
functionality was added later, therefore the list of meters still
contains existence type and other event related items. The proper
way of using Telemetry is to configure it to use the event store and
turn off the collection of the event related meters. For further
information about events see `Events section
<https://docs.openstack.org/developer/ceilometer/events.html>`__
in the Telemetry documentation. For further information about how to
turn on and off meters see :ref:`telemetry-pipeline-configuration`. Please
also note that currently no migration is available to move the already
existing event type samples to the event store.
.. _telemetry-compute-meters:
OpenStack Compute
~~~~~~~~~~~~~~~~~
The following meters are collected for OpenStack Compute.
+-----------+-------+------+----------+----------+---------+------------------+
| Name | Type | Unit | Resource | Origin | Support | Note |
+===========+=======+======+==========+==========+=========+==================+
| **Meters added in the Mitaka release or earlier** |
+-----------+-------+------+----------+----------+---------+------------------+
| memory | Gauge | MB | instance | Notific\ | Libvirt,| Volume of RAM |
| | | | ID | ation | Hyper-V | allocated to the |
| | | | | | | instance |
+-----------+-------+------+----------+----------+---------+------------------+
| memory.\ | Gauge | MB | instance | Pollster | Libvirt,| Volume of RAM |
| usage | | | ID | | Hyper-V,| used by the inst\|
| | | | | | vSphere,| ance from the |
| | | | | | XenAPI | amount of its |
| | | | | | | allocated memory |
+-----------+-------+------+----------+----------+---------+------------------+
| memory.r\ | Gauge | MB | instance | Pollster | Libvirt | Volume of RAM u\ |
| esident | | | ID | | | sed by the inst\ |
| | | | | | | ance on the phy\ |
| | | | | | | sical machine |
+-----------+-------+------+----------+----------+---------+------------------+
| cpu | Cumu\ | ns | instance | Pollster | Libvirt,| CPU time used |
| | lative| | ID | | Hyper-V | |
+-----------+-------+------+----------+----------+---------+------------------+
| cpu.delta | Delta | ns | instance | Pollster | Libvirt,| CPU time used s\ |
| | | | ID | | Hyper-V | ince previous d\ |
| | | | | | | atapoint |
+-----------+-------+------+----------+----------+---------+------------------+
| cpu_util | Gauge | % | instance | Pollster | vSphere,| Average CPU |
| | | | ID | | XenAPI | utilization |
+-----------+-------+------+----------+----------+---------+------------------+
| vcpus | Gauge | vcpu | instance | Notific\ | Libvirt,| Number of virtual|
| | | | ID | ation | Hyper-V | CPUs allocated to|
| | | | | | | the instance |
+-----------+-------+------+----------+----------+---------+------------------+
| disk.read\| Cumul\| req\ | instance | Pollster | Libvirt,| Number of read |
| .requests | ative | uest | ID | | Hyper-V | requests |
+-----------+-------+------+----------+----------+---------+------------------+
| disk.read\| Gauge | requ\| instance | Pollster | Libvirt,| Average rate of |
| .requests\| | est/s| ID | | Hyper-V,| read requests |
| .rate | | | | | vSphere | |
+-----------+-------+------+----------+----------+---------+------------------+
| disk.writ\| Cumul\| req\ | instance | Pollster | Libvirt,| Number of write |
| e.requests| ative | uest | ID | | Hyper-V | requests |
+-----------+-------+------+----------+----------+---------+------------------+
| disk.writ\| Gauge | requ\| instance | Pollster | Libvirt,| Average rate of |
| e.request\| | est/s| ID | | Hyper-V,| write requests |
| s.rate | | | | | vSphere | |
+-----------+-------+------+----------+----------+---------+------------------+
| disk.read\| Cumu\ | B | instance | Pollster | Libvirt,| Volume of reads |
| .bytes | lative| | ID | | Hyper-V | |
+-----------+-------+------+----------+----------+---------+------------------+
| disk.read\| Gauge | B/s | instance | Pollster | Libvirt,| Average rate of |
| .bytes.\ | | | ID | | Hyper-V,| reads |
| rate | | | | | vSphere,| |
| | | | | | XenAPI | |
+-----------+-------+------+----------+----------+---------+------------------+
| disk.writ\| Cumu\ | B | instance | Pollster | Libvirt,| Volume of writes |
| e.bytes | lative| | ID | | Hyper-V | |
+-----------+-------+------+----------+----------+---------+------------------+
| disk.writ\| Gauge | B/s | instance | Pollster | Libvirt,| Average rate of |
| e.bytes.\ | | | ID | | Hyper-V,| writes |
| rate | | | | | vSphere,| |
| | | | | | XenAPI | |
+-----------+-------+------+----------+----------+---------+------------------+
| disk.dev\ | Cumu\ | req\ | disk ID | Pollster | Libvirt,| Number of read |
| ice.read\ | lative| uest | | | Hyper-V | requests |
| .requests | | | | | | |
+-----------+-------+------+----------+----------+---------+------------------+
| disk.dev\ | Gauge | requ\| disk ID | Pollster | Libvirt,| Average rate of |
| ice.read\ | | est/s| | | Hyper-V,| read requests |
| .requests\| | | | | vSphere | |
| .rate | | | | | | |
+-----------+-------+------+----------+----------+---------+------------------+
| disk.dev\ | Cumu\ | req\ | disk ID | Pollster | Libvirt,| Number of write |
| ice.write\| lative| uest | | | Hyper-V | requests |
| .requests | | | | | | |
+-----------+-------+------+----------+----------+---------+------------------+
| disk.dev\ | Gauge | requ\| disk ID | Pollster | Libvirt,| Average rate of |
| ice.write\| | est/s| | | Hyper-V,| write requests |
| .requests\| | | | | vSphere | |
| .rate | | | | | | |
+-----------+-------+------+----------+----------+---------+------------------+
| disk.dev\ | Cumu\ | B | disk ID | Pollster | Libvirt,| Volume of reads |
| ice.read\ | lative| | | | Hyper-V | |
| .bytes | | | | | | |
+-----------+-------+------+----------+----------+---------+------------------+
| disk.dev\ | Gauge | B/s | disk ID | Pollster | Libvirt,| Average rate of |
| ice.read\ | | | | | Hyper-V,| reads |
| .bytes | | | | | vSphere | |
| .rate | | | | | | |
+-----------+-------+------+----------+----------+---------+------------------+
| disk.dev\ | Cumu\ | B | disk ID | Pollster | Libvirt,| Volume of writes |
| ice.write\| lative| | | | Hyper-V | |
| .bytes | | | | | | |
+-----------+-------+------+----------+----------+---------+------------------+
| disk.dev\ | Gauge | B/s | disk ID | Pollster | Libvirt,| Average rate of |
| ice.write\| | | | | Hyper-V,| writes |
| .bytes | | | | | vSphere | |
| .rate | | | | | | |
+-----------+-------+------+----------+----------+---------+------------------+
| disk.root\| Gauge | GB | instance | Notific\ | Libvirt,| Size of root disk|
| .size | | | ID | ation | Hyper-V | |
+-----------+-------+------+----------+----------+---------+------------------+
| disk.ephe\| Gauge | GB | instance | Notific\ | Libvirt,| Size of ephemeral|
| meral.size| | | ID | ation | Hyper-V | disk |
+-----------+-------+------+----------+----------+---------+------------------+
| disk.lat\ | Gauge | ms | instance | Pollster | Hyper-V | Average disk la\ |
| ency | | | ID | | | tency |
+-----------+-------+------+----------+----------+---------+------------------+
| disk.iop\ | Gauge | coun\| instance | Pollster | Hyper-V | Average disk io\ |
| s | | t/s | ID | | | ps |
+-----------+-------+------+----------+----------+---------+------------------+
| disk.dev\ | Gauge | ms | disk ID | Pollster | Hyper-V | Average disk la\ |
| ice.late\ | | | | | | tency per device |
| ncy | | | | | | |
+-----------+-------+------+----------+----------+---------+------------------+
| disk.dev\ | Gauge | coun\| disk ID | Pollster | Hyper-V | Average disk io\ |
| ice.iops | | t/s | | | | ps per device |
+-----------+-------+------+----------+----------+---------+------------------+
| disk.cap\ | Gauge | B | instance | Pollster | Libvirt | The amount of d\ |
| acity | | | ID | | | isk that the in\ |
| | | | | | | stance can see |
+-----------+-------+------+----------+----------+---------+------------------+
| disk.all\ | Gauge | B | instance | Pollster | Libvirt | The amount of d\ |
| ocation | | | ID | | | isk occupied by |
| | | | | | | the instance o\ |
| | | | | | | n the host mach\ |
| | | | | | | ine |
+-----------+-------+------+----------+----------+---------+------------------+
| disk.usa\ | Gauge | B | instance | Pollster | Libvirt | The physical si\ |
| ge | | | ID | | | ze in bytes of |
| | | | | | | the image conta\ |
| | | | | | | iner on the host |
+-----------+-------+------+----------+----------+---------+------------------+
| disk.dev\ | Gauge | B | disk ID | Pollster | Libvirt | The amount of d\ |
| ice.capa\ | | | | | | isk per device |
| city | | | | | | that the instan\ |
| | | | | | | ce can see |
+-----------+-------+------+----------+----------+---------+------------------+
| disk.dev\ | Gauge | B | disk ID | Pollster | Libvirt | The amount of d\ |
| ice.allo\ | | | | | | isk per device |
| cation | | | | | | occupied by the |
| | | | | | | instance on th\ |
| | | | | | | e host machine |
+-----------+-------+------+----------+----------+---------+------------------+
| disk.dev\ | Gauge | B | disk ID | Pollster | Libvirt | The physical si\ |
| ice.usag\ | | | | | | ze in bytes of |
| e | | | | | | the image conta\ |
| | | | | | | iner on the hos\ |
| | | | | | | t per device |
+-----------+-------+------+----------+----------+---------+------------------+
| network.\ | Cumu\ | B | interface| Pollster | Libvirt,| Number of |
| incoming.\| lative| | ID | | Hyper-V | incoming bytes |
| bytes | | | | | | |
+-----------+-------+------+----------+----------+---------+------------------+
| network.\ | Gauge | B/s | interface| Pollster | Libvirt,| Average rate of |
| incoming.\| | | ID | | Hyper-V,| incoming bytes |
| bytes.rate| | | | | vSphere,| |
| | | | | | XenAPI | |
+-----------+-------+------+----------+----------+---------+------------------+
| network.\ | Cumu\ | B | interface| Pollster | Libvirt,| Number of |
| outgoing\ | lative| | ID | | Hyper-V | outgoing bytes |
| .bytes | | | | | | |
+-----------+-------+------+----------+----------+---------+------------------+
| network.\ | Gauge | B/s | interface| Pollster | Libvirt,| Average rate of |
| outgoing.\| | | ID | | Hyper-V,| outgoing bytes |
| bytes.rate| | | | | vSphere,| |
| | | | | | XenAPI | |
+-----------+-------+------+----------+----------+---------+------------------+
| network.\ | Cumu\ | pac\ | interface| Pollster | Libvirt,| Number of |
| incoming\ | lative| ket | ID | | Hyper-V | incoming packets |
| .packets | | | | | | |
+-----------+-------+------+----------+----------+---------+------------------+
| network.\ | Gauge | pack\| interface| Pollster | Libvirt,| Average rate of |
| incoming\ | | et/s | ID | | Hyper-V,| incoming packets |
| .packets\ | | | | | vSphere,| |
| .rate | | | | | XenAPI | |
+-----------+-------+------+----------+----------+---------+------------------+
| network.\ | Cumu\ | pac\ | interface| Pollster | Libvirt,| Number of |
| outgoing\ | lative| ket | ID | | Hyper-V | outgoing packets |
| .packets | | | | | | |
+-----------+-------+------+----------+----------+---------+------------------+
| network.\ | Gauge | pac\ | interface| Pollster | Libvirt,| Average rate of |
| outgoing\ | | ket/s| ID | | Hyper-V,| outgoing packets |
| .packets\ | | | | | vSphere,| |
| .rate | | | | | XenAPI | |
+-----------+-------+------+----------+----------+---------+------------------+
| **Meters added in the Newton release** |
+-----------+-------+------+----------+----------+---------+------------------+
| cpu_l3_c\ | Gauge | B | instance | Pollster | Libvirt | L3 cache used b\ |
| ache | | | ID | | | y the instance |
+-----------+-------+------+----------+----------+---------+------------------+
| memory.b\ | Gauge | B/s | instance | Pollster | Libvirt | Total system ba\ |
| andwidth\ | | | ID | | | ndwidth from on\ |
| .total | | | | | | e level of cache |
+-----------+-------+------+----------+----------+---------+------------------+
| memory.b\ | Gauge | B/s | instance | Pollster | Libvirt | Bandwidth of me\ |
| andwidth\ | | | ID | | | mory traffic fo\ |
| .local | | | | | | r a memory cont\ |
| | | | | | | roller |
+-----------+-------+------+----------+----------+---------+------------------+
| perf.cpu\ | Gauge | cyc\ | instance | Pollster | Libvirt | the number of c\ |
| .cycles | | le | ID | | | pu cycles one i\ |
| | | | | | | nstruction needs |
+-----------+-------+------+----------+----------+---------+------------------+
| perf.ins\ | Gauge | inst\| instance | Pollster | Libvirt | the count of in\ |
| tructions | | ruct\| ID | | | structions |
| | | ion | | | | |
+-----------+-------+------+----------+----------+---------+------------------+
| perf.cac\ | Gauge | cou\ | instance | Pollster | Libvirt | the count of ca\ |
| he.refer\ | | nt | ID | | | che hits |
| ences | | | | | | |
+-----------+-------+------+----------+----------+---------+------------------+
| perf.cac\ | Gauge | cou\ | instance | Pollster | Libvirt | the count of ca\ |
| he.misses | | nt | ID | | | che misses |
+-----------+-------+------+----------+----------+---------+------------------+
| **Meters removed as of Ocata release** |
+-----------+-------+------+----------+----------+---------+------------------+
| instance | Gauge | inst\| instance | Notific\ | Libvirt,| Existence of |
| | | ance | ID | ation, | Hyper-V,| instance |
| | | | | Pollster | vSphere | |
+-----------+-------+------+----------+----------+---------+------------------+
| **Meters added in the Ocata release** |
+-----------+-------+------+----------+----------+---------+------------------+
| network.\ | Cumul\| pack\| interface| Pollster | Libvirt | Number of |
| incoming\ | ative | et | ID | | | incoming dropped |
| .packets\ | | | | | | packets |
| .drop | | | | | | |
+-----------+-------+------+----------+----------+---------+------------------+
| network.\ | Cumul\| pack\| interface| Pollster | Libvirt | Number of |
| outgoing\ | ative | et | ID | | | outgoing dropped |
| .packets\ | | | | | | packets |
| .drop | | | | | | |
+-----------+-------+------+----------+----------+---------+------------------+
| network.\ | Cumul\| pack\| interface| Pollster | Libvirt | Number of |
| incoming\ | ative | et | ID | | | incoming error |
| .packets\ | | | | | | packets |
| .error | | | | | | |
+-----------+-------+------+----------+----------+---------+------------------+
| network.\ | Cumul\| pack\| interface| Pollster | Libvirt | Number of |
| outgoing\ | ative | et | ID | | | outgoing error |
| .packets\ | | | | | | packets |
| .error | | | | | | |
+-----------+-------+------+----------+----------+---------+------------------+
The Telemetry service supports to create new meters by using
transformers. For more details about transformers see
:ref:`telemetry-transformers`. Among the meters gathered from libvirt and
Hyper-V there are a few ones which are generated from other meters. The list of
meters that are created by using the ``rate_of_change`` transformer from the
above table is the following:
- cpu_util
- cpu.delta
- disk.read.requests.rate
- disk.write.requests.rate
- disk.read.bytes.rate
- disk.write.bytes.rate
- disk.device.read.requests.rate
- disk.device.write.requests.rate
- disk.device.read.bytes.rate
- disk.device.write.bytes.rate
- network.incoming.bytes.rate
- network.outgoing.bytes.rate
- network.incoming.packets.rate
- network.outgoing.packets.rate
.. note::
To enable the libvirt ``memory.usage`` support, you need to install
libvirt version 1.1.1+, QEMU version 1.5+, and you also need to
prepare suitable balloon driver in the image. It is applicable
particularly for Windows guests, most modern Linux distributions
already have it built in. Telemetry is not able to fetch the
``memory.usage`` samples without the image balloon driver.
.. note::
To enable libvirt ``disk.*`` support when running on RBD-backed shared
storage, you need to install libvirt version 1.2.16+.
OpenStack Compute is capable of collecting ``CPU`` related meters from
the compute host machines. In order to use that you need to set the
``compute_monitors`` option to ``cpu.virt_driver`` in the
``nova.conf`` configuration file. For further information see the
Compute configuration section in the `Compute chapter
<https://docs.openstack.org/ocata/config-reference/compute/config-options.html>`__
of the OpenStack Configuration Reference.
The following host machine related meters are collected for OpenStack
Compute:
+---------------------+-------+------+----------+-------------+---------------+
| Name | Type | Unit | Resource | Origin | Note |
+=====================+=======+======+==========+=============+===============+
| **Meters added in the Mitaka release or earlier** |
+---------------------+-------+------+----------+-------------+---------------+
| compute.node.cpu.\ | Gauge | MHz | host ID | Notification| CPU frequency |
| frequency | | | | | |
+---------------------+-------+------+----------+-------------+---------------+
| compute.node.cpu.\ | Cumu\ | ns | host ID | Notification| CPU kernel |
| kernel.time | lative| | | | time |
+---------------------+-------+------+----------+-------------+---------------+
| compute.node.cpu.\ | Cumu\ | ns | host ID | Notification| CPU idle time |
| idle.time | lative| | | | |
+---------------------+-------+------+----------+-------------+---------------+
| compute.node.cpu.\ | Cumu\ | ns | host ID | Notification| CPU user mode |
| user.time | lative| | | | time |
+---------------------+-------+------+----------+-------------+---------------+
| compute.node.cpu.\ | Cumu\ | ns | host ID | Notification| CPU I/O wait |
| iowait.time | lative| | | | time |
+---------------------+-------+------+----------+-------------+---------------+
| compute.node.cpu.\ | Gauge | % | host ID | Notification| CPU kernel |
| kernel.percent | | | | | percentage |
+---------------------+-------+------+----------+-------------+---------------+
| compute.node.cpu.\ | Gauge | % | host ID | Notification| CPU idle |
| idle.percent | | | | | percentage |
+---------------------+-------+------+----------+-------------+---------------+
| compute.node.cpu.\ | Gauge | % | host ID | Notification| CPU user mode |
| user.percent | | | | | percentage |
+---------------------+-------+------+----------+-------------+---------------+
| compute.node.cpu.\ | Gauge | % | host ID | Notification| CPU I/O wait |
| iowait.percent | | | | | percentage |
+---------------------+-------+------+----------+-------------+---------------+
| compute.node.cpu.\ | Gauge | % | host ID | Notification| CPU |
| percent | | | | | utilization |
+---------------------+-------+------+----------+-------------+---------------+
.. _telemetry-bare-metal-service:
Bare metal service
~~~~~~~~~~~~~~~~~~
Telemetry captures notifications that are emitted by the Bare metal
service. The source of the notifications are IPMI sensors that collect
data from the host machine.
.. note::
The sensor data is not available in the Bare metal service by
default. To enable the meters and configure this module to emit
notifications about the measured values see the `Installation
Guide <https://docs.openstack.org/project-install-guide/baremetal/ocata>`__
for the Bare metal service.
The following meters are recorded for the Bare metal service:
+------------------+-------+------+----------+-------------+------------------+
| Name | Type | Unit | Resource | Origin | Note |
+==================+=======+======+==========+=============+==================+
| **Meters added in the Mitaka release or earlier** |
+------------------+-------+------+----------+-------------+------------------+
| hardware.ipmi.fan| Gauge | RPM | fan | Notification| Fan rounds per |
| | | | sensor | | minute (RPM) |
+------------------+-------+------+----------+-------------+------------------+
| hardware.ipmi\ | Gauge | C | temper\ | Notification| Temperature read\|
| .temperature | | | ature | | ing from sensor |
| | | | sensor | | |
+------------------+-------+------+----------+-------------+------------------+
| hardware.ipmi\ | Gauge | W | current | Notification| Current reading |
| .current | | | sensor | | from sensor |
+------------------+-------+------+----------+-------------+------------------+
| hardware.ipmi\ | Gauge | V | voltage | Notification| Voltage reading |
| .voltage | | | sensor | | from sensor |
+------------------+-------+------+----------+-------------+------------------+
IPMI based meters
~~~~~~~~~~~~~~~~~
Another way of gathering IPMI based data is to use IPMI sensors
independently from the Bare metal service's components. Same meters as
:ref:`telemetry-bare-metal-service` could be fetched except that origin is
``Pollster`` instead of ``Notification``.
You need to deploy the ceilometer-agent-ipmi on each IPMI-capable node
in order to poll local sensor data. For further information about the
IPMI agent see :ref:`telemetry-ipmi-agent`.
.. warning::
To avoid duplication of metering data and unnecessary load on the
IPMI interface, do not deploy the IPMI agent on nodes that are
managed by the Bare metal service and keep the
``conductor.send_sensor_data`` option set to ``False`` in the
``ironic.conf`` configuration file.
Besides generic IPMI sensor data, the following Intel Node Manager
meters are recorded from capable platform:
+---------------------+-------+------+----------+----------+------------------+
| Name | Type | Unit | Resource | Origin | Note |
+=====================+=======+======+==========+==========+==================+
| **Meters added in the Mitaka release or earlier** |
+---------------------+-------+------+----------+----------+------------------+
| hardware.ipmi.node\ | Gauge | W | host ID | Pollster | Current power |
| .power | | | | | of the system |
+---------------------+-------+------+----------+----------+------------------+
| hardware.ipmi.node\ | Gauge | C | host ID | Pollster | Current tempera\ |
| .temperature | | | | | ture of the |
| | | | | | system |
+---------------------+-------+------+----------+----------+------------------+
| hardware.ipmi.node\ | Gauge | C | host ID | Pollster | Inlet temperatu\ |
| .inlet_temperature | | | | | re of the system |
+---------------------+-------+------+----------+----------+------------------+
| hardware.ipmi.node\ | Gauge | C | host ID | Pollster | Outlet temperat\ |
| .outlet_temperature | | | | | ure of the system|
+---------------------+-------+------+----------+----------+------------------+
| hardware.ipmi.node\ | Gauge | CFM | host ID | Pollster | Volumetric airf\ |
| .airflow | | | | | low of the syst\ |
| | | | | | em, expressed as |
| | | | | | 1/10th of CFM |
+---------------------+-------+------+----------+----------+------------------+
| hardware.ipmi.node\ | Gauge | CUPS | host ID | Pollster | CUPS(Compute Us\ |
| .cups | | | | | age Per Second) |
| | | | | | index data of the|
| | | | | | system |
+---------------------+-------+------+----------+----------+------------------+
| hardware.ipmi.node\ | Gauge | % | host ID | Pollster | CPU CUPS utiliz\ |
| .cpu_util | | | | | ation of the |
| | | | | | system |
+---------------------+-------+------+----------+----------+------------------+
| hardware.ipmi.node\ | Gauge | % | host ID | Pollster | Memory CUPS |
| .mem_util | | | | | utilization of |
| | | | | | the system |
+---------------------+-------+------+----------+----------+------------------+
| hardware.ipmi.node\ | Gauge | % | host ID | Pollster | IO CUPS |
| .io_util | | | | | utilization of |
| | | | | | the system |
+---------------------+-------+------+----------+----------+------------------+
SNMP based meters
~~~~~~~~~~~~~~~~~
Telemetry supports gathering SNMP based generic host meters. In order to
be able to collect this data you need to run snmpd on each target host.
The following meters are available about the host machines by using
SNMP:
+---------------------+-------+------+----------+----------+------------------+
| Name | Type | Unit | Resource | Origin | Note |
+=====================+=======+======+==========+==========+==================+
| **Meters added in the Mitaka release or earlier** |
+---------------------+-------+------+----------+----------+------------------+
| hardware.cpu.load.\ | Gauge | proc\| host ID | Pollster | CPU load in the |
| 1min | | ess | | | past 1 minute |
+---------------------+-------+------+----------+----------+------------------+
| hardware.cpu.load.\ | Gauge | proc\| host ID | Pollster | CPU load in the |
| 5min | | ess | | | past 5 minutes |
+---------------------+-------+------+----------+----------+------------------+
| hardware.cpu.load.\ | Gauge | proc\| host ID | Pollster | CPU load in the |
| 15min | | ess | | | past 15 minutes |
+---------------------+-------+------+----------+----------+------------------+
| hardware.cpu.util | Gauge | % | host ID | Pollster | cpu usage |
| | | | | | percentage |
+---------------------+-------+------+----------+----------+------------------+
| hardware.disk.size\ | Gauge | KB | disk ID | Pollster | Total disk size |
| .total | | | | | |
+---------------------+-------+------+----------+----------+------------------+
| hardware.disk.size\ | Gauge | KB | disk ID | Pollster | Used disk size |
| .used | | | | | |
+---------------------+-------+------+----------+----------+------------------+
| hardware.memory.to\ | Gauge | KB | host ID | Pollster | Total physical |
| tal | | | | | memory size |
+---------------------+-------+------+----------+----------+------------------+
| hardware.memory.us\ | Gauge | KB | host ID | Pollster | Used physical m\ |
| ed | | | | | emory size |
+---------------------+-------+------+----------+----------+------------------+
| hardware.memory.bu\ | Gauge | KB | host ID | Pollster | Physical memory |
| ffer | | | | | buffer size |
+---------------------+-------+------+----------+----------+------------------+
| hardware.memory.ca\ | Gauge | KB | host ID | Pollster | Cached physical |
| ched | | | | | memory size |
+---------------------+-------+------+----------+----------+------------------+
| hardware.memory.sw\ | Gauge | KB | host ID | Pollster | Total swap space |
| ap.total | | | | | size |
+---------------------+-------+------+----------+----------+------------------+
| hardware.memory.sw\ | Gauge | KB | host ID | Pollster | Available swap |
| ap.avail | | | | | space size |
+---------------------+-------+------+----------+----------+------------------+
| hardware.network.i\ | Cumul\| B | interface| Pollster | Bytes received |
| ncoming.bytes | ative | | ID | | by network inte\ |
| | | | | | rface |
+---------------------+-------+------+----------+----------+------------------+
| hardware.network.o\ | Cumul\| B | interface| Pollster | Bytes sent by n\ |
| utgoing.bytes | ative | | ID | | etwork interface |
+---------------------+-------+------+----------+----------+------------------+
| hardware.network.o\ | Cumul\| pack\| interface| Pollster | Sending error o\ |
| utgoing.errors | ative | et | ID | | f network inter\ |
| | | | | | face |
+---------------------+-------+------+----------+----------+------------------+
| hardware.network.i\ | Cumul\| data\| host ID | Pollster | Number of recei\ |
| p.incoming.datagra\ | ative | grams| | | ved datagrams |
| ms | | | | | |
+---------------------+-------+------+----------+----------+------------------+
| hardware.network.i\ | Cumul\| data\| host ID | Pollster | Number of sent |
| p.outgoing.datagra\ | ative | grams| | | datagrams |
| ms | | | | | |
+---------------------+-------+------+----------+----------+------------------+
| hardware.system_st\ | Cumul\| bloc\| host ID | Pollster | Aggregated numb\ |
| ats.io.incoming.bl\ | ative | ks | | | er of blocks re\ |
| ocks | | | | | ceived to block |
| | | | | | device |
+---------------------+-------+------+----------+----------+------------------+
| hardware.system_st\ | Cumul\| bloc\| host ID | Pollster | Aggregated numb\ |
| ats.io.outgoing.bl\ | ative | ks | | | er of blocks se\ |
| ocks | | | | | nt to block dev\ |
| | | | | | ice |
+---------------------+-------+------+----------+----------+------------------+
| hardware.system_st\ | Gauge | % | host ID | Pollster | CPU idle percen\ |
| ats.cpu.idle | | | | | tage |
+---------------------+-------+------+----------+----------+------------------+
OpenStack Image service
~~~~~~~~~~~~~~~~~~~~~~~
The following meters are collected for OpenStack Image service:
+--------------------+--------+------+----------+----------+------------------+
| Name | Type | Unit | Resource | Origin | Note |
+====================+========+======+==========+==========+==================+
| **Meters added in the Mitaka release or earlier** |
+--------------------+--------+------+----------+----------+------------------+
| image.size | Gauge | image| image ID | Notifica\| Size of the upl\ |
| | | | | tion, Po\| oaded image |
| | | | | llster | |
+--------------------+--------+------+----------+----------+------------------+
| image.update | Delta | image| image ID | Notifica\| Number of updat\ |
| | | | | tion | es on the image |
+--------------------+--------+------+----------+----------+------------------+
| image.upload | Delta | image| image ID | Notifica\| Number of uploa\ |
| | | | | tion | ds on the image |
+--------------------+--------+------+----------+----------+------------------+
| image.delete | Delta | image| image ID | Notifica\| Number of delet\ |
| | | | | tion | es on the image |
+--------------------+--------+------+----------+----------+------------------+
| image.download | Delta | B | image ID | Notifica\| Image is downlo\ |
| | | | | tion | aded |
+--------------------+--------+------+----------+----------+------------------+
| image.serve | Delta | B | image ID | Notifica\| Image is served |
| | | | | tion | out |
+--------------------+--------+------+----------+----------+------------------+
| **Meters removed as of Ocata release** |
+--------------------+--------+------+----------+----------+------------------+
| image | Gauge | image| image ID | Notifica\| Existence of the |
| | | | | tion, Po\| image |
| | | | | llster | |
+--------------------+--------+------+----------+----------+------------------+
OpenStack Block Storage
~~~~~~~~~~~~~~~~~~~~~~~
The following meters are collected for OpenStack Block Storage:
+--------------------+-------+--------+----------+----------+-----------------+
| Name | Type | Unit | Resource | Origin | Note |
+====================+=======+========+==========+==========+=================+
| **Meters added in the Mitaka release or earlier** |
+--------------------+-------+--------+----------+----------+-----------------+
| volume.size | Gauge | GB | volume ID| Notifica\| Size of the vol\|
| | | | | tion | ume |
+--------------------+-------+--------+----------+----------+-----------------+
| snapshot.size | Gauge | GB | snapshot | Notifica\| Size of the sna\|
| | | | ID | tion | pshot |
+--------------------+-------+--------+----------+----------+-----------------+
| **Meters removed as of Ocata release** |
+--------------------+-------+--------+----------+----------+-----------------+
| volume | Gauge | volume | volume ID| Notifica\| Existence of the|
| | | | | tion | volume |
+--------------------+-------+--------+----------+----------+-----------------+
| snapshot | Gauge | snapsh\| snapshot | Notifica\| Existence of the|
| | | ot | ID | tion | snapshot |
+--------------------+-------+--------+----------+----------+-----------------+
| volume.create.(sta\| Delta | volume | volume ID| Notifica\| Creation of the |
| rt|end) | | | | tion | volume |
+--------------------+-------+--------+----------+----------+-----------------+
| volume.delete.(sta\| Delta | volume | volume ID| Notifica\| Deletion of the |
| rt|end) | | | | tion | volume |
+--------------------+-------+--------+----------+----------+-----------------+
| volume.update.(sta\| Delta | volume | volume ID| Notifica\| Update the name |
| rt|end) | | | | tion | or description |
| | | | | | of the volume |
+--------------------+-------+--------+----------+----------+-----------------+
| volume.resize.(sta\| Delta | volume | volume ID| Notifica\| Update the size |
| rt|end) | | | | tion | of the volume |
+--------------------+-------+--------+----------+----------+-----------------+
| volume.attach.(sta\| Delta | volume | volume ID| Notifica\| Attaching the v\|
| rt|end) | | | | tion | olume to an ins\|
| | | | | | tance |
+--------------------+-------+--------+----------+----------+-----------------+
| volume.detach.(sta\| Delta | volume | volume ID| Notifica\| Detaching the v\|
| rt|end) | | | | tion | olume from an i\|
| | | | | | nstance |
+--------------------+-------+--------+----------+----------+-----------------+
| snapshot.create.(s\| Delta | snapsh\| snapshot | Notifica\| Creation of the |
| tart|end) | | ot | ID | tion | snapshot |
+--------------------+-------+--------+----------+----------+-----------------+
| snapshot.delete.(s\| Delta | snapsh\| snapshot | Notifica\| Deletion of the |
| tart|end) | | ot | ID | tion | snapshot |
+--------------------+-------+--------+----------+----------+-----------------+
| volume.backup.crea\| Delta | volume | backup ID| Notifica\| Creation of the |
| te.(start|end) | | | | tion | volume backup |
+--------------------+-------+--------+----------+----------+-----------------+
| volume.backup.dele\| Delta | volume | backup ID| Notifica\| Deletion of the |
| te.(start|end) | | | | tion | volume backup |
+--------------------+-------+--------+----------+----------+-----------------+
| volume.backup.rest\| Delta | volume | backup ID| Notifica\| Restoration of |
| ore.(start|end) | | | | tion | the volume back\|
| | | | | | up |
+--------------------+-------+--------+----------+----------+-----------------+
.. _telemetry-object-storage-meter:
OpenStack Object Storage
~~~~~~~~~~~~~~~~~~~~~~~~
The following meters are collected for OpenStack Object Storage:
+--------------------+-------+-------+------------+---------+-----------------+
| Name | Type | Unit | Resource | Origin | Note |
+====================+=======+=======+============+=========+=================+
| **Meters added in the Mitaka release or earlier** |
+--------------------+-------+-------+------------+---------+-----------------+
| storage.objects | Gauge | object| storage ID | Pollster| Number of objec\|
| | | | | | ts |
+--------------------+-------+-------+------------+---------+-----------------+
| storage.objects.si\| Gauge | B | storage ID | Pollster| Total size of s\|
| ze | | | | | tored objects |
+--------------------+-------+-------+------------+---------+-----------------+
| storage.objects.co\| Gauge | conta\| storage ID | Pollster| Number of conta\|
| ntainers | | iner | | | iners |
+--------------------+-------+-------+------------+---------+-----------------+
| storage.objects.in\| Delta | B | storage ID | Notific\| Number of incom\|
| coming.bytes | | | | ation | ing bytes |
+--------------------+-------+-------+------------+---------+-----------------+
| storage.objects.ou\| Delta | B | storage ID | Notific\| Number of outgo\|
| tgoing.bytes | | | | ation | ing bytes |
+--------------------+-------+-------+------------+---------+-----------------+
| storage.api.request| Delta | requ\ | storage ID | Notific\| Number of API r\|
| | | est | | ation | equests against |
| | | | | | OpenStack Obje\ |
| | | | | | ct Storage |
+--------------------+-------+-------+------------+---------+-----------------+
| storage.containers\| Gauge | object| storage ID\| Pollster| Number of objec\|
| .objects | | | /container | | ts in container |
+--------------------+-------+-------+------------+---------+-----------------+
| storage.containers\| Gauge | B | storage ID\| Pollster| Total size of s\|
| .objects.size | | | /container | | tored objects i\|
| | | | | | n container |
+--------------------+-------+-------+------------+---------+-----------------+
Ceph Object Storage
~~~~~~~~~~~~~~~~~~~
In order to gather meters from Ceph, you have to install and configure
the Ceph Object Gateway (radosgw) as it is described in the `Installation
Manual <http://docs.ceph.com/docs/master/radosgw/>`__. You have to enable
`usage logging <http://ceph.com/docs/master/man/8/radosgw/#usage-logging>`__ in
order to get the related meters from Ceph. You will also need an
``admin`` user with ``users``, ``buckets``, ``metadata`` and ``usage``
``caps`` configured.
In order to access Ceph from Telemetry, you need to specify a
``service group`` for ``radosgw`` in the ``ceilometer.conf``
configuration file along with ``access_key`` and ``secret_key`` of the
``admin`` user mentioned above.
The following meters are collected for Ceph Object Storage:
+------------------+------+--------+------------+----------+------------------+
| Name | Type | Unit | Resource | Origin | Note |
+==================+======+========+============+==========+==================+
| **Meters added in the Mitaka release or earlier** |
+------------------+------+--------+------------+----------+------------------+
| radosgw.objects | Gauge| object | storage ID | Pollster | Number of objects|
+------------------+------+--------+------------+----------+------------------+
| radosgw.objects.\| Gauge| B | storage ID | Pollster | Total size of s\ |
| size | | | | | tored objects |
+------------------+------+--------+------------+----------+------------------+
| radosgw.objects.\| Gauge| contai\| storage ID | Pollster | Number of conta\ |
| containers | | ner | | | iners |
+------------------+------+--------+------------+----------+------------------+
| radosgw.api.requ\| Gauge| request| storage ID | Pollster | Number of API r\ |
| est | | | | | equests against |
| | | | | | Ceph Object Ga\ |
| | | | | | teway (radosgw) |
+------------------+------+--------+------------+----------+------------------+
| radosgw.containe\| Gauge| object | storage ID\| Pollster | Number of objec\ |
| rs.objects | | | /container | | ts in container |
+------------------+------+--------+------------+----------+------------------+
| radosgw.containe\| Gauge| B | storage ID\| Pollster | Total size of s\ |
| rs.objects.size | | | /container | | tored objects in |
| | | | | | container |
+------------------+------+--------+------------+----------+------------------+
.. note::
The ``usage`` related information may not be updated right after an
upload or download, because the Ceph Object Gateway needs time to
update the usage properties. For instance, the default configuration
needs approximately 30 minutes to generate the usage logs.
OpenStack Identity
~~~~~~~~~~~~~~~~~~
The following meters are collected for OpenStack Identity:
+-------------------+------+--------+-----------+-----------+-----------------+
| Name | Type | Unit | Resource | Origin | Note |
+===================+======+========+===========+===========+=================+
| **Meters added in the Mitaka release or earlier** |
+-------------------+------+--------+-----------+-----------+-----------------+
| identity.authent\ | Delta| user | user ID | Notifica\ | User successful\|
| icate.success | | | | tion | ly authenticated|
+-------------------+------+--------+-----------+-----------+-----------------+
| identity.authent\ | Delta| user | user ID | Notifica\ | User pending au\|
| icate.pending | | | | tion | thentication |
+-------------------+------+--------+-----------+-----------+-----------------+
| identity.authent\ | Delta| user | user ID | Notifica\ | User failed to |
| icate.failure | | | | tion | authenticate |
+-------------------+------+--------+-----------+-----------+-----------------+
| **Meters removed as of Ocata release** |
+-------------------+------+--------+-----------+-----------+-----------------+
| identity.user.cr\ | Delta| user | user ID | Notifica\ | User is created |
| eated | | | | tion | |
+-------------------+------+--------+-----------+-----------+-----------------+
| identity.user.de\ | Delta| user | user ID | Notifica\ | User is deleted |
| leted | | | | tion | |
+-------------------+------+--------+-----------+-----------+-----------------+
| identity.user.up\ | Delta| user | user ID | Notifica\ | User is updated |
| dated | | | | tion | |
+-------------------+------+--------+-----------+-----------+-----------------+
| identity.group.c\ | Delta| group | group ID | Notifica\ | Group is created|
| reated | | | | tion | |
+-------------------+------+--------+-----------+-----------+-----------------+
| identity.group.d\ | Delta| group | group ID | Notifica\ | Group is deleted|
| eleted | | | | tion | |
+-------------------+------+--------+-----------+-----------+-----------------+
| identity.group.u\ | Delta| group | group ID | Notifica\ | Group is updated|
| pdated | | | | tion | |
+-------------------+------+--------+-----------+-----------+-----------------+
| identity.role.cr\ | Delta| role | role ID | Notifica\ | Role is created |
| eated | | | | tion | |
+-------------------+------+--------+-----------+-----------+-----------------+
| identity.role.de\ | Delta| role | role ID | Notifica\ | Role is deleted |
| leted | | | | tion | |
+-------------------+------+--------+-----------+-----------+-----------------+
| identity.role.up\ | Delta| role | role ID | Notifica\ | Role is updated |
| dated | | | | tion | |
+-------------------+------+--------+-----------+-----------+-----------------+
| identity.project\ | Delta| project| project ID| Notifica\ | Project is crea\|
| .created | | | | tion | ted |
+-------------------+------+--------+-----------+-----------+-----------------+
| identity.project\ | Delta| project| project ID| Notifica\ | Project is dele\|
| .deleted | | | | tion | ted |
+-------------------+------+--------+-----------+-----------+-----------------+
| identity.project\ | Delta| project| project ID| Notifica\ | Project is upda\|
| .updated | | | | tion | ted |
+-------------------+------+--------+-----------+-----------+-----------------+
| identity.trust.c\ | Delta| trust | trust ID | Notifica\ | Trust is created|
| reated | | | | tion | |
+-------------------+------+--------+-----------+-----------+-----------------+
| identity.trust.d\ | Delta| trust | trust ID | Notifica\ | Trust is deleted|
| eleted | | | | tion | |
+-------------------+------+--------+-----------+-----------+-----------------+
| identity.role_as\ | Delta| role_a\| role ID | Notifica\ | Role is added to|
| signment.created | | ssignm\| | tion | an actor on a |
| | | ent | | | target |
+-------------------+------+--------+-----------+-----------+-----------------+
| identity.role_as\ | Delta| role_a\| role ID | Notifica\ | Role is removed |
| signment.deleted | | ssignm\| | tion | from an actor |
| | | ent | | | on a target |
+-------------------+------+--------+-----------+-----------+-----------------+
OpenStack Networking
~~~~~~~~~~~~~~~~~~~~
The following meters are collected for OpenStack Networking:
+-----------------+-------+--------+-----------+-----------+------------------+
| Name | Type | Unit | Resource | Origin | Note |
+=================+=======+========+===========+===========+==================+
| **Meters added in the Mitaka release or earlier** |
+-----------------+-------+--------+-----------+-----------+------------------+
| bandwidth | Delta | B | label ID | Notifica\ | Bytes through t\ |
| | | | | tion | his l3 metering |
| | | | | | label |
+-----------------+-------+--------+-----------+-----------+------------------+
| **Meters removed as of Ocata release** |
+-----------------+-------+--------+-----------+-----------+------------------+
| network | Gauge | networ\| network ID| Notifica\ | Existence of ne\ |
| | | k | | tion | twork |
+-----------------+-------+--------+-----------+-----------+------------------+
| network.create | Delta | networ\| network ID| Notifica\ | Creation reques\ |
| | | k | | tion | ts for this net\ |
| | | | | | work |
+-----------------+-------+--------+-----------+-----------+------------------+
| network.update | Delta | networ\| network ID| Notifica\ | Update requests |
| | | k | | tion | for this network |
+-----------------+-------+--------+-----------+-----------+------------------+
| subnet | Gauge | subnet | subnet ID | Notifica\ | Existence of su\ |
| | | | | tion | bnet |
+-----------------+-------+--------+-----------+-----------+------------------+
| subnet.create | Delta | subnet | subnet ID | Notifica\ | Creation reques\ |
| | | | | tion | ts for this sub\ |
| | | | | | net |
+-----------------+-------+--------+-----------+-----------+------------------+
| subnet.update | Delta | subnet | subnet ID | Notifica\ | Update requests |
| | | | | tion | for this subnet |
+-----------------+-------+--------+-----------+-----------+------------------+
| port | Gauge | port | port ID | Notifica\ | Existence of po\ |
| | | | | tion | rt |
+-----------------+-------+--------+-----------+-----------+------------------+
| port.create | Delta | port | port ID | Notifica\ | Creation reques\ |
| | | | | tion | ts for this port |
+-----------------+-------+--------+-----------+-----------+------------------+
| port.update | Delta | port | port ID | Notifica\ | Update requests |
| | | | | tion | for this port |
+-----------------+-------+--------+-----------+-----------+------------------+
| router | Gauge | router | router ID | Notifica\ | Existence of ro\ |
| | | | | tion | uter |
+-----------------+-------+--------+-----------+-----------+------------------+
| router.create | Delta | router | router ID | Notifica\ | Creation reques\ |
| | | | | tion | ts for this rou\ |
| | | | | | ter |
+-----------------+-------+--------+-----------+-----------+------------------+
| router.update | Delta | router | router ID | Notifica\ | Update requests |
| | | | | tion | for this router |
+-----------------+-------+--------+-----------+-----------+------------------+
| ip.floating | Gauge | ip | ip ID | Notifica\ | Existence of IP |
| | | | | tion, Po\ | |
| | | | | llster | |
+-----------------+-------+--------+-----------+-----------+------------------+
| ip.floating.cr\ | Delta | ip | ip ID | Notifica\ | Creation reques\ |
| eate | | | | tion | ts for this IP |
+-----------------+-------+--------+-----------+-----------+------------------+
| ip.floating.up\ | Delta | ip | ip ID | Notifica\ | Update requests |
| date | | | | tion | for this IP |
+-----------------+-------+--------+-----------+-----------+------------------+
SDN controllers
~~~~~~~~~~~~~~~
The following meters are collected for SDN:
+-----------------+---------+--------+-----------+----------+-----------------+
| Name | Type | Unit | Resource | Origin | Note |
+=================+=========+========+===========+==========+=================+
| **Meters added in the Mitaka release or earlier** |
+-----------------+---------+--------+-----------+----------+-----------------+
| switch | Gauge | switch | switch ID | Pollster | Existence of sw\|
| | | | | | itch |
+-----------------+---------+--------+-----------+----------+-----------------+
| switch.port | Gauge | port | switch ID | Pollster | Existence of po\|
| | | | | | rt |
+-----------------+---------+--------+-----------+----------+-----------------+
| switch.port.re\ | Cumula\ | packet | switch ID | Pollster | Packets receive\|
| ceive.packets | tive | | | | d on port |
+-----------------+---------+--------+-----------+----------+-----------------+
| switch.port.tr\ | Cumula\ | packet | switch ID | Pollster | Packets transmi\|
| ansmit.packets | tive | | | | tted on port |
+-----------------+---------+--------+-----------+----------+-----------------+
| switch.port.re\ | Cumula\ | B | switch ID | Pollster | Bytes received |
| ceive.bytes | tive | | | | on port |
+-----------------+---------+--------+-----------+----------+-----------------+
| switch.port.tr\ | Cumula\ | B | switch ID | Pollster | Bytes transmitt\|
| ansmit.bytes | tive | | | | ed on port |
+-----------------+---------+--------+-----------+----------+-----------------+
| switch.port.re\ | Cumula\ | packet | switch ID | Pollster | Drops received |
| ceive.drops | tive | | | | on port |
+-----------------+---------+--------+-----------+----------+-----------------+
| switch.port.tr\ | Cumula\ | packet | switch ID | Pollster | Drops transmitt\|
| ansmit.drops | tive | | | | ed on port |
+-----------------+---------+--------+-----------+----------+-----------------+
| switch.port.re\ | Cumula\ | packet | switch ID | Pollster | Errors received |
| ceive.errors | tive | | | | on port |
+-----------------+---------+--------+-----------+----------+-----------------+
| switch.port.tr\ | Cumula\ | packet | switch ID | Pollster | Errors transmit\|
| ansmit.errors | tive | | | | ted on port |
+-----------------+---------+--------+-----------+----------+-----------------+
| switch.port.re\ | Cumula\ | packet | switch ID | Pollster | Frame alignment |
| ceive.frame\_er\| tive | | | | errors receive\ |
| ror | | | | | d on port |
+-----------------+---------+--------+-----------+----------+-----------------+
| switch.port.re\ | Cumula\ | packet | switch ID | Pollster | Overrun errors |
| ceive.overrun\_\| tive | | | | received on port|
| error | | | | | |
+-----------------+---------+--------+-----------+----------+-----------------+
| switch.port.re\ | Cumula\ | packet | switch ID | Pollster | CRC errors rece\|
| ceive.crc\_error| tive | | | | ived on port |
+-----------------+---------+--------+-----------+----------+-----------------+
| switch.port.co\ | Cumula\ | count | switch ID | Pollster | Collisions on p\|
| llision.count | tive | | | | ort |
+-----------------+---------+--------+-----------+----------+-----------------+
| switch.table | Gauge | table | switch ID | Pollster | Duration of tab\|
| | | | | | le |
+-----------------+---------+--------+-----------+----------+-----------------+
| switch.table.a\ | Gauge | entry | switch ID | Pollster | Active entries |
| ctive.entries | | | | | in table |
+-----------------+---------+--------+-----------+----------+-----------------+
| switch.table.l\ | Gauge | packet | switch ID | Pollster | Lookup packets |
| ookup.packets | | | | | for table |
+-----------------+---------+--------+-----------+----------+-----------------+
| switch.table.m\ | Gauge | packet | switch ID | Pollster | Packets matches |
| atched.packets | | | | | for table |
+-----------------+---------+--------+-----------+----------+-----------------+
| switch.flow | Gauge | flow | switch ID | Pollster | Duration of flow|
+-----------------+---------+--------+-----------+----------+-----------------+
| switch.flow.du\ | Gauge | s | switch ID | Pollster | Duration of flow|
| ration.seconds | | | | | in seconds |
+-----------------+---------+--------+-----------+----------+-----------------+
| switch.flow.du\ | Gauge | ns | switch ID | Pollster | Duration of flow|
| ration.nanosec\ | | | | | in nanoseconds |
| onds | | | | | |
+-----------------+---------+--------+-----------+----------+-----------------+
| switch.flow.pa\ | Cumula\ | packet | switch ID | Pollster | Packets received|
| ckets | tive | | | | |
+-----------------+---------+--------+-----------+----------+-----------------+
| switch.flow.by\ | Cumula\ | B | switch ID | Pollster | Bytes received |
| tes | tive | | | | |
+-----------------+---------+--------+-----------+----------+-----------------+
These meters are available for OpenFlow based switches. In order to
enable these meters, each driver needs to be properly configured.
Load-Balancer-as-a-Service (LBaaS v1)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The following meters are collected for LBaaS v1:
+---------------+---------+---------+-----------+-----------+-----------------+
| Name | Type | Unit | Resource | Origin | Note |
+===============+=========+=========+===========+===========+=================+
| **Meters added in the Mitaka release or earlier** |
+---------------+---------+---------+-----------+-----------+-----------------+
| network.serv\ | Gauge | pool | pool ID | Pollster | Existence of a |
| ices.lb.pool | | | | | LB pool |
+---------------+---------+---------+-----------+-----------+-----------------+
| network.serv\ | Gauge | vip | vip ID | Pollster | Existence of a |
| ices.lb.vip | | | | | LB VIP |
+---------------+---------+---------+-----------+-----------+-----------------+
| network.serv\ | Gauge | member | member ID | Pollster | Existence of a |
| ices.lb.memb\ | | | | | LB member |
| er | | | | | |
+---------------+---------+---------+-----------+-----------+-----------------+
| network.serv\ | Gauge | health\ | monitor ID| Pollster | Existence of a |
| ices.lb.heal\ | | _monit\ | | | LB health probe |
| th_monitor | | or | | | |
+---------------+---------+---------+-----------+-----------+-----------------+
| network.serv\ | Cumula\ | connec\ | pool ID | Pollster | Total connectio\|
| ices.lb.tota\ | tive | tion | | | ns on a LB |
| l.connections | | | | | |
+---------------+---------+---------+-----------+-----------+-----------------+
| network.serv\ | Gauge | connec\ | pool ID | Pollster | Active connecti\|
| ices.lb.acti\ | | tion | | | ons on a LB |
| ve.connections| | | | | |
+---------------+---------+---------+-----------+-----------+-----------------+
| network.serv\ | Gauge | B | pool ID | Pollster | Number of incom\|
| ices.lb.inco\ | | | | | ing Bytes |
| ming.bytes | | | | | |
+---------------+---------+---------+-----------+-----------+-----------------+
| network.serv\ | Gauge | B | pool ID | Pollster | Number of outgo\|
| ices.lb.outg\ | | | | | ing Bytes |
| oing.bytes | | | | | |
+---------------+---------+---------+-----------+-----------+-----------------+
| **Meters removed as of Ocata release** |
+---------------+---------+---------+-----------+-----------+-----------------+
| network.serv\ | Delta | pool | pool ID | Notifica\ | LB pool was cre\|
| ices.lb.pool\ | | | | tion | ated |
| .create | | | | | |
+---------------+---------+---------+-----------+-----------+-----------------+
| network.serv\ | Delta | pool | pool ID | Notifica\ | LB pool was upd\|
| ices.lb.pool\ | | | | tion | ated |
| .update | | | | | |
+---------------+---------+---------+-----------+-----------+-----------------+
| network.serv\ | Delta | vip | vip ID | Notifica\ | LB VIP was crea\|
| ices.lb.vip.\ | | | | tion | ted |
| create | | | | | |
+---------------+---------+---------+-----------+-----------+-----------------+
| network.serv\ | Delta | vip | vip ID | Notifica\ | LB VIP was upda\|
| ices.lb.vip.\ | | | | tion | ted |
| update | | | | | |
+---------------+---------+---------+-----------+-----------+-----------------+
| network.serv\ | Delta | member | member ID | Notifica\ | LB member was c\|
| ices.lb.memb\ | | | | tion | reated |
| er.create | | | | | |
+---------------+---------+---------+-----------+-----------+-----------------+
| network.serv\ | Delta | member | member ID | Notifica\ | LB member was u\|
| ices.lb.memb\ | | | | tion | pdated |
| er.update | | | | | |
+---------------+---------+---------+-----------+-----------+-----------------+
| network.serv\ | Delta | health\ | monitor ID| Notifica\ | LB health probe |
| ices.lb.heal\ | | _monit\ | | tion | was created |
| th_monitor.c\ | | or | | | |
| reate | | | | | |
+---------------+---------+---------+-----------+-----------+-----------------+
| network.serv\ | Delta | health\ | monitor ID| Notifica\ | LB health probe |
| ices.lb.heal\ | | _monit\ | | tion | was updated |
| th_monitor.u\ | | or | | | |
| pdate | | | | | |
+---------------+---------+---------+-----------+-----------+-----------------+
Load-Balancer-as-a-Service (LBaaS v2)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The following meters are collected for LBaaS v2.
+---------------+---------+---------+-----------+-----------+-----------------+
| Name | Type | Unit | Resource | Origin | Note |
+===============+=========+=========+===========+===========+=================+
| **Meters added in the Mitaka release or earlier** |
+---------------+---------+---------+-----------+-----------+-----------------+
| network.serv\ | Gauge | pool | pool ID | Pollster | Existence of a |
| ices.lb.pool | | | | | LB pool |
+---------------+---------+---------+-----------+-----------+-----------------+
| network.serv\ | Gauge | listen\ | listener | Pollster | Existence of a |
| ices.lb.list\ | | er | ID | | LB listener |
| ener | | | | | |
+---------------+---------+---------+-----------+-----------+-----------------+
| network.serv\ | Gauge | member | member ID | Pollster | Existence of a |
| ices.lb.memb\ | | | | | LB member |
| er | | | | | |
+---------------+---------+---------+-----------+-----------+-----------------+
| network.serv\ | Gauge | health\ | monitor ID| Pollster | Existence of a |
| ices.lb.heal\ | | _monit\ | | | LB health probe |
| th_monitor | | or | | | |
+---------------+---------+---------+-----------+-----------+-----------------+
| network.serv\ | Gauge | loadba\ | loadbala\ | Pollster | Existence of a |
| ices.lb.load\ | | lancer | ncer ID | | LB loadbalancer |
| balancer | | | | | |
+---------------+---------+---------+-----------+-----------+-----------------+
| network.serv\ | Cumula\ | connec\ | pool ID | Pollster | Total connectio\|
| ices.lb.tota\ | tive | tion | | | ns on a LB |
| l.connections | | | | | |
+---------------+---------+---------+-----------+-----------+-----------------+
| network.serv\ | Gauge | connec\ | pool ID | Pollster | Active connecti\|
| ices.lb.acti\ | | tion | | | ons on a LB |
| ve.connections| | | | | |
+---------------+---------+---------+-----------+-----------+-----------------+
| network.serv\ | Gauge | B | pool ID | Pollster | Number of incom\|
| ices.lb.inco\ | | | | | ing Bytes |
| ming.bytes | | | | | |
+---------------+---------+---------+-----------+-----------+-----------------+
| network.serv\ | Gauge | B | pool ID | Pollster | Number of outgo\|
| ices.lb.outg\ | | | | | ing Bytes |
| oing.bytes | | | | | |
+---------------+---------+---------+-----------+-----------+-----------------+
| **Meters removed as of Ocata release** |
+---------------+---------+---------+-----------+-----------+-----------------+
| network.serv\ | Delta | pool | pool ID | Notifica\ | LB pool was cre\|
| ices.lb.pool\ | | | | tion | ated |
| .create | | | | | |
+---------------+---------+---------+-----------+-----------+-----------------+
| network.serv\ | Delta | pool | pool ID | Notifica\ | LB pool was upd\|
| ices.lb.pool\ | | | | tion | ated |
| .update | | | | | |
+---------------+---------+---------+-----------+-----------+-----------------+
| network.serv\ | Delta | listen\ | listener | Notifica\ | LB listener was |
| ices.lb.list\ | | er | ID | tion | created |
| ener.create | | | | | |
+---------------+---------+---------+-----------+-----------+-----------------+
| network.serv\ | Delta | listen\ | listener | Notifica\ | LB listener was |
| ices.lb.list\ | | er | ID | tion | updated |
| ener.update | | | | | |
+---------------+---------+---------+-----------+-----------+-----------------+
| network.serv\ | Delta | member | member ID | Notifica\ | LB member was c\|
| ices.lb.memb\ | | | | tion | reated |
| er.create | | | | | |
+---------------+---------+---------+-----------+-----------+-----------------+
| network.serv\ | Delta | member | member ID | Notifica\ | LB member was u\|
| ices.lb.memb\ | | | | tion | pdated |
| er.update | | | | | |
+---------------+---------+---------+-----------+-----------+-----------------+
| network.serv\ | Delta | health\ | monitor ID| Notifica\ | LB health probe |
| ices.lb.heal\ | | _monit\ | | tion | was created |
| thmonitor.cr\ | | or | | | |
| eate | | | | | |
+---------------+---------+---------+-----------+-----------+-----------------+
| network.serv\ | Delta | health\ | monitor ID| Notifica\ | LB health probe |
| ices.lb.heal\ | | _monit\ | | tion | was updated |
| thmonitor.up\ | | or | | | |
| date | | | | | |
+---------------+---------+---------+-----------+-----------+-----------------+
| network.serv\ | Delta | loadba\ | loadbala\ | Notifica\ | LB loadbalancer |
| ices.lb.load\ | | lancer\ | ncer ID | tion | was created |
| balancer.cre\ | | | | | |
| ate | | | | | |
+---------------+---------+---------+-----------+-----------+-----------------+
| network.serv\ | Delta | loadba\ | loadbala\ | Notifica\ | LB loadbalancer |
| ices.lb.load\ | | lancer\ | ncer ID | tion | was updated |
| balancer.upd\ | | | | | |
| ate | | | | | |
+---------------+---------+---------+-----------+-----------+-----------------+
.. note::
The above meters are experimental and may generate a large load against the
Neutron APIs. The future enhancement will be implemented when Neutron
supports the new APIs.
VPN-as-a-Service (VPNaaS)
~~~~~~~~~~~~~~~~~~~~~~~~~
The following meters are collected for VPNaaS:
+---------------+-------+---------+------------+-----------+------------------+
| Name | Type | Unit | Resource | Origin | Note |
+===============+=======+=========+============+===========+==================+
| **Meters added in the Mitaka release or earlier** |
+---------------+-------+---------+------------+-----------+------------------+
| network.serv\ | Gauge | vpnser\ | vpn ID | Pollster | Existence of a |
| ices.vpn | | vice | | | VPN |
+---------------+-------+---------+------------+-----------+------------------+
| network.serv\ | Gauge | ipsec\_\| connection | Pollster | Existence of an |
| ices.vpn.con\ | | site\_c\| ID | | IPSec connection |
| nections | | onnect\ | | | |
| | | ion | | | |
+---------------+-------+---------+------------+-----------+------------------+
| **Meters removed as of Ocata release** |
+---------------+-------+---------+------------+-----------+------------------+
| network.serv\ | Delta | vpnser\ | vpn ID | Notifica\ | VPN was created |
| ices.vpn.cre\ | | vice | | tion | |
| ate | | | | | |
+---------------+-------+---------+------------+-----------+------------------+
| network.serv\ | Delta | vpnser\ | vpn ID | Notifica\ | VPN was updated |
| ices.vpn.upd\ | | vice | | tion | |
| ate | | | | | |
+---------------+-------+---------+------------+-----------+------------------+
| network.serv\ | Delta | ipsec\_\| connection | Notifica\ | IPSec connection |
| ices.vpn.con\ | | site\_c\| ID | tion | was created |
| nections.cre\ | | onnect\ | | | |
| ate | | ion | | | |
+---------------+-------+---------+------------+-----------+------------------+
| network.serv\ | Delta | ipsec\_\| connection | Notifica\ | IPSec connection |
| ices.vpn.con\ | | site\_c\| ID | tion | was updated |
| nections.upd\ | | onnect\ | | | |
| ate | | ion | | | |
+---------------+-------+---------+------------+-----------+------------------+
| network.serv\ | Gauge | ipsecp\ | ipsecpolicy| Notifica\ | Existence of an |
| ices.vpn.ips\ | | olicy | ID | tion, Po\ | IPSec policy |
| ecpolicy | | | | llster | |
+---------------+-------+---------+------------+-----------+------------------+
| network.serv\ | Delta | ipsecp\ | ipsecpolicy| Notifica\ | IPSec policy was |
| ices.vpn.ips\ | | olicy | ID | tion | created |
| ecpolicy.cre\ | | | | | |
| ate | | | | | |
+---------------+-------+---------+------------+-----------+------------------+
| network.serv\ | Delta | ipsecp\ | ipsecpolicy| Notifica\ | IPSec policy was |
| ices.vpn.ips\ | | olicy | ID | tion | updated |
| ecpolicy.upd\ | | | | | |
| ate | | | | | |
+---------------+-------+---------+------------+-----------+------------------+
| network.serv\ | Gauge | ikepol\ | ikepolicy | Notifica\ | Existence of an |
| ices.vpn.ike\ | | icy | ID | tion, Po\ | Ike policy |
| policy | | | | llster | |
+---------------+-------+---------+------------+-----------+------------------+
| network.serv\ | Delta | ikepol\ | ikepolicy | Notifica\ | Ike policy was |
| ices.vpn.ike\ | | icy | ID | tion | created |
| policy.create | | | | | |
+---------------+-------+---------+------------+-----------+------------------+
| network.serv\ | Delta | ikepol\ | ikepolicy | Notifica\ | Ike policy was |
| ices.vpn.ike\ | | icy | ID | tion | updated |
| policy.update | | | | | |
+---------------+-------+---------+------------+-----------+------------------+
Firewall-as-a-Service (FWaaS)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The following meters are collected for FWaaS:
+---------------+-------+---------+------------+-----------+------------------+
| Name | Type | Unit | Resource | Origin | Note |
+===============+=======+=========+============+===========+==================+
| **Meters added in the Mitaka release or earlier** |
+---------------+-------+---------+------------+-----------+------------------+
| network.serv\ | Gauge | firewall| firewall ID| Pollster | Existence of a |
| ices.firewall | | | | | firewall |
+---------------+-------+---------+------------+-----------+------------------+
| network.serv\ | Gauge | firewa\ | firewall ID| Pollster | Existence of a |
| ices.firewal\ | | ll_pol\ | | | firewall policy |
| l.policy | | icy | | | |
+---------------+-------+---------+------------+-----------+------------------+
| **Meters removed as of Ocata release** |
+---------------+-------+---------+------------+-----------+------------------+
| network.serv\ | Delta | firewall| firewall ID| Notifica\ | Firewall was cr\ |
| ices.firewal\ | | | | tion | eated |
| l.create | | | | | |
+---------------+-------+---------+------------+-----------+------------------+
| network.serv\ | Delta | firewall| firewall ID| Notifica\ | Firewall was up\ |
| ices.firewal\ | | | | tion | dated |
| l.update | | | | | |
+---------------+-------+---------+------------+-----------+------------------+
| network.serv\ | Delta | firewa\ | policy ID | Notifica\ | Firewall policy |
| ices.firewal\ | | ll_pol\ | | tion | was created |
| l.policy.cre\ | | icy | | | |
| ate | | | | | |
+---------------+-------+---------+------------+-----------+------------------+
| network.serv\ | Delta | firewa\ | policy ID | Notifica\ | Firewall policy |
| ices.firewal\ | | ll_pol\ | | tion | was updated |
| l.policy.upd\ | | icy | | | |
| ate | | | | | |
+---------------+-------+---------+------------+-----------+------------------+
| network.serv\ | Gauge | firewa\ | rule ID | Notifica\ | Existence of a |
| ices.firewal\ | | ll_rule | | tion | firewall rule |
| l.rule | | | | | |
+---------------+-------+---------+------------+-----------+------------------+
| network.serv\ | Delta | firewa\ | rule ID | Notifica\ | Firewall rule w\ |
| ices.firewal\ | | ll_rule | | tion | as created |
| l.rule.create | | | | | |
| | | | | | |
+---------------+-------+---------+------------+-----------+------------------+
| network.serv\ | Delta | firewa\ | rule ID | Notifica\ | Firewall rule w\ |
| ices.firewal\ | | ll_rule | | tion | as updated |
| l.rule.update | | | | | |
+---------------+-------+---------+------------+-----------+------------------+
Orchestration service
~~~~~~~~~~~~~~~~~~~~~
The following meters were previously collected for the Orchestration service:
+----------------+-------+------+----------+--------------+-------------------+
| Name | Type | Unit | Resource | Origin | Note |
+================+=======+======+==========+==============+===================+
| **Meters removed as of Ocata release** |
+----------------+-------+------+----------+--------------+-------------------+
| stack.create | Delta | stack| stack ID | Notification | Stack was success\|
| | | | | | fully created |
+----------------+-------+------+----------+--------------+-------------------+
| stack.update | Delta | stack| stack ID | Notification | Stack was success\|
| | | | | | fully updated |
+----------------+-------+------+----------+--------------+-------------------+
| stack.delete | Delta | stack| stack ID | Notification | Stack was success\|
| | | | | | fully deleted |
+----------------+-------+------+----------+--------------+-------------------+
| stack.resume | Delta | stack| stack ID | Notification | Stack was success\|
| | | | | | fully resumed |
+----------------+-------+------+----------+--------------+-------------------+
| stack.suspend | Delta | stack| stack ID | Notification | Stack was success\|
| | | | | | fully suspended |
+----------------+-------+------+----------+--------------+-------------------+
Data processing service for OpenStack
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The following meters were previously collected for the Data processing service
for OpenStack:
+----------------+-------+---------+-----------+-------------+----------------+
| Name | Type | Unit | Resource | Origin | Note |
+================+=======+=========+===========+=============+================+
| **Meters removed as of Ocata release** |
+----------------+-------+---------+-----------+-------------+----------------+
| cluster.create | Delta | cluster | cluster ID| Notification| Cluster was |
| | | | | | successfully |
| | | | | | created |
| | | | | | |
+----------------+-------+---------+-----------+-------------+----------------+
| cluster.update | Delta | cluster | cluster ID| Notification| Cluster was |
| | | | | | successfully |
| | | | | | updated |
+----------------+-------+---------+-----------+-------------+----------------+
| cluster.delete | Delta | cluster | cluster ID| Notification| Cluster was |
| | | | | | successfully |
| | | | | | deleted |
+----------------+-------+---------+-----------+-------------+----------------+
Key Value Store module
~~~~~~~~~~~~~~~~~~~~~~
The following meters were previously collected for the Key Value Store module:
+------------------+-------+------+----------+-------------+------------------+
| Name | Type | Unit | Resource | Origin | Note |
+==================+=======+======+==========+=============+==================+
| **Meters removed as of Newton release** |
+------------------+-------+------+----------+-------------+------------------+
| magnetodb.table.\| Gauge | table| table ID | Notification| Table was succe\ |
| create | | | | | ssfully created |
+------------------+-------+------+----------+-------------+------------------+
| magnetodb.table\ | Gauge | table| table ID | Notification| Table was succe\ |
| .delete | | | | | ssfully deleted |
+------------------+-------+------+----------+-------------+------------------+
| magnetodb.table\ | Gauge | index| table ID | Notification| Number of indices|
| .index.count | | | | | created in a |
| | | | | | table |
+------------------+-------+------+----------+-------------+------------------+
Energy
~~~~~~
The following energy related meters were previously available:
+---------------+------------+------+----------+----------+-------------------+
| Name | Type | Unit | Resource | Origin | Note |
+===============+============+======+==========+==========+===================+
| **Meters deprecated as of Newton release** |
+---------------+------------+------+----------+----------+-------------------+
| energy | Cumulative | kWh | probe ID | Pollster | Amount of energy |
+---------------+------------+------+----------+----------+-------------------+
| power | Gauge | W | probe ID | Pollster | Power consumption |
+---------------+------------+------+----------+----------+-------------------+
View Git Blame Copy Permalink