| name | foxctl Observability |
| description | Query and browse observability logs - foxcular events, errors, stats. |
Observability Logs
Query foxcular events without navigating to the observability directory.
foxctl run obs/logs --input '{}'
foxctl run obs/logs --input '{"errors_only": true}'
foxctl run obs/logs --input '{"command": "code/semantic_search", "stats": true}'
foxctl run obs/logs --input '{"since": "1h", "limit": 50}'
foxctl run obs/logs --input '{"operation": "skill.run", "status": "error"}'
Parameters
| Param | Description |
|---|
limit | Max events (default: 20, max: 500) |
operation | Filter by operation (e.g., skill.run, hook.execute) |
command | Filter by skill/command name |
status | Filter: ok, error, canceled |
component | Filter: cli, web, hook, skill, job |
since | RFC3339 timestamp or duration (1h, 30m) |
stats | Include aggregate statistics |
errors_only | Only show error events |
Output
Returns events sorted by timestamp (most recent first) with:
events[]: Matching foxcular events
count: Number of events returned
total_scanned: Total events in file
stats: Aggregate statistics (if requested)
summary: Human-readable filter summary