Understand deployment failures and unresponsive applications
Your app doesn't respond on the public URL or your service is in an abnormal state and you're wondering why? You will find below a few common errors and failures which might happen.
When you investigate failures, you should pay attention to the state of the nodes composing your service. When you deploy a service, Koyeb will start one or more nodes depending on your configuration. All these nodes will be health-checked before routing production traffic to them.
Nodes are detected as unhealthy when health-checks fail.
More precisely, every time a node is booted to support your service, all the network ports you decided to open will be health-checked every XX secs. If any of these ports doesn't respond in XX sec after the boot of the node, the node will be declared as unhealthy.
Unresponsive network ports usually come from one of these reasons:
If you don't understand why a node is unhealthy, check the logs of the node.
Click Logs. You can filter logs per node, we will display the last 1000 lines for each node.
Slow service response time are usually related to a lack of resource or to a contention for external resources like a database.