Merge pull request #25182 from jan--f/mgr-prometheus-doc-mention-instance-label

doc/mgr/prometheus: readd section about custom instance labels
This commit is contained in:
Jan Fajerski 2018-11-22 14:29:43 +01:00 committed by GitHub
commit ed05b163e7
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -129,17 +129,21 @@ Configuring Prometheus server
honor_labels
------------
To enable Ceph to output properly-labelled data relating to any host,
To enable Ceph to output properly-labeled data relating to any host,
use the ``honor_labels`` setting when adding the ceph-mgr endpoints
to your prometheus configuration.
This allows Ceph to export the proper ``instance`` label without prometheus
overwriting it. Without this setting, Prometheus applies an ``instance`` label
that includes the hostname and port of the endpoint that the series game from.
that includes the hostname and port of the endpoint that the series came from.
Because Ceph clusters have multiple manager daemons, this results in an
``instance`` label that changes spuriously when the active manager daemon
changes.
If this is undesirable a custom ``instance`` label can be set in the
Prometheus target configuration: you might wish to set it to the hostname
of your first mgr daemon, or something completely arbitrary like "ceph_cluster".
node_exporter hostname labels
-----------------------------