Skip to content

Commit 7e35dd3

Browse files
committedFeb 9, 2022
fixes from batami
1 parent db0c936 commit 7e35dd3

File tree

3 files changed

+72
-9
lines changed

3 files changed

+72
-9
lines changed
 

‎articles/azure-monitor/faq.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -268,7 +268,9 @@ sections:
268268
Why should I use the AMA or migrate from Log Analytics agent (MMA) to AMA?
269269
answer: |
270270
The AMA replaces the [Log Analytics agent](/azure/azure-monitor/agents/log-analytics-agent), the [Azure Diagnostics extension](/azure/azure-monitor/agents/diagnostics-extension-overview), and the [Telegraf Agent](/azure/azure-monitor/essentials/collect-custom-metrics-linux-telegraf). The AMA offers a higher rate of EPS with a lower footprint, providing enhanced filtering features, scalable deployment management and configuration using DCRs and Azure policies.
271+
271272
While the AMA has not yet reached full parity with the MMA, we continue to add features and support and the MMA will be retired on August 31, 2024.
273+
272274
For more information, see the [Azure Monitor Agent overview](/azure/azure-monitor/agents/azure-monitor-agent-overview).
273275
274276

‎articles/sentinel/ama-migrate.md

Lines changed: 70 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -3,24 +3,62 @@ title: Migrate to the Azure Monitor agent (AMA) from the Log Analytics agent (MM
33
description: Learn about migrating from the Log Analytics agent (MMA/OMS) to the Azure Monitor agent (AMA), when working with Microsoft Sentinel.
44
author: batamig
55
ms.topic: reference
6-
ms.date: 12/28/2021
6+
ms.date: 02/09/2022
77
ms.author: bagol
88
---
99

1010
# AMA migration for Microsoft Sentinel
11-
This article describes the migration process to the Azure Monitor Agent (AMA) when you have an existing Log Analytics Agent (MMA/OMS), and are working with Microsoft Sentinel. Start with the [Azure Monitor documentation](/azure/azure-monitor/agents/azure-monitor-agent-migration) which provides an agent comparison and general information for this migration process. This article provides specific details and differences for Microsoft Sentinel.
11+
This article describes the migration process to the Azure Monitor Agent (AMA) when you have an existing Log Analytics Agent (MMA/OMS), and are working with Microsoft Sentinel.
1212

1313
> [!IMPORTANT]
1414
> The Log Analytics agent will be [retired on **31 August, 2024**](https://azure.microsoft.com/updates/were-retiring-the-log-analytics-agent-in-azure-monitor-on-31-august-2024/). If you are using the Log Analytics agent in your Microsoft Sentinel deployment, we recommend that you start planning your migration to the AMA.
15-
>
15+
16+
## Prerequisites
17+
Start with the [Azure Monitor documentation](/azure/azure-monitor/agents/azure-monitor-agent-migration) which provides an agent comparison and general information for this migration process.
18+
19+
This article provides specific details and differences for Microsoft Sentinel.
20+
21+
22+
## Gap analysis between agents
23+
The following tables show gap analyses for the log types that currently rely on agent-based data collection for Microsoft Sentinel. This will be updated as support for AMA grows towards parity with the Log Analytics agent.
24+
25+
### Windows logs
26+
27+
|Log type / Support |Azure Monitor agent support |Log Analytics agent support |
28+
|---------|---------|---------|
29+
|**Security Events** | [Windows Security Events data connector](../../sentinel/data-connectors-reference.md#windows-security-events-via-ama) (Public preview) | [Windows Security Events data connector (Legacy)](../../sentinel/data-connectors-reference.md#security-events-via-legacy-agent-windows) |
30+
|**Filtering by security event ID** | [Windows Security Events data connector (AMA)](../../sentinel/data-connectors-reference.md#windows-security-events-via-ama) (Public preview) | - |
31+
|**Filtering by event ID** | Collection only | - |
32+
|**Windows Event Forwarding** | [Windows Forwarded Events](../../sentinel/data-connectors-reference.md#windows-forwarded-events-preview) (Public Preview) | - |
33+
|**Windows Firewall Logs** | - | [Windows Firewall data connector](../../sentinel/data-connectors-reference.md#windows-firewall) |
34+
|**Performance counters** | Collection only | Collection only |
35+
|**Windows Event Logs** | Collection only | Collection only |
36+
|**Custom logs** | - | Collection only |
37+
|**IIS logs** | - | Collection only |
38+
|**Multi-homing** | Collection only | Collection only |
39+
|**Application and service logs** | - | Collection only |
40+
|**Sysmon** | Collection only | Collection only |
41+
|**DNS logs** | - | Collection only |
42+
| | | |
43+
44+
### Linux logs
45+
46+
|Log type / Support |Azure Monitor agent support |Log Analytics agent support |
47+
|---------|---------|---------|
48+
|**Syslog** | [Local Collection only Only](#capacity-planning) | [Syslog data connector](../../sentinel/connect-syslog.md) |
49+
|**Common Event Format (CEF)** | Collection only | [CEF data connector](../../sentinel/connect-common-event-format.md) |
50+
|**Sysmon** | Collection only | Collection only |
51+
|**Custom logs** | - | Collection only |
52+
|**Multi-homing** | Collection only | - |
53+
| | | |
1654

1755
## Recommended migration plan
1856

1957
Each organization will have different metrics of success and internal migration processes. This section provides suggested guidance to considered when migrating from the Log Analytics MMA/OMS agent to the AMA, specifically for Microsoft Sentinel.
2058

2159
**Include the following steps in your migration process**:
2260

23-
1. Make sure that you've considered your environmental requirements and understand the gaps between the different agents. For more information, see [Plan your migration](../azure-monitor/agents/azure-monitor-agent-migration.md#plan-your-migration).
61+
1. Make sure that you've considered your environmental requirements and understand the gaps between the different agents. For more information, see [Plan your migration](../azure-monitor/agents/azure-monitor-agent-migration.md#plan-your-migration) in the Azure Monitor documentation.
2462

2563
1. Run a proof of concept to test how the AMA sends data to Microsoft Sentinel, ideally in a development or sandbox environment.
2664

@@ -34,23 +72,46 @@ Each organization will have different metrics of success and internal migration
3472
> If you need to keep both data connectors running simultaneously, we recommend that you do so only for a limited time for a benchmarking, or test comparison activity, ideally in a separate test workspace.
3573
>
3674
37-
1. Measure the success of your proof of concept. Success criteria should include a statistical analysis and comparison of the quantitative data ingested by the MMA/OMS and AMA agents on the same host:
75+
1. Measure the success of your proof of concept.
76+
77+
To help with this step, use the **AMA migration tracker** workbook, which displays the servers reporting to your workspaces, and whether they have the legacy MMA, the AMA, or both agents installed. You can also use this workbook to view the DCRs collecting events from your machines, and which events they are collecting.
78+
79+
For example:
80+
81+
:::image type="content" source="media/ama-migrate/migrate-workbook.png" alt-text="Screenshot of the AMA migration tracker workbook." lightbox="media/ama-migrate/migrate-workbook.png" :::
82+
83+
Success criteria should include a statistical analysis and comparison of the quantitative data ingested by the MMA/OMS and AMA agents on the same host:
3884

3985
- Measure your success over a predefined time period that represents a normal workload for your environment.
4086

4187
- While testing, make sure to test each new feature provided by the AMA, such as Linux multi-homing, Windows event filtering, and so on.
4288

4389
- Plan your rollout for AMA agents in your production environment according to your organization's risk profile and change processes.
4490

45-
1. Roll out the new agent on your production environment and run a final test of the AMA functionality.
91+
3. Roll out the new agent on your production environment and run a final test of the AMA functionality.
4692

47-
1. Disconnect any data connectors that rely on the legacy connector, such as Security Events with MMA. Leave the new connector, such as Windows Security Events with AMA, running.
93+
4. Disconnect any data connectors that rely on the legacy connector, such as Security Events with MMA. Leave the new connector, such as Windows Security Events with AMA, running.
4894

4995
While you can have both the legacy MMA/OMS and the AMA agents running in parallel, prevent duplicate costs and data by making sure that each data source uses only one agent to send data to Microsoft Sentinel.
5096

51-
1. Check your Microsoft Sentinel workspace to make sure that all your data streams have been replaced using the new AMA-based connectors.
97+
5. Check your Microsoft Sentinel workspace to make sure that all your data streams have been replaced using the new AMA-based connectors.
98+
99+
6. Uninstall the legacy agent. For more information, see [Manage the Azure Log Analytics agent ](/azure/azure-monitor/agents/agent-manage#uninstall-agent).
100+
101+
## FAQs
102+
The following FAQs address issues specific to AMA migration with Microsoft Sentinel. For more information, see also the [Frequently asked questions for AMA migration](/azure/azure-monitor/faq#azure-monitor-agent) in the Azure Monitor documentation.
103+
104+
## What happens if I run both MMA/OMS and AMA in parallel in my Microsoft Sentinel deployment?
105+
Both the AMA and MMA/OMS agents can co-exist on the same machine. If they both send data, from the same data source to a Microsoft Sentinel workspace, at the same time, from a single host, duplicate events and double ingestion charges will occur.
106+
107+
For your production rollout, we recommend that you configure either an MMA/OMS agent or the AMA for each data source. To address any issues for duplication, see the relevant FAQs in the [Azure Monitor documentation](/azure/azure-monitor/faq#azure-monitor-agent).
108+
109+
## The AMA doesn’t yet have the features my Microsoft Sentinel deployment needs to work. Should I migrate yet?
110+
The legacy Log Analytics agent will be retired on 31 August 2024.
111+
112+
We recommend that you keep up to date with the new features being released for the AMA over time, as it reaches towards parity with the MMA/OMS. Aim to migrate as soon as the features you need to run your Microsoft Sentinel deployment are available in the AMA.
52113

53-
1. Uninstall the legacy agent. For more information, see [Manage the Azure Log Analytics agent ](/azure/azure-monitor/agents/agent-manage#uninstall-agent).
114+
While you can run the MMA and AMA simultaneously, you may want to migrate each connector, one at a time, while running both agents.
54115

55116

56117

Loading

0 commit comments

Comments
 (0)
Please sign in to comment.