Skip to content

Commit 8a5f877

Browse files
RoRoJbene2k1jcirinosclwyldecarvalho-doc
committed
feat(lb): add troubleshooting (#4591)
* feat(lb): continue troubleshooting * feat(lb): add more troubleshooting * fix(lb): add troubleshooting * Update pages/load-balancer/troubleshooting/k8s-errors.mdx * Apply suggestions from code review Co-authored-by: Benedikt Rollik <[email protected]> Co-authored-by: Jessica <[email protected]> Co-authored-by: ldecarvalho-doc <[email protected]> * Update pages/load-balancer/troubleshooting/configuration.mdx * Apply suggestions from code review * fix(lb): add index and links --------- Co-authored-by: Benedikt Rollik <[email protected]> Co-authored-by: Jessica <[email protected]> Co-authored-by: ldecarvalho-doc <[email protected]>
1 parent a6e498a commit 8a5f877

File tree

8 files changed

+410
-4
lines changed

8 files changed

+410
-4
lines changed

menu/navigation.json

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3635,6 +3635,22 @@
36353635
},
36363636
{
36373637
"items": [
3638+
{
3639+
"label": "I am having problems configuring my Load Balancer",
3640+
"slug": "configuration"
3641+
},
3642+
{
3643+
"label": "I am experiencing connection problems and HTTP errors with my Load Balancer",
3644+
"slug": "http-connection-errors"
3645+
},
3646+
{
3647+
"label": "I am having problems with my Load Balancer's certificate",
3648+
"slug": "certificates"
3649+
},
3650+
{
3651+
"label": "I am experiencing problems with my Kubernetes Load Balancer",
3652+
"slug": "k8s-errors"
3653+
},
36383654
{
36393655
"label": "Load Balancer Limitations",
36403656
"slug": "load-balancer-limitations"

pages/load-balancer/how-to/add-certificate.mdx

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -200,4 +200,8 @@ Use the <Icon name="delete" /> button to delete unwanted certificates.
200200
If you have more than one certificate for your Load Balancer, it will automatically use the first in the list, regardless of its expiry date. Ensure that you delete any expired certificates, and that the current certificate you want to use is first in the list.
201201
</Message>
202202

203+
## Troubleshooting certificate problems
204+
205+
See our [dedicated troubleshooting documentation](/load-balancer/troubleshooting/certifiates/.)
206+
203207

pages/load-balancer/reference-content/kubernetes-load-balancer.mdx

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,7 @@ Full documentation for creating and configuring a Load Balancer for your cluster
2424
- [Managing Load Balancer IPs](/kubernetes/reference-content/managing-load-balancer-ips/)
2525
- [Using Load Balancer annotations](/kubernetes/reference-content/using-load-balancer-annotations/)
2626
- [Exposing a Kubernetes Kapsule ingress controller service with a Load Balancer](/kubernetes/reference-content/lb-ingress-controller/)
27+
- [Troubleshooting Kubernetes Load Balancers](/load-balancer/troubleshooting/k8s-errors/)
2728

2829
You may also find the following resources helpful:
2930

Lines changed: 84 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,84 @@
1+
---
2+
meta:
3+
title: I am having problems with my Load Balancer's certificate
4+
description: Troubleshoot errors that you may experience when creating an SSL/TLS certificate, adding it to your Load Balancer frontend, or successfully handling HTTPS connections.
5+
content:
6+
h1: I am having problems with my Load Balancer's certificate
7+
paragraph: Troubleshoot errors that you may experience when creating an SSL/TLS certificate, adding it to your Load Balancer frontend, or successfully handling HTTPS connections.
8+
tags: load-balancer certificate ssl tls dns
9+
dates:
10+
validation: 2025-03-10
11+
posted: 2025-03-10
12+
categories:
13+
- network
14+
---
15+
16+
## I'm experiencing DNS errors when adding an SSL/TLS certificate
17+
18+
You may be trying to [create or upload](/load-balancer/how-to/add-certificate/) a certificate for your Load Balancer, and receive the following error message:
19+
20+
```
21+
invalid argument(s): dns_name does not respect constraint, <domain> does not resolve to your Load Balancer IP
22+
```
23+
24+
### Cause
25+
26+
The domain name specified does not resolve to the Load Balancer's public IP address.
27+
28+
### Solution
29+
30+
Try the following steps:
31+
32+
- Ensure that a DNS record exists, pointing this domain to the Load Balancer's public IP address.
33+
- Ensure that you have correctly typed the domain name, with no typos or errors.
34+
- If you created the DNS record very recently, DNS propagation might not yet be complete. Wait for 30-60 minutes and try again, to see if the issue resolves itself.
35+
- If you are trying to upload a custom certificate:
36+
- Check the certificate's validity dates and ensure it's not expired or not yet valid.
37+
- If the certificate has wildcards, ensure it covers the correct domain and subdomains. For example, if your certificate covers `*.example.com`, you can use it to secure `subdomain.example.com` but not `sub.subdomain.example.com`. Check the [IETF documentation](https://www.ietf.org/rfc/rfc2818.txt).
38+
- If the error persists, check the DNS entry using a tool like `dig`, to ensure it is resolving correctly.
39+
40+
41+
## I am experiencing HTTP errors when generating a Let's Encrypt SSL/TLS certificate
42+
43+
You may be trying to [generate a Let's Encrypt certificate](/load-balancer/how-to/add-certificate/#how-to-generate-and-add-a-lets-encrypt-certificate) for your Load Balancer, and receive the following error message:
44+
45+
```
46+
HTTP error 400: The port 80 frontend must be associated to an HTTP backend
47+
```
48+
49+
### Cause
50+
51+
Let's Encrypt certificates cannot be created for Load Balancers which have a frontend listening on port 80, but are attached to a **TCP** backend. This is because the Let's Encrypt challenge would fail.
52+
53+
### Solution:
54+
55+
Ensure that your Load Balancer has either:
56+
- An HTTP-protocol-backend attached to a frontend listening on port 80, or
57+
- A TCP-protocol-backend attached to a frontend listening on a port other than 80
58+
59+
Alternatively, create and import your own [custom certificate](/load-balancer/how-to/add-certificate/#how-to-import-a-certificate) for your Load Balancer, rather than generating a Let's Encrypt certificate via Scaleway.
60+
61+
## I added a certificate to my Kubernetes Load Balancer via the Scaleway console, but it is not working correctly
62+
63+
You may have used the Scaleway console attach a certificate to your Kubernetes Kapsule Load Balancer, and then find that the SSL certificate does not work as expected afterwards, with connections lost and HTTPS traffic dropped.
64+
65+
### Cause
66+
67+
Kubernetes Kapsule is a managed service, as are the Load Balancers created as part of the cluster.
68+
Modifying a Kubernetes Load Balancer via the Scaleway console results in non-permanent modifications which are not known to the Kubernetes Kapsule service, and therefore end up being overwritten.
69+
70+
### Solution
71+
72+
Always modify Kubernetes Load Balancers via the cluster's Cloud Controller Manager (CCM), using [Load Balancer annotations](/kubernetes/reference-content/using-load-balancer-annotations/).
73+
74+
The specific annotation to use can be found in the [Scaleway CCM documentation](https://github.com/scaleway/scaleway-cloud-controller-manager/blob/master/docs/loadbalancer-annotations.md#servicebetakubernetesioscw-loadbalancer-certificate-ids).
75+
76+
77+
## I have a different problem related to my Load Balancer SSL/TLS certificate
78+
79+
Check the following documentation:
80+
81+
- [How to add an SSL/TLS certificate](/load-balancer/how-to/add-certificate/)
82+
- [Setting up SSL bridging, offloading or passthrough](/load-balancer/reference-content/ssl-bridging-offloading-passthrough/)
83+
- [Load Balancer API Documentation: Certificates](https://www.scaleway.com/en/developers/api/load-balancer/zoned-api/#path-certificate-get-an-ssltls-certificate)
84+
- [Load Balancer Terraform Documentation: Certificates](https://registry.terraform.io/providers/scaleway/scaleway/latest/docs/resources/lb_certificate)
Lines changed: 97 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,97 @@
1+
---
2+
meta:
3+
title: I am having problems configuring my Load Balancer
4+
description: Troubleshoot problems that you may experience when configuring your Load Balancer, such as adding backend servers, setting up Private Networks and dealing with security concerns.
5+
content:
6+
h1: I am having problems configuring my Load Balancer
7+
paragraph: Troubleshoot problems that you may experience when configuring your Load Balancer, such as adding backend servers, setting up Private Networks and dealing with security concerns.
8+
tags: load-balancer configuration backend server error security ip
9+
dates:
10+
validation: 2025-03-06
11+
posted: 2025-03-06
12+
categories:
13+
- network
14+
---
15+
16+
If your problem concerns any of the following, see our specific documentation pages:
17+
18+
- [Troubleshooting certificate configuration](/load-balancer/troubleshooting/certificates/)
19+
- [Setting up SSL bridging, offloading or passthrough](/load-balancer/reference-content/ssl-bridging-offloading-passthrough/)
20+
- [Troubleshooting connection and HTTP errors](/load-balancer/troubleshooting/http-connection-errors/)
21+
- General advice and help for configuring [frontends](/load-balancer/reference-content/configuring-frontends/), [backends](/load-balancer/reference-content/configuring-backends/) and [health checks](/load-balancer/reference-content/configuring-health-checks/)
22+
- [Creating and configuring a Kubernetes Load Balancer](/kubernetes/reference-content/kubernetes-load-balancer/)
23+
24+
## When adding a backend server to my Load Balancer, I get the message: IP is not owned by Scaleway
25+
26+
You may be trying to [add a backend server](/load-balancer/how-to/create-frontends-backends/#configuring-traffic-management) to your Load Balancer's backend, and experience the following error:
27+
28+
`HTTP 404: IP not owned by Scaleway`
29+
30+
### Cause
31+
32+
You are trying to add the IP address of a backend server that is not owned by Scaleway (i.e. is not a Scaleway resource such as an Instance, Elastic Metal server or Managed Database).
33+
34+
### Solution
35+
36+
Only certain Load Balancer types (L and XL) allow you to add non-Scaleway resources as backend servers. This is indicated as "Multi-cloud provider" compatibility in the [Load Balancer creation form](https://console.scaleway.com/load-balancer/lbs/create).
37+
38+
Either:
39+
40+
- [Resize](/load-balancer/how-to/resize-lb/) your Load Balancer to a type that is compatible with multi-cloud backend servers, or
41+
- Use only Scaleway resources as backend servers for your Load Balancer
42+
43+
## When adding a backend server via its private IP address, I get the message: IP doesn't exist
44+
45+
You may be trying to [add a backend server](/load-balancer/how-to/create-frontends-backends/#configuring-traffic-management) to your Load Balancer's backend using the server's private IP address, and experience an error message saying that the IP doesn't exist.
46+
47+
### Cause
48+
49+
You are entering an incorrect IP address for your resource, or using private IP address that is outside the standard range for private networks.
50+
51+
### Solution
52+
53+
- Check that you are entering the correct [private IP address](/vpc/how-to/attach-resources-to-pn/#how-to-view-the-resources-ip-address) for your resource, and that it is attached to the same Private Network as the Load Balancer.
54+
- Verify that you are using a private IP address that is within the standard ranges used for private networks as described in [RFC1918](https://en.wikipedia.org/wiki/Private_network#Private_IPv4_addresses). Only IP addresses from within one of these ranges are supported by Scaleway Load Balancer.
55+
56+
57+
## My Load Balancer's Elastic Metal backend servers added via private IPs are all down
58+
59+
You may add Elastic Metal backend servers to your Load Balancer using their private IP address, and find they are marked as `DOWN` as soon as you add them. You are unable to work out why they are failing their health checks.
60+
61+
### Cause
62+
63+
The Load Balancer is unable to successfully communicate with the Elastic Metal backend servers over the Private Network, resulting in failed health checks.
64+
65+
### Solution
66+
67+
- Check that your health checks and backend servers are correctly configured to work together.
68+
- Check that you have entered the correct [private IP address](/vpc/how-to/attach-resources-to-pn/#how-to-view-the-resources-ip-address) for your Elastic Metal server, and that it is attached to the same Private Network as the Load Balancer.
69+
- Elastic Metal servers require additional manual configuration of their network interface, unlike Instances and other resource types. Ensure you have [followed the necessary configuration steps](/elastic-metal/how-to/use-private-networks/#how-to-configure-the-network-interface-on-your-elastic-metal-server-for-private-networks).
70+
71+
72+
## My Load Balancer's IP address is appearing in the backend application's logs, instead of the real client IP address.
73+
74+
You may find that as requests are passed from the client, through the Load Balancer, to your backend servers, that the client's original IP address is replaced with the Load Balancer's IP address in your backend application's logs. This is problematic if you need the original IP address for localization, security or other purposes.
75+
76+
### Cause
77+
78+
Proxy Protocol has not been activated on your Load Balancer, meaning that information about the original client's connection is not being passed through to the backend servers.
79+
80+
### Solution
81+
82+
Activate [Proxy Protocol](/load-balancer/reference-content/configuring-backends/#proxy-protocol) on your Load Balancer, and ensure that your backend server is [correctly configured](/tutorials/proxy-protocol-v2-load-balancer/) to handle this protocol.
83+
84+
## Security rules are not being applied as expected, and I am having difficulties in filtering incoming traffic through my Load Balancer
85+
86+
You may find that traffic is not being filtered as expected via your Load Balancer, and that Instances in your backend are not dropping unauthorized traffic as expected.
87+
88+
### Cause
89+
90+
Instance security groups and/or Load Balancer ACLs are incorrectly configured.
91+
92+
### Solution
93+
94+
Instance [security groups](instances/how-to/use-security-groups/) should still filter public traffic arriving on your backend server Instances, as long as that traffic is arriving over the public interface. This means the Instance in question must be attached to the Load Balancer via its public IP and not any private IP.
95+
- Ensure that your Instance is attached via its public IP address. If your Instance behind a Load Balancer is attached via a private IP address, the security group rules will not be applied.
96+
- Double check your [security group rules](/instances/how-to/use-security-groups/#how-to-choose-security-group-settings), to verify that they correspond to the required ports, protocols, and IP addresses configured for your Load Balancer
97+
- To filter incoming traffic to your backend servers **as it passes through the Load Balancer**, use [Load Balancer ACLs](/load-balancer/how-to/create-manage-acls/).
Lines changed: 75 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,75 @@
1+
---
2+
meta:
3+
title: I am experiencing connection problems and HTTP errors with my Load Balancer
4+
description: Troubleshoot connection problems and HTTP errors that you may experience when accessing applications served via your Load Balancer. Learn how to resolve common problems and get your application back up and running.
5+
content:
6+
h1: I am experiencing connection problems and HTTP errors with my Load Balancer
7+
paragraph: Troubleshoot connection problems and HTTP errors that you may experience when accessing applications served via your Load Balancer. Learn how to resolve common problems and get your application back up and running.
8+
tags: load-balancer http-errors bad-request
9+
dates:
10+
validation: 2025-03-06
11+
posted: 2025-03-06
12+
categories:
13+
- network
14+
---
15+
16+
You may experience connection problems and HTTP errors when attempting to connect to an application served via your Load Balancer.
17+
18+
This page helps you find solutions to some of these most common errors.
19+
20+
## I am getting a 400 Bad Request error when accessing my application through my Load Balancer
21+
22+
You may find that when attempting to connect to the domain linked to your Load Balancer / the application being served by your backend servers, you receive a `400 Bad Request` error.
23+
24+
### Cause
25+
26+
400 Bad Request errors occur when the backend servers cannot process a request due to client-side issues, or an incompatibility in the way that requests are passed through the Load Balancer and received by the backend server.
27+
28+
### Solutions
29+
30+
- Try accessing your application directly, and not through your Load Balancer, to eliminate the possibility that the problem does not come from the Load Balancer. Use a tool such as `cURL` or Postman to compare headers and body content to check how the Load Balancer is modifying requests.
31+
- Check your Load Balancer's [Grafana dashboard](/load-balancer/how-to/monitor-lb-cockpit/) for any additional information about the way the request was handled.
32+
- Verify your certificate and [SSL bridging/offloading/passthrough](/load-balancer/reference-content/ssl-bridging-offloading-passthrough/) settings. For example, if SSL is terminated at the Load Balancer, but the backend expects HTTPS, requests may be rejected.
33+
- Check if [Proxy Protocol](load-balancer/reference-content/configuring-backends/#proxy-protocol) is enabled on your Load Balancer. If your backend server is not configured to handle Proxy Protocol headers correctly, it may reject the requests. Try [disabling Proxy Protocol](/load-balancer/how-to/manage-frontends-and-backends/#how-to-edit-backends-and-health-checks) on your Load Balancer to see if it resolves the issue. If the issue is resolved when Proxy Protocol is disabled, [ensure your backend server is correctly configured for Proxy Protocol](/tutorials/proxy-protocol-v2-load-balancer/) before re-enabling.
34+
35+
## I am getting a 503 Service Unavailable error when trying to access my application through my Load Balancer
36+
37+
You may find that when attempting to connect to the domain linked to your Load Balancer / the application being served by your backend servers, you receive a `503 Service Unavailable` error.
38+
39+
### Cause
40+
41+
503 Service Unavailable errors occur when backend servers are unable to handle requests due to overload or maintenance issues. It indicates that the server cannot currently fulfill the request, but may be able to in the future.
42+
43+
### Solutions
44+
45+
- Check the health of your backend servers. If the servers are failing their health checks, this is likely to be the reason for the error. Investigate the reason for the failing health check, and reconfigure your server or [health check settings](/load-balancer/reference-content/configuring-health-checks/) as necessary.
46+
- Check that your Load Balancer is not exceeding its bandwidth. Each Load Balancer type has a [maximum bandwidth](https://www.scaleway.com/en/pricing/network/#load-balancer) it can handle. If you are exceeding this bandwidth, a 503 error is likely. [Check your Load Balancer's metrics](/load-balancer/how-to/monitor-lb-cockpit/), and [resize your Load Balancer](/load-balancer/how-to/resize-lb/) if necessary.
47+
- Check your Load Balancer's [backend protection settings](/load-balancer/reference-content/configuring-backends/#backend-protection), and compare with [Cockpit data](/load-balancer/how-to/monitor-lb-cockpit/). If backend protection compared to request/connection volume is set in such a way that all backend servers are becoming overloaded, you may need to add additional backend servers or adjust your backend protection settings.
48+
49+
50+
## I am getting SSL protocol errors when trying to access my application through my Load Balancer
51+
52+
You may find that when attempting to connect to the domain linked to your Load Balancer / the application being served by your backend servers, you receive an error similar to one of the following
53+
54+
```
55+
ERR_SSL_PROTOCOL_ERROR
56+
```
57+
58+
```
59+
SSL_ERROR_PROTOCOL_VERSION_ALERT
60+
```
61+
62+
```
63+
This site can't provide a secure connection
64+
OpenSSL/3.0.14: error:0A00010B:SSL routines::wrong version number
65+
```
66+
67+
### Cause
68+
69+
There is a mismatch between the SSL/TLS protocol versions or configurations between the client and the Load Balancer / its backend servers. This can prevent you from being able to establish a secure connection to your application.
70+
71+
### Solution
72+
73+
- Check that the client or backend servers are not using older SSL protocols such as SSLv2 or SSLv3, which are considered insecure.
74+
- Ensure that you have correctly configured [SSL bridging, offloading or passthrough](/load-balancer/reference-content/ssl-bridging-offloading-passthrough/) on your Load Balancer, depending on your use case.
75+
- Ensure that you have not confused activation of the [Proxy Protocol](/load-balancer/reference-content/configuring-backends/#proxy-protocol) setting as anything to do with SSL bridging, offloading or passthrough, as it is unrelated.

0 commit comments

Comments
 (0)