What is changing?
When customers enable Container Insights, Azure Monitor deploys a containerized collection agent. This agent is being renamed from OMSAgent to Azure Monitor Agent. There are no feature updates or functional changes to the agent in this release.
Why are the changes being made?
The current OMSAgent name is a legacy name from the OMS product and does not reflect the branding for Azure Monitor and Container Insights products. The Azure Monitor Agent is being standardized as the single collection agent for Azure Monitor. The name change brings the agent’s name in line with these updates.
When are the changes going live?
The changes will roll out region by region starting from early September. Exact dates and a version number of Container Insights image version with changes will be shared closer to the release date with an update to this blog post.
UPDATE: The changes were delayed and released on 26th October 2022 starting with the West Central US (WCUS) region. They should be all regions by the end of November.
Agent versions with the change
AKS customers will receive the changes as part of an AKS service update. Arc and Hybrid customers will have to update their extension and HELM chart versions manually. See detailed instructions below.
What are the exact changes?
The agent used by Container Insights has been renamed. So, customers will see a new pod name in their clusters. Alongside that, several other related resources have also been renamed. See the “List of renamed resources” and “List of renamed labels " tables below for complete details.
What is the impact? What do I need to do?
Log analytics queries
All log queries with string the omsagent in them will not work and results will only be returned for dates before the change. To mitigate, update the queries to have query clause to cover “omsagent” or “ama-logs” in existing queries. See examples below.
Original query |
Updated query |
KubePodInventory | where Namespace == "kube-system" | where Name contains "omsagent"
|
KubePodInventory | where Namespace == "kube-system" | where Name contains "omsagent" or Name contains “ama-logs”
|
Original query |
Updated query |
ContainerLog | where Name contains "omsagent"
|
ContainerLog |
Alert Rules
Alert Rules with the string the omsagent will not work.
You can find alert rules using
Option 1 – In the Alerts section of Azure Monitor in the Azure portal
Option 2 - Programmatically using Azure Resource Graph queries
Go to the “Azure Resource Graph Explorer” in the portal and run the below query:
alertsmanagementresources
| where properties contains "omsagent"
The above steps should help you find the affected rules. To update the rules, simply edit them in the portal (as below).
User scripts
Any user scripts explicitly referencing the pod names will not work.
Resource name in all UIs
Customers will see the updated controller names in the Container Insights UI as well as the command line.
Screenshot 1 – Container Insights Portal UI
Screenshot 2 – Command Line
Screenshot 3 – Workbooks
Instructions for consuming the update
Instructions for AKS customers
No action needed from customers. Customers will receive this as part of an AKS service update.
Instructions for Arc K8s customers
Note: The extension version with the above changes is version 3.0.0
az k8s-extension show --name azuremonitor-containers --cluster-name <cluster-name> --resource-group <resource-group> --cluster-type connectedClusters -n azuremonitor-containers
Instructions for Hybrid customers
Hybrid customers refers to customers running AKS Engine, Azure OpenShift, and other self-managed K8S distributions on Azure VMs.
Note: The Helm chart version with the above changes is version 3.0.0
helm get values <azure-monitor-for-containers-release-name> -A
List of renamed resources
Note: The xxxx below is a placeholder for random hash values appended to the resource name. In practice, a name like “ama-logs-xxxxx” will appear as “ama-logs-cfkst” or similar.
Resource Type |
Old name |
New name |
Configmap |
configmap/omsagent-rs-config |
configmap/ama-logs-rs-config |
Pod |
pod/omsagent-xxxxx |
pod/ama-logs-xxxxx |
Pod |
pod/omsagent-rs-xxxxxxxxxx- xxxxx |
pod/ama-logs-rs- xxxxxxxxxx-xxxxx |
Pod |
pod/omsagent-win-xxxxx |
pod/ama-logs-windows- xxxxx |
Secret |
secret/omsagent-secret |
secret/ama-logs-secret |
Secret |
secret/omsagent-token-xxxxx |
secret/ama-logs-token-xxxxx |
ServiceAccount |
serviceaccount/omsagent |
serviceaccount/ama-logs |
ControllerRevision |
controllerrevision.apps/omsagent-xxxxxxxxxx |
controllerrevision.apps/ama-logs-xxxxxxxxxx |
ControllerRevision |
controllerrevision.apps/omsagent-win-xxxxxxxxxx |
controllerrevision.apps/ama-logs-windows-xxxxxxxxxx |
Daemonset |
daemonset.apps/omsagent |
daemonset.apps/ama-logs |
Daemonset |
daemonset.apps/omsagent-win |
daemonset.apps/ama-logs-windows |
Deployment |
deployment.apps/omsagent-rs |
deployment.apps/ama-logs-rs |
Replicaset |
replicaset.apps/omsagent-rs-xxxxxxxxxx |
replicaset.apps/ama-logs-rs-xxxxxxxxxx |
List of renamed labels
component=oms-agent |
component=ama-logs-agent |
component=oms-agent-win |
component=ama-logs-agent-windows |
You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.