Skip to content

Commit 227741d

Browse files
authored
Revise troubleshooting guide for dependency analysis
Updated the article to reflect changes in agentless dependency analysis capabilities. Revised sections on visualization, error handling, and export processes.
1 parent cb4d569 commit 227741d

1 file changed

Lines changed: 18 additions & 10 deletions

File tree

articles/migrate/troubleshoot-dependencies.md

Lines changed: 18 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Troubleshoot issues with agentless and agent-based dependency analysis
33
description: Get help with dependency visualization in Azure Migrate.
44
author: Vikram1988
55
ms.author: vibansa
6-
ms.manager: abhemraj
6+
ms.manager: ronai
77
ms.service: azure-migrate
88
ms.reviewer: v-uhabiba
99
ms.topic: troubleshooting
@@ -16,15 +16,22 @@ ms.custom:
1616

1717
# Troubleshoot dependency visualization
1818

19-
This article helps you troubleshoot issues with agent-based and agentless dependency analysis, which is _only available for VMware servers_. [Learn more](concepts-dependency-visualization.md) about the types of dependency visualization supported in Azure Migrate.
19+
This article helps you troubleshoot issues with agent-based and agentless dependency analysis which can be performed on VMware, Hyper-V and physical servers. [Learn more](concepts-dependency-visualization.md) about the types of dependency visualization supported in Azure Migrate.
2020

2121
## Visualize dependencies for >1 hour with agentless dependency analysis
2222

23-
With agentless dependency analysis, you can visualize dependencies or export them in a map for a duration of up to 30 days.
23+
With agentless dependency analysis, you can visualize dependencies in a multi-server visualization or export them in a CSV file for a duration of up to 30 days.
2424

2525
## Visualize dependencies for >10 servers with agentless dependency analysis
2626

27-
Azure Migrate offers a Power BI template that you can use to visualize network connections of many servers at once, and filter by process and server. [Learn more](how-to-create-group-machine-dependencies-agentless.md#visualize-network-connections-in-power-bi) about how to visualize the dependencies for many servers together.
27+
You can now visualize dependencies across all servers where dependency analysis is auto-enabled and running without any errors in the [multi-server dependency visualization](how-to-create-group-machine-dependencies-agentless.md#visualize-dependencies-across-servers).
28+
29+
## Unable to view all the connections in the new dependency analysis visualization and export
30+
In the new dependency analysis capabilities, the unresolved connections between discovered or undiscovered servers are omitted from the single-server, multi-server visualization and the exported CSV file. This is done to reduce the unwanted noise from the dependency data for ease of analysis and interpretation.
31+
- Resolved connections : Network connections between servers discovered by Azure Migrate where Application & Process information was successfully gathered from both source and destination servers.
32+
- Unresolved connections: Network connections either between a discovered and undiscovered server (not discovered by Azure Migrate) or the connection where Application & Process information could not be gathered from any of the source or destination servers, that were discovered by Azure Migrate (Dependency anlaysis either not enabled or failing due to errors).
33+
34+
If you want to visualize or export all network connections (including unresolved connections), you can switch to the **Classic experience** on through a footer note on the **Overview** page of the project on the portal.
2835

2936
## Dependencies export CSV shows "Unknown process" with agentless dependency analysis
3037
In agentless dependency analysis, the process names are captured on a best-effort basis. In certain scenarios, although the source and destination server names and the destination port are captured, it isn't feasible to determine the process names at both ends of the dependency. In such cases, the process is marked as "Unknown process."
@@ -34,9 +41,7 @@ If your Azure Migrate project has private endpoint connectivity, the request to
3441

3542
## Export the dependency analysis errors
3643

37-
You can export all the errors and remediations for agentless dependency analysis from the portal by selecting **Export notifications**. The exported CSV file also contains additional information like the timestamp at which the error was encountered and if it was an error in validation or discovery of dependency data.
38-
39-
:::image type="content" source="./media/troubleshoot-dependencies/export-notifications.png" alt-text="Screenshot of Export notifications screen.":::
44+
You can export all the errors and remediations from the Action Center in your project by filtering the errors for affected features as dependency mapping and selecting **Export issues**. The exported CSV file also contains additional information like the timestamp at which the error was encountered.
4045

4146
## Common agentless dependency analysis errors
4247

@@ -328,16 +333,19 @@ For Linux servers:
328333
329334
After you verify that the mitigation worked, go to the **Azure Migrate project** > **Discovery and assessment** > **Overview** > **Manage** > **Appliances**, select the appliance name, and select **Refresh services** to start a fresh discovery cycle.
330335
336+
## Unable to find a way to get to agent-based dependency analysis from the new Azure Migrate experiences
337+
Agent-based dependency analysis is not supported in the new Azure Migrate experience. You can go to the Classic experience through a footer note on the **Overview** page of the project, where you can continue using the agent-based dependency analysis using the associated Log Analytics workspace.
338+
331339
## My Log Analytics workspace isn't listed when you try to configure the workspace in Azure Migrate for agent-based dependency analysis
332-
Azure Migrate currently supports creation of OMS workspace in East US, Southeast Asia, and West Europe regions. If the workspace is created outside of Azure Migrate in any other region, it currently can't be associated with a project.
340+
Azure Migrate currently supports creation of Log Analytics workspace in East US, Southeast Asia, and West Europe regions. If the workspace is created outside of Azure Migrate in any other region, it currently can't be associated with a project.
333341
334342
## Agent-based dependency visualization in Azure Government
335343
336-
Agent-based dependency analysis isn't supported in Azure Government. Use agentless dependency analysis, which is _only available for VMware servers_.
344+
Agent-based dependency analysis isn't supported in Azure Government. You can use agentless dependency analysis instead.
337345
338346
## Agent-based dependencies don't show after agent installation
339347
340-
After you've installed the dependency visualization agents on on-premises VMs, Azure Migrate typically takes 15 to 30 minutes to display the dependencies in the portal. If you've waited for more than 30 minutes, make sure that the Microsoft Monitoring Agent (MMA) can connect to the Log Analytics workspace.
348+
After you've installed the dependency visualization agents on on-premises VMs, Azure Migrate typically takes 15 to 30 minutes to display the dependencies in the portal. If you've waited for more than 30 minutes, make sure that the Azure Monitoring Agent (AMA) can connect to the Log Analytics workspace.
341349
342350
For Windows VMs:
343351
1. In the Control Panel, start MMA.

0 commit comments

Comments
 (0)