Console
View real-time engine and application logs with filtering, color-coded categories, and export capabilities.
Overview
The Console provides a live view of your project's engine logs. Every action in your project β endpoint calls, database queries, auth events, AI operations β generates log entries that appear here in real time.
The console supports live streaming, multiple filtering modes, and export options to help you debug issues and monitor your application in production.
Live Mode
Toggle Live mode to enable automatic log polling. When active, the console auto-scrolls to show the latest entries as they arrive.
You can configure the polling interval based on your needs:
| Interval | Use case |
|---|---|
2s | Active debugging β highest refresh rate |
4s | Default β balanced performance and freshness |
10s | Moderate monitoring β lower resource usage |
30s | Background monitoring β minimal overhead |
Filtering
The console offers two filtering dimensions that can be combined:
By Scope
| Scope | Shows |
|---|---|
| User | User-triggered activity only (endpoint calls, auth events, storage operations) |
| All | Full debug output including internal engine logs, health checks, and system events |
By Log Level
| Filter | Levels shown |
|---|---|
| All | DEBUG, INFO, WARN, ERROR |
| Warnings + Errors | WARN, ERROR |
| Errors only | ERROR |
Log Categories
Every log entry is tagged with a category and color-coded for quick visual identification. This makes it easy to scan through large volumes of logs and find relevant entries:
| Tag | Color | Source |
|---|---|---|
[ERROR] | Red | Application errors and unhandled exceptions |
[WARN] | Yellow | Deprecation notices, near-limit warnings |
[ENDPOINT] | Blue | API endpoint execution (method, path, status) |
[WORKFLOW] | Purple | Flow editor node execution steps |
[AUTH] | Orange | Login, logout, token refresh, provider events |
[AI] | Emerald | LLM calls, agent execution, MCP tool use |
[DATABASE] | Sky | SQL queries, table operations, migrations |
[STORAGE] | Amber | File uploads, downloads, bucket operations |
[HTTP] | Cyan | Outbound HTTP requests from edge functions |
[RATE_LIMIT] | Red | Rate limiting events and throttled requests |
[INFO] | Blue | General informational messages |
[DEBUG] | Gray | Verbose debug output (only in All scope) |
Reading Log Entries
Each log entry follows a consistent format:
[2024-03-15 14:32:01] [ENDPOINT] POST /api/users β 201 (45ms)
[2024-03-15 14:32:01] [DATABASE] INSERT INTO users (email, name) VALUES ($1, $2)
[2024-03-15 14:32:02] [AUTH] Token issued for user_id=abc123
[2024-03-15 14:32:05] [ERROR] Edge function timeout after 30000msThe format includes a timestamp, category tag, and a descriptive message. Endpoint logs also include the HTTP method, path, status code, and execution time.
Export Options
The console toolbar provides several actions for working with logs:
| Action | Description |
|---|---|
| Copy | Copy all visible logs to clipboard as plain text |
| Download | Export logs as a .txt file with timestamps |
| Clear | Clear all logs from the current view |
| Refresh | Manually fetch the latest logs from the server |
Multiple Containers
If your project runs across multiple containers (e.g., in a scaled deployment), you can select which container's logs to view using the container selector in the toolbar. This is useful for debugging issues that only occur on specific instances.