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/azure-cache-for-redis/cache-troubleshoot-connectivity.md
+22-20Lines changed: 22 additions & 20 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,24 +5,24 @@ description: Learn how to resolve connectivity problems when creating clients wi
5
5
6
6
7
7
ms.topic: conceptual
8
-
ms.date: 04/16/2025
8
+
ms.date: 04/17/2025
9
9
appliesto:
10
10
- ✅ Azure Cache for Redis
11
11
ms.custom: template-concept, ignite-2024
12
12
---
13
13
14
14
# Troubleshoot Azure Cache for Redis connectivity
15
15
16
-
This article explains how to troubleshoot common issues connecting your client application to Azure Cache for Redis. Connectivity issues might be caused by intermittent conditions, or by incorrect cache configuration. This article is divided into intermittent issues and cache configuration issues.
16
+
This article explains how to troubleshoot common issues with connecting your client application to Azure Cache for Redis. Connectivity issues might be caused by intermittent conditions, or by incorrect cache configuration. This article is divided into intermittent issues and cache configuration issues.
@@ -31,25 +31,25 @@ This article explains how to troubleshoot common issues connecting your client a
31
31
32
32
## Test connectivity
33
33
34
-
You can test connectivity using the Redis command line tool _redis-cli_. For more information on Redis CLI, see [Use the Redis command-line tool with Azure Cache for Redis](cache-how-to-redis-cli-tool.md).
34
+
You can test connectivity by using the Redis command line tool _redis-cli_. For more information on Redis CLI, see [Use the Redis command-line tool with Azure Cache for Redis](cache-how-to-redis-cli-tool.md).
35
35
36
36
If redis-cli is unable to connect, you can test connectivity by using `PSPING` in Azure PowerShell.
37
37
38
38
```azurepowershell-interactive
39
39
psping -q <cachename>:<port>
40
40
```
41
41
42
-
If the number of sent packets is equal to the number of received packets, there is no drop in connectivity.
42
+
If the number of sent packets is equal to the number of received packets, there's no drop in connectivity.
43
43
44
44
## Intermittent connectivity issues
45
45
46
46
Your client application might have intermittent connectivity issues caused by spikes in the number of connections or by events such as patching.
47
47
48
48
### Kubernetes hosted applications
49
49
50
-
If your client application is hosted on Kubernetes, check whether the pod running the client application or the cluster nodes are under memory, CPU, or network pressure. A pod running the client application can be affected by other pods running on the same node and might throttle Redis connections or IO operations.
50
+
If your client application is hosted on Kubernetes, check whether the cluster nodes or the pod running the client application are under memory, CPU, or network pressure. A pod running the client application can be affected by other pods running on the same node and might throttle Redis connections or IO operations.
51
51
52
-
If you're using _Istio_ or any other service mesh, make sure that your service mesh proxy reserves port 13000-13019 or 15000-15019. Clients use these ports to communicate with nodes in a clustered Azure Redis cache, and could cause connectivity issues on those ports.
52
+
If you're using _Istio_ or any other service mesh, make sure that your service mesh proxy reserves ports `13000-13019` or `15000-15019`. Clients use these ports to communicate with nodes in a clustered Azure Redis cache, and could cause connectivity issues on those ports.
53
53
54
54
### Linux-based client application
55
55
@@ -69,25 +69,27 @@ If your application can't connect to your Azure Redis cache at all, some cache c
69
69
70
70
### Firewall rules
71
71
72
-
If you have a firewall configured for your Azure Cache for Redis, ensure that your client IP address is added to the firewall rules. On the Azure portal page for your cache, check**Firewall** under **Settings** in the left navigation menu.
72
+
If you have a firewall configured for your Azure Redis cache, ensure that your client IP address is added to the firewall rules. To check the firewall rules, select**Firewall** under **Settings** in the left navigation menu for your cache page.
73
73
74
-
If you use a third-party firewall or proxy in your network, make sure they allow the Azure Cache for Redis endpoint `*.redis.cache.windows.net` and the ports `6379` and `6380`. You might need to allow more ports when you use a clustered cache or geo-replication.
74
+
#### Third-party firewall or external proxy
75
+
76
+
If you use a third-party firewall or proxy in your network, make sure they it allows the Azure Cache for Redis endpoint `*.redis.cache.windows.net` and the ports `6379` and `6380`. You might need to allow more ports when you use a clustered cache or geo-replication.
75
77
76
78
### Private endpoint configuration
77
79
78
-
Check your private endpoint configuration as follows:
80
+
In the Azure portal, check your private endpoint configuration by selecting **Private Endpoint** under **Settings** in the left navigation menu for your cache.
79
81
80
-
-Ensure that**Public Network Access**is set correctly. In the Azure portal, select **Private Endpoint** in the left navigation menu for your cache.
82
+
-On the**Private Endpoint**page, ensure that **Enable public network access** is set correctly.
81
83
82
84
- Public network access is disabled by default when you create a private endpoint.
83
-
- To connect to your cache private endpoint from outside your cache virtual network, you must enable **Public Network Access**.
84
-
- If you delete your private endpoint, make sure to enable public network access.
85
+
- To connect to your cache private endpoint from outside your cache virtual network, you must enable public network access.
86
+
- If you delete your private endpoint, be sure to enable public network access.
85
87
86
-
-Make sure your private endpoint is configured correctly. For more information, see [Create a private endpoint with a new Azure Cache for Redis instance](cache-private-link.md#create-a-private-endpoint-with-a-new-azure-cache-for-redis-instance).
88
+
-Select the link under **Private endpoint** and make sure your private endpoint is configured correctly. For more information, see [Create a private endpoint with a new Azure Cache for Redis instance](cache-private-link.md#create-a-private-endpoint-with-a-new-azure-cache-for-redis-instance).
87
89
88
-
- Make sure your application connects to `<cachename>.redis.cache.windows.net` on port 6380. Avoid using `<cachename>.privatelink.redis.cache.windows.net` in the configuration or the connection string.
90
+
- Make sure your application connects to `<cachename>.redis.cache.windows.net` on port `6380`. Avoid using `<cachename>.privatelink.redis.cache.windows.net` in the configuration or the connection string.
89
91
90
-
- To verify that a command resolves to the private IP address for the cache, run a command like `nslookup <hostname>` from within the virtual network that's linked to the private endpoint.
92
+
- To verify that a command resolves to the private IP address for the cache, run a command like `nslookup <hostname>` from within the virtual network linked to the private endpoint.
91
93
92
94
### Public IP address change
93
95
@@ -104,13 +106,13 @@ Check your virtual network configuration as follows:
104
106
105
107
For more information, see [Configure virtual network support for a Premium Azure Cache for Redis instance](cache-how-to-premium-vnet.md).
106
108
107
-
#### Geo-replication issues using virtual network injection with Premium caches
109
+
#### Geo-replication using VNet injection with Premium caches
108
110
109
-
Geo-replication between caches in the same virtual network is supported. Geo-replication between caches in different virtual networks is also supported, with the following caveats:
111
+
Geo-replication between caches in the same virtual network is supported. Geo-replication between caches in different virtual networks is supported with the following caveats:
110
112
111
113
- If the virtual networks are in the same region, you can connect them using [virtual network peering](/azure/virtual-network/virtual-network-peering-overview) or a [VPN Gateway VNet-to-VNet connection](/azure/vpn-gateway/vpn-gateway-howto-vnet-vnet-resource-manager-portal).
112
114
113
-
- If the virtual networks are in different regions, geo-replication using virtual network peering isn't supported. A client virtual machine in VNet 1 (region 1) can't access a cache in VNet 2 (region 2) by using its DNS name because of a constraint with Basic internal load balancers. Instead, use a VPN Gateway VNet-to-VNet connection. For more information about virtual network peering constraints, see [Virtual Network peering requirements and constraints](/azure/virtual-network/virtual-network-manage-peering#requirements-and-constraints).
115
+
- If the virtual networks are in different regions, geo-replication using virtual network peering isn't supported. A client virtual machine in `VNet 1` (region 1) can't access a cache in `VNet 2` (region 2) by using its name, because of a constraint with Basic internal load balancers. Instead, use a VPN Gateway VNet-to-VNet connection. For more information about virtual network peering constraints, see [Virtual Network peering requirements and constraints](/azure/virtual-network/virtual-network-manage-peering#requirements-and-constraints).
114
116
115
117
To configure your virtual network effectively and avoid geo-replication issues, you must configure both the inbound and outbound ports correctly. For more information on avoiding the most common virtual network misconfiguration issues, see [Geo-replication peer port requirements](cache-how-to-premium-vnet.md#geo-replication-peer-port-requirements).
0 commit comments