stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity
Files
3ecafc49a3805e5aa7fc89507a389359baa0db88
git.stella-ops.org/docs/features/checked/cli/cli-observability-dashboard-commands.md
master e9aeadc040 save checkpoint
2026-02-14 09:11:48 +02:00

2.1 KiB
Raw Blame History

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