Loading...

Name update for Agent and associated resources in Azure Monitor - Container Insights

Name update for Agent and associated resources in Azure Monitor  - Container Insights

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 with AKS service update, expected to be these changes rolled out to all regions by the end of October. 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. 

AKS customers will receive the changes as part of an AKS service update. Arc and Hybrid customers will have to update the 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  
| where Name contains "omsagent" or Name contains "ama-logs"  
 

 

Alert Rules 

Alert Rules with the string the omsagent will not work.  

  1. Query alerts with the string “omsagent” 
  1. Metric alerts which reference omsagent in a dimension   

You can find alert rules using  

Option 1 – In the Alerts section of Azure Monitor in the Azure portal

iacairns_0-1658251096562.png

 

 

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).  

 

iacairns_1-1658251096572.png

 

 

 

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   

iacairns_2-1658251096578.png

 

 

iacairns_3-1658251096581.png

 

 

 

Screenshot 2 – Command Line 

iacairns_4-1658251096588.png

 

 

Screenshot 3 – Workbooks    

iacairns_5-1658251096591.png

 

 

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 

  1. Get the Azure Log Analytics Workspace Resource Id which configured on the existing Azure Monitor for containers extension  

az k8s-extension show --name azuremonitor-containers --cluster-name <cluster-name> --resource-group <resource-group> --cluster-type connectedClusters -n azuremonitor-containers 

 

  1. Delete the existing Azure Monitor for Containers extension either through Azure Portal or Azure CLI 
  1. Create Azure Monitor for containers extension either through Azure Portal or Azure CLI. Make sure to use the same Azure Log Analytics Workspace ResourceId which is obtained in Step #1, to ensure the data being ingested to the same Log analytics workspace as before  

 

Instructions for Hybrid customers  

Note: The Helm chart version with the above changes is version 3.0.0 

  1. Get the Azure Log Analytics workspace which is being used for the Azure Monitor for containers HELM chart.  You can obtain through   

helm get values <azure-monitor-for-containers-release-name> -A 

  1. Delete the Azure Monitor for containers HELM chart - https://docs.microsoft.com/en-us/azure/azure-monitor/containers/container-insights-optout-hybrid#how-to-stop-monitoring-using-helm 
  1. Install the HELM chart as per the Instructions -  https://docs.microsoft.com/en-us/azure/azure-monitor/containers/container-insights-hybrid-setup#install-the-helm-chart . Make sure to same Azure Log Analytics Workspace to ensure the data being ingested to the same Log Analytics workspace as before. 

 

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 

 

 

Published on:

Learn more
Azure Monitor Status articles
Azure Monitor Status articles

Azure Monitor Status articles

Share post:

Related posts

Recovery options for Azure Virtual Desktop session host VMs

Last week an update issue caused unresponsiveness and startup failures on Windows machines using the CrowdStrike Falcon agent, including some ...

2 hours ago

Tailor your Reference Layers in Azure Maps Visual for Power BI

  We’re excited to share the latest enhancements to the Azure Maps visual in Power BI, designed to make your data visualization even mor...

7 hours ago

Azure Lab Services - Upcoming maintenance update on 08/24

Hi, We will be doing an update to the service on Saturday, August 24 starting at 12:30 pm PDT and ending at 11:59 pm PDT. The service is not g...

9 hours ago

Generally Available: Transition to WS2012 / R2 ESUs enabled by Azure Arc from Volume Licensing

Customers that have enrolled in WS2012/ R2 ESUs through Volume Licensing for Year 1 can transition to Azure Arc for Year 2 of the program. Ext...

18 hours ago

Soft delete for NFS Azure file shares is now Generally Available.

Soft delete protects your Azure file shares from accidental deletion. The following feature was already made available for SMB File share...

22 hours ago

Announcing v7.0 Support on vCore-based Azure Cosmos DB for MongoDB

    We are thrilled to announce that vCore-based Azure Cosmos DB for MongoDB now officially supports version 7.0. This addition expa...

1 day ago

Skyrocket Your Efficiency: Dive into Azure Cloud-Native solutions

This blog invites you to explore the power of cloud-native solutions, which can transform the way businesses operate and innovate. As part of ...

1 day ago

[Mitigated] Azure Lab Services - Maintenance update outage

Hi, We are experiencing a service outage due to ongoing maintenance since around July 21st, 4 pm PDT. The service is currently not available i...

3 days ago

Azure Lab Services - Maintenance update outage

Hi, We are experiencing a service outage due to ongoing maintenance since around July 21st, 4 pm PDT. The service is currently not available i...

3 days ago

Dataverse: Create Custom Integration To Azure Cosmos DB for PostgreSQL

In a world where integration is common to do. Especially, because clouds is a common term, for sure, there are requests to integrate Dataverse...

4 days ago
Stay up to date with latest Microsoft Dynamics 365 and Power Platform news!
* Yes, I agree to the privacy policy