Merge pull request #94284 from MicrosoftDocs/release-ignite-azmon-containerinsights

Ignite

Author: SyntaxC4

.openpublishing.redirection.json

@@ -43634,6 +43634,11 @@
       "source_path": "articles/active-directory/develop/msal-acquire-token-interactively.md",
       "redirect_url": "/azure/active-directory/develop/msal-acquire-cache-tokens",
       "redirect_document_id": true
+    },
+    {
+      "source_path": "articles/azure-monitor/insights/container-insights-live-logs.md",
+      "redirect_url": "/azure/azure-monitor/insights/container-insights-livedata-overview",
+      "redirect_document_id": false
     }
   ]
 }

articles/aks/TOC.yml

@@ -227,8 +227,8 @@
       href: view-master-logs.md
     - name: View the kubelet logs
       href: kubelet-logs.md
-    - name: View real-time container logs (preview)
-      href: ../azure-monitor/insights/container-insights-live-logs.md
+    - name: View container data real-time
+      href: ../azure-monitor/insights/container-insights-livedata-overview.md
       maintainContext: true
   - name: Use Windows Server containers (preview)
     items:

articles/azure-monitor/insights/container-insights-agent-config.md

@@ -1,23 +1,23 @@
 ---
-title: Monitor AKS cluster performance with Azure Monitor for containers | Microsoft Docs
+title: Monitor Kubernetes cluster performance with Azure Monitor for containers | Microsoft Docs
 description: This article describes how you can view and analyze the performance and log data with Azure Monitor for containers.
 ms.service:  azure-monitor
 ms.subservice: 
 ms.topic: conceptual
 author: mgoedtel
 ms.author: magoedte
-ms.date: 09/17/2019
-
+ms.date: 10/15/2019
 ---
 
-# Understand AKS cluster performance with Azure Monitor for containers
-With Azure Monitor for containers, you can use the performance charts and health status to monitor the workload of your Azure Kubernetes Service (AKS) clusters from two perspectives. You can monitor directly from an AKS cluster, or you can monitor all AKS clusters in a subscription from Azure Monitor. Viewing Azure Container Instances is also possible when you monitor a specific AKS cluster.
+# Understand Kubernetes cluster performance with Azure Monitor for containers
+
+With Azure Monitor for containers, you can use the performance charts and health status to monitor the workload of Kubernetes clusters hosted on Azure Kubernetes Service (AKS), Azure Stack, or other environment from two perspectives. You can monitor directly from the cluster, or you can view all clusters in a subscription from Azure Monitor. Viewing Azure Container Instances is also possible when monitoring a specific AKS cluster.
 
 This article helps you understand the two perspectives, and how Azure Monitor helps you quickly assess, investigate, and resolve detected issues.
 
 For information about how to enable Azure Monitor for containers, see [Onboard Azure Monitor for containers](container-insights-onboard.md).
 
-Azure Monitor provides a multi-cluster view that shows the health status of all monitored AKS clusters running Linux and Windows Server 2019 deployed across resource groups in your subscriptions. It shows AKS clusters discovered that aren't monitored by the solution. You can immediately understand cluster health, and from here, you can drill down to the node and controller performance page or navigate to see performance charts for the cluster. For AKS clusters that were discovered and identified as unmonitored, you can enable monitoring for them at any time. 
+Azure Monitor provides a multi-cluster view that shows the health status of all monitored Kubernetes clusters running Linux and Windows Server 2019 deployed across resource groups in your subscriptions. It shows clusters discovered across all environments that aren't monitored by the solution. You can immediately understand cluster health, and from here, you can drill down to the node and controller performance page or navigate to see performance charts for the cluster. For AKS clusters that were discovered and identified as unmonitored, you can enable monitoring for them at any time. 
 
 The main differences in monitoring a Windows Server cluster with Azure Monitor for containers compared to a Linux cluster are the following:
 
@@ -33,13 +33,24 @@ Sign in to the [Azure portal](https://portal.azure.com).
 
 ## Multi-cluster view from Azure Monitor
 
-To view the health status of all AKS clusters deployed, select **Monitor** from the left pane in the Azure portal. Under the **Insights** section, select **Containers**. 
+To view the health status of all Kubernetes clusters deployed, select **Monitor** from the left pane in the Azure portal. Under the **Insights** section, select **Containers**. 
 
 ![Azure Monitor multi-cluster dashboard example](./media/container-insights-analyze/azmon-containers-multiview.png)
 
+You can scope the results presented in the grid to show clusters that are:
+
+* **Azure** - AKS and AKS-Engine clusters hosted in Azure Kubernetes Service
+* **Azure Stack (Preview)** - AKS-Engine clusters hosted on Azure Stack
+* **Non-Azure (Preview)** - Kubernetes clusters hosted on-premises
+* **All** - View all the Kubernetes clusters hosted in Azure, Azure Stack, and on-premises environments that are onboarded to Azure Monitor for containers
+
+To view clusters from a specific environment, select it from the **Environments** pill on the top-left corner of the page.
+
+![Environment pill selector example](./media/container-insights-analyze/clusters-multiview-environment-pill.png)
+
 On the **Monitored clusters** tab, you learn the following:
 
-- How many clusters are in a Critical or unhealthy state, versus how many are Healthy or not reporting (referred to as an Unknown state).
+- How many clusters are in a critical or unhealthy state, versus how many are healthy or not reporting (referred to as an Unknown state).
 - Whether all of the [Azure Kubernetes Engine (AKS-engine)](https://github.com/Azure/aks-engine) deployments are healthy.
 - How many nodes and user and system pods are deployed per cluster.
 - How much disk space is available and if there's a capacity issue.
@@ -78,18 +89,21 @@ The following table provides a breakdown of the calculation that controls the he
 | |Critical |<60% |
 | |Unknown |If not reported in last 30 minutes |
 
-From the list of clusters, you can drill down to the **Cluster** page by selecting the name of the cluster. Then go to the **Nodes** performance page by selecting the rollup of nodes in the **Nodes** column for that specific cluster. Or, you can drill down to the **Controllers** performance page by selecting the rollup of the **User pods** or **System pods** column.  ​
+From the list of clusters, you can drill down to the **Cluster** page by selecting the name of the cluster. Then go to the **Nodes** performance page by selecting the rollup of nodes in the **Nodes** column for that specific cluster. Or, you can drill down to the **Controllers** performance page by selecting the rollup of the **User pods** or **System pods** column.
 
-## View performance directly from an AKS cluster
+## View performance directly from a cluster
 
-Access to Azure Monitor for containers is available directly from an AKS cluster by selecting **Insights** from the left pane. Information about your AKS cluster is organized into four perspectives:
+Access to Azure Monitor for containers is available directly from an AKS cluster by selecting **Insights** > **Cluster** from the left pane, or when you selected a cluster from the multi-cluster view. Information about your cluster is organized into four perspectives:
 
 - Cluster
 - Nodes 
 - Controllers 
 - Containers
 
-The default page opens when you select **Insights** > **Cluster**. Four line performance charts display key performance metrics of your cluster. 
+>[!NOTE]
+>The experience described in the remainder of this article are also applicable for viewing performance and health status of your Kubernetes clusters hosted on Azure Stack or other environment when selected from the multi-cluster view. 
+
+The default page opens and displays four line performance charts that show key performance metrics of your cluster. 
 
 ![Example performance charts on the Cluster tab](./media/container-insights-analyze/containers-cluster-perfview.png)
 
@@ -132,14 +146,10 @@ You can [split](../platform/metrics-charts.md#apply-splitting-to-a-chart) a metr
 
 When you switch to the **Nodes**, **Controllers**, and **Containers** tabs, a property pane automatically displays on the right side of the page. It shows the properties of the item selected, which includes the labels you defined to organize Kubernetes objects. When a Linux node is selected, the **Local Disk Capacity** section also shows the available disk space and the percentage used for each disk presented to the node. Select the **>>** link in the pane to view or hide the pane.
 
-![Example Kubernetes perspectives properties panes](./media/container-insights-analyze/perspectives-preview-pane-01.png)
-
-As you expand the objects in the hierarchy, the properties pane updates based on the object selected. From the pane, you also can view Kubernetes events with predefined log searches by selecting the **View Kubernetes event logs** link at the top of the pane. For more information about how to view Kubernetes log data, see [Search logs to analyze data](container-insights-log-search.md). While you review cluster resources, you can see container logs and events in real time. For more information about this feature and the configuration required to grant and control access, see [View logs in real time with Azure Monitor for containers](container-insights-live-logs.md). 
+As you expand the objects in the hierarchy, the properties pane updates based on the object selected. From the pane, you also can view Kubernetes container logs (stdout/stderror), events, and pod metrics by selecting the **View live data (preview)** link at the top of the pane. For more information about the configuration required to grant and control access to view this data, see [Setup the Live Data (preview)](container-insights-livedata-setup.md). While you review cluster resources, you can see this data from the container in real-time. For more information about this feature, see [How to view Kubernetes logs, events, and pod metrics in real time](container-insights-livedata-overview.md). To view Kubernetes log data stored in your workspace based on pre-defined log searches, select **View container logs** from the **View in analytics** drop-down list. For additional information about this topic, see [Search logs to analyze data](container-insights-log-search.md#search-logs-to-analyze-data).
 
 Use the **+ Add Filter** option at the top of the page to filter the results for the view by **Service**, **Node**, **Namespace**, or **Node Pool**. After you select the filter scope, select one of the values shown in the **Select value(s)** field. After the filter is configured, it's applied globally while viewing any perspective of the AKS cluster. The formula only supports the equal sign. You can add additional filters on top of the first one to further narrow your results. For example, if you specify a filter by **Node**, you can only select **Service** or **Namespace** for the second filter.
 
-![Example using the filter to narrow down results](./media/container-insights-analyze/add-filter-option-01.png)
-
 Specifying a filter in one tab continues to be applied when you select another. It's deleted after you select the **x** symbol next to the specified filter. 
 
 Switch to the **Nodes** tab and the row hierarchy follows the Kubernetes object model, which starts with a node in your cluster. Expand the node to view one or more pods running on the node. If more than one container is grouped to a pod, they're displayed as the last row in the hierarchy. You also can view how many non-pod-related workloads are running on the host if the host has processor or memory pressure.
@@ -303,4 +313,5 @@ You access these workbooks by selecting each one from the **View Workbooks** dro
 ## Next steps
 
 - Review [Create performance alerts with Azure Monitor for containers](container-insights-alerts.md) to learn how to create alerts for high CPU and memory utilization to support your DevOps or operational processes and procedures.
+
 - View [log query examples](container-insights-log-search.md#search-logs-to-analyze-data) to see predefined queries and examples to evaluate or customize to alert, visualize, or analyze your clusters.

articles/azure-monitor/insights/container-insights-analyze.md

@@ -43,7 +43,7 @@ provisioningState       : Succeeded
 
 If you would rather integrate with an existing workspace, perform the following steps to first identify the full resource ID of your Log Analytics workspace required for the `--workspace-resource-id` parameter, and then run the command to enable the monitoring add-on against the specified workspace.  
 
-1. List all the subscriptions which you have access using the following command:
+1. List all the subscriptions that you have access to using the following command:
 
     ```azurecli
     az account list --all -o table
@@ -367,4 +367,6 @@ After a few minutes, the command completes and returns JSON-formatted informatio
 
 * If you experience issues while attempting to onboard the solution, review the [troubleshooting guide](container-insights-troubleshoot.md)
 
-* With monitoring enabled to capture health metrics for both the AKS cluster nodes and pods, these health metrics are available in the Azure portal. To learn how to use Azure Monitor for containers, see [View Azure Kubernetes Service health](container-insights-analyze.md).
+* With monitoring enabled to collect health and resource utilization of your AKS cluster and workloads running on them, learn [how to use](container-insights-analyze.md) Azure Monitor for containers.
+
+

articles/azure-monitor/insights/container-insights-enable-existing-clusters.md

@@ -117,4 +117,4 @@ After a few minutes, the command completes and returns JSON-formatted informatio
 
 * If you experience issues while attempting to onboard the solution, review the [troubleshooting guide](container-insights-troubleshoot.md)
 
-* With monitoring enabled to capture health metrics for both the AKS cluster nodes and pods, these health metrics are available in the Azure portal. To learn how to use Azure Monitor for containers, see [View Azure Kubernetes Service health](container-insights-analyze.md).
+* With monitoring enabled to collect health and resource utilization of your AKS cluster and workloads running on them, learn [how to use](container-insights-analyze.md) Azure Monitor for containers.

articles/azure-monitor/insights/container-insights-enable-new-cluster.md

@@ -6,14 +6,17 @@ ms.subservice:
 ms.topic: conceptual
 author: mgoedtel
 ms.author: magoedte
-ms.date: 08/14/2019
-
+ms.date: 10/15/2019
 ---
 
 # Azure Monitor for containers Frequently Asked Questions
 
 This Microsoft FAQ is a list of commonly asked questions about Azure Monitor for containers. If you have any additional questions about the solution, go to the [discussion forum](https://feedback.azure.com/forums/34192--general-feedback) and post your questions. When a question is frequently asked, we add it to this article so that it can be found quickly and easily.
 
+## Can I view metrics collected in Grafana?
+
+Azure Monitor for containers supports viewing metrics stored in your Log Analytics workspace in Grafana dashboards. We have provided a template that you can download from Grafana's [dashboard repository](https://grafana.com/grafana/dashboards?dataSource=grafana-azure-monitor-datasource&category=docker) to get you started and  reference to help you learn how to query additional data from your monitored clusters to visualize in custom Grafana dashbaords. 
+
 ## Can I monitor my AKS-engine cluster with Azure Monitor for containers?
 
 Azure Monitor for containers supports monitoring container workloads deployed to AKS-engine (formerly known as ACS-engine) cluster(s) hosted on Azure. For further details and an overview of steps required to enable monitoring for this scenario, see [Using Azure Monitor for containers for AKS-engine](https://github.com/microsoft/OMS-docker/tree/aks-engine).
@@ -68,20 +71,15 @@ For a detailed look at the issue, review the following [GitHub link](https://git
 
 ## How do I resolve Azure AD errors when I enable live logs? 
 
-You may see the following error: **The reply url specified in the request does not match the reply urls configured for the application: '<application ID\>'**. The solution to solve it can be found in the article [How to view container logs real time with Azure Monitor for containers](container-insights-live-logs.md#configure-aks-with-azure-active-directory). 
+You may see the following error: **The reply url specified in the request does not match the reply urls configured for the application: '<application ID\>'**. The solution to solve it can be found in the article [How to view container data in real time with Azure Monitor for containers](container-insights-livedata-setup.md#configure-ad-integrated-authentication). 
 
 ## Why can't I upgrade cluster after onboarding?
 
 If after you enable Azure Monitor for containers for an AKS cluster, you delete the Log Analytics workspace the cluster was sending its data to, when attempting to upgrade the cluster it will fail. To work around this, you will have to disable monitoring and then re-enable it referencing a different valid workspace in your subscription. When you try to perform the cluster upgrade again, it should process and complete successfully.  
 
 ## Which ports and domains do I need to open/whitelist for the agent?
-- *.ods.opinsights.azure.com   443
-- *.oms.opinsights.azure.com   443
-- *.blob.core.windows.net      443
-- dc.services.visualstudio.com 443
-- *.microsoftonline.com        443
-- *.monitoring.azure.com       443
-- login.microsoftonline.com    443
+
+See the [Network firewall requirements](container-insights-onboard.md#network-firewall-requirements) for the proxy and firewall configuration information required for the containerized agent with Azure, Azure US Government, and Azure China clouds.
 
 ## Next steps