Merge pull request #194888 from cebundy/observability2.1

revise alt-text for images

Author: v-regandowner

articles/container-apps/observability.md

@@ -5,7 +5,7 @@ services: container-apps
 author: cebundy
 ms.service: container-apps
 ms.topic: conceptual
-ms.date: 03/25/2022
+ms.date: 04/11/2022
 ms.author: v-bcatherine
 ---
 
@@ -25,7 +25,7 @@ These features include:
 
 ## Azure Monitor metrics
 
-The Azure Monitor metrics feature allows you to monitor your app's compute and network usage.  These metrics are available to view and analyze through the [metrics explorer in the Azure portal](/../azure-monitor/essentials/metrics-getting-started).  Metric data is also available through the [Azure CLI](/cli/azure/monitor/metrics), and Azure [PowerShell cmdlets](/powershell/module/az.monitor/get-azmetric).
+The Azure Monitor metrics feature allows you to monitor your app's compute and network usage.  These metrics are available to view and analyze through the [metrics explorer in the Azure portal](../azure-monitor/essentials/metrics-getting-started.md).  Metric data is also available through the [Azure CLI](/cli/azure/monitor/metrics), and Azure [PowerShell cmdlets](/powershell/module/az.monitor/get-azmetric).
 
 ### Available metrics for Container Apps
 
@@ -45,7 +45,7 @@ The metrics namespace is `microsoft.app/containerapps`.
 
 Using the Azure portal, navigate to your container apps **Overview** page.  The **Monitoring** section displays the current CPU, memory, and network utilization for your container app.
 
-:::image type="content" source="media/observability/metrics-in-overview-page.png" alt-text="Monitoring section in container app overview":::
+:::image type="content" source="media/observability/metrics-in-overview-page.png" alt-text="Screenshot of the Monitoring section in the container app overview page.":::
 
 From this view, you can pin one or more charts to your dashboard.  When you select a chart, it's opened in the metrics explorer.
 
@@ -57,19 +57,19 @@ The metrics page allows you to create and view charts to display your container
 
 When you first navigate to the metrics explorer, you'll see the main page.  From here, select the metric that you want to display.  You can add more metrics to the chart by selecting **Add Metric** in the upper left.
 
-:::image type="content" source="media/observability/metrics-main-page.png" alt-text="Metrics blade":::
+:::image type="content" source="media/observability/metrics-main-page.png" alt-text="Screenshot of the metrics explorer from the container app resource page.":::
 
 You can filter your metrics by revision or replica.  For example, to filter by a replica, select **Add filter**, then select a replica from the *Value* drop-down.   You can also filter by your container app's revision.
 
-:::image type="content" source="media/observability/metrics-add-filter.png" alt-text="Add a filter to chart":::
+:::image type="content" source="media/observability/metrics-add-filter.png" alt-text="Screenshot of the metrics explorer showing the chart filter options.":::
 
 You can split the information in your chart by revision or replica. For example, to split by revision, select **Applying splitting** and select **Revision** as the value. Splitting is only available when the chart contains a single metric.
 
-:::image type="content" source="media/observability/metrics-apply-splitting.png" alt-text="Apply spitting by revision to chart.":::
+:::image type="content" source="media/observability/metrics-apply-splitting.png" alt-text="Screenshot of the metrics explorer that shows a chart with metrics split by revision.":::
 
 You can view metrics across multiple container apps to view resource utilization over your entire application.
 
-:::image type="content" source="media/observability/metrics-across-apps.png" alt-text="Create chart showing metrics over multiple container apps":::
+:::image type="content" source="media/observability/metrics-across-apps.png" alt-text="Screenshot of the metrics explorer that shows a chart with metrics for multiple container apps.":::
 
 ## Azure Monitor Log Analytics
 
@@ -97,7 +97,7 @@ You can run Log Analytic queries via the Azure portal, the Azure CLI or PowerShe
 
 In the Azure portal, logs are available from either the **Monitor**->**Logs** page or by navigating to your container app and selecting the **Logs** menu item.  From Log Analytics interface, you can query the logs based on the **CustomLogs>ContainerAppConsoleLogs_CL** table.
 
-:::image type="content" source="media/observability/log-analytics-query-page.png" alt-text="Log Analytics query page":::
+:::image type="content" source="media/observability/log-analytics-query-page.png" alt-text="Screenshot of the Log Analytics query editor.":::
 
 Here's an example of a simple query, that displays log entries for the container app named *album-api*.  
 
@@ -124,37 +124,37 @@ For more information, see [Viewing Logs](monitor.md#viewing-logs).
 
 ## Azure Monitor alerts
 
-You can configure alerts to send notifications based on metrics values and Log Analytics queries.  Alerts can be added from the metrics explorer and the Log Analytics interface in the Azure portal. 
+You can configure alerts to send notifications based on metrics values and Log Analytics queries.  In the Azure portal, you can add alerts from the metrics explorer and the Log Analytics interface.
 
 In the metrics explorer and the Log Analytics interface, alerts are based on existing charts and queries.  You can manage your alerts from the **Monitor>Alerts** page.  From this page, you can create metric and log alerts without existing metric charts or log queries.  To learn more about alerts, refer to [Overview of alerts in Microsoft Azure](../azure-monitor/alerts/alerts-overview.md).
 
-### Setting alerts in metrics explorer
+### Setting alerts in the metrics explorer
 
 Metric alerts monitor metric data at set intervals and trigger when an alert rule condition is met.  For more information, see [Metric alerts](../azure-monitor/alerts/alerts-metric-overview.md).
 
-In metrics explorer, you can create metric alerts based on Container Apps metrics.  Once you create a metric chart, you're able to create alert rules based on the chart's settings. You can create an alert rule by selecting **New alert rule**.
+in the metrics explorer, you can create metric alerts based on Container Apps metrics.  Once you create a metric chart, you're able to create alert rules based on the chart's settings. You can create an alert rule by selecting **New alert rule**.
 
-:::image type="content" source="media/observability/metrics-alert-new-alert-rule.png" alt-text="Create a new metric alert.":::
+:::image type="content" source="media/observability/metrics-alert-new-alert-rule.png" alt-text="Screenshot of the metrics explorer highlighting the new rule button.":::
 
 When you create a new alert rule, the rule creation pane is opened to the **Condition** tab.  An alert condition is started for you based on the metric that you selected for the chart.  You then edit the condition to configure threshold and other settings.
 
-:::image type="content" source="media/observability/metrics-alert-create-condition.png" alt-text="Automatically created condition.":::
+:::image type="content" source="media/observability/metrics-alert-create-condition.png" alt-text="Screenshot of the metric explorer alert rule editor.  A condition is automatically created based on the chart settings.":::
 
 You can add more conditions to your alert rule by selecting the **Add condition** option in the **Create an alert rule** pane.
 
-:::image type="content" source="media/observability/metrics-alert-add-condition.png" alt-text="Add a condition to your alert rule.":::
+:::image type="content" source="media/observability/metrics-alert-add-condition.png" alt-text="Screenshot of the metric explorer alert rule editor highlighting the Add condition button.":::
 
 When you add an alert condition, the **Select a signal** pane is opened.  This pane lists the Container Apps metrics from which you can select for the condition.
 
-:::image type="content" source="media/observability/metrics-alert-select-a-signal.png" alt-text="Select a metric.":::
+:::image type="content" source="media/observability/metrics-alert-select-a-signal.png" alt-text="Screenshot of the metric explorer alert rule editor showing the Select a signal pane.":::
 
 After you've selected the metric, you can configure the settings for your alert condition.  For more information about configuring alerts, see [Manage metric alerts](../azure-monitor/alerts/alerts-metric.md).
 
 You can add alert splitting to the condition so you can receive individual alerts for specific revisions or replicas.
 
 Example of setting a dimension for a condition:
 
-:::image type="content" source="media/observability/metrics-alert-split-by-dimension.png" alt-text="Select split by replica":::
+:::image type="content" source="media/observability/metrics-alert-split-by-dimension.png" alt-text="Screenshot of the metrics explorer alert rule editor.  This example shows the Split by dimensions options in the Configure signal logic pane.":::
 
 Once you create the alert rule, it's a resource in your resource group.  To manage your alert rules, navigate to **Monitor>Alerts**. 
 
@@ -164,11 +164,11 @@ Once you create the alert rule, it's a resource in your resource group.  To mana
 
 You can use Log Analytics queries to periodically monitor logs and trigger alerts based on the results.  The Log Analytics interface allows you to add alert rules to your queries.  Once you have created and run a query, you're able to create an alert rule.
 
-:::image type="content" source="media/observability/log-alert-new-alert-rule.png" alt-text="Select new alert rule.":::
+:::image type="content" source="media/observability/log-alert-new-alert-rule.png" alt-text="Screenshot of the Log Analytics interface highlighting the new alert rule button.":::
 
 Selecting **New alert rule** opens the **Create an alert rule** editor, where you can configure the setting for your alerts.
 
-:::image type="content" source="media/observability/log-alerts-rule-editor.png" alt-text="Create an alert rule.":::
+:::image type="content" source="media/observability/log-alerts-rule-editor.png" alt-text="Screenshot of the Log Analytics alert rule editor.":::
 
 To learn more about creating a log alert, see [Manage log alerts](../azure-monitor/alerts/alerts-log.md)
 
@@ -179,7 +179,7 @@ Enabling splitting will send individual alerts for each dimension you define.  C
 - container
 - log message
 
-:::image type="content" source="media/observability/log-alerts-splitting.png" alt-text="Configure alert splitting":::
+:::image type="content" source="media/observability/log-alerts-splitting.png" alt-text="Screenshot of the Log Analytics alert rule editor showing the Split by dimensions options":::
 
 To learn more about log alerts, refer to [Log alerts in Azure Monitor](../azure-monitor/alerts/alerts-unified-log.md).
 
@@ -188,5 +188,6 @@ To learn more about log alerts, refer to [Log alerts in Azure Monitor](../azure-
 
 ## Next steps
 
-- [Health probes in Azure Container Apps](health-probes.md)
-- [Monitor an App in Azure Container Apps](monitor.md)
+> [!div class="nextstepaction"]
+> [Health probes in Azure Container Apps](health-probes.md)
+> [Monitor an App in Azure Container Apps](monitor.md)