From 9155b210bdcce7ccdd9f00ceeb69582eb93fe089 Mon Sep 17 00:00:00 2001
From: Andrei Nistor <andrei_nistor@smart-x.net>
Date: Tue, 26 Oct 2021 17:10:17 +0300
Subject: [PATCH] Add multicluster dashboards docs

---
 docs/multicluster-dashboards.md | 60 +++++++++++++++++++++++++++++++++
 1 file changed, 60 insertions(+)
 create mode 100644 docs/multicluster-dashboards.md

diff --git a/docs/multicluster-dashboards.md b/docs/multicluster-dashboards.md
new file mode 100644
index 0000000000..d05d3d26a7
--- /dev/null
+++ b/docs/multicluster-dashboards.md
@@ -0,0 +1,60 @@
+---
+weight: 660
+toc: true
+title: Multi-cluster dashboard support
+menu:
+    docs:
+        parent: kube
+lead: Enable multi-cluster dashboard support in grafana
+---
+
+#Prerequisites
+
+Let's say we have two clusters, `east` and `west`.
+
+Each prometheus cluster should have `externalLabels` configured:
+
+```jsonnet
+# east
+values+:: {
+  prometheus+: {
+    externalLabels: {
+      cluster: "east",
+    },
+  },
+}
+
+# west
+values+:: {
+  prometheus+: {
+    externalLabels: {
+      cluster: "west",
+    },
+  },
+}
+```
+
+# Enable multi cluster support
+
+At the time of writing, only kubernetes-mixin and node-mixin support this.
+
+```jsonnet
+values+:: {
+  nodeExporter+: {
+    mixin+: {
+      _config+: {
+        showMultiCluster: true,
+        # clusterLabel: '<cluster label, if different than the default "cluster">',
+      },
+    },
+  },  
+  kubernetesControlPlane+: {
+    mixin+: {
+      _config+: {
+        showMultiCluster: true,
+        # clusterLabel: '<cluster label, if different than the default "cluster">',
+      },
+    },
+  },
+}
+```