You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/network-watcher/network-watcher-connectivity-overview.md
+13-51Lines changed: 13 additions & 51 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,60 +2,22 @@
2
2
title: Introduction to Azure Network Watcher Connection Troubleshoot | Microsoft Docs
3
3
description: This page provides an overview of the Network Watcher connection troubleshooting capability
4
4
services: network-watcher
5
-
author: shijaiswal
5
+
documentationcenter: na
6
+
author: damendo
6
7
ms.service: network-watcher
7
8
ms.topic: article
8
9
ms.tgt_pltfrm: na
9
-
ms.custom: ignite-2022
10
10
ms.workload: infrastructure-services
11
-
ms.date: 10/12/2022
12
-
ms.author: shijaiswal
11
+
ms.date: 07/11/2017
12
+
ms.author: damendo
13
13
---
14
14
15
15
# Introduction to connection troubleshoot in Azure Network Watcher
16
16
17
-
With the increase in sophisticated and high-performance workloads into Azure, there's a critical need for increased visibility and control over the operational state of complex networks running these workloads. With limited visibility, diagnosis of issues such as connectivity issues becomes difficult as there is minimum control.
18
-
19
-
The Connection troubleshoot feature of Network Watcher provides the capability to check a direct TCP connection from a virtual machine to a virtual machine (VM), fully qualified domain name (FQDN), URI, or IPv4 address. Network scenarios are complex, they're implemented using network security groups, firewalls, user-defined routes, and resources provided by Azure. Complex configurations make troubleshooting connectivity issues challenging. Network Watcher helps reduce the amount of time to find and detect connectivity issues. The results returned can provide insights into whether a connectivity issue is due to a platform or a user configuration issue. Connectivity can be checked with the [Azure portal](network-watcher-connectivity-portal.md), [PowerShell](network-watcher-connectivity-powershell.md), [Azure CLI](network-watcher-connectivity-cli.md), and [REST API](network-watcher-connectivity-rest.md).
20
-
21
-
The current capabilities of Connection troubleshoot entail the following:
22
-
- Check connectivity between source (VM) and destination (VM, URI, FQDN, IP Address).
23
-
- Identify configuration issues that impact reachability.
24
-
- Provide all possible hop by hop paths from the source to destination.
25
-
- Hop by hop latency.
26
-
- Latency - minimum, maximum, and average between source and destination.
27
-
- A topology (graphical) view from your source to destination.
28
-
- Number of packets dropped during the connection troubleshoot check.
29
-
30
-
:::image type="content" source="./media/network-watcher-connectivity-portal/network-watcher-graph-view.png" alt-text="Screenshot of graph view of Connection troubleshoot capabilities.":::
31
-
32
-
Connection troubleshoot can detect the following types of issues that can impact connectivity:
- No servers listening on designated destination ports
43
-
44
-
Microsoft Azure Network Watcher provides numerous specialized standalone tools to diagnose and troubleshoot connectivity cases such as
45
-
-*[IP Flow Verify](network-watcher-ip-flow-verify-overview.md)* to detect blocked traffic due to NSG rules restriction.
46
-
-*[Next Hop](network-watcher-next-hop-overview.md)* to determine intended traffic as per the rules of the effective route.
47
-
-*Port Scanner* to determine any port that is blocking traffic.
48
-
However, there was no mechanism to perform all the connectivity checks in a single location.
49
-
50
-
The enhanced Connection troubleshoot feature brings all the above functionality in one place as a comprehensive method of performing all major checks, specifically issues pertaining to NSG, UDR, and blocked ports and reduces the Mean Time To Resolution (MTTR). It also provides actionable insights where a step-by-step guide or corresponding documentation is provided for faster resolution.
17
+
The connection troubleshoot feature of Network Watcher provides the capability to check a direct TCP connection from a virtual machine to a virtual machine (VM), fully qualified domain name (FQDN), URI, or IPv4 address. Network scenarios are complex, they are implemented using network security groups, firewalls, user-defined routes, and resources provided by Azure. Complex configurations make troubleshooting connectivity issues challenging. Network Watcher helps reduce the amount of time to find and detect connectivity issues. The results returned can provide insights into whether a connectivity issue is due to a platform or a user configuration issue. Connectivity can be checked with [PowerShell](network-watcher-connectivity-powershell.md), [Azure CLI](network-watcher-connectivity-cli.md), and [REST API](network-watcher-connectivity-rest.md).
51
18
52
19
> [!IMPORTANT]
53
-
>
54
-
> Ensure that the `AzureNetworkWatcherExtension` VM extension is installed on the VM that you troubleshoot from.
55
-
> - To install the extension on a Windows VM, see [Azure Network Watcher Agent virtual machine extension for Windows](../virtual-machines/extensions/network-watcher-windows.md?toc=%2fazure%2fnetwork-watcher%2ftoc.json)
56
-
> - To install the extension on a Linux VM, see [Azure Network Watcher Agent virtual machine extension for Linux](../virtual-machines/extensions/network-watcher-linux.md?toc=%2fazure%2fnetwork-watcher%2ftoc.json).
57
-
>
58
-
> The extension isn't required on the destination endpoint.
20
+
> Connection troubleshoot requires that the VM you troubleshoot from has the `AzureNetworkWatcherExtension` VM extension installed. For installing the extension on a Windows VM visit [Azure Network Watcher Agent virtual machine extension for Windows](../virtual-machines/extensions/network-watcher-windows.md?toc=%2fazure%2fnetwork-watcher%2ftoc.json) and for Linux VM visit [Azure Network Watcher Agent virtual machine extension for Linux](../virtual-machines/extensions/network-watcher-linux.md?toc=%2fazure%2fnetwork-watcher%2ftoc.json). The extension is not required on the destination endpoint.
59
21
60
22
## Response
61
23
@@ -64,16 +26,16 @@ The following table shows the properties returned when connection troubleshoot h
64
26
|Property |Description |
65
27
|---------|---------|
66
28
|ConnectionStatus | The status of the connectivity check. Possible results are **Reachable** and **Unreachable**. |
67
-
|AvgLatencyInMs | Average latency during the connectivity check, in milliseconds. (Only shown if check status is reachable) |
68
-
|MinLatencyInMs | Minimum latency during the connectivity check, in milliseconds. (Only shown if check status is reachable) |
69
-
|MaxLatencyInMs | Maximum latency during the connectivity check, in milliseconds. (Only shown if check status is reachable) |
29
+
|AvgLatencyInMs | Average latency during the connectivity check in milliseconds. (Only shown if check status is reachable) |
30
+
|MinLatencyInMs | Minimum latency during the connectivity check in milliseconds. (Only shown if check status is reachable) |
31
+
|MaxLatencyInMs | Maximum latency during the connectivity check in milliseconds. (Only shown if check status is reachable) |
70
32
|ProbesSent | Number of probes sent during the check. Max value is 100. |
71
33
|ProbesFailed | Number of probes that failed during the check. Max value is 100. |
72
34
|Hops | Hop by hop path from source to destination. |
73
35
|Hops[].Type | Type of resource. Possible values are **Source**, **VirtualAppliance**, **VnetLocal**, and **Internet**. |
74
36
|Hops[].Id | Unique identifier of the hop.|
75
37
|Hops[].Address | IP address of the hop.|
76
-
|Hops[].ResourceId | ResourceID of the hop if the hop is an Azure resource. If it's an internet resource, ResourceID is **Internet**. |
38
+
|Hops[].ResourceId | ResourceID of the hop if the hop is an Azure resource. If it is an internet resource, ResourceID is **Internet**. |
77
39
|Hops[].NextHopIds | The unique identifier of the next hop taken.|
78
40
|Hops[].Issues | A collection of issues that were encountered during the check at that hop. If there were no issues, the value is blank.|
79
41
|Hops[].Issues[].Origin | At the current hop, where issue occurred. Possible values are:<br/> **Inbound** - Issue is on the link from the previous hop to the current hop<br/>**Outbound** - Issue is on the link from the current hop to the next hop<br/>**Local** - Issue is on the current hop.|
@@ -83,7 +45,7 @@ The following table shows the properties returned when connection troubleshoot h
83
45
|Hops[].Issues[].Context[].key |Key of the key value pair returned.|
84
46
|Hops[].Issues[].Context[].value |Value of the key value pair returned.|
85
47
86
-
The following is an example of an issue found on a Hop.
48
+
The following is an example of an issue found on a hop.
87
49
88
50
```json
89
51
"Issues": [
@@ -102,7 +64,7 @@ The following is an example of an issue found on a Hop.
102
64
```
103
65
## Fault types
104
66
105
-
The Connection troubleshoot feature returns fault types about the connection. The following table lists the current fault types returned.
67
+
Connection troubleshoot returns fault types about the connection. The following table provides a list of the current fault types returned.
106
68
107
69
|Type |Description |
108
70
|---------|---------|
@@ -115,4 +77,4 @@ The Connection troubleshoot feature returns fault types about the connection. Th
115
77
116
78
### Next steps
117
79
118
-
Learn how to troubleshoot connections using the [Azure portal](network-watcher-connectivity-portal.md), [PowerShell](network-watcher-connectivity-powershell.md), the [Azure CLI](network-watcher-connectivity-cli.md), or [REST API](network-watcher-connectivity-rest.md).
80
+
Learn how to troubleshoot connections using the [Azure portal](network-watcher-connectivity-portal.md), [PowerShell](network-watcher-connectivity-powershell.md), the [Azure CLI](network-watcher-connectivity-cli.md), or [REST API](network-watcher-connectivity-rest.md).
description: Learn how to use the connection troubleshoot capability of Azure Network Watcher using the Azure portal.
5
5
services: network-watcher
6
-
author: shijaiswal
6
+
documentationcenter: na
7
+
author: damendo
7
8
ms.service: network-watcher
8
9
ms.topic: troubleshooting
10
+
ms.tgt_pltfrm: na
9
11
ms.workload: infrastructure-services
10
-
ms.custom: ignite-2022
11
-
ms.date: 10/12/2022
12
-
ms.author: shijaiswal
12
+
ms.date: 01/04/2021
13
+
ms.author: damendo
13
14
---
14
15
15
16
# Troubleshoot connections with Azure Network Watcher using the Azure portal
16
17
17
-
This article describes the procedure to use Connection troubleshoot to verify whether a direct connection from a virtual machine to a destination can be established.
Learn how to use connection troubleshoot to verify whether a direct TCP connection from a virtual machine to a given endpoint can be established.
20
25
21
-
Ensure that you have the following:
26
+
## Before you begin
27
+
28
+
This article assumes you have the following resources:
22
29
23
30
* An instance of Network Watcher in the region you want to troubleshoot a connection.
24
31
* Virtual machines to troubleshoot connections with.
25
32
26
33
> [!IMPORTANT]
27
-
>
28
-
> Ensure that the `AzureNetworkWatcherExtension` VM extension is installed on the VM that you troubleshoot from.
29
-
> - To install the extension on a Windows VM, see [Azure Network Watcher Agent virtual machine extension for Windows](../virtual-machines/extensions/network-watcher-windows.md)
30
-
> - To install the extension on a Linux VM, see [Azure Network Watcher Agent virtual machine extension for Linux](../virtual-machines/extensions/network-watcher-linux.md).
31
-
>
32
-
> The extension isn't required on the destination endpoint.
34
+
> Connection troubleshoot requires that the VM you troubleshoot from has the `AzureNetworkWatcherExtension` VM extension installed. For installing the extension on a Windows VM visit [Azure Network Watcher Agent virtual machine extension for Windows](../virtual-machines/extensions/network-watcher-windows.md?toc=%2fazure%2fnetwork-watcher%2ftoc.json) and for Linux VM visit [Azure Network Watcher Agent virtual machine extension for Linux](../virtual-machines/extensions/network-watcher-linux.md?toc=%2fazure%2fnetwork-watcher%2ftoc.json). The extension is not required on the destination endpoint.
33
35
34
36
## Check connectivity to a virtual machine
35
37
36
-
To check the connectivity to a destination virtual machine over port 80 follow these steps:
37
-
38
-
1. In Network Watcher, select **Connection troubleshoot**.
39
-
2. In the **Source** section, enter the details of the virtual machine that you want to check connectivity from:
40
-
1. Select the **Subscription** to which the VM belongs.
41
-
2. Select the **Resource group** within the subscription.
42
-
3. Select the type of the source machine from the **Source type** drop-down. The source can be a Virtual machine, Application Gateway, or a Bastion host.
43
-
3. In the **Destination** section,
44
-
1. Select the **Destination type** as **Virtual machine**.
45
-
2. Select the **Resource group** to which the destination machine belongs.
46
-
3. The **Virtual machine** drop-down lists the virtual machines belonging to the same resource group as the source VM. Select the destination virtual machine from the drop-down list.
47
-
4. Provide the Probe information in the **Probe Settings** section.
48
-
1. Select the **Preferred IP version** to be used. You can choose IPv4, IPv6, or both.
49
-
2. Select the probing **Protocol**.
50
-
1. If you chose **TCP**, enter the value of the **Destination port**.
51
-
2. Enter the value of the **Source port**. This is an optional field.
52
-
3. Select **Test connection**.
53
-
4. If you chose **ICMP**, select **Test connection**.
54
-
55
-
Connection troubleshoot checks the connectivity between the virtual machines on the specified port.
56
-
The results of the connectivity test are available in the [**Connection troubleshoot Result**](#connection-troubleshoot-result) section.
57
-
58
-
:::image type="content" source="./media/network-watcher-connectivity-portal/network-watcher-tcp-selection.png" alt-text="Screenshot of Connection troubleshoot screen with values selected.":::
38
+
This example checks connectivity to a destination virtual machine over port 80.
59
39
60
-
## Check remote endpoint connectivity
40
+
Navigate to your Network Watcher and click **Connection troubleshoot**. Select the virtual machine to check connectivity from. In the **Destination** section choose **Select a virtual machine** and choose the correct virtual machine and port to test.
61
41
62
-
To check the connectivity and latency to a remote endpoint, follow these steps:
42
+
Once you click **Check**, connectivity between the virtual machines on the port specified is checked. In the example, the destination VM is unreachable, a listing of hops are shown.
63
43
64
-
1. In Network Watcher, select **Connection troubleshoot**.
65
-
2. In the **Source** section, enter the details of the virtual machine that you want to check connectivity from:
66
-
1. Select the **Subscription** to which the VM belongs.
67
-
2. Select the **Resource group** within the subscription.
68
-
3. Select the type of the source machine from the **Source type** drop-down. The source can be a Virtual machine, Application Gateway, or a Bastion host..
69
-
3. Choose **Specify manually** in the **Destination type** section.
70
-
4. Enter the URI, FQDN, or IP address and select **Test connection**.
44
+
![Check connectivity results for a virtual machine][1]
71
45
72
-
This method of checking connectivity is used for remote endpoints like websites and storage endpoints. The results of the connectivity test are available in the [**Connection troubleshoot Result**](#connection-troubleshoot-result) section.
46
+
## Check remote endpoint connectivity
73
47
74
-
## Connection troubleshoot result
48
+
To check the connectivity and latency to a remote endpoint, choose the **Specify manually** radio button in the **Destination** section, input the url and the port and click **Check**. This is used for remote endpoints like websites and storage endpoints.
75
49
76
-
This section provides actionable insights with a step-by-step guide to resolve issues. It also shows the status of the connection and provides details such as latency, hops, details of tests performed, their status, and the steps to mitigate the issues.
50
+
![Check connectivity results for a web site][2]
77
51
78
-
For each test with a *Failed* or *Warning* status, the **Connection troubleshoot Result** table provides links to specific articles in the documentation to assist the users in resolving issues.
52
+
## Next steps
79
53
80
-
:::image type="content" source="./media/network-watcher-connectivity-portal/network-watcher-unsuccessful.png" alt-text="Screenshot of Results table for unsuccessful connection.":::
54
+
Learn how to automate packet captures with Virtual machine alerts by viewing [Create an alert triggered packet capture](network-watcher-alert-triggered-packet-capture.md)
81
55
82
-
## Next steps
56
+
Find if certain traffic is allowed in or out of your VM by visiting [Check IP flow verify](diagnose-vm-network-traffic-filtering-problem.md)
83
57
84
-
- Automate packet captures with Virtual machine alerts using [Create an alert triggered packet capture](network-watcher-alert-triggered-packet-capture.md).
85
-
- Check the type of traffic that is allowed in or out of your VM using [Check IP flow verify](diagnose-vm-network-traffic-filtering-problem.md).
0 commit comments