Commands for monitoring server health, resource usage, and run lifecycle events.
stats
Show queue statistics including queued, executing, and delayed counts.
strait statshealth
Check server health status.
| Flag | Type | Default | Description |
|---|---|---|---|
| --ready | bool | false | Checks Postgres and Redis connectivity |
strait health --readytop
Live resource usage statistics.
| Flag | Type | Default | Description |
|---|---|---|---|
| --watch | bool | false | Enable live updates |
| --interval | duration | 2s | Update interval |
| --project | string | Filter by project |
top queue
Show queue depth metrics.
strait top queue --watchtop jobs
Show job execution metrics.
strait top jobs --interval 5stui
Interactive terminal dashboard for real-time monitoring.
| Flag | Type | Default | Description |
|---|---|---|---|
| --project | string | Filter by project | |
| --interval | duration | Refresh interval | |
| --run-limit | int | Maximum number of runs to display | |
| --event-limit | int | Maximum number of events to display |
strait tui --project my-projectverify
Perform post-deployment verification checks to ensure the environment is correctly configured.
strait verifydiagnose
General troubleshooting diagnostics.
| Flag | Type | Default | Description |
|---|---|---|---|
| --verbose | bool | false | Enable verbose output |
| --check-readiness | bool | false | Check if the system is ready for operations |
strait diagnose --verbosediagnose run
Diagnose a specific run by ID.
| Flag | Type | Default | Description |
|---|---|---|---|
| --follow | bool | false | Follow the diagnosis in real time |
| --interval | duration | 2s | Refresh interval |
| --level | string | Filter by log level | |
| --type | string | Filter by event type | |
| --show-payload | bool | false | Include event payloads in output |
| --show-result | bool | false | Include event results in output |
| --event-limit | int | 50 | Maximum number of events to show |
strait diagnose run <run_id> --followlisten
Watch for new runs in real time.
| Flag | Type | Default | Description |
|---|---|---|---|
| --project | string | Filter by project | |
| --status | string | Filter by run status | |
| --interval | duration | 2s | Polling interval |
strait listen --project my-project --status executingdrain
Wait for executing runs to complete. This is useful for graceful shutdowns.
| Flag | Type | Default | Description |
|---|---|---|---|
| --timeout | duration | 5m | Maximum time to wait |
| --interval | duration | 2s | Check interval |
The command exits with code 0 when the count reaches 0, and exits with code 1 if the timeout is reached.
strait drain --timeout 10mtrace
ASCII timeline visualization of a run lifecycle events.
| Flag | Type | Default | Description |
|---|---|---|---|
| --show-payload | bool | false | Include event payloads |
| --show-result | bool | false | Include event results |
| --event-limit | int | 50 | Maximum number of events to visualize |
strait trace <run_id> --show-payloadlogs
View events for a specific run or project.
| Flag | Type | Default | Description |
|---|---|---|---|
| --run | string | Filter by run ID | |
| --project | string | Filter by project | |
| --level | string | Filter by log level | |
| --type | string | Filter by event type | |
| --follow, -f | bool | false | Stream logs in real time |
| --interval | duration | 2s | Refresh interval |
strait logs --run <run_id> --followevents
Inspect run events.
| Flag | Type | Default | Description |
|---|---|---|---|
| --run | string | Run ID (Required) | |
| --level | string | Filter by log level | |
| --type | string | Filter by event type |
strait events --run <run_id> --level error