Skip to content

Commit 0b6e962

Browse files
ldecarvalho-docldecarvalho-doc
committed
fix(red): add ts pages
1 parent 117bb5d commit 0b6e962

File tree

8 files changed

+318
-7
lines changed

8 files changed

+318
-7
lines changed

‎menu/navigation.json‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2329,6 +2329,24 @@
23292329
],
23302330
"label": "Additional Content",
23312331
"slug": "reference-content"
2332+
},
2333+
{
2334+
"items": [
2335+
{
2336+
"label": "Dealing with Database Instance unavailability",
2337+
"slug": "database-instance-unavailable"
2338+
},
2339+
{
2340+
"label": "Dealing with Database Instance connectivity issues",
2341+
"slug": "database-instance-connectivity-issues"
2342+
},
2343+
{
2344+
"label": "Dealing with Database Instance performance issues",
2345+
"slug": "database-instance-performance-issues"
2346+
}
2347+
],
2348+
"label": "Troubleshooting",
2349+
"slug": "troubleshooting"
23322350
}
23332351
],
23342352
"label": "Managed Databases for Redis™",

‎pages/managed-databases-for-postgresql-and-mysql/troubleshooting/database-instance-connectivity-issues.mdx‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ meta:
55
content:
66
h1: Dealing with Database Instance connectivity issues
77
paragraph: Troubleshoot Database Instance connectivity issues for Managed Databases for MySQL and PostgreSQL.
8-
tags: disk-full databases
8+
tags: connectivity databases
99
dates:
1010
validation: 2025-01-29
1111
posted: 2025-01-29
@@ -145,5 +145,5 @@ Run the script in a terminal:
145145
```
146146
export INSTANCE_IP=<xxx.xxx.xxx.xxx>
147147
export INSTANCE_PORT=<xxxxx>
148-
./troubleshoot.sh
148+
./rdb_troubleshoot.sh
149149
```

‎pages/managed-databases-for-postgresql-and-mysql/troubleshooting/database-instance-performance-issues.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ meta:
55
content:
66
h1: Dealing with Database Instance performance issues
77
paragraph: Troubleshoot Database Instance performance issues in Managed Databases for MySQL and PostgreSQL.
8-
tags: disk-full databases
8+
tags: databases performance
99
dates:
1010
validation: 2025-01-29
1111
posted: 2025-01-29

‎pages/managed-databases-for-postgresql-and-mysql/troubleshooting/database-instance-unavailable.mdx‎

Lines changed: 22 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -14,21 +14,39 @@ categories:
1414
- postgresql-and-mysql
1515
---
1616

17-
## Problem
17+
## My Database Instance is unavailable
18+
19+
### Problem
1820

1921
My Database Instance is unavailable.
2022

21-
## Possible causes
23+
### Possible causes
2224

2325
- High data loads
2426
- High incoming traffic from specific apps or websites
2527

26-
## Solution
28+
### Solution
2729

2830
You can monitor your Database Instance activity to be able to quickly identify and act on irregular activities that might be causing the instability/unavailability.
2931

3032
[Monitor usage metrics on Cockpit](/managed-databases-for-postgresql-and-mysql/how-to/monitor-databases-cockpit) to:
3133

3234
- Check if the usage is regular. Database Instance can be impacted by high data loads or unexpected high traffic from an app or website, for example
3335
- Check if there are slow queries in the Database Instance log. Huge or sub-optimized queries can fill up all the memory and trigger OOM kills
34-
- Check the Database Instance logs for any unusual or suspicious activity
36+
- Check the Database Instance logs for any unusual or suspicious activity
37+
38+
## My Database Instance is in a stuck state
39+
40+
### Problem
41+
42+
My Database Instance is currently in a stuck state.
43+
44+
### Possible causes
45+
46+
- A maintenance operation on Scaleway's side is taking longer than usual and timed out, making the Database Instance go into a transitional state
47+
48+
### Solution
49+
50+
If the Database Instance is sent to a transitional state, the Scaleway Databases team receives an alert and will act on the issue as soon as possible.
51+
52+
If you observe the resolution is taking longer than usual, [create a support ticket](/account/how-to/open-a-support-ticket/#writing-an-effective-subject-and-description) to let us know.

‎pages/managed-databases-for-redis/troubleshooting/database-instance-connectivity-issues.mdx‎

Lines changed: 149 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,149 @@
1+
---
2+
meta:
3+
title: Dealing with Redis™ Database Instance connectivity issues
4+
description: Troubleshoot Database Instance connectivity issues for Managed Databases for Redis™.
5+
content:
6+
h1: Dealing with Redis™ Database Instance connectivity issues
7+
paragraph: Troubleshoot Database Instance connectivity issues for Managed Databases for Redis™.
8+
tags: disk-full databases
9+
dates:
10+
validation: 2025-02-12
11+
posted: 2025-02-12
12+
categories:
13+
- managed-databases
14+
- redis
15+
---
16+
17+
## Public access
18+
19+
### Problem
20+
21+
I cannot connect to my Redis™ Database Instance through the public network.
22+
23+
### Possible causes
24+
25+
- The Database Instance TLS certificate is outdated
26+
- Your allowed IPs are not properly configured
27+
- You have reached the maximum number of connections
28+
- The Database Instance is experiencing instabilities due to a high load
29+
30+
### Solution
31+
32+
You can check the following points to identify and act on what might be causing the issue:
33+
34+
1. If TLS is enabled on the Database Instance, make sure the certificate is up to date and that your client application is properly configured.
35+
2. Make sure your [ACLs](/managed-databases-for-redis/concepts/#allowed-ips) are [properly configured](/managed-databases-for-redis/how-to/manage-allowed-ip-addresses-redis).
36+
3. Make sure your Database Instance has not reached the maximum number of connections stipulated in the advanced settings of the Database Instance. You can monitor the number of connections on Cockpit. You can also [adjust the advanced settings](/managed-databases-for-redis/how-to/configure-advanced-settings-redis) to accept a higher number of connections.
37+
4. [Monitor other usage metrics on Cockpit](/managed-databases-for-postgresql-and-mysql/how-to/monitor-databases-cockpit) to:
38+
39+
- Check if the memory usage is nominal. High memory usage could trigger OOM Kills and cause disconnection
40+
- Check Database Instance logs and look for anything else that could explain the issue
41+
42+
## Private access
43+
44+
### Problem
45+
46+
I cannot connect to my Database Instance through a Private Network.
47+
48+
### Possible causes
49+
50+
- The Database Instance TLS certificate is outdated
51+
- Client network issue
52+
- You have reached the maximum number of connections
53+
- The Database Instance is experiencing instabilities due to a high load
54+
55+
### Solution
56+
57+
You can carry out the following actions:
58+
59+
1. Try to connect to the Database Instance from the public endpoint, if one is available, to identify the possible origin (network or instance). This information can help you or the support team to identify the issue.
60+
2. [Use Cockpit](/managed-databases-for-redis/how-to/monitor-databases-cockpit) to check database logs and look for any activity or behavior that could explain the issue.
61+
3. Create a support ticket if the first two steps do not help troubleshoot the issue. In the body of the ticket, make sure you provide:
62+
63+
- The resource ID of resource from which the connection was attempted
64+
- The output of the `redis_troubleshoot.sh` script, indicated below. Make sure you execute the script on the machine from which the connection was attempted.
65+
66+
#### Database Instance connectivity check script
67+
68+
`redis_troubleshoot.sh`:
69+
70+
```sh
71+
#!/bin/bash
72+
73+
set -o nounset
74+
75+
if [ -z "$INSTANCE_IP" ]; then
76+
echo "INSTANCE_IP is a mandatory environment variable."
77+
echo "e.g. export INSTANCE_IP=<xxx.xxx.xxx.xxx>"
78+
exit 1
79+
fi
80+
81+
if [ -z "$INSTANCE_PORT" ]; then
82+
echo "INSTANCE_PORT is a mandatory environment variable."
83+
echo "e.g. export INSTANCE_PORT=<xxxxx>"
84+
exit 1
85+
fi
86+
87+
function header() {
88+
echo -e "\n # ${1}"
89+
echo -e "---------------------------------\n"
90+
}
91+
92+
echo -e "\nREDIS troubleshooting script\nThis script will run for several minutes to get enough information."
93+
header "Host information"
94+
if ! [ -x "$(command -v uname)" ]; then
95+
echo 'Skipped: uname command is not availabe.'
96+
else
97+
uname -a
98+
fi
99+
100+
header "Host connectivity check"
101+
if ! [ -x "$(command -v ping)" ]; then
102+
echo 'Skipped: ping command is not availabe.'
103+
else
104+
ping -c 5 ${INSTANCE_IP}
105+
fi
106+
107+
header "Database connectivity check"
108+
if ! [ -x "$(command -v telnet)" ]; then
109+
# try to fallback on curl telnet
110+
if ! [ -x "$(command -v curl)" ]; then
111+
echo "Skipped: neither telnet nor curl command are availabe."
112+
else
113+
echo "(using curl)"
114+
timeout 2 curl -v telnet://$INSTANCE_IP:$INSTANCE_PORT
115+
fi
116+
else
117+
echo "(using telnet)"
118+
echo -n | telnet ${INSTANCE_IP} ${INSTANCE_PORT}
119+
fi
120+
121+
header "Ip configuration check"
122+
if ! [ -x "$(command -v ip)" ]; then
123+
echo 'Skipped: ip command is not availabe.'
124+
else
125+
echo -e "Interfaces:\n- \n"
126+
ip a
127+
echo -e "\nNeighbour:\n- \n"
128+
129+
TEST_ITERATION=30
130+
TEST_INTERVAL=10 # seconds
131+
132+
# Iterate a few times to try to catch relevant info
133+
for ((i=1;i<=$TEST_ITERATION;i++)); do
134+
echo -e "\nIteration $i:\n"
135+
ip neighbour show
136+
echo -e "\nWaiting ${TEST_INTERVAL}s...\n"
137+
sleep $TEST_INTERVAL
138+
done
139+
echo -e "\nRoute:\n-\n"
140+
ip route
141+
fi
142+
```
143+
Run the script in a terminal:
144+
145+
```
146+
export INSTANCE_IP=<xxx.xxx.xxx.xxx>
147+
export INSTANCE_PORT=<xxxxx>
148+
./redis_troubleshoot.sh
149+
```

‎pages/managed-databases-for-redis/troubleshooting/database-instance-performance-issues.mdx‎

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
---
2+
meta:
3+
title: Dealing with Database Instance performance issues
4+
description: Troubleshoot Database Instance performance issues in Managed Databases for Redis™.
5+
content:
6+
h1: Dealing with Database Instance performance issues
7+
paragraph: Troubleshoot Database Instance performance issues in Managed Databases for Redis™.
8+
tags: databases performance
9+
dates:
10+
validation: 2025-02-13
11+
posted: 2025-02-13
12+
categories:
13+
- managed-databases
14+
- redis
15+
---
16+
17+
## Problem
18+
19+
My Database Instance is not performing as expected.
20+
21+
## Possible causes
22+
23+
- High data loads
24+
- High incoming traffic from specific apps or websites
25+
- Huge or sub-optimized SQL queries
26+
27+
## Solution
28+
29+
You can [Monitor usage metrics on Cockpit](/managed-databases-for-redis/how-to/monitor-databases-cockpit) to check if the usage is nominal.
30+
31+
The Database Instance can be impacted by high data loads or unexpected high traffic from an app or website, for example. You can [scale up your Instance](/managed-databases-for-redis/how-to/scale-up-a-database-for-redis) if necessary.

‎pages/managed-databases-for-redis/troubleshooting/database-instance-unavailable.mdx‎

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
---
2+
meta:
3+
title: Dealing with Database Instance unavailability
4+
description: Troubleshoot Database Instance unavailability for Managed Databases for Redis™.
5+
content:
6+
h1: Dealing with Database Instance unavailability
7+
paragraph: Troubleshoot Database Instance unavailability for Managed Databases for Redis™.
8+
tags: unavailability databases
9+
dates:
10+
validation: 2025-02-17
11+
posted: 2025-02-17
12+
categories:
13+
- managed-databases
14+
- redis
15+
---
16+
17+
## Problem
18+
19+
My Database Instance is unavailable.
20+
21+
## Possible causes
22+
23+
- High data loads
24+
- High incoming traffic from specific apps or websites
25+
26+
## Solution
27+
28+
You can monitor your Database Instance activity to be able to quickly identify and act on irregular activities that might be causing the instability/unavailability.
29+
30+
[Monitor usage metrics on Cockpit](/managed-databases-for-redis/how-to/monitor-databases-cockpit) to:
31+
32+
- Check if the usage is regular. Database Instance can be impacted by high data loads or unexpected high traffic from an app or website, for example
33+
- Check the Database Instance logs for any unusual or suspicious activity

‎pages/managed-databases-for-redis/troubleshooting/index.mdx‎

Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
---
2+
meta:
3+
title: Managed Databases for Redis™
4+
description: Find troubleshooting resources for resolving issues with Managed Databases for Redis™.
5+
content:
6+
paragraph: Find troubleshooting resources for resolving issues with Managed Databases for Redis™.
7+
dates:
8+
posted: 2025-06-05
9+
categories:
10+
- managed-databases
11+
---
12+
13+
<ProductHeader
14+
productName="Managed Databases for Redis™ troubleshooting"
15+
productLogo="managedDatabase"
16+
description="Discover how to solve the most common issues in Scaleway Managed Databases for Redis™."
17+
/>
18+
19+
## Featured Pages
20+
21+
<Grid>
22+
<DefaultCard
23+
title="Managed Databases for Redis™ FAQ"
24+
description="General info on Managed Databases"
25+
url="/managed-databases-for-postgresql-and-mysql/faq/"
26+
label="See more"
27+
/>
28+
<DefaultCard
29+
title="How to connect to a Redis™ Database Instance"
30+
description="Connect to a Redis™ Instance"
31+
url="/managed-databases-for-redis/how-to/connect-to-redis-database-instance"
32+
label="See more"
33+
/>
34+
<DefaultCard
35+
title="Security and Reliability"
36+
description="Best practices for security"
37+
url="/managed-databases-for-postgresql-and-mysql/reference-content/security-and-reliability/"
38+
label="See more"
39+
/>
40+
</Grid>
41+
<Grid>
42+
<DefaultCard
43+
title="Ensuring data persistance"
44+
description="Learn more about data persistance in Redis™"
45+
url="/managed-databases-for-postgresql-and-mysql/reference-content/postgresql-extensions/"
46+
label="See more"
47+
/>
48+
<DefaultCard
49+
title="Understanding default user permissions"
50+
description="Learn more about user permissions"
51+
url="/managed-databases-for-redis/reference-content/default-user-permissions"
52+
label="See more"
53+
/>
54+
</Grid>
55+
56+
## Managed Databases for Redis™ troubleshooting pages
57+
58+
- [Dealing with Database Instance unavailability](/managed-databases-for-redis/troubleshooting/database-instance-unavailable/)
59+
- [Dealing with Database Instance connectivity issues](/managed-databases-for-redis/troubleshooting/database-instance-connectivity-issues/)
60+
- [Dealing with Database Instance performance issues](/managed-databases-for-redis/troubleshooting/database-instance-performance-issues/)
61+
62+

0 commit comments

Comments
 (0)