From 92494c969f8dcc89bbd412d535ee0fa22644a669 Mon Sep 17 00:00:00 2001 From: Jan Fajerski Date: Tue, 20 Nov 2018 12:43:12 +0100 Subject: [PATCH] doc/mgr/prometheus: readd section about custom instance labels This section was removed accidentally by 331a826a9f7433812dc5ed789ac7652e00aaaa71. It offers a helpful configuration variant to deal with mgr failovers. Signed-off-by: Jan Fajerski --- doc/mgr/prometheus.rst | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/doc/mgr/prometheus.rst b/doc/mgr/prometheus.rst index fc2f15fe235..983ea9ae4c5 100644 --- a/doc/mgr/prometheus.rst +++ b/doc/mgr/prometheus.rst @@ -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 ----------------------------- -- 2.39.5