Skip to content

Find the failure. Fix the right thing.

A failed build, a missing asset, and an unavailable external API are different problems. Logs help your agent narrow the cause before changing code or configuration.

Start deployingRead the docs

Build logs answer build questions

When a deployment fails before it goes live, inspect its build output. Dependency installation, the selected command, required configuration, and the expected output directory are useful places to start. Find the first relevant error rather than treating every later failure as a separate root cause.

Ask the agent to connect the error to the project’s actual configuration. Repeated deployment attempts without a change in source or settings are unlikely to resolve a deterministic build problem.

Runtime logs answer application questions

If the site is live but a user flow fails, describe the route, action, and approximate time. Inspect runtime logs for that app and distinguish application errors from unavailable external services. A successful homepage request does not prove every form or API call works.

Use a bounded log range when possible. Enough context to explain an error is useful; a full dump of unrelated activity makes investigation harder and can expose information that does not belong in a shared conversation.

Close the loop on the real workflow

After correcting a problem, redeploy or restart only as the change requires, then repeat the original failing action. Check the live response and relevant logs. A green deployment status is a useful signal, but the user-facing behavior is the test that matters.

If the failure remains, keep the new evidence and revise the diagnosis. Report an unresolved external dependency honestly rather than replacing the failed action with a simulated success message.

Good questions.

Should I restart whenever I see an error?

No. A restart can help with some runtime conditions, but it does not correct broken code, invalid credentials, or the wrong build configuration. Investigate the error first.

Can I share logs with a contributor?

Share only the relevant, sanitized evidence. Remove credentials, customer content, and unrelated account information before posting it publicly.