File: prometheus.rst

package info (click to toggle)
gnocchi 4.7.0-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 4,384 kB
  • sloc: python: 21,820; sh: 366; makefile: 54
file content (29 lines) | stat: -rw-r--r-- 1,000 bytes parent folder | download | duplicates (5)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
====================
 Prometheus support
====================

`Prometheus`_ can use Gnocchi to store its data through `Remote Write
Adapter`_. Gnocchi needs to be installed with the `prometheus` flavor.

Example of Prometheus configuration::

  remote_write:
  - url: "http://localhost:8041/v1/prometheus/write"
    basic_auth:
      username: "admin"
      password: "whatever"


The `/v1/prometheus/write` endpoint handles the `WriteRequest` protobuf
message.

Gnocchi maps Prometheus metrics to its data model.

For each metric sent by Prometheus, Gnocchi maintains a corresponding resource
based on each `job` and `instance` pair. This resource is created with the
`prometheus` resource type and contains two attributes, `job` and `instance`.
The metrics sent by Prometheus with this pair are attached to that resource and
filled with the provided measures.

.. _`Prometheus`: https://prometheus.io/
.. _`Remote Write Adapter`: https://prometheus.io/docs/operating/configuration/#<remote_write>