2018-04-14 11:24:47 +02:00
|
|
|
.. include:: ../global.rst.inc
|
|
|
|
|
|
|
|
|
|
.. _monitoring:
|
|
|
|
|
|
|
|
|
|
Monitoring
|
|
|
|
|
==========
|
|
|
|
|
|
|
|
|
|
Monitoring endpoints are configured in the ``global.monitoring`` section of the |mainconfig|.
|
|
|
|
|
|
|
|
|
|
.. _monitoring-prometheus:
|
|
|
|
|
|
2019-03-16 15:48:37 +01:00
|
|
|
Prometheus & Grafana
|
|
|
|
|
--------------------
|
2018-04-14 11:24:47 +02:00
|
|
|
|
|
|
|
|
zrepl can expose `Prometheus metrics <https://prometheus.io/docs/instrumenting/exposition_formats/>`_ via HTTP.
|
|
|
|
|
The ``listen`` attribute is a `net.Listen <https://golang.org/pkg/net/#Listen>`_ string for tcp, e.g. ``:9091`` or ``127.0.0.1:9091``.
|
|
|
|
|
The Prometheues monitoring job appears in the ``zrepl control`` job list and may be specified **at most once**.
|
2019-03-16 15:48:37 +01:00
|
|
|
|
|
|
|
|
zrepl also ships with an importable `Grafana <https://grafana.com>`_ dashboard that consumes the Prometheus metrics:
|
|
|
|
|
see :repomasterlink:`dist/grafana`.
|
|
|
|
|
The dashboard also contains some advice on which metrics are important to monitor.
|
|
|
|
|
|
|
|
|
|
.. NOTE::
|
|
|
|
|
|
|
|
|
|
At the time of writing, there is no stability guarantee on the exported metrics.
|
2018-04-14 11:24:47 +02:00
|
|
|
|
|
|
|
|
::
|
|
|
|
|
|
|
|
|
|
global:
|
|
|
|
|
monitoring:
|
|
|
|
|
- type: prometheus
|
|
|
|
|
listen: ':9091'
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
