Documentation
Troubleshooting
How to diagnose and resolve common issues with a Vestval environment.
Overview
When something isn't working, a structured approach beats guesswork. This guide describes how to diagnose issues — reading logs, isolating the problem, and knowing when and how to escalate.
Most issues fall into a few categories; recognizing them speeds resolution.
What this covers
Check status
Confirm whether the issue is an incident or local to your environment.
Read the logs
Audit and application logs surface what actually happened.
Isolate
Narrow the problem to a component, integration or configuration.
Reproduce
A reliable reproduction is the fastest path to a fix.
Escalate
Know how and when to escalate to support with useful detail.
Prevent
Feed recurring issues back into configuration and monitoring.
FAQ
Frequently asked
- Check platform status first; if it's not a broad incident, isolate the issue within your environment.
Related across the ecosystem