add cache monitoring article

Author: ekpgh

articles/hpc-cache/hpc-cache-manage.md

@@ -4,7 +4,7 @@ description: How to manage and update Azure HPC Cache using the Azure portal or
 author: ekpgh
 ms.service: hpc-cache
 ms.topic: how-to
-ms.date: 06/28/2021
+ms.date: 07/08/2021
 ms.author: v-erkel
 ---
 
@@ -245,14 +245,6 @@ $
 
 ---
 
-## Cache metrics and monitoring
-
-The overview page shows graphs for some basic cache statistics - cache throughput, operations per second, and latency.
-
-![screenshot of three line graphs showing the statistics mentioned above for a sample cache](media/hpc-cache-overview-stats.png)
-
-These charts are part of Azure's built-in monitoring and analytics tools. Additional tools and alerts are available from the pages under the **Monitoring** heading in the portal sidebar. Learn more in the portal section of the [Azure Monitoring documentation](../azure-monitor/essentials/monitor-azure-resource.md#monitoring-in-the-azure-portal).
-
 ## View warnings
 
 If the cache goes into an unhealthy state, check the **Warnings** page. This page shows notifications from the cache software that might help you understand its state.
@@ -269,5 +261,5 @@ Kinds of warnings you might see here include:
 
 ## Next steps
 
-* Learn more about [Azure metrics and statistics tools](../azure-monitor/index.yml)
+* [Monitor the cache with statistics](metrics.md)
 * Get [help with your Azure HPC Cache](hpc-cache-support-ticket.md)

articles/hpc-cache/index.yml

@@ -39,8 +39,10 @@ landingContent:
             url: hpc-cache-add-storage.md
           - text: Mount clients
             url: hpc-cache-mount.md
-          - text: Manage and monitor the cache
+          - text: Manage the cache
             url: hpc-cache-manage.md
+          - text: View cache metrics
+            url: metrics.md
       - linkListType: concept
         links:
           - text: Plan the aggregated namespace

articles/hpc-cache/media/cache-report.png

@@ -0,0 +1,73 @@
+---
+title: Azure HPC Cache metrics and monitoring
+description: How to see statistics about your Azure HPC Cache
+author: ekpgh
+ms.service: hpc-cache
+ms.topic: how-to
+ms.date: 07/08/2021
+ms.author: v-erkel
+---
+
+# Cache metrics and monitoring
+
+The Azure Portal has several built-in visualizations that you can use to monitor the performance of your Azure HPC Cache.
+
+This article explains where to find the statistics visualizations, and what they show.
+
+There are four HPC Cache portal pages that show cache performance data:
+
+* **Overview**
+* **Metrics**
+* **Cache report**
+* **Client status**
+
+Open the **Metrics**, **Cache report**, and **Client status** pages from the **Monitoring** menu in the sidebar. The cache's **Overview** page is the top item on the sidebar menu.
+
+![screenshot of the Monitoring menu on the left of the Azure portal interface for HPC Cache.](media/monitoring-menu.png)
+
+## Overview page
+
+The cache's **Overview** page shows graphs for some basic cache statistics - cache throughput, operations per second, and latency. The graphs are at the bottom of the page, underneath the **Essentials** section.
+
+![screenshot of three line graphs showing the statistics mentioned above for a sample cache](media/hpc-cache-overview-stats.png)
+
+These charts are part of Azure's built-in monitoring and analytics tools. Learn more about these capabilities from the [Azure Monitoring documentation](../azure-monitor/essentials/monitor-azure-resource.md#monitoring-in-the-azure-portal).
+
+## Metrics page
+
+The HPC Cache **Metrics** page is another standard Azure feature. Follow the tips on the page to create your own charts and to learn more about the features.
+
+## Cache report
+
+The **Cache report** is a customized set of charts that show your cache's used space, free space, and cache recycle rate.
+
+By default, the page shows aggregated data for all of the cache's storage targets, but you can use the **Storage target** control to show the cache consumption data for one particular storage target instead. You also can customize the time range to show.
+
+![screenshot of the Cache report page.](media/cache-report.png)
+
+* **Cache used space** is the amount of space in your cache storage that's in use storing files that client machines have requested. If you selected a single storage target, it shows only the space used for files from that back-end storage system.
+
+* **Cache free space** is the available capacity remaining in cache storage.
+
+* **Cache recycle rate** represents the rate at which old files are being removed from the cache to make room for newly requested files. For a single storage target, this calculation only includes files stored on that target.
+
+## Client status
+
+The **Client status** page lists the client machines that are connected to your Azure HPC Cache.
+
+![screenshot of the Client status page.](media/client-status.png)
+
+You can customize the table with filters to show a specific client address or address range, a specific storage target, or an individual cache mount address.
+
+The connection types shown in the table have to do with the client connections to the storage target:
+
+* `azure_https_backend` is a secure client connection to a standard Azure Blob storage system.
+* `mount_backend` is an NFS connection to either a hardware NFS system or an NFS-enabled blob container.
+* `nfs_backend` is similar to the `mount_backend` connection, but represents a separate connection used by an NFS-internal remote procedure call instead of one initiated by the client mount operation.
+
+These values can be useful when debugging connection issues between clients and the HPC Cache.
+
+## Next steps
+
+* Learn more about [Azure metrics and statistics tools](../azure-monitor/index.yml)
+* [Manage the cache](hpc-cache-manage.md)

articles/hpc-cache/media/client-status.png

@@ -51,6 +51,8 @@ items:
     href: hpc-cache-mount.md
   - name: Manage the cache
     href: hpc-cache-manage.md
+  - name: Metrics and monitoring
+    href: metrics.md
   - name: Use optional settings
     items:
     - name: Configure optional settings