Add top-level Visualize data TOC section. (#5292)

* Create top-level Visualize data TOC section. * Clarify built-in support for Mimir via Prometheus * Incorporate SME feedback; reweight TOC sections. * Provide guidance about how to derive URL. * Specify inside vs. outside default URLs --------- Co-authored-by: Charles Korn <[email protected]> Co-authored-by: J Stickler <[email protected]> Co-authored-by: George Krajcsovits <[email protected]>
grafana · Jun 22, 2023 · 0bb0050 · 0bb0050
1 parent 1e1f646
commit 0bb0050
Show file tree

Hide file tree

Showing 2 changed files with 43 additions and 1 deletion.
diff --git a/docs/sources/mimir/tutorials/_index.md b/docs/sources/mimir/tutorials/_index.md
@@ -2,7 +2,7 @@
 description: Grafana Mimir tutorials
 menuTitle: Tutorials
 title: Tutorials
-weight: 40
+weight: 50
 ---
 
 # Tutorials

diff --git a/docs/sources/mimir/visualize/grafana.md b/docs/sources/mimir/visualize/grafana.md
@@ -0,0 +1,42 @@
+---
+description: Visualize your metric data with Grafana
+title: Visualize metric data
+menuTitle: Visualize data
+weight: 45
+keywords:
+  - visualize
+  - grafana
+  - dashboards
+---
+
+# Visualize metric data
+
+[Grafana](/grafana/download/) has built-in support for Mimir through the Prometheus data source type.
+
+## Before you begin
+
+1. Log in to your Grafana instance.
+   If this is your first time running Grafana,
+   the username and password are both `admin`.
+1. From within Grafana, go to `Connections` > `Add new connection`.
+1. Search for Prometheus, and select **Create a Prometheus data source**.
+1. In the **HTTP** > **Prometheus server URL** field, enter a server URL:
+
+   - If you deployed Mimir via the `mimir-distributed` Helm chart,
+     the default URL inside the Kubernetes cluster is `http://<HELM-RELEASE>-nginx.<MIMIR-NAMESPACE>.svc/prometheus`,
+     and `http://<INGRESS-HOST>/prometheus` from the outside, provided that you set up an ingress.
+
+   - If you are running microservices, point to the proxy in front of Mimir
+     (such as Nginx or the GEM gateway) rather than to one component of Mimir.
+
+## Steps
+
+1. To view metrics in Grafana, select **Explore**.
+1. From the top-left, select the newly created data source.
+1. Select a metric, apply (optional) label filters, and select **Run query**.
+1. Learn more about PromQL and querying by reading [Querying Prometheus](https://prometheus.io/docs/prometheus/latest/querying/basics/).
+
+## See also
+
+- Read more about Grafana's [Explore](http://docs.grafana.org/features/explore) feature.
+- Read about Grafana’s built-in support for the [Prometheus data source](/docs/grafana/latest/datasources/prometheus/).