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