Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
In this article, we provide troubleshooting help for connecting your client application to Azure Managed Redis. Connectivity issues are divided into two types: intermittent connectivity issues and continuous connectivity issues.
Your client application might have intermittent connectivity issues caused by events such as patching, or spikes in the number of connections.
Sometimes, your cache undergoes a planned or an unplanned server maintenance. Your application can be negatively affected during the maintenance. To minimize the effects of failovers, see Connection resilience.
Check if the Max aggregate for Connected Clients metric is close or higher than the maximum number of allowed connections for a particular cache size. For more information on sizing per client connections, see Azure Managed Redis pricing.
- If your client application is hosted on Kubernetes, check that the pod running the client application or the cluster nodes aren't under memory/CPU/Network pressure. A pod running the client application can be affected by other pods running on the same node and throttle Redis connections or IO operations.
Using optimistic TCP settings in Linux might cause client applications to experience connectivity issues. See Connection stalls lasting for 15 minutes.
If your application can't connect to your Azure Managed Redis instance, it's possible some configuration on the cache isn't set up correctly. The following sections offer suggestions on how to make sure your cache is configured correctly.
Test connectivity using redis-cli. For more information on CLI, Use the Redis command-line tool with Azure Managed Redis.
If redis-cli is unable to connect, you can test connectivity using PSPING in PowerShell.
psping -q <cache DNS endpoint>:<Port Number>
You can confirm the number of sent packets is equal to the received packets. Confirming ensures no drop in connectivity.
Steps to check your private endpoint configuration:
Verify if your private endpoint is configured correctly. For more information, see Create a private endpoint with a new Azure Managed Redis instance.
Verify if your application is connecting to
<instancename>.<region>.redis.chinacloudapi.cnon port 10000. We recommend avoiding the use of<instancename>.<region>.privatelink.redis.cache.chinacloudapi.cnin the configuration or the connection string.Run a command like
nslookup <hostname>from within the VNet that is linked to the private endpoint to verify that the command resolves to the private IP address for the cache.Public Network Accessis currently not supported for Azure Managed Redis. You cannot connect to your cache private endpoint from outside the virtual network of your cache.
If you have a firewall configured for your Azure Managed Redis, ensure that your client IP address is added to the firewall rules. You can check Firewall on the Resource menu under Settings on the Azure portal.
When you use a third-party firewall or proxy in your network, check that the endpoint for Azure Managed Redis, *.redis.chinacloudapi.cn, is allowed along with the port 10000. You might need to allow more ports when using a clustered cache or geo-replication.
If you've configured any networking or security resource to use your cache's public IP address, check to see if your cache's public IP address changed. For more information, see Rely on hostname not public IP address for your cache.