Skip to content

Commit d7c360a

Browse files
Merge pull request #247143 from bwren/patch-67
Update container-insights-enable-arc-enabled-clusters.md
2 parents 0a1265c + cd8885d commit d7c360a

File tree

1 file changed

+25
-1
lines changed

1 file changed

+25
-1
lines changed

articles/azure-monitor/containers/container-insights-enable-arc-enabled-clusters.md

Lines changed: 25 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Monitor Azure Arc-enabled Kubernetes clusters
3-
ms.date: 05/24/2022
3+
ms.date: 08/02/2023
44
ms.topic: article
55
description: Collect metrics and logs of Azure Arc-enabled Kubernetes clusters using Azure Monitor.
66
ms.reviewer: aul
@@ -108,6 +108,9 @@ This option uses the following defaults:
108108
- Creates or uses existing default log analytics workspace corresponding to the region of the cluster
109109
- Auto-upgrade is enabled for the Azure Monitor cluster extension
110110
111+
>[!NOTE]
112+
> Managed identity authentication is the default in k8s-extension version 1.43.0 or higher.
113+
111114
```azurecli
112115
az k8s-extension create --name azuremonitor-containers --cluster-name <cluster-name> --resource-group <resource-group> --cluster-type connectedClusters --extension-type Microsoft.AzureMonitor.Containers
113116
```
@@ -118,6 +121,24 @@ To use [managed identity authentication](container-insights-onboard.md#authentic
118121
az k8s-extension create --name azuremonitor-containers --cluster-name <cluster-name> --resource-group <resource-group> --cluster-type connectedClusters --extension-type Microsoft.AzureMonitor.Containers --configuration-settings amalogs.useAADAuth=true
119122
```
120123

124+
>[!NOTE]
125+
> Managed identity authentication is not supported for Arc-enabled Kubernetes clusters with **ARO**.
126+
>
127+
128+
To use legacy/non-managed identity authentication to create an extension instance on **Arc K8S connected clusters with ARO**, use the commands below that don't use managed identity. Non-cli onboarding is not supported for Arc-enabled Kubernetes clusters with **ARO**. Currently, only k8s-extension version 1.3.7 or below is supported.
129+
130+
If you are using k8s-extension version above 1.3.7, downgrade the version.
131+
132+
```azurecli
133+
Install the extension with **amalogs.useAADAuth=false**.
134+
az extension add --name k8s-extension --version 1.3.7
135+
```
136+
137+
Install the extension with **amalogs.useAADAuth=false**.
138+
139+
```azurecli
140+
az k8s-extension create --name azuremonitor-containers --cluster-name <cluster-name> --resource-group <resource-group> --cluster-type connectedClusters --extension-type Microsoft.AzureMonitor.Containers --configuration-settings amalogs.useAADAuth=false
141+
```
121142

122143
### Option 2 - With existing Azure Log Analytics workspace
123144

@@ -228,6 +249,9 @@ az k8s-extension show --name azuremonitor-containers --cluster-name <cluster-nam
228249
## Migrate to managed identity authentication
229250
Use the flowing guidance to migrate an existing extension instance to managed identity authentication.
230251

252+
>[!NOTE]
253+
> Managed identity authentication is not supported for Arc-enabled Kubernetes clusters with **ARO**.
254+
231255
## [CLI](#tab/migrate-cli)
232256
First retrieve the Log Analytics workspace configured for Container insights extension.
233257

0 commit comments

Comments
 (0)