diff --git a/.github/vale/dicts/aiven.dic b/.github/vale/dicts/aiven.dic index c951e6ba74..496de859ee 100644 --- a/.github/vale/dicts/aiven.dic +++ b/.github/vale/dicts/aiven.dic @@ -197,6 +197,7 @@ rebalance rebalances rebalancing Redis +redis_timeout Redli refcard reindex @@ -244,6 +245,7 @@ subprocesses subtab syslog TaskManager +Tcpdump Telegraf Tenant Terraform @@ -269,6 +271,7 @@ VMs VPC/MS VNet wget +Wireshark Workbench Worldmap worldPing diff --git a/_toc.yml b/_toc.yml index 86b380e27d..afc14ded23 100644 --- a/_toc.yml +++ b/_toc.yml @@ -1295,7 +1295,12 @@ entries: entries: - file: docs/products/redis/reference/advanced-params title: Advanced parameters - + - file: docs/products/redis/troubleshooting + title: Troubleshooting + entries: + - file: docs/products/redis/troubleshooting/troubleshoot-redis-connection-issues + title: Troubleshoot connection issues + # -------- SUPPORT -------- - file: docs/platform/howto/list-support title: Support @@ -1305,7 +1310,7 @@ entries: title: Upgrade your support tier - file: docs/platform/concepts/service-level-agreement - file: docs/platform/concepts/beta_services - + # -------- COMMUNITY -------- - file: docs/community title: Community diff --git a/docs/products/redis/troubleshooting.rst b/docs/products/redis/troubleshooting.rst new file mode 100644 index 0000000000..ae3600e68a --- /dev/null +++ b/docs/products/redis/troubleshooting.rst @@ -0,0 +1,3 @@ +Troubleshooting common issues +============================= +.. tableofcontents:: \ No newline at end of file diff --git a/docs/products/redis/troubleshooting/troubleshoot-redis-connection-issues.rst b/docs/products/redis/troubleshooting/troubleshoot-redis-connection-issues.rst new file mode 100644 index 0000000000..03b4c58688 --- /dev/null +++ b/docs/products/redis/troubleshooting/troubleshoot-redis-connection-issues.rst @@ -0,0 +1,21 @@ +Troubleshoot Redis®* connection issues +###################################### + +Discover troubleshooting techniques for your Redis®* service and check out how to resolve common connection issues. + +Important notes +--------------- +By default :doc:`Aiven for Redis® uses SSL connections` and these connections are closed automatically after 12 hours. This is not a parameter that can be changed. Aiven also sets the ``redis_timeout`` advanced parameter to 300 seconds by default. + +Some Redis®* connections are closed intermittently +-------------------------------------------------- +When experiencing connection issues with your Redis®* service, here are some common things to check: +- Some Redis®* clients do not support SSL connections. It is recommended to check the documentation for the Redis®* client being used to ensure SSL connections are supported. +- If you are noticing older connections terminating, you should check to see what the value is configured for the :doc:`redis_timeout advanced parameter`. This parameter controls the timeout value for idle connections. Once the timeout is reached, the connection is terminated. + +Methods for troubleshooting connections +--------------------------------------- + +A great way to troubleshoot connection issues is to arrange for a packet capture to take place. This can be achieved with tools like `Tcpdump `_ and `Wireshark `_. This allows you to see if connections are making it outside your network to the Aiven for Redis®* instance. + +Another tool you can use to help diagnose connection issues is the Socket Statistics CLI tool which dumps socket statistics. \ No newline at end of file