Process Log
Tail workspace application logs from Loki with filters for app, runner, search, and time window.
The Process Log shows runtime log lines from apps and Coderunners in a workspace. The portal polls Control Plane every 5 seconds; the backend proxies to Loki with workspace-scoped LogQL.
Pillar #11· Process Log✅ Live
Who can access
| Action | Required permission |
|---|---|
| Tail logs | read on the workspace |
Prerequisites
- Workspace selected in the top navigation picker
- Loki available in the environment (empty state if not yet deployed)
Tail logs
Open Process Log
In the sidebar under Observe, click Process Log.
Select a workspace
Use the workspace picker in the top navigation bar.
Set filters (optional)
- App ID — filter to a specific app
- Runner ID — filter to a Coderunner instance
- Search — substring match in log lines
- Time window — last 5 minutes to last 24 hours
Watch the stream
Log lines appear in the viewer. Auto-refresh polls every 5 seconds when enabled. Click Refresh for a manual pull.
Link from Coderunner
The Coderunner page links to Process Log with ?workspace_id=…&app_id=…&runner_id=… query parameters pre-filled.
If Loki is not running in your environment, the page shows an empty state. Local setup: see Phase 2 deps in the Control Plane repo.
Troubleshooting
| Problem | Likely cause | What to do |
|---|---|---|
| Empty log stream | No runners emitting logs, or Loki down | Verify Coderunner is running; check Loki health |
| Stale logs | Auto-refresh off | Enable auto-refresh or click Refresh |
| Wrong workspace | Picker mismatch | Reselect workspace in top nav |
| Missing app filter options | No apps registered | Register an app first (see Apps) |
Related API
GET /v1/workspaces/{id}/logs— tail logs (LogQL proxy)
Related
- Activity Log — administrative audit events
- Coderunner — manage runners