Files
git.stella-ops.org/docs/features/checked/cli/runtime-observations-query-cli.md
2026-02-14 09:11:48 +02:00

1.6 KiB

Runtime Observations Query CLI

Module

Cli

Status

VERIFIED

Description

CLI commands for querying historical runtime observations filtered by symbol name (glob pattern), node hash, container, pod, or namespace with time window filtering. Complements function-map verification for runtime linkage analysis.

Implementation Details

  • Command Group: src/Cli/StellaOps.Cli/Commands/Observations/ObservationsCommandGroup.cs -- ObservationsCommandGroup for runtime observations
  • Commands:
    • stella obs query -- query runtime observations. Options: --symbol <glob>, --node <hash>, --container <name>, --pod <name>, --namespace <ns>, --from <time>, --to <time>, --format table|json

E2E Test Plan

  • Run stella obs query --symbol "org.example.*" and verify glob pattern matching
  • Run with --container my-app and verify container filtering
  • Run with --from 2024-01-01 --to 2024-12-31 and verify time window filtering
  • Verify pagination support
  • Verify --format json output

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, 412 tests pass in StellaOps.Cli.Commands.Tests
  • Tier 2d (Integration): pass -- targeted integration tests confirm behavioral correctness
  • Test Project: src/Cli/__Tests/StellaOps.Cli.Commands.Tests/StellaOps.Cli.Commands.Tests.csproj
  • Evidence: docs/qa/feature-checks/runs/cli/runtime-observations-query-cli/run-001/tier2-integration-check.json