events
View process events.
Usage
runix events [flags]
Description
View event history for managed processes. Events are persisted to ~/.runix/events.log in JSON format.
Event Types
| Type | Description |
|---|---|
process.started | Process started successfully |
process.stopped | Process stopped cleanly |
process.crashed | Process exited unexpectedly |
process.healthy | Health check passed after recovery |
process.unhealthy | Health check failed consecutively |
process.reloaded | Process was reloaded |
Examples
# Show events from the last hour
runix events
# Show events from the last 24 hours
runix events --since 24h
# Stream events in real time
runix events --follow
# Filter by event type
runix events --type process.crashed
runix events --type process.started
Flags
| Flag | Short | Default | Description |
|---|---|---|---|
--follow | -f | false | Stream events in real time |
--since | 1h | Show events since duration (e.g. 10m, 1h, 24h) | |
--type | -t | Filter by event type |
Output Format
Each event is a JSON object on a single line:
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"type": "process.started",
"timestamp": "2025-01-15T10:30:00Z",
"process_id": "abc123-def456",
"process_name": "api",
"payload": {}
}
What's Next
- Events System — How the event bus works internally