glances/docs/gw/prometheus.rst

40 lines
975 B
ReStructuredText
Raw Normal View History

2017-03-19 19:59:21 +03:00
.. _prometheus:
2017-03-19 19:59:21 +03:00
Prometheus
==========
2017-03-19 19:59:21 +03:00
You can export statistics to a ``Prometheus`` server through an exporter.
When the *--export-prometheus* is used, Glances creates a Prometheus exporter
listening on <host:port> (define in the Glances configuration file).
.. code-block:: ini
2017-03-19 19:59:21 +03:00
[prometheus]
host=localhost
2017-03-19 19:59:21 +03:00
port=9091
prefix=glances
and run Glances with:
.. code-block:: console
2017-03-19 19:59:21 +03:00
$ glances --export-prometheus
2017-03-19 19:59:21 +03:00
You can check that Glances exports the stats using this URL: http://localhost:9091
.. image:: ../_static/prometheus_exporter.png
In order to store the metrics in a Prometheus server, you should add this
exporter to your Prometheus server configuration with the following lines
(in the prometheus.yml configuration file):
.. code-block:: ini
2017-03-19 19:59:21 +03:00
scrape_configs:
- job_name: 'glances_exporter'
scrape_interval: 5s
static_configs:
- targets: ['localhost:9091']
2017-03-19 19:59:21 +03:00
.. image:: ../_static/prometheus_server.png