From bccb18e0aee2c3cba0c2ba0f48730cd54131df4e Mon Sep 17 00:00:00 2001
From: Lana Brindley <github@lanabrindley.com>
Date: Fri, 28 Jan 2022 13:43:40 +1000
Subject: [PATCH] Cloud ops lana (#735)

* Draft metrics page

* Add new page to index

* remove passive voice

* passive be gone

* Update screenshots, add note about gray bars

* en-US spelling of 'gray'

Co-authored-by: Charis <26616127+charislam@users.noreply.github.com>
---
 cloud/metrics.md               | 25 +++++++++++++++++++++++++
 cloud/page-index/page-index.js |  4 ++++
 2 files changed, 29 insertions(+)
 create mode 100644 cloud/metrics.md

diff --git a/cloud/metrics.md b/cloud/metrics.md
new file mode 100644
index 000000000000..ef5d74205c3f
--- /dev/null
+++ b/cloud/metrics.md
@@ -0,0 +1,25 @@
+# Metrics
+Timescale Cloud provides a Metrics dashboard for managing your services. You can
+see the Metrics dashboard in your Timescale Cloud account by navigating to the
+`Services` section, clicking the service you want to explore, and selecting the
+`Metrics` tab.
+
+You can view metrics for your services for any of these time ranges:
+*   Last hour, with one minute granularity
+*   Last 24 hours, with one minute granularity
+*   Last seven days, with one hour granularity
+*   Last thirty days, with one hour granularity
+
+To change the view, select the time range from the drop down menu.
+
+<img class="main-content__illustration" src="https://s3.amazonaws.com/assets.timescale.com/docs/images/tsc-metrics_lastmonth.png" alt="Timescale Cloud Metrics dashboard"/>
+
+Additionally, you can turn automatic metric refreshes on and off. When automatic
+metric refresh is on, the dashboard updates every thirty seconds.
+
+In some cases, gray vertical bars display on the metrics dashboard, like this:
+
+<img class="main-content__illustration" src="https://s3.amazonaws.com/assets.timescale.com/docs/images/tsc-metrics_graybar.png" alt="Timescale Cloud Metrics not collected"/>
+
+This indicates that metrics have not been collected for the period shown. It
+does not mean that your Timescale Cloud service was down.
diff --git a/cloud/page-index/page-index.js b/cloud/page-index/page-index.js
index 8e11d71800dd..4fdd15188980 100644
--- a/cloud/page-index/page-index.js
+++ b/cloud/page-index/page-index.js
@@ -34,6 +34,10 @@ module.exports = [
         title: "Operations",
         href: "operations"
       },
+      {
+        title: "Metrics",
+        href: "metrics"
+      },
       {
         title: "Maintenance",
         href: "maintenance"