Migrate to Connection monitor from Connection monitor (classic)
In this article, you learn how to migrate your existing connection monitors from Connection monitor (classic) to the new Connection monitor with zero downtime. For more information, see Connection monitor overview.
Important
Connection monitor (Classic) is deprecated and no longer available. To minimize service disruption to your current workloads, migrate from Connection monitor (classic) to the new Connection monitor.
Key benefits of the new Connection monitor
The following are key benefits of the new Connection monitor:
Unified connectivity monitoring experience for Azure and Hybrid endpoints
Virtual machines (VMs) and scale sets support as source and destination endpoints.
Azure Monitor agent enabled ARC servers as source and destination endpoints.
Cross subscription, cross workspace and cross region monitoring support.
Ease of experience with simplified agent support
Lightweight Azure Network Watcher extension compatible with ARC endpoints.
Auto upgrade of agents with automated agent enablement support.
Visualize & measure end-to-end network path performance with the new Topology (preview)
Deep insights into network performance metrics with synthetic monitoring across TCP, ICMP and HTTP protocols.
Enhanced visibility into end-to-end network path and connections with per hop latency and path loss across path components, highlighting links with high latency or packet loss.
Enhanced troubleshooting with clear actionable insights
Fast detection with real-time alerting network connectivity issues.
Smart insights into changes across networking path components to highlight the underlying cause for connectivity errors.
Identification of blocking rules and resources responsible for endpoint connectivity failures.
Connection monitor (classic) vs new Connection monitor
The following table compares Connection monitor (classic) and the new Connection monitor:
| Feature | Connection monitor (classic) | Connection monitor |
|---|---|---|
| Unified experience for Azure and hybrid monitoring | Not available | Available |
| Support for ARC enabled Azure Monitor agent supported endpoints as source and destination endpoints | Not available | Available |
| Compound resources - Virtual networks, subnets, and on-premises custom networks | Not available | Available |
| Cross subscription, cross-region, and cross-workspace monitoring | Not available | Available |
| Centralized workspace support | Not available | Available |
| Multiple sources can ping multiple destinations | Not available | Available |
| Unified topology across on-premises, internet, and Azure hops | Not available | Available |
| HTTP status code checks | Not available | Available |
| Enhanced connectivity diagnostics | Not available | Available |
| Connectivity metrics and dimension measurements with Log Analytics support | Not available | Available with TCP, ICMP and HTTP |
| Automation – PowerShell, the Azure CLI, Terraform | Available | Available |
| Support for Linux | Available | Available |
| Support for public, Government, China, and air-gapped cloud | Available | Available |
Key points to note
The migration helps produce the following results:
- Agents and firewall settings work as is. No changes are required.
- Existing connection monitors are mapped to Connection monitor > Test group > Test format. By selecting Edit, you can view and modify the properties of the new Connection monitor, download a template to make changes to Connection monitor, and submit it via Azure Resource Manager.
- Azure virtual machines with the Network Watcher extension send data to both the workspace and the metrics. Connection monitor makes the data available through the new metrics
ChecksFailedPercentandRoundTripTimeMsinstead of the old metricsProbesFailedPercentandAverageRoundtripMsrespectively. - Data monitoring:
- Alerts: Migrated automatically to the new metrics.
- Dashboards and integrations: Require manual editing of the metrics set.
Prerequisites
- If you're using a custom workspace, ensure that Network Watcher is enabled in your subscription and in the region of your Log Analytics workspace. If not, you get an error stating "Before you attempt to migrate, please enable Network watcher extension in the subscription and location of LA workspace selected."
- In case virtual machines used as sources in Connection monitor (classic) no longer have the Network Watcher extension enabled, you get an error message stating "Connection monitors having following tests cannot be imported as one or more Azure virtual machines don't have network watcher extension installed. Install Network Watcher extension and click refresh to import them."
Migrate the connection monitors
To migrate the older connection monitors to the new Connection monitor, select Connection monitor, and then select Migrate Connection Monitors.
Select your subscription and the connection monitors you want to migrate, and then select Migrate selected.
You can now customize Connection monitor properties, change the default workspace, download templates, and check the migration status.
After the migration begins, the following changes take place:
- The Azure Resource Manager resource changes to the newer connection monitor:
- The name, region, and subscription of the connection monitor remain unchanged. The resource ID is unaffected.
- Unless the connection monitor is customized, a default Log Analytics workspace is created in the subscription and in the region of the connection monitor. This workspace is where monitoring data is stored. The test result data is also stored in the metrics.
- Each test is migrated to a test group called defaultTestGroup.
- Source and destination endpoints are created and used in the new test group. The default names are defaultSourceEndpoint and defaultDestinationEndpoint.
- The destination port and probing interval are moved to a test configuration called defaultTestConfiguration. The protocol is set based on the port values. Success thresholds and other optional properties are left blank.
- Metrics alerts are migrated to Connection monitor metrics alerts. The metrics are different, hence the change. For more information, see Metrics in Azure Monitor.
- The migrated connection monitors are no longer displayed as the older connection monitor solution. They're now available for use only in Connection monitor.
- Any external integrations, such as dashboards in Power BI and Grafana, and integrations with Security Information and Event Management (SIEM) systems, must be migrated manually. This is the only manual step you need to perform to migrate your setup.
Common errors encountered
The following table list common errors that you might encounter during the migration:
| Error | Reason |
|---|---|
| Following Connection monitors cannot be imported as one or more Subscription/Region combinations don't have network watcher enabled. Enable network watcher and click refresh to import them. | This error occurs when you migrate tests from Connection monitor (classic) to Connection monitor and Network Watcher extension isn't enabled in one or more subscriptions and regions of Connection monitor (classic). You need to enable Network Watcher extension in all subscriptions and regions used in Connection monitor (classic). |
| Connection monitors having following tests cannot be imported as one or more Azure virtual machines don't have Network Watcher extension installed. Install Network Watcher extension and select refresh to import the tests. | This error occurs when you migrate tests from Connection monitor (classic) to Connection monitor and Network Watcher extension isn't installed in one or more Azure VMs of Connection monitor (classic). You need to install the Network Watcher extension in all Azure VMs of Connection monitor (classic), and then refresh before migrating again. |
| No rows to display | This error occurs when you try to migrate subscriptions from Connection monitor (classic) to Connection monitor but no Connection monitor (classic) is created in the subscriptions. |