Skip to content

Add early process lifecycle observability#7238

Description

@ravarora2

馃

Motivation

Buzz can currently crash before readiness without one typed, ordered application record identifying whether crypto installation, tracing initialization, configuration loading, key loading, or Prometheus binding failed. Metrics setup also panics on known installation failures and detaches the exporter task.

Proposed solution

  • Add a process lifecycle/boot tracker at relay process entry with a closed phase, result, and reason vocabulary.
  • Give each startup phase an owned terminal guard with an explicit abandoned fallback for in-process paths that forget to terminalize.
  • Emit a bounded single-line lifecycle event before tracing exists, then use the same schema through structured tracing after initialization.
  • Make metrics installation return a typed result and retain supervision of the exporter lifecycle.
  • Add only survivor-aware fleet metrics for observed process-to-metrics-ready outcome and duration.
  • Add production-seam child-process tests for invalid config, occupied metrics port, early panic/error behavior, exact terminal accounting, and secret-safe output.
  • Deploy the exact image to staging, read back the log/metric contract, and add an Early process startup row to the Buzz Startup & Rollout Safety dashboard.

Alternatives considered

Metrics-only telemetry cannot report failures that happen before the metrics listener exists. Unstructured logs do not provide bounded phases, exact terminal accounting, or safe fleet aggregation. Kubernetes remains authoritative for process existence and hard-kill disappearance.

Additional context

No duplicate issue was found in the open block/buzz issue search for startup lifecycle/process telemetry. Design notes: /Users/rarora/.buzz/PLANS/BUZZ_POD_HANDOFF_IMPLEMENTATION_PACKAGES.md Package 1 and /Users/rarora/.buzz/RESEARCH/BUZZ_POD_HANDOFF_NEXT_PACKAGE_2026_09_02.md.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions