Skip to content

Commit 14fe30c

Browse files
authored
Merge pull request #102106 from MGoedtel/CILinkFix123
updated k8s agent manage article
2 parents aa1f9d5 + 408ff61 commit 14fe30c

File tree

2 files changed

+29
-6
lines changed

2 files changed

+29
-6
lines changed

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ For information about how to enable Azure Monitor for containers, see [Onboard A
1818
>[!NOTE]
1919
>To support AKS Engine clusters, verify it meets the following:
2020
>- It is using the latest version of the [HELM client](https://helm.sh/docs/using_helm/).
21-
>- The containerized agent version is *microsoft/oms:ciprod11012019*. To upgrade the agent, see [upgrading agent on Kubernetes cluster](container-insights-manage-agent.md#upgrading-agent-on-monitored-kubernetes-cluster).
21+
>- The containerized agent version is *microsoft/oms:ciprod11012019*. To upgrade the agent, see [upgrading agent on Kubernetes cluster](container-insights-manage-agent.md#upgrade-agent-on-monitored-kubernetes-cluster).
2222
>
2323
2424
## Overview

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

Lines changed: 28 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: How to manage the Azure Monitor for containers agent | Microsoft Docs
33
description: This article describes managing the most common maintenance tasks with the containerized Log Analytics agent used by Azure Monitor for containers.
44
ms.topic: conceptual
5-
ms.date: 01/13/2020
5+
ms.date: 01/24/2020
66

77
---
88

@@ -12,13 +12,13 @@ Azure Monitor for containers uses a containerized version of the Log Analytics a
1212

1313
## How to upgrade the Azure Monitor for containers agent
1414

15-
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 automatically upgraded on your managed Kubernetes clusters hosted on Azure Kubernetes Service (AKS).
15+
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 automatically upgraded on your managed Kubernetes clusters hosted on Azure Kubernetes Service (AKS) and Azure Red Hat OpenShift. For a [hybrid Kubernetes cluster](container-insights-hybrid-setup.md) the agent is not managed, and you need to manually upgrade the agent.
1616

17-
If the agent upgrade fails, this article describes the process to manually upgrade the agent. To follow the versions released, see [agent release announcements](https://github.com/microsoft/docker-provider/tree/ci_feature_prod).
17+
If the agent upgrade fails for a cluster hosted on AKS, this article also describes the process to manually upgrade the agent. To follow the versions released, see [agent release announcements](https://github.com/microsoft/docker-provider/tree/ci_feature_prod).
1818

19-
### Upgrading agent on monitored Kubernetes cluster
19+
### Upgrade agent on monitored Kubernetes cluster
2020

21-
The process to upgrade the agent on clusters, other than Azure Red Hat OpenShift, 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](container-insights-optout.md?#azure-cli) 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.
21+
The process to upgrade the agent on clusters, other than Azure Red Hat OpenShift, 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](container-insights-optout.md?#azure-cli) 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.
2222

2323
>[!NOTE]
2424
>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.
@@ -49,6 +49,29 @@ The status should resemble the following example, where the value for *omi* and
4949
omsagent 1.6.0-163
5050
docker-cimprov 1.0.0.31
5151

52+
## Upgrade agent on hybrid Kubernetes cluster
53+
54+
The process to upgrade the agent on a Kubernetes cluster hosted on-premises, AKS Engine on Azure and Azure Stack can be completed by running the following command:
55+
56+
```
57+
$ helm upgrade --name myrelease-1 \
58+
--set omsagent.secret.wsid=<your_workspace_id>,omsagent.secret.key=<your_workspace_key>,omsagent.env.clusterName=<my_prod_cluster> incubator/azuremonitor-containers
59+
```
60+
61+
If the Log Analytics workspace is in Azure China, run the following command:
62+
63+
```
64+
$ helm upgrade --name myrelease-1 \
65+
--set omsagent.domain=opinsights.azure.cn,omsagent.secret.wsid=<your_workspace_id>,omsagent.secret.key=<your_workspace_key>,omsagent.env.clusterName=<your_cluster_name> incubator/azuremonitor-containers
66+
```
67+
68+
If the Log Analytics workspace is in Azure US Government, run the following command:
69+
70+
```
71+
$ helm upgrade --name myrelease-1 \
72+
--set omsagent.domain=opinsights.azure.us,omsagent.secret.wsid=<your_workspace_id>,omsagent.secret.key=<your_workspace_key>,omsagent.env.clusterName=<your_cluster_name> incubator/azuremonitor-containers
73+
```
74+
5275
## How to disable environment variable collection on a container
5376

5477
Azure Monitor for containers collects environmental variables from the containers running in a pod and presents them in the property pane of the selected container in the **Containers** view. You can control this behavior by disabling collection for a specific container either during deployment of the Kubernetes cluster, or after by setting the environment variable *AZMON_COLLECT_ENV*. This feature is available from the agent version – ciprod11292018 and higher.

0 commit comments

Comments
 (0)