Merge pull request #233141 from guywi-ms/law-sli-slo

Update log-analytics-workspace-health.md

Author: v-dirichards

articles/azure-monitor/logs/log-analytics-workspace-health.md

@@ -12,7 +12,7 @@ ms.date: 02/07/2023
 
 # Monitor Log Analytics workspace health
 
-[Azure Service Health](../../service-health/overview.md) monitors the health of your cloud resources, including Log Analytics workspaces. When a Log Analytics workspace is healthy, data you collect from resources in your IT environment is available for querying and analysis in a relatively short period of time, known as [latency](../logs/data-ingestion-time.md). This article explains how to view the health status of your Log Analytics workspace and set up alerts to track Log Analytics workspace health status changes.  
+[Azure Service Health](../../service-health/overview.md) monitors the health of your cloud resources, including Log Analytics workspaces. When a Log Analytics workspace is healthy, data you collect from resources in your IT environment is available for querying and analysis in a relatively short period of time, known as [latency](../logs/data-ingestion-time.md). This article explains how to view the health status of your Log Analytics workspace, set up workspace health status alerts, and view workspace health metrics.  
 
 Azure Service Health monitors:
 
@@ -39,22 +39,41 @@ To view your Log Analytics workspace health and set up health status alerts:
 
 1. To set up health status alerts, you can either [enable recommended out-of-the-box alert](../alerts/alerts-overview.md#recommended-alert-rules) rules, or manually create new alert rules.
     - To enable the recommended alert rules:
-        1. select **Alerts**, then select **Enable recommended alert rules**. The **Enable recommended alert rules** pane opens with a list of recommended alert rules based on your type of resource.  
-        1. In the **Alert me if** section, select all of the rules you want to enable. The rules are populated with the default values for the rule condition, you can change the default values if you would like.
-        1. In the **Notify me by** section, select the way you want to be notified if an alert is fired.
+        1. Select **Alerts** > **Enable recommended alert rules**. 
+        
+            The **Enable recommended alert rules** pane opens with a list of recommended alert rules for your Log Analytics workspace.  
+        
+            :::image type="content" source="../alerts/media/alerts-managing-alert-instances/alerts-enable-recommended-alert-rule-pane.png" alt-text="Screenshot of recommended alert rules pane.":::
+
+        1. In the **Alert me if** section, select all of the rules you want to enable. 
+        1. In the **Notify me by** section, select the way you want to be notified if an alert is triggered.
         1. Select **Use an existing action group**, and enter the details of the existing action group if you want to use an action group that already exists.
         1. Select **Enable**.
 
-        :::image type="content" source="../alerts/media/alerts-managing-alert-instances/alerts-enable-recommended-alert-rule-pane.png" alt-text="Screenshot of recommended alert rules pane.":::
-
     - To create a new alert rule:
        1. Select **Add resource health alert**.
 
-            The **Create alert rule** wizard opens, with the **Scope** and **Condition** panes pre-populated. By default, the rule triggers alerts all status changes in all Log Analytics workspaces in the subscription. If necessary, you can edit and modify the scope and condition at this stage. 
+            The **Create alert rule** wizard opens, with the **Scope** and **Condition** panes prepopulated. By default, the rule triggers alerts all status changes in all Log Analytics workspaces in the subscription. If necessary, you can edit and modify the scope and condition at this stage. 
 
             :::image type="content" source="media/data-ingestion-time/log-analytics-workspace-latency-alert-rule.png" lightbox="media/data-ingestion-time/log-analytics-workspace-latency-alert-rule.png" alt-text="Screenshot that shows the Create alert rule wizard for Log Analytics workspace latency issues.":::
 
        1. Follow the rest of the steps in [Create a new alert rule in the Azure portal](../alerts/alerts-create-new-alert-rule.md#create-a-new-alert-rule-in-the-azure-portal). 
+
+## View Log Analytics workspace health metrics
+
+Azure Monitor exposes a set of metrics that provide insight into Log Analytics workspace health. 
+
+To view Log Analytics workspace health metrics:
+
+1. Select **Metrics** from the Log Analytics workspace menu. This opens [Metrics Explorer](../essentials/metrics-charts.md) in context of your Log Analytics workspace.
+1. In the **Metric** field, select one of the Log Analytics workspace health metrics:
+
+   | Metric name | Description |
+   | - | - |
+   | Query count | Total number of user queries in the Log Analytics workspace within the selected time range.<br>This number includes only user-initiated queries, and doesn't include queries initiated by Sentinel rules and alert-related queries. |
+   | Query failure count | Total number of failed user queries in the Log Analytics workspace within the selected time range.<br>This number includes all queries that return 5XX response codes - except 504 *Gateway Timeout* - which indicate an error related to the application gateway or the backend server.|
+   | Query success rate | Total number of successful user queries in the Log Analytics workspace within the selected time range.<br>This number includes all queries that return 2XX, 4XX, and 504 response codes; in other words, all user queries that don't result in a service error. |
+
 ## Investigate Log Analytics workspace health issues
 
 To investigate Log Analytics workspace health issues:
@@ -63,6 +82,9 @@ To investigate Log Analytics workspace health issues:
 - Query the data in your Log Analytics workspace to [understand which factors are contributing greater than expected latency in your workspace](../logs/data-ingestion-time.md).  
 - [Use the `_LogOperation` function to view and set up alerts about operational issues](../logs/monitor-workspace.md) logged in your Log Analytics workspace.
 
+      
+
+
 ## Next steps
 
 Learn more about: