From: Jan Fajerski Date: Tue, 20 Nov 2018 11:43:12 +0000 (+0100) Subject: doc/mgr/prometheus: readd section about custom instance labels X-Git-Tag: v14.1.0~832^2 X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=refs%2Fpull%2F25182%2Fhead;p=ceph.git 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 --- diff --git a/doc/mgr/prometheus.rst b/doc/mgr/prometheus.rst index fc2f15fe235d..983ea9ae4c55 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 -----------------------------