Files
git.stella-ops.org/docs/features/unchecked/cli/cli-observability-dashboard-commands.md

31 lines
1.5 KiB
Markdown

# CLI Observability Dashboard Commands
## Module
Cli
## Status
IMPLEMENTED
## Description
Real-time observability commands providing health/SLO/burn-rate dashboards with TUI rendering, distributed trace inspection, and log querying with pagination and evidence links.
## Implementation Details
- **Command Handlers**: `src/Cli/StellaOps.Cli/Commands/CommandHandlers.cs` -- observability command handlers
- **Observability Client**: `src/Cli/StellaOps.Cli/Services/ObservabilityClient.cs` / `IObservabilityClient.cs` -- API client for observability data
- **Telemetry**: `src/Cli/StellaOps.Cli/Telemetry/` -- CLI telemetry integration
- **Commands**:
- `stella obs health` -- health dashboard with system status
- `stella obs slo` -- SLO compliance dashboard with burn-rate metrics
- `stella obs trace <trace-id>` -- inspect distributed trace
- `stella obs logs` -- query logs with filtering and pagination. Options: `--service`, `--level`, `--from`, `--to`, `--limit`
- **TUI**: Uses Spectre.Console for rich terminal rendering of dashboards
## E2E Test Plan
- [ ] Run `stella obs health` and verify health dashboard with component status
- [ ] Run `stella obs slo` and verify SLO metrics with burn-rate indicators
- [ ] Run `stella obs trace <trace-id>` and verify trace spans displayed
- [ ] Run `stella obs logs --service policy --level error --limit 50` and verify filtered log output
- [ ] Verify log pagination with `--offset` and `--limit`
- [ ] Verify evidence links in log entries are clickable/actionable
- [ ] Verify `--format json` output for automation