Skip to main content

Troubleshooting services

This is a list of potential issues that you might encounter when running your tech stack on mogenius. It is being updated on a regular basis. If you're facing a problem that is not on the list, please contact support.

Pod crash, CrashLoopBackoff and Restarts

If your application is crashing frequently there's several indicators to look out for. On your logs page a restart counter, e.g. (3) shows that the container of this pod restarted three times after an error. In your service's events the error CrashLoopBackoff or the message "Back-off restarting failed container" means that the container crashed and is restarting. This can have several reasons:

  • The service has not enough resources. You might want to check the resource limits in your service settings. A common indicator for this is an interrupted log of your pod without an error message before the crash.
  • Configuration errors in your application can cause the container to crash. Check your service logs for errors in the logs.
  • The startup process failed due to another service. For example, if your service requires a database connection, ensure that the database is accessible to your service, that the database is ready to accept connections, and that you have provided the correct connection details as environment variables in your service settings.

Ephemeral local storage usage exceeds the total limit of containers

Example in deployment logs
[Evicted]  Pod ephemeral local storage usage exceeds the total limit of containers 500Mi.

If your application is crashing and restarting with the message above prompted in the Deployment logs it indicates that the limit of ephemeral storage is set too low. Try increasing it in the resource settings of your service, by adjusting the limit for "Temp. storage" incrementally. After saving your settings the service will restart. Wait until the new instance of your service is ready and then check if the error still occurs.

Insufficient ephemeral storage

Example in deployment logs
0/2 nodes are available: Insufficient ephemeral storage.

This issue results in failing deployments due to insufficient ephemeral storage on the Kubernetes cluster. It usually means that your service ran out of ephemeral storage on the node. This can be solved by reducing the temp. storage of other services on the cluster. In the service settings, go to Resources and decrease the temp. storage limit in order to free more ephemeral storage for the service that is facing the deployment issues. If you don't have enough ephemeral storage overall you might want to increase the resources on the node pool. Read more about ephemeral storage in Kubernetes here.

Default backend on external hostnames

If you're seeing a blue mogenius default page when opening an external hostname of your service it means that the ingress could not resolve the hostname. Here's what you can do:

  • Is your service running? On your service page, make sure that the service is not stopped.
  • Make sure that the right hostname is set for your service domain (on your service page > Ports & Domain > Custom domain).
  • Check your DNS records: Does the record match your cluster's IP address and is the desired hostname included in the scope of your DNS record?
  • Verify that your service has an exposed port (on your service page > Ports & Domain > Ports).