Logs and debugging
Choose build, runtime, or server logs, stream or historical views, and what to copy before opening a support ticket.
Written By Zoro
Last updated 3 days ago
dFlow surfaces several log types. Pick the one that matches when the problem appears.
Build and deploy logs
Use when: the Deployment never succeeds, the build step fails, or the image cannot be prepared.
Where: Application β Environment β Service β Deployments; open a deployment and use the log action the UI provides (wording may be View logs or similar).
Tip: The first compiler or package manager error is usually the root cause; scroll up from the last line.
Runtime logs
Use when: the Service is running but returns errors, restarts, or behaves incorrectly under traffic.
Where: the Logs tab on the Service while it is active. Streams may truncate; reproduce once and capture promptly for transient bugs.
Worker Node (server) logs
Use when: operations that touch the node fail (plugin actions, disk, SSH execution), or multiple Services on the same node misbehave.
Where: Server logs (or equivalent) in the dashboard for the Worker Node. Pair with Compute and worker node issues.
What to capture (for yourself or support)
- Organisation name, Application name, Environment name, Service name (as shown in the UI).
- Approximate time (with timezone) of the failed Deployment or error.
- A snippet of the log around the first clear error (redact tokens, passwords, connection strings, and personal data).
- Whether the Service is Git, Docker, or database type.
Task guide: Logs under Deployments and Operations in the sidebar.
If logs are empty or missing
- Confirm you opened logs for the Service and Deployment that actually failed.
- Retry once to reproduce; some failures clear quickly.
- Check Compute and worker node issues when the node is unreachable.