@open-infra/telemetry-koa
v0.2.0
Published
Koa request-context and active-span enrichment for OpenInfra telemetry.
Maintainers
Readme
@open-infra/telemetry-koa
Koa middleware for active HTTP span enrichment.
Install
npm install @open-infra/telemetry-koa koaES modules with TypeScript declarations. Node.js 20.11 or newer; browser bindings require a browser bundler. Use synchronized versions of the OpenInfra telemetry packages.
Usage
Use app.use(koaTelemetry({ route: () => "/orders/:id" })) before routes, or rely on a router-provided _matchedRoute. Start server telemetry before importing Koa. Use route templates, not raw user-specific paths.
Lifecycle and limits
Application runtimes own startup, consent, batching, and shutdown. Queues are bounded and can drop records under pressure. Framework adapters enrich existing spans rather than creating a second request span or provider. Keep browser gateway credentials on the server.
Getting started · Operations · Delivery semantics
Apache-2.0.
