Turbo Pipeline Monitoring & Debugging Reference

CLI commands, error patterns, and troubleshooting reference for Turbo pipelines. For interactive pipeline diagnosis (running commands, checking logs, walking through fixes), use /turbo-doctor instead.

Quick Reference

Action	Command
List pipelines	goldsky turbo list
View live data	goldsky turbo inspect <name>
Inspect specific node	goldsky turbo inspect <name> -n <node>
View logs	goldsky turbo logs <name>
Follow logs	goldsky turbo logs <name> --follow
Logs with timestamps	goldsky turbo logs <name> --timestamps
Last N lines	goldsky turbo logs <name> --tail N
Logs since N seconds ago	goldsky turbo logs <name> --since N

Live Inspect TUI Shortcuts

Key	Action
Tab/→, Shift+Tab/←	Next/prev tab
1-9	Jump to tab number
j/k / ↑/↓	Scroll
g/Home, G/End	Top/bottom
Page Up/Page Down	Scroll by page
/ → Enter	Search
n / N	Next/prev match
Esc	Clear search
d	Toggle definition
w	Open web dashboard
e	Open web editor
q / Ctrl+C	Quit
Shift + mouse	Select and copy text

Auto-Reconnection

The TUI automatically reconnects when the pipeline is updated, paused, resumed, or temporarily unavailable. It displays "Reconnecting..." and preserves previously received data. The TUI has a 30-minute timeout — if the pipeline remains unreachable for 30 minutes, it closes automatically.

Error Pattern Reference

Detailed error patterns and solutions are in the data/ folder.

File	Contents
error-patterns.json	All known error patterns with causes and solutions

Data location: data/ (relative to this skill's directory)

Log Analysis Script

Use the helper script to quickly analyze pipeline logs:

./scripts/analyze-logs.sh <pipeline-name>
./scripts/analyze-logs.sh <pipeline-name> --tail 100

The script checks for common error patterns and reports findings with recommendations.

---

Common Error Patterns

Error Pattern	Likely Cause	Fix
connection refused	Database unreachable	Check network/firewall settings
authentication failed	Wrong credentials	Update secret with correct credentials
secret not found	Missing secret	Create secret with goldsky secret create
SQL syntax error	Invalid transform SQL	Fix SQL in YAML and redeploy
duplicate key	Primary key collision	Ensure unique primary key in transform
script transform error	TypeScript runtime failure	Check script logic, null handling, return types
dynamic_table error	Backend connection issue	Verify dynamic table secret/table exists
WASM execution failed	Script crash in sandbox	Debug script — check for undefined access
handler timeout	External HTTP endpoint slow	Increase timeout_ms or fix handler endpoint

Script Transform Issues

Issue	Fix
undefined property access	Add null checks: input.field ?? ''
Wrong return type	Ensure returned object matches schema exactly
Missing return fields	All schema fields must be present in returned object
invoke is not a function	Ensure script defines function invoke(data)
BigInt errors	Use BigInt() constructor, not direct number literals

Dynamic Table Issues

Issue	Fix
Table not found	Create the table in PostgreSQL before deploying
No matches from check	Verify data exists in the backing table
Stale data	For postgres backend, verify rows are actually there
Memory pressure	Large in_memory tables → switch to postgres backend

Common Issues Quick Reference

Symptom	Likely Cause	Quick Fix
No data flowing	start_at: latest	Wait for new data or use earliest
Auth failed	Wrong credentials	Update secret with correct password
Connection refused	Network/firewall	Check host, whitelist Goldsky IPs
Storage exceeded	Neon free tier (512MB)	Upgrade plan or clear data
SQL error	Bad transform syntax	Validate YAML first

Troubleshooting

Issue	Action
Can't connect to inspect	Check pipeline is running with goldsky turbo list
Logs are empty	Pipeline may be new; wait for data or check start_at
TUI disconnects	Auto-reconnects within 30 min; check pipeline status
Can't find pipeline	Verify correct project with goldsky project list

Related

• /turbo-doctor — Interactive diagnostic skill that uses this reference to troubleshoot pipelines
• /turbo-builder — Build and deploy new pipelines