40 lines
2.1 KiB
Markdown
40 lines
2.1 KiB
Markdown
# CLI Observability Dashboard Commands
|
|
|
|
## Module
|
|
Cli
|
|
|
|
## Status
|
|
VERIFIED
|
|
|
|
## 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
|
|
|
|
## Verification
|
|
|
|
- **Verified**: 2026-02-13T15:30:00Z
|
|
- **Tier 0 (Source)**: pass -- all referenced source files exist on disk
|
|
- **Tier 1 (Build)**: pass -- module builds cleanly, 238 tests pass in StellaOps.Cli.Formatting.Tests
|
|
- **Tier 2d (Integration)**: pass -- targeted integration tests confirm behavioral correctness
|
|
- **Test Project**: `src/Cli/__Tests/StellaOps.Cli.Formatting.Tests/StellaOps.Cli.Formatting.Tests.csproj`
|
|
- **Evidence**: `docs/qa/feature-checks/runs/cli/cli-observability-dashboard-commands/run-001/tier2-integration-check.json`
|