Merge pull request #94019 from bwren/am-azure-resource

Monitor Azure resource

Author: GitHubber17

articles/azure-monitor/insights/monitor-azure-resource.md

@@ -58,12 +58,20 @@ Resources in Azure generate [logs](../platform/data-platform-logs.md) and [metri
 
 
 ## Configuration requirements
+
+### Configure monitoring
 Some monitoring data is collected automatically, but you may need to perform some configuration depending on your requirements. See the information below for specific information for each type of monitoring data.
 
 - [Platform metrics](../platform/data-platform-metrics.md) - Platform metrics are collected automatically into [Azure Monitor Metrics](../platform/data-platform-metrics.md) with no configuration required. Create a diagnostic setting to send entries to Azure Monitor Logs or to forward them outside of Azure.
 - [Resource logs](../platform/resource-logs-overview.md) - Resource logs are automatically generated by Azure resources but not collected without a diagnostic setting.  Create a diagnostic setting to send entries to Azure Monitor Logs or to forward them outside of Azure.
 - [Activity log](../platform/activity-logs-overview.md) - The Activity log is collected automatically with no configuration required and can be view in the Azure portal. Create a diagnostic setting to copy them to Azure Monitor Logs or to forward them outside of Azure.
 
+### Log Analytics workspace
+Collecting data into Azure Monitor Logs requires a Log Analytics workspace. You can start monitoring your service quickly by creating a new workspace, but there may be value in using a workspace that's collecting data from other services. See [Create a Log Analytics workspace in the Azure portal](../learn/quick-create-workspace.md) for details on creating a workspace and [Designing your Azure Monitor Logs deployment](../platform/design-logs-deployment.md) to help determine the best workspace design for your requirements. If you use an existing workspace in your organization, then you will require appropriate permissions as described in [Manage access to log data and workspaces in Azure Monitor](../platform/manage-access.md). 
+
+
+
+
 
 ## Diagnostic settings
 Diagnostic settings define where resource logs and metrics for a particular resource should be sent. Possible destinations are:
@@ -72,27 +80,34 @@ Diagnostic settings define where resource logs and metrics for a particular reso
 - [Event hubs](../platform/resource-logs-stream-event-hubs.md) to stream data to external systems such as third-party SIEMs and other log analytics solutions. 
 - [Azure storage account](../platform/resource-logs-collect-storage.md) which is useful for audit, static analysis, or backup.
 
-Follow the procedure in [Create diagnostic setting to collect platform logs and metrics in Azure](../platform/diagnostic-settings.md) to create and manage diagnostic settings through the Azure portal. See [Create diagnostic setting in Azure using a Resource Manager template](../platform/diagnostic-settings-template.md) to defined them in a template and enable complete monitoring for a resource when it's created.
+Follow the procedure in [Create diagnostic setting to collect platform logs and metrics in Azure](../platform/diagnostic-settings.md) to create and manage diagnostic settings through the Azure portal. See [Create diagnostic setting in Azure using a Resource Manager template](../platform/diagnostic-settings-template.md) to define them in a template and enable complete monitoring for a resource when it's created.
 
 
 ## Monitoring in the Azure portal
  You can access monitoring data for most Azure resources from the resource's menu in the Azure portal. This will give you access to a single resource's data using standard Azure Monitor tools. Some Azure services will provide different options, so you should reference the documentation for that service for additional information. Use the **Azure Monitor** menu to analyze data from all monitored resources. 
 
+### Overview
 Many services will include monitoring data on their **Overview** page as a quick glance to their operation. This will typically be based on a subset of platform metrics stored in Azure Monitor Metrics. Other monitoring options will typically be available in a **Monitoring** section of the services. menu.
 
 ![Overview page](media/monitor-azure-resource/overview-page.png)
 
-## Analyzing metrics
-Analyze individual metrics and correlate multiple metrics to identify correlations and trends using [metrics explorer](../platform/metrics-getting-started.md). Some services will provide a customized experience for working with its metrics when you open **Metrics** from the resource menu.
+
+### Insights and Solutions 
+Some services will provide tools beyond the standard features of Azure Monitor. [Insights](../insights/insights-overview.md) provide a customized monitoring experience built on the Azure Monitor data platform and standard features. [Solutions](../insights/solutions.md) provide predefined monitoring logic built on Azure Monitor Logs. 
+
+If a service has an Azure Monitor insight, you can access it from **Monitoring** in each resource's menu. Access all insights and solutions from the **Azure Monitor** menu.
+
+![Insights](media/monitor-azure-resource/insights.png)
+
+### Metrics
+Analyze metrics in the Azure portal using [metrics explorer](../platform/metrics-getting-started.md) which is available from the **Metrics** menu item for most services. This tool allows you to work with individual metrics or combine  multiple to identify correlations and trends. 
 
 - See [Getting started with Azure Metrics Explorer](../platform/metrics-getting-started.md) for the basics of using metrics explorer.
 - See [Advanced features of Azure Metrics Explorer](../platform/metrics-charts.md) for advanced features of metrics explorer such as using multiple metrics and applying filters and splitting.
 
 ![Metrics](media/monitor-azure-resource/metrics.png)
 
 
-## Analyzing logs
-
 ### Activity log 
 View entries in the activity log in the Azure portal with the initial filter set to the current resource. Copy the activity log to a Log Analytics workspace to access it to use it in log queries and workbooks. 
 
@@ -106,14 +121,26 @@ Azure Monitor Logs consolidates logs and metrics from multiple services and othe
 
 [Log Analytics](../log-query/get-started-portal.md) allows you to work with [log queries](../log-query/log-query-overview.md), which is a powerful feature of Azure Monitor that allows you to perform advanced analysis of log data using a fully featured query language. Open Log Analytics from **Logs** in the **Monitoring** menu for an Azure resource to work with log queries using the resource as the [query scope](../log-query/scope.md#query-scope). This lets you analyze data across multiple tables for just that resource. Use **Logs** from the Azure Monitor menu to access logs for all resources. 
 
-- See [Get started with Log Analytics in Azure Monitor](../log-query/get-started-portal.md) for a walkthrough of using Log Analytics to write a query and work with the results.
 - See [Get started with log queries in Azure Monitor](../log-query/get-started-queries.md) for a tutorial on using the query language used to write log queries.
 - See [Collect Azure resource logs in Log Analytics workspace in Azure Monitor](../platform/resource-logs-collect-workspace.md) for information on how resource logs are collected in Azure Monitor Logs and details for how to access them in a query.
 - See [Collection mode](../platform/resource-logs-collect-workspace.md#collection-mode) for an explanation of how resource log data is structured in Azure Monitor Logs.
 - See the documentation for each Azure service for details on its table in Azure Monitor Logs.
 
 ![Logs](media/monitor-azure-resource/logs.png)
 
+## Monitoring from command line
+You can access monitoring data collected from your resource from a command line or include in a script using [Azure PowerShell](/powershell/azure/) or [Azure Command Line Interface](/cli/azure/). 
+
+- See [CLI metrics reference](/cli/azure/monitor/metrics) for accessing metric data from CLI.
+- See [CLI Log Analytics reference](/cli/azure/ext/log-analytics/monitor/log-analytics) for accessing Azure Monitor Logs data using a log query from CLI.
+- See [Azure PowerShell metrics reference](/powershell/module/azurerm.insights/get-azurermmetric) for accessing metric data from Azure PowerShell.
+- See [Azure PowerShell log query reference](/powershell/module/az.operationalinsights/Invoke-AzOperationalInsightsQuery) for accessing Azure Monitor Logs data using a log query from Azure PowerShell.
+
+## Monitoring from REST API
+Include monitoring data collected from your resource in a custom application using a REST API.
+
+- See [Azure Monitoring REST API walkthrough](../platform/rest-api-walkthrough.md) for details on accessing metrics from the Azure Monitor REST API.
+- See [Azure Log Analytics REST API](https://dev.loganalytics.io/) for information on accessing Azure Monitor Logs data using a log query from Azure PowerShell.
 
 ## Alerts
 [Alerts](../platform/alerts-overview.md) proactively notify you and potentially take action when important conditions are found in your monitoring data. You create an alert rule that defines a target for the alert, the conditions for whether to create an alert, and any actions to take in response.
@@ -129,14 +156,7 @@ Use **Alerts** from a resource's menu to view alerts and manage alert rules for
 - See the articles for the different kinds of alerts above for details on creating alert rules.
 - See [Create and manage action groups in the Azure portal](../platform/action-groups.md) for details on creating an action group which allows you to manage responses to alerts.
 
-## Insights and Solutions 
-Some services will provide tools beyond the standard features of Azure Monitor. [Solutions](../insights/solutions.md) provide predefined monitoring logic built on standard Azure Monitor features. [Insights](../insights/insights-overview.md) provide a customized monitoring experience built on the Azure Monitor data platform and standard features.
-
-If a resource has an insight available, you can access it from **Insights** in the resource menu. Access all insights and solutions from the Azure Monitor menu.
 
-- See the monitoring documentation for each service to determine if there are insights or solutions available.
-
-![Insights](media/monitor-azure-resource/insights.png)
 
 ## Next steps