From dc3ae6d7792a6b6dc4dbbeff6027aeb558a97c13 Mon Sep 17 00:00:00 2001 From: SamyOubouaziz Date: Tue, 15 Jul 2025 16:57:42 +0200 Subject: [PATCH 1/4] feat(srv): add troubleshooting pages MTA-5446 --- .../cannot-access-container.mdx | 42 +++++++++++++++++ .../troubleshooting/index.mdx | 2 + .../known-dns-containers-errors.mdx | 45 +++++++++++++++++++ 3 files changed, 89 insertions(+) create mode 100644 pages/serverless-containers/troubleshooting/cannot-access-container.mdx create mode 100644 pages/serverless-containers/troubleshooting/known-dns-containers-errors.mdx diff --git a/pages/serverless-containers/troubleshooting/cannot-access-container.mdx b/pages/serverless-containers/troubleshooting/cannot-access-container.mdx new file mode 100644 index 0000000000..c84a62a91b --- /dev/null +++ b/pages/serverless-containers/troubleshooting/cannot-access-container.mdx @@ -0,0 +1,42 @@ +--- +meta: + title: I cannot access my container + description: Troubleshoot issues encountered while accessing or connecting to your Scaleway Serverless Containers. +content: + h1: I cannot access my container + paragraph: Troubleshoot issues encountered while accessing or connecting to your Scaleway Serverless Containers. +tags: serverless containers troubleshooting issue error state unreachable connection log in access +dates: + validation: 2025-07-15 + posted: 2025-07-15 +categories: + - serverless +--- + +## Problem + +I am experiencing issues while accessing my Serverless Containers. + +## Possible causes + +- The container returns A DNS error or issue +- The container response time is abnormally long +- The container returns a `HTTP 5xx` error +- The container returns a `Could not resolve host` error +- The container is in an error state + +## Solutions + +- If you encounter a DNS issue, refer to the [dedicated troubleshooting page](/serverless-containers/troubleshooting/known-dns-containers-errors/). + +- For long response time, check: + - if the first instance of the container is currently starting, a [cold start](/serverless-containers/concepts/#cold-start) can appear + - if not, [check the metrics in Cockpit](/serverless-containers/how-to/monitor-container/) (especially CPU) and see if there is a high usage explaining the slow response + +- `HTTP 5XX` errors can come from the application itself. Check if you can reproduce locally with a dummy container, or if your application is not misbehaving. + +- A `Could not resolve host` error can indicate that you are trying to reach the container in IPv4 with its IPv6 address, or vice versa. This can also appear if there is a [DNS issue](/serverless-containers/troubleshooting/known-dns-containers-errors/). + +- If your container is in an `error` state: + - Refer to the [dedicated troubleshooting page](/serverless-containers/troubleshooting/container-error-state/). + - Check the `error_message` field in your [Cockpit logs](/serverless-containers/how-to/monitor-container/) to investigate the actual cause. diff --git a/pages/serverless-containers/troubleshooting/index.mdx b/pages/serverless-containers/troubleshooting/index.mdx index ad1820b953..da981b4c5c 100644 --- a/pages/serverless-containers/troubleshooting/index.mdx +++ b/pages/serverless-containers/troubleshooting/index.mdx @@ -68,4 +68,6 @@ productIcon: ContainersProductIcon - [My container stopped working after a redeploy](/serverless-containers/troubleshooting/container-stopped-after-redeploy) - [Tests fail on Serverless Containers](/serverless-containers/troubleshooting/tests-fail-on-container) - [I am experiencing clock drift with my Serverless Containers](/serverless-containers/troubleshooting/container-clock-drift) + - [I am experiencing DNS issues with my container](/serverless-containers/troubleshooting/known-dns-containers-errors/) + - [I cannot access my container](/serverless-containers/troubleshooting/cannot-access-container/) diff --git a/pages/serverless-containers/troubleshooting/known-dns-containers-errors.mdx b/pages/serverless-containers/troubleshooting/known-dns-containers-errors.mdx new file mode 100644 index 0000000000..983d96ec47 --- /dev/null +++ b/pages/serverless-containers/troubleshooting/known-dns-containers-errors.mdx @@ -0,0 +1,45 @@ +--- +meta: + title: I am experiencing DNS issues with my container + description: Troubleshoot Domain Name System (DNS) issues with Scaleway Serverless Containers. +content: + h1: I am experiencing DNS issues with my container + paragraph: Troubleshoot Domain Name System (DNS) issues with Scaleway Serverless Containers. +tags: serverless containers troubleshooting issue error state dns domain name system +dates: + validation: 2025-07-15 + posted: 2025-07-15 +categories: + - serverless +--- + +## Problem + +I am encountering DNS errors while using Scaleway Serverless Containers. + +## Possible causes + +The DNS record for the default endpoint (`functions.fnc..scw.cloud`) is not available yet on every DNS resolver. This issue can appear even a few seconds after the container is marked as “ready”, and mostly appears when the user calls the container too early after the first deployment. + +- For custom domains, a DNS resolution failure can indicate that the custom domain is not properly configured. + + +## Solutions + +- When the DNS answer is cached locally, you can: + - retry later (negative DNS caching last around 60 seconds) + - try from another host, where the DNS answer is not cached + - clean the DNS cache locally + - use another DNS resolver (common DNS resolvers should have the record in a few seconds) + +- For custom domains: + - check the configuration on your DNS provider + - check the TTL on the DNS record. High TTL values will cache the DNS answers for a long time, so we recommend adding a small TTL for setting up the custom domain (60s) + - make sure [you properly configured your custom domain](/serverless-containers/how-to/add-a-custom-domain-to-a-container/) in Serverless Containers + + +## Going further + +- Refer to the dedicated documentation on [how to add a custom domain to a container](/serverless-containers/how-to/add-a-custom-domain-to-a-container/) for more information. + +- If you managed your domain names with Scaleway, refer to the [Scaleway Domains and DNS documentation](/domains-and-dns/). \ No newline at end of file From 3cac4ca1edb965e282f08bd34ced7f036b8b7ba0 Mon Sep 17 00:00:00 2001 From: SamyOubouaziz Date: Wed, 16 Jul 2025 14:13:54 +0200 Subject: [PATCH 2/4] Apply suggestion from @RoRoJ Co-authored-by: Rowena Jones <36301604+RoRoJ@users.noreply.github.com> --- .../troubleshooting/cannot-access-container.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/serverless-containers/troubleshooting/cannot-access-container.mdx b/pages/serverless-containers/troubleshooting/cannot-access-container.mdx index c84a62a91b..ba996df6d7 100644 --- a/pages/serverless-containers/troubleshooting/cannot-access-container.mdx +++ b/pages/serverless-containers/troubleshooting/cannot-access-container.mdx @@ -19,7 +19,7 @@ I am experiencing issues while accessing my Serverless Containers. ## Possible causes -- The container returns A DNS error or issue +- The container returns a DNS error or issue - The container response time is abnormally long - The container returns a `HTTP 5xx` error - The container returns a `Could not resolve host` error From a2731534c1b7fc45af3ec68b05ca6c9da5d92d46 Mon Sep 17 00:00:00 2001 From: SamyOubouaziz Date: Wed, 16 Jul 2025 14:14:33 +0200 Subject: [PATCH 3/4] Apply suggestions from code review Co-authored-by: Rowena Jones <36301604+RoRoJ@users.noreply.github.com> --- .../troubleshooting/cannot-access-container.mdx | 4 ++-- .../troubleshooting/known-dns-containers-errors.mdx | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/pages/serverless-containers/troubleshooting/cannot-access-container.mdx b/pages/serverless-containers/troubleshooting/cannot-access-container.mdx index ba996df6d7..aae35c45b1 100644 --- a/pages/serverless-containers/troubleshooting/cannot-access-container.mdx +++ b/pages/serverless-containers/troubleshooting/cannot-access-container.mdx @@ -30,10 +30,10 @@ I am experiencing issues while accessing my Serverless Containers. - If you encounter a DNS issue, refer to the [dedicated troubleshooting page](/serverless-containers/troubleshooting/known-dns-containers-errors/). - For long response time, check: - - if the first instance of the container is currently starting, a [cold start](/serverless-containers/concepts/#cold-start) can appear + - if the first instance of the container is currently starting. This can entail a [cold start](/serverless-containers/concepts/#cold-start) - if not, [check the metrics in Cockpit](/serverless-containers/how-to/monitor-container/) (especially CPU) and see if there is a high usage explaining the slow response -- `HTTP 5XX` errors can come from the application itself. Check if you can reproduce locally with a dummy container, or if your application is not misbehaving. +- `HTTP 5XX` errors can come from the application itself. Check if you can reproduce locally with a dummy container, or if your application is misbehaving. - A `Could not resolve host` error can indicate that you are trying to reach the container in IPv4 with its IPv6 address, or vice versa. This can also appear if there is a [DNS issue](/serverless-containers/troubleshooting/known-dns-containers-errors/). diff --git a/pages/serverless-containers/troubleshooting/known-dns-containers-errors.mdx b/pages/serverless-containers/troubleshooting/known-dns-containers-errors.mdx index 983d96ec47..5e6181e498 100644 --- a/pages/serverless-containers/troubleshooting/known-dns-containers-errors.mdx +++ b/pages/serverless-containers/troubleshooting/known-dns-containers-errors.mdx @@ -27,7 +27,7 @@ The DNS record for the default endpoint (`functions.fnc..scw.cloud`) is ## Solutions - When the DNS answer is cached locally, you can: - - retry later (negative DNS caching last around 60 seconds) + - retry later (negative DNS caching lasts around 60 seconds) - try from another host, where the DNS answer is not cached - clean the DNS cache locally - use another DNS resolver (common DNS resolvers should have the record in a few seconds) @@ -42,4 +42,4 @@ The DNS record for the default endpoint (`functions.fnc..scw.cloud`) is - Refer to the dedicated documentation on [how to add a custom domain to a container](/serverless-containers/how-to/add-a-custom-domain-to-a-container/) for more information. -- If you managed your domain names with Scaleway, refer to the [Scaleway Domains and DNS documentation](/domains-and-dns/). \ No newline at end of file +- If you manage your domain names with Scaleway, refer to the [Scaleway Domains and DNS documentation](/domains-and-dns/). \ No newline at end of file From 1b39c3de05d01255331e877a199014f22acd0196 Mon Sep 17 00:00:00 2001 From: SamyOubouaziz Date: Wed, 16 Jul 2025 14:20:01 +0200 Subject: [PATCH 4/4] docs(srv): update --- .../troubleshooting/cannot-access-container.mdx | 8 ++------ .../troubleshooting/known-dns-containers-errors.mdx | 8 ++------ 2 files changed, 4 insertions(+), 12 deletions(-) diff --git a/pages/serverless-containers/troubleshooting/cannot-access-container.mdx b/pages/serverless-containers/troubleshooting/cannot-access-container.mdx index aae35c45b1..f6c3f7a142 100644 --- a/pages/serverless-containers/troubleshooting/cannot-access-container.mdx +++ b/pages/serverless-containers/troubleshooting/cannot-access-container.mdx @@ -1,10 +1,6 @@ --- -meta: - title: I cannot access my container - description: Troubleshoot issues encountered while accessing or connecting to your Scaleway Serverless Containers. -content: - h1: I cannot access my container - paragraph: Troubleshoot issues encountered while accessing or connecting to your Scaleway Serverless Containers. +title: I cannot access my container +description: Troubleshoot issues encountered while accessing or connecting to your Scaleway Serverless Containers. tags: serverless containers troubleshooting issue error state unreachable connection log in access dates: validation: 2025-07-15 diff --git a/pages/serverless-containers/troubleshooting/known-dns-containers-errors.mdx b/pages/serverless-containers/troubleshooting/known-dns-containers-errors.mdx index 5e6181e498..a9cebfed33 100644 --- a/pages/serverless-containers/troubleshooting/known-dns-containers-errors.mdx +++ b/pages/serverless-containers/troubleshooting/known-dns-containers-errors.mdx @@ -1,10 +1,6 @@ --- -meta: - title: I am experiencing DNS issues with my container - description: Troubleshoot Domain Name System (DNS) issues with Scaleway Serverless Containers. -content: - h1: I am experiencing DNS issues with my container - paragraph: Troubleshoot Domain Name System (DNS) issues with Scaleway Serverless Containers. +title: I am experiencing DNS issues with my container +description: Troubleshoot Domain Name System (DNS) issues with Scaleway Serverless Containers. tags: serverless containers troubleshooting issue error state dns domain name system dates: validation: 2025-07-15