Skip to content

Cephalon.Observability.Aws

Maturity: M1 · Ownership: cephalon-managed · Family: observability · See audit, matrix.

Cephalon.Observability.Aws adds AWS-hosted OTLP defaults for Cephalon hosts.

  • host-builder registration for OTLP logs, metrics, and traces over the shared Engine:Observability:Telemetry contract
  • AWS X-Ray-compatible trace IDs and optional AWS X-Ray text-map propagation
  • AWS SDK client tracing plus optional Lambda context configuration
  • explicit hosted AWS resource defaults and AWS resource detectors for EC2, ECS, EKS, and Elastic Beanstalk
  • startup diagnostics that summarize the active AWS export mode without logging secrets
  • Configuration/AwsTelemetryExportOptions.cs
  • Hosting/AwsHostApplicationBuilderExtensions.cs
  • Hosting/AwsSummaryHostedService.cs
  • Configuration
  • Hosting

This package stays outside Cephalon.Engine and Cephalon.Observability on purpose. The engine still owns diagnostics names and lifecycle signals, Cephalon.Observability still owns the shared telemetry contract, and this companion package layers AWS-specific propagation, resource detection, and AWS SDK instrumentation on top of the same OTLP baseline.

The AWS slice is intentionally narrower than a generic “all AWS observability products” abstraction. It keeps the shared OTLP contract intact, adds X-Ray-compatible tracing defaults plus hosted AWS resource defaults, and leaves any collector-, account-, or gateway-specific auth path explicit in host configuration. If a deployment sends OTLP data to AWS-managed endpoints directly, prefer an ADOT collector or another SigV4-capable gateway in front of that endpoint instead of pushing AWS auth rules into Cephalon.Engine.