| title | description | services | documentationcenter | author | manager | editor | ms.assetid | ms.service | ms.devlang | ms.topic | ms.tgt_pltfrm | ms.workload | ms.date | ms.author |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
How to upgrade Azure Monitor for containers (Preview) agent | Microsoft Docs |
This article describes how you upgrade the Log Analytics agent used by Azure Monitor for containers. |
azure-monitor |
mgoedtel |
carmonm |
azure-monitor |
na |
conceptual |
na |
infrastructure-services |
11/13/2018 |
magoedte |
Azure Monitor for containers uses a containerized version of the Log Analytics agent for Linux. When a new version of the agent is released, the agent is not automatically upgraded on your managed Kubernetes clusters hosted on Azure Kubernetes Service (AKS).
This article describes the process for upgrading the agent.
The process to upgrade the agent consists of two straight forward steps. The first step is to disable monitoring with Azure Monitor for containers using Azure CLI. Follow the steps described in the Disable monitoring article. Using Azure CLI allows us to remove the agent from the nodes in the cluster without impacting the solution and the corresponding data that is stored in the workspace.
Note
While you are performing this maintenance activity, the nodes in the cluster are not forwarding collected data, and performance views will not show data between the time you remove the agent and install the new version.
To install the new version of the agent, follow the steps described in the Onboard monitoring article using Azure CLI, to complete this process.
After you've re-enabled monitoring, it might take about 15 minutes before you can view updated health metrics for the cluster.
If you experience issues while upgrading the agent, review the troubleshooting guide for support.