Skip to content

Commit ae8a2e1

Browse files
committed
Update azure-monitor-agent-migration.md
1 parent 2f0881a commit ae8a2e1

File tree

1 file changed

+9
-13
lines changed

1 file changed

+9
-13
lines changed

articles/azure-monitor/agents/azure-monitor-agent-migration.md

Lines changed: 9 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -32,13 +32,11 @@ Azure Monitor Agent provides the following benefits over legacy agents:
3232
- Greater transparency and control of more capabilities and services, such as Sentinel, Defender for Cloud, and VM Insights.
3333
- **A single agent** that consolidates all features necessary to address all telemetry data collection needs across servers and client devices (running Windows 10, 11). This is the goal, though Azure Monitor Agent currently converges with the Log Analytics agents.
3434

35-
## Migrate plan considerations
35+
## Migration plan considerations
3636

3737
Your migration plan to the Azure Monitor Agent should take into account:
3838

39-
- **Environment requirements:** Azure Monitor Agent supports [these operating systems](./agents-overview.md#supported-operating-systems) today. Support for future operating system versions, environment support, and networking requirements will only be provided for Azure Monitor Agent.
40-
41-
- **Current and new feature requirements:** Most new capabilities in Azure Monitor will be made available only with Azure Monitor Agent. Review [Azure Monitor Agent's supported services and features](agents-overview.md#supported-services-and-features) to ensure that Azure Monitor Agent has the features you require. If you currently use unsupported features you can temporarily do without, consider migrating to benefit from other important features in the new agent.
39+
- **Current and new feature requirements:** Most new capabilities in Azure Monitor will be made available only with Azure Monitor Agent. Review [Azure Monitor Agent's supported services and features](agents-overview.md#supported-services-and-features) to ensure that Azure Monitor Agent has the features you require. If you currently use unsupported features you can temporarily do without, consider migrating to benefit from other important features in the new agent. Use the [migration helper tool]() to discover what solutions and features you're using the legacy agent for.
4240

4341
If you use Microsoft Sentinel, see [Gap analysis for Microsoft Sentinel](../../sentinel/ama-migrate.md#gap-analysis-between-agents) for a comparison of the extra data collected by Microsoft Sentinel.
4442

@@ -54,21 +52,19 @@ To ensure safe deployment during migration, begin testing with few resources run
5452
See [create new data collection rules](./data-collection-rule-azure-monitor-agent.md#create-data-collection-rule-and-association) to start collecting some of the existing data types. After you validate that data is flowing as expected with Azure Monitor Agent, check the `Category` column in the [Heartbeat](/azure/azure-monitor/reference/tables/heartbeat) table for the value *Azure Monitor Agent* for AMA collected data. Ensure it matches data flowing through the existing Log Analytics agent.
5553

5654
## At-scale migration using Azure Policy
57-
[Azure Policy](../../governance/policy/overview.md) and [Resource Manager templates](../resource-manager-samples.md) provide scalability to migrate a large number of agents.
58-
Start by analyzing your current monitoring setup with the Log Analytics agent using the following criteria:
59-
60-
- Sources, such as virtual machines, virtual machine scale sets, and on-premises servers.
61-
- Data sources, such as performance counters, Windows event logs, and Syslog.
62-
- Destinations, such as Log Analytics workspaces.
55+
We recommend using [Azure Policy](../../governance/policy/overview.md) to migrate a large number of agents.
56+
Start by analyzing your current monitoring setup with the Log Analytics agent using the [migration helper tool]() to find sources, such as virtual machines, virtual machine scale sets, and on-premises servers.
57+
Use the [DCR generator] to migrate legacy agent configuration, including data sources and destinations from the workspace to the new DCRs.
6358

6459
> [!IMPORTANT]
6560
> Before you deploy to a large number of agents, consider [configuring the workspace](agent-data-sources.md) to disable data collection for the Log Analytics agent. If you leave data collection for the Log Analytics agent enabled, you may collect duplicate data and increase your costs. You might choose to collect duplicate data for a short period during migration until you verify that you've deployed and configured Azure Monitor Agent correctly.
6661
67-
See [Using Azure Policy](azure-monitor-agent-manage.md#using-azure-policy) for details on deploying Azure Monitor Agent across a set of virtual machines. Associate the agents to the data collection rules developed during your [testing](#test-migration).
68-
6962
Validate that Azure Monitor Agent is collecting data as expected and all downstream dependencies, such as dashboards, alerts, and workbooks, function properly.
7063

71-
After you confirm that Azure Monitor Agent is collecting data properly, [uninstall the Log Analytics agent](./agent-manage.md#uninstall-agent) from monitored resources. Don't uninstall the legacy agent if you need to use it for System Center Operations Manager scenarios or others solutions not yet available on Azure Monitor Agent. Clean up any configuration files, workspace keys, or certificates that were used previously by the Log Analytics agent.
64+
After you confirm that Azure Monitor Agent is collecting data properly, [uninstall the Log Analytics agent](./agent-manage.md#uninstall-agent) from monitored resources. Clean up any configuration files, workspace keys, or certificates that were used previously by the Log Analytics agent.
65+
66+
> [!IMPORTANT]
67+
> Don't uninstall the legacy agent if you need to use it for System Center Operations Manager scenarios or others solutions not yet available on Azure Monitor Agent.
7268
7369
## Next steps
7470

0 commit comments

Comments
 (0)