> For the complete documentation index, see [llms.txt](https://pedal.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pedal.gitbook.io/docs/common-issues/debugging.md).

# Debugging

Diagnose and resolve issues in PEDAL with these debugging tools.

## CLI Debug Mode

* Run with `--debug` flag for detailed output
* Example: `pedal run my-workflow --debug`

## API Logs

* Check FastAPI logs for request/response details
* Enable Uvicorn debug mode for more information

## Web Logs

* Use browser console for frontend errors
* Review server logs for backend issues

## Workflow Logs

* Access logs via CLI: `pedal logs`
* Retrieve logs via API or web interface

***

> For performance issues, see [Performance Issues](/docs/common-issues/performance.md)