[new] Integrate mst and grafana (github#1482)

* mst grafana integration * fixed latest * incorporated the changes suggested by Lana * Update mst/grafana-mst.md Co-authored-by: Lana Brindley <github@lanabrindley.com> * Update mst/grafana-mst.md Co-authored-by: Charis <26616127+charislam@users.noreply.github.com> * Update mst/grafana-mst.md Co-authored-by: Charis <26616127+charislam@users.noreply.github.com> * Update mst/grafana-mst.md Co-authored-by: Charis <26616127+charislam@users.noreply.github.com> * Update mst/grafana-mst.md Co-authored-by: Charis <26616127+charislam@users.noreply.github.com> * Added intro para before the procedure Co-authored-by: Lana Brindley <github@lanabrindley.com> Co-authored-by: Charis <26616127+charislam@users.noreply.github.com>
jnidzwetzki · Aug 23, 2022 · 66e42a0 · 66e42a0
1 parent 71bee5c
commit 66e42a0
Show file tree

Hide file tree

Showing 2 changed files with 55 additions and 0 deletions.
diff --git a/mst/grafana-mst.md b/mst/grafana-mst.md
@@ -0,0 +1,51 @@
+---
+title: Integrate Managed Service for TimescaleDB as a data source in Grafana
+excerpt: Integrate Managed Service for TimescaleDB as a data source in Grafana to visualize your data
+keywords: [Grafana, visualizations, analytics]
+---
+
+# Integrate Managed Service for TimescaleDB and Grafana
+
+You can integrate Managed Service for TimescaleDB with Grafana to visualize your data.
+Grafana service in MST has built-in Prometheus, PostgreSQL, Jaeger, and other data source plugins
+that allow you to query and visualize data from a compatible database.
+
+## Before you begin
+
+*   Create a Managed Service for TimescaleDB [service][mst-install]
+*   Create a service for [Grafana in MST][grafana-install]
+
+## Configure Managed Service for TimescaleDB as a data source
+You can configure a TimescaleDB service as a data source to a Grafana service
+to query and visualize the data from the database. 
+<procedure>
+
+### Configuring Managed Service for TimescaleDB as a data source
+
+1.  In the [MST account][mst-login] `Services` view, click the Managed Service
+    for TimescaleDB service that you want to add as a data source for the Grafana
+    service.
+1.  In the `Overview` tab for the service go to the `Service Integrations` section.
+1.  Click the `Set up integration` button.
+1.  In the `Available service integrations for TimescaleDB` dialog, click
+    the `Use Integration` button for `Datasource`.
+1.  In the dialog that appears, choose the Grafana service in the drop-down menu,
+    and click the `Enable` button.
+1.  In the `Services` view, click the Grafana service to which you added the MST
+    service as a data source.
+1.  In the `Overview` tab for the Grafana service, make a note of the `User` and
+    `Password` fields.
+1.  In the `Overview` tab for the Grafana service, click the link in the
+   `Service URI` field to open Grafana.
+1.  Log in to Grafana with your service credentials.
+1.  Navigate to `Configuration` → `Data sources`. The data sources page lists
+    Managed Service for TimescaleDB as a configured data source for the Grafana instance.
+
+</procedure>
+
+When you have configured Managed Service for TimescaleDB as a data source in
+Grafana, you can create panels that are populated with data using SQL.
+
+[grafana-install]: /timescaledb/:currentVersion:/tutorials/grafana/installation/#create-a-new-service-for-grafana
+[mst-install]: /install/:currentVersion:/installation-mst/#create-your-first-service
+[mst-login]: https://portal.managed.timescale.com
diff --git a/mst/page-index/page-index.js b/mst/page-index/page-index.js
@@ -71,6 +71,10 @@ module.exports = [
         title: "Backups",
         href: "manage-backups",
       },
+      {
+        title: "Integrate Managed Service for TimescaleDB as a data source in Grafana",
+        href: "grafana-mst",
+      },
       {
         title: "Migrate your data to Managed Service for TimescaleDB",
         href: "migrate-to-mst",