Skip to content

feat(otel-collector): add serverless / sidecar-less deployment rule#19

Open
liathoffman wants to merge 1 commit into
dash0hq:mainfrom
liathoffman:slo-coach-vibe-coder
Open

feat(otel-collector): add serverless / sidecar-less deployment rule#19
liathoffman wants to merge 1 commit into
dash0hq:mainfrom
liathoffman:slo-coach-vibe-coder

Conversation

@liathoffman

@liathoffman liathoffman commented Jul 12, 2026

Copy link
Copy Markdown

What this adds

The deployment decision tree dead-ended for platforms where you cannot run a co-located Collector: AWS App Runner, Google Cloud Run, Fly.io, Azure Container Apps, and container-image Lambda. This adds rules/deployment/serverless.md covering the direct SDK-to-Dash0 OTLP export pattern:

  • http/protobuf on 443 (serverless egress rarely offers an arbitrary-port gRPC path)
  • The ingest token delivered via the platform's secret store, never through IaC parameters
  • The egress pitfall that bites everyone: VPC-only egress without a NAT fails silently (spans just never arrive)
  • Shutdown flush on SIGTERM-heavy platforms
  • A worked AWS App Runner CloudFormation example

Routes step 1 of the deployment decision process to the new rule, registers it in the SKILL.md rules table and README, and cross-links from the Node.js SDK rule.

Why

Grounded in a real instrumentation of a production App Runner app: this pattern is how its telemetry ships to Dash0 today. The rule keeps to this repo's "this is good OTel" scope; the Dash0-product-specific skills that were previously on this branch have been moved to a separate repo following review feedback.

Validation

  • Executed for real on AWS App Runner (traces, metrics, and logs flowing)
  • All relative links verified; commit follows the conventional format enforced by CI

🤖 Generated with Claude Code

@liathoffman
liathoffman force-pushed the slo-coach-vibe-coder branch from 7b51929 to 3b3f380 Compare July 13, 2026 09:40
@liathoffman liathoffman changed the title Add builder-experience skills: serverless export, observability starter, ad-hoc dashboards, embedded views feat(otel-collector): add serverless / sidecar-less deployment rule Jul 13, 2026
The deployment decision tree dead-ended non-Kubernetes targets at "Docker
Compose / binary" and never covered serverless container platforms (AWS App
Runner, Cloud Run, Fly, Azure Container Apps, container-image Lambda) where
you cannot run a co-located Collector at all.

Adds rules/deployment/serverless.md: the direct SDK-to-Dash0 OTLP export
pattern (no Collector), with the two things that bite on serverless
(internet egress must reach the ingress; keep the ingest token in the
platform secret store), a shutdown-flush note, and an AWS App Runner
CloudFormation worked example. Routes step 1 of the deployment decision
process to it, adds it to the SKILL.md rule table + summary + references,
and cross-links from the Node.js SDK rule.

Grounded in a real instrumentation of an App Runner app (Dash0 SLO Coach).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@liathoffman
liathoffman force-pushed the slo-coach-vibe-coder branch from 3b3f380 to c09928f Compare July 13, 2026 11:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant