-
Notifications
You must be signed in to change notification settings - Fork 261
feat(srv): add troubleshooting pages MTA-5446 #5280
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
Merged
Changes from all commits
Commits
Show all changes
4 commits
Select commit
Hold shift + click to select a range
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
38 changes: 38 additions & 0 deletions
38
pages/serverless-containers/troubleshooting/cannot-access-container.mdx
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,38 @@ | ||
| --- | ||
| 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 | ||
| 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. 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 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. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
41 changes: 41 additions & 0 deletions
41
pages/serverless-containers/troubleshooting/known-dns-containers-errors.mdx
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,41 @@ | ||
| --- | ||
| 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 | ||
| 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.<region>.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 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) | ||
|
|
||
| - 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 manage your domain names with Scaleway, refer to the [Scaleway Domains and DNS documentation](/domains-and-dns/). | ||
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.