]> git.apps.os.sepia.ceph.com Git - ceph-ci.git/commitdiff
doc/mgr/prometheus: readd section about custom instance labels
authorJan Fajerski <jfajerski@suse.com>
Tue, 20 Nov 2018 11:43:12 +0000 (12:43 +0100)
committerJan Fajerski <jfajerski@suse.com>
Tue, 20 Nov 2018 11:43:12 +0000 (12:43 +0100)
This section was removed accidentally by
331a826a9f7433812dc5ed789ac7652e00aaaa71. It offers a helpful configuration
variant to deal with mgr failovers.

Signed-off-by: Jan Fajerski <jfajerski@suse.com>
doc/mgr/prometheus.rst

index fc2f15fe235d4f6cbccf72d71eb747328945cd42..983ea9ae4c555ad86ef0a0eb95375bb36ec0260f 100644 (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
 -----------------------------