@adonis-agora/diagnostics

A standard convention for Agora AdonisJS libs to emit observability events over node:diagnostics_channel — recorded by a single generic Telescope watcher, with zero coupling between emitter and observer.

Every Agora lib publishes on agora:<lib>:<event>. Anything that wants to observe (Telescope, a metrics exporter, your own handler) subscribes — there is no import between them, only the channel-name wire contract.

Install

npm i @adonis-agora/diagnostics
node ace configure @adonis-agora/diagnostics

configure registers the provider and publishes two files: config/diagnostics.ts (the otel flag and the cross-process transports) and start/diagnostics.ts (preloaded), where you register handlers.

Emit

import { emit, trace } from '@adonis-agora/diagnostics'

// POINT event — free when nothing is subscribed:
emit('billing', 'invoice-paid', { invoiceId: 'inv_123', amount: 4200 })

// SPAN — start/end/error with timing (sync or async):
const decision = trace('authz', 'decision', () => evaluate(req), { subject })