Skip to content

Commit aaf9f13

Browse files
EdB-MSFTEdB-MSFT
committed
Update migration content
1 parent 7fb2ea5 commit aaf9f13

6 files changed

+359
-266
lines changed

‎.openpublishing.redirection.azure-monitor.json

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6733,9 +6733,11 @@
67336733
"source_path_from_root": "/articles/azure-monitor/essentials/pipeline-overview.md",
67346734
"redirect_url": "/azure/azure-monitor/essentials/data-collection-rule-overview",
67356735
"redirect_document_id": false
6736-
}
6737-
6738-
6739-
6736+
},
6737+
{
6738+
"source_path_from_root": "/articles/azure-monitor/agents/azure-monitor-agent-migration-tools.md",
6739+
"redirect_url": "/azure/azure-monitor/agents/azure-monitor-agent-migration",
6740+
"redirect_document_id": false
6741+
}
67406742
]
67416743
}

‎articles/azure-monitor/agents/azure-monitor-agent-migration-dcr-generator.md

Lines changed: 81 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,81 @@
1+
---
2+
title: Workspace configuration to DCR config generator
3+
description: Using the Workspace configuration to DCR config generator to help migrate from MMA to AMA agents
4+
author: EdB-MSFT
5+
ms.author: edbaynash
6+
ms.reviewer: guywild
7+
ms.topic: conceptual
8+
ms.date: 06/16/2024
9+
10+
# Customer intent: As an azure administrator, I want to understand how to use the workspace configuration to DCR config generator.
11+
12+
---
13+
14+
# Convert workspace configuration to DCR configurations.
15+
16+
Whereas Log Analytics Agent inherits its configuration from Log Analytics workspaces, the Azure Monitor Agent relies on data collection rules (DCRs) for configuration
17+
18+
The workspace configuration to DCR config generator is a PowerShell that reads the configuration from your workspace produce multiple DCR ARM templates, based on the MMA configurations present on the workspace.
19+
20+
## Prerequisites
21+
- PowerShell version 7.1.3 or higher is recommended (minimum version 5.1)
22+
- Az PowerShell module to pull workspace agent configuration information Az PowerShell module. To install the Az PowerShell module, see [Install Azure PowerShell on Windows](/powershell/azure/install-azps-windows)
23+
- Read/Write access to the specified workspace resource
24+
25+
## Installation and execution
26+
27+
Download the [PowerShell script](https://github.com/microsoft/AzureMonitorCommunity/tree/master/Azure%20Services/Azure%20Monitor/Agents/Migration%20Tools/DCR%20Config%20Generator) from Git Hub.
28+
29+
30+
The script retrieves the configuration of the legacy agent configurations from the workspace and generates DCR ARM templates for each supported DCR type in the specified output folder. More than one template may be created, one for each DCR type.
31+
32+
For multiple workspaces with data collections configured, you must run the script for each workspace. IIS logs the script also creates an additional data collection role as part of that configuration.
33+
34+
35+
When the script completes, it prompts you to test the deployment of the template in your environment. Choose to either let it deploy the template for you, or store the template specified output folder
36+
37+
> [!NOTE]
38+
> The script does not associate the DCRs with the workspace. You must create your own data collection rule associations (DCRAs), to associate the DCRs with the relevant servers. This allows you to control the deployment of the DCRs to the servers and test the DCRs on a sample of servers before deploying at scale.
39+
40+
41+
To run script, copy the following command and replace the parameters with your values:
42+
43+
```powershell
44+
.\WorkspaceConfigToDCRMigrationTool.ps1 -SubscriptionId $subId -ResourceGroupName $rgName -WorkspaceName $workspaceName -DCRName $dcrName -OutputFolder $outputFolderPath
45+
```
46+
47+
### Script parameters
48+
49+
50+
| Name | Required | Description |
51+
| ----------------------- |:---------:|:-----------------------------------------------------------------------------:|
52+
| `SubscriptionId` | YES | The subscription ID of the workspace |
53+
| `ResourceGroupName` | YES | The resource Group of the workspace |
54+
| `WorkspaceName` | YES | The name of the workspace (Azure resource IDs are case insensitive) |
55+
| `DCRName` | YES | The base name used for each one the outputs DCRs |
56+
| `OutputFolder` | NO | The output folder path. If not provided, the working directory path is used |
57+
58+
59+
### Outputs:
60+
- For each supported `DCR type`, the script produces a ready to be deployed DCR ARM template and a DCR payload, for users that don't need the ARM template.
61+
62+
Currently supported DCR types:
63+
64+
- **Windows** contains `WindowsPerfCounters` and `WindowsEventLogs` data sources only
65+
- **Linux** contains `LinuxPerfCounters` and `Syslog` data sources only
66+
- **Custom Logs** contains `logFiles` data sources only
67+
- **IIS Logs** contains `iisLogs` data sources only
68+
- **Extensions** contains `extensions` data sources only along with any associated perfCounters data sources
69+
- `VMInsights`
70+
71+
## Deployment
72+
73+
For information on deploying the DCRs, see [Data collection rules in Azure Monitor](/azure/azure-monitor/essentials/data-collection-rule-overview) and [Create and edit data collection rules (DCRs) in Azure Monitor](/azure/azure-monitor/essentials/data-collection-rule-create-edit)
74+
75+
76+
## Next steps
77+
78+
- [Azure Monitor Agent Migration Helper workbook](azure-monitor-agent-migration-helper-workbook.md)
79+
- [Data collection rule structure](../essentials/data-collection-rule-structure.md)
80+
- [Sample data collection rules (DCRs)](../essentials/data-collection-rule-samples.md) for sample DCRs for different data collection scenarios.
81+
- [Azure Monitor service limits](../service-limits.md#data-collection-rules) for limits that apply to each DCR.

‎articles/azure-monitor/agents/azure-monitor-agent-migration-helper-workbook.md

Lines changed: 133 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,133 @@
1+
2+
---
3+
title: Azure Monitor Agent Migration Helper workbook
4+
description: Plan your migration from the Log Analytics Agent to the Azure Monitor Agent using the Azure Monitor Agent Migration Helper workbook.
5+
author: EdB-MSFT
6+
ms.author: edbaynash
7+
ms.reviewer: guywild
8+
ms.topic: conceptual
9+
ms.date: 06/16/2024
10+
11+
# Customer intent: As an azure administrator, I want to understand how the Azure Monitor Agent Migration Helper workbook can help me in migrating from the MMA agent to the AMA agent.
12+
13+
---
14+
15+
# Azure Monitor Agent Migration Helper workbook
16+
17+
Azure Monitor Agent Migration Helper workbook is a workbook-based Azure Monitor solution that helps you discover what to migrate and track progress as you move from Log Analytics Agent to Azure Monitor Agent. Use this single pane of glass view to expedite and track the status of your agent migration journey. The helper now supports multiple subscriptions, and includes automatic migration recommendations based on your usage.
18+
19+
## Using the AMA workbook
20+
21+
To open the workbook:
22+
1. Navigate to the **Azure Monitor** page in the Azure portal, and select **Workbooks**.
23+
1. In the **Workbooks** pane, scroll down to the **AMA Migration Helper** workbook, and select it.
24+
25+
:::image type="content" source="./media/azure-monitor-agent-migration-helper-workbook/select-monitor-workbook.png" lightbox="./media/azure-monitor-agent-migration-helper-workbook/select-monitor-workbook.png" alt-text="A screenshot showing the AMA Migration helper tine in the list of workbooks.":::
26+
27+
The workbook opens on the **Subscriptions Overview** tab.
28+
This page provides a high-level view of the resources in your subscriptions, which agents are deployed, and the migration status. Use this page to keep track of the migration status of your resources across your subscriptions.
29+
30+
On the subscriptions overview tab, the workbook automatically detects the following resources:
31+
- Subscriptions
32+
- Workspaces
33+
- Azure VMs
34+
- Virtual Machine Scale Sets
35+
- Arc-enabled servers
36+
- Hybrid machines without Arc where the legacy agent is deployed
37+
38+
Each item has a tab that provides a detailed view of the resources in that category.
39+
40+
:::image type="content" source="./media/azure-monitor-agent-migration-helper-workbook/subscriptions-overview.png" lightbox="./media/azure-monitor-agent-migration-helper-workbook/subscriptions-overview.png" alt-text="A screenshot showing subscriptions overview tab.":::
41+
42+
The Migration status table appears at the bottom of the page.
43+
44+
The table includes the following columns:
45+
- Subscription
46+
- Resource Type
47+
- Resource count
48+
- How many resources have both agents deployed
49+
- How many resources have only the Log Analytics Agent deployed
50+
- How many resources have only the Azure Monitor Agent deployed
51+
- Migration status
52+
53+
The table can be exported to Excel to allow you to work offline or share the data.
54+
55+
The following image shows the migration status table with the following statuses:
56+
57+
- Not Started: Resources that don't have any Azure Monitor Agents deployed.
58+
- In progress: Resources that have both agents deployed.
59+
- Completed: Resources that have only the Azure Monitor Agent deployed.
60+
61+
62+
:::image type="content" source="./media/azure-monitor-agent-migration-helper-workbook/migration-status.png" lightbox="./media/azure-monitor-agent-migration-helper-workbook/migration-status.png" alt-text="A screenshot showing the migration status table.":::
63+
64+
### Azure Virtual Machines, VM Scale Sets, and Arc-enabled servers tabs
65+
66+
The Azure Virtual Machines and Scale Sets tabs provides a detailed view of the Azure VMs, VM scale sets and Arc-enabled serves in your subscriptions. These machines are listed regardless of the workspace to which they send telemetry.
67+
The table provides a view of the migration status is per machine showing which agents are deployed, the last time a heartbeat was sent to one of your workspaces, and the migration status.
68+
69+
:::image type="content" source="./media/azure-monitor-agent-migration-helper-workbook/azure-virtual-machines-tab.png" lightbox="./media/azure-monitor-agent-migration-helper-workbook/azure-virtual-machines-tab.png" alt-text="A screenshot showing the Azure Virtual Machines migration status tab.":::
70+
71+
### Hybrid machines without Arc
72+
73+
The Hybrid machines without Arc tab provide a detailed view of the hybrid machines in your subscriptions that aren't Arc-enables but have the legacy agent deployed. The table includes the Log Analytics workspace that the machine sends telemetry to, the last time the machine sent a heartbeat to the workspace
74+
75+
:::image type="content" source="./media/azure-monitor-agent-migration-helper-workbook/hybrid-machines-tab.png" lightbox="./media/azure-monitor-agent-migration-helper-workbook/hybrid-machines-tab.png" alt-text="A screenshot showing the Hybrid machines without Arc migration status tab.":::
76+
77+
78+
### Workspaces
79+
80+
The **Workspace** tab provides a detailed view of the workspaces in your subscriptions. Choose a specific workspace to view using the dropdown above the table. The dropdown at the top of the page doesn't filter the table.
81+
82+
On the **Agents** tab, the table shows how many resources of each type are sending telemetry to the workspace, which agent is configured and the migration status.
83+
84+
:::image type="content" source="./media/azure-monitor-agent-migration-helper-workbook/workspace-agents-tab.png" lightbox="./media/azure-monitor-agent-migration-helper-workbook/workspace-agents-tab.png" alt-text="A screenshot showing the workspace agents tab.":::
85+
86+
The **Solutions** tab shows the legacy solutions that have been deployed into the workspace and the recommended migration steps are for that specific solution. Select the recommendation for more information. The last time data any kind of logs or telemetry was received from teach solution is listed.
87+
88+
:::image type="content" source="./media/azure-monitor-agent-migration-helper-workbook/workspace-solutions-tab.png" lightbox="./media/azure-monitor-agent-migration-helper-workbook/workspace-solutions-tab.png" alt-text="A screenshot showing the workspace solutions tab.":::
89+
90+
You can also see this information in the **Legacy solutions** tab on your Log Analytics workspace page.
91+
92+
### Automation update management
93+
94+
The AMA migration Helper workbook provides you with guidance on which of your machines are using the update Management solution and how to migrate them.
95+
96+
The **Azure Automation Update Management** tab provides a detailed view of the machines in your subscriptions that are using the Update Management solution. It detects your automation accounts linked to your workspace, shows the machines that may require migration, their status, and the ability to migrate them.
97+
98+
Select **Migrate Now** to go to the Azure Update Manager migration tool(Preview).
99+
100+
For more information, see [Move from Automation Update Management to Azure Update Manager](/azure/update-manager/guidance-migration-automation-update-management-azure-update-manager)
101+
102+
:::image type="content" source="./media/azure-monitor-agent-migration-helper-workbook/automation-update-management.png" lightbox="./media/azure-monitor-agent-migration-helper-workbook/automation-update-management.png" alt-text="A screenshot showing the automation update management tab.":::
103+
104+
105+
## Workspace Auditing workbook
106+
107+
The Azure Monitor Workspace Auditing workbook is another workbook tool to help you understand your workspaces.
108+
This workbook collects all of your Log Analytics workspaces and shows you the following for each workspace:
109+
1. All data sources that are sending data to the workspace.
110+
1. The agents that are sending heartbeats to the workspace.
111+
1. The resources that are sending data to the workspace.
112+
1. Any Application Insights resources that are sending data to the workspace.
113+
114+
To use the Azure Monitor Workspace Auditing workbook, follow the steps below
115+
116+
1. Copy the workbook JSON from the [GitHub repository](https://github.com/microsoft/AzureMonitorCommunity/blob/master/Azure%20Services/Log%20Analytics%20workspaces/Workbooks/Workspace%20Audit.json).
117+
1. In the Azure portal, navigate to the **Azure Monitor** page, and select **Workbooks**.
118+
1. Select **+ New**.
119+
1. Select the Advanced editor **</>**
120+
1. Select **Gallery Template**.
121+
1. Replace the text with the JSON from the GitHub repository.
122+
1. Select **Apply**.
123+
124+
:::image type="content" source="./media/azure-monitor-agent-migration-helper-workbook/workspace-auditing-workbook.png" lightbox="./media/azure-monitor-agent-migration-helper-workbook/workspace-auditing-workbook.png" alt-text="A screenshot showing the edit workbook page.":::
125+
126+
The **Data Collection** tab shows the data sources that have been collected into this workspace over th last seven days. The table includes the data source, whether it's billable and the volume of data ingested, and the last time data was received from that data source.
127+
128+
:::image type="content" source="./media/azure-monitor-agent-migration-helper-workbook/workspace-auditing-workbook-data-collection.png" lightbox="./media/azure-monitor-agent-migration-helper-workbook/workspace-auditing-workbook-data-collection.png" alt-text="A screenshot showing the workbook data collection tab.":::
129+
130+
The following tabs are also available in the workbook:
131+
- **Agents**: Lists the agents that are sending heartbeats to the workspace.
132+
- **Azure Resources**: Lists the resources that are sending data to the workspace.
133+
- **Application Insights**: The Application Insights resources that are sending data to the workspace.

0 commit comments

Comments
 (0)