[{"data":1,"prerenderedAt":3464},["ShallowReactive",2],{"navigation_docs":3,"-extend-diagnostics-channel":598,"-extend-diagnostics-channel-surround":3459},[4,35,85,138,318,453,475,534,573],{"title":5,"path":6,"stem":7,"children":8,"page":34},"Start","\u002Fstart","1.start",[9,14,19,24,29],{"title":10,"path":11,"stem":12,"icon":13},"Introduction","\u002Fstart\u002Fintroduction","1.start\u002F1.introduction","i-lucide-info",{"title":15,"path":16,"stem":17,"icon":18},"Why start with evlog","\u002Fstart\u002Fwhy-evlog","1.start\u002F2.why-evlog","i-lucide-rocket",{"title":20,"path":21,"stem":22,"icon":23},"Installation","\u002Fstart\u002Finstallation","1.start\u002F3.installation","i-lucide-download",{"title":25,"path":26,"stem":27,"icon":28},"Quick Start","\u002Fstart\u002Fquick-start","1.start\u002F4.quick-start","i-lucide-zap",{"title":30,"path":31,"stem":32,"icon":33},"Choose your logger","\u002Fstart\u002Ftypescript-logging-library","1.start\u002F5.typescript-logging-library","i-lucide-file-code",false,{"title":36,"path":37,"stem":38,"children":39,"page":34},"Learn","\u002Flearn","2.learn",[40,45,50,55,60,65,70,75,80],{"title":41,"path":42,"stem":43,"icon":44},"Overview","\u002Flearn\u002Foverview","2.learn\u002F0.overview","i-lucide-list",{"title":46,"path":47,"stem":48,"icon":49},"Simple Logging","\u002Flearn\u002Fsimple-logging","2.learn\u002F1.simple-logging","i-lucide-terminal",{"title":51,"path":52,"stem":53,"icon":54},"Wide Events","\u002Flearn\u002Fwide-events","2.learn\u002F2.wide-events","i-lucide-layers",{"title":56,"path":57,"stem":58,"icon":59},"Structured Errors","\u002Flearn\u002Fstructured-errors","2.learn\u002F3.structured-errors","i-lucide-shield-alert",{"title":61,"path":62,"stem":63,"icon":64},"Lifecycle","\u002Flearn\u002Flifecycle","2.learn\u002F4.lifecycle","i-lucide-arrow-right-left",{"title":66,"path":67,"stem":68,"icon":69},"Sampling","\u002Flearn\u002Fsampling","2.learn\u002F5.sampling","i-lucide-filter",{"title":71,"path":72,"stem":73,"icon":74},"Auto-Redaction","\u002Flearn\u002Fredaction","2.learn\u002F6.redaction","i-lucide-eye-off",{"title":76,"path":77,"stem":78,"icon":79},"Typed Fields","\u002Flearn\u002Ftyped-fields","2.learn\u002F7.typed-fields","i-simple-icons-typescript",{"title":81,"path":82,"stem":83,"icon":84},"Catalogs","\u002Flearn\u002Fcatalogs","2.learn\u002F8.catalogs","i-lucide-book-open",{"title":86,"path":87,"stem":88,"children":89,"page":34},"CLI","\u002Fcli","3.cli",[90,93,98,103,108,113,118,123,128,133],{"title":41,"path":91,"stem":92,"icon":49},"\u002Fcli\u002Foverview","3.cli\u002F0.overview",{"title":94,"path":95,"stem":96,"icon":97},"init","\u002Fcli\u002Finit","3.cli\u002F1.init","i-lucide-wand-sparkles",{"title":99,"path":100,"stem":101,"icon":102},"map","\u002Fcli\u002Fmap","3.cli\u002F2.map","i-lucide-radar",{"title":104,"path":105,"stem":106,"icon":107},"Rules","\u002Fcli\u002Frules","3.cli\u002F3.rules","i-lucide-list-checks",{"title":109,"path":110,"stem":111,"icon":112},"Scoring","\u002Fcli\u002Fscoring","3.cli\u002F4.scoring","i-lucide-gauge",{"title":114,"path":115,"stem":116,"icon":117},"CI","\u002Fcli\u002Fci","3.cli\u002F5.ci","i-lucide-git-pull-request",{"title":119,"path":120,"stem":121,"icon":122},"doctor","\u002Fcli\u002Fdoctor","3.cli\u002F6.doctor","i-lucide-stethoscope",{"title":124,"path":125,"stem":126,"icon":127},"telemetry","\u002Fcli\u002Ftelemetry","3.cli\u002F7.telemetry","i-lucide-bar-chart-3",{"title":129,"path":130,"stem":131,"icon":132},"agents","\u002Fcli\u002Fagents","3.cli\u002F8.agents","i-lucide-bot",{"title":134,"path":135,"stem":136,"icon":137},"Observability Score","\u002Fcli\u002Fobservability-score","3.cli\u002F9.observability-score","i-lucide-activity",{"title":139,"path":140,"stem":141,"children":142,"page":34},"Integrate","\u002Fintegrate","4.integrate",[143,147,230],{"title":41,"path":144,"stem":145,"icon":146},"\u002Fintegrate\u002Foverview","4.integrate\u002F0.overview","i-lucide-plug",{"title":148,"path":149,"stem":150,"children":151,"page":34},"Adapters","\u002Fintegrate\u002Fadapters","4.integrate\u002Fadapters",[152,155,185,210],{"title":41,"path":153,"stem":154,"icon":44},"\u002Fintegrate\u002Fadapters\u002Foverview","4.integrate\u002Fadapters\u002F01.overview",{"title":156,"path":157,"stem":158,"children":159,"page":34},"Cloud","\u002Fintegrate\u002Fadapters\u002Fcloud","4.integrate\u002Fadapters\u002Fcloud",[160,165,170,175,180],{"title":161,"path":162,"stem":163,"icon":164},"Axiom","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Faxiom","4.integrate\u002Fadapters\u002Fcloud\u002F01.axiom","i-custom-axiom",{"title":166,"path":167,"stem":168,"icon":169},"PostHog","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fposthog","4.integrate\u002Fadapters\u002Fcloud\u002F02.posthog","i-simple-icons-posthog",{"title":171,"path":172,"stem":173,"icon":174},"Sentry","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fsentry","4.integrate\u002Fadapters\u002Fcloud\u002F03.sentry","i-simple-icons-sentry",{"title":176,"path":177,"stem":178,"icon":179},"Better Stack","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fbetter-stack","4.integrate\u002Fadapters\u002Fcloud\u002F04.better-stack","i-simple-icons-betterstack",{"title":181,"path":182,"stem":183,"icon":184},"Datadog","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fdatadog","4.integrate\u002Fadapters\u002Fcloud\u002F05.datadog","i-simple-icons-datadog",{"title":186,"path":187,"stem":188,"children":189,"page":34},"Cloud or Self-Hosted","\u002Fintegrate\u002Fadapters\u002Fhybrid","4.integrate\u002Fadapters\u002Fhybrid",[190,195,200,205],{"title":191,"path":192,"stem":193,"icon":194},"Grafana Loki","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Floki","4.integrate\u002Fadapters\u002Fhybrid\u002F01.loki","i-simple-icons-grafana",{"title":196,"path":197,"stem":198,"icon":199},"ClickHouse","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Fclickhouse","4.integrate\u002Fadapters\u002Fhybrid\u002F02.clickhouse","i-simple-icons-clickhouse",{"title":201,"path":202,"stem":203,"icon":204},"OTLP","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Fotlp","4.integrate\u002Fadapters\u002Fhybrid\u002F03.otlp","i-simple-icons-opentelemetry",{"title":206,"path":207,"stem":208,"icon":209},"HyperDX","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Fhyperdx","4.integrate\u002Fadapters\u002Fhybrid\u002F04.hyperdx","i-custom-hyperdx",{"title":211,"path":212,"stem":213,"children":214,"page":34},"Self-Hosted","\u002Fintegrate\u002Fadapters\u002Fself-hosted","4.integrate\u002Fadapters\u002Fself-hosted",[215,220,225],{"title":216,"path":217,"stem":218,"icon":219},"File System","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Ffs","4.integrate\u002Fadapters\u002Fself-hosted\u002F01.fs","i-lucide-hard-drive",{"title":221,"path":222,"stem":223,"icon":224},"NuxtHub","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Fnuxthub","4.integrate\u002Fadapters\u002Fself-hosted\u002F02.nuxthub","i-simple-icons-nuxt",{"title":226,"path":227,"stem":228,"icon":229},"Memory","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Fmemory","4.integrate\u002Fadapters\u002Fself-hosted\u002F03.memory","i-lucide-cpu",{"title":231,"path":232,"stem":233,"children":234,"page":34},"Frameworks","\u002Fintegrate\u002Fframeworks","4.integrate\u002Fframeworks",[235,239,244,249,254,259,264,269,274,279,284,289,294,299,303,308,313],{"title":41,"path":236,"stem":237,"icon":238},"\u002Fintegrate\u002Fframeworks\u002Foverview","4.integrate\u002Fframeworks\u002F00.overview","i-lucide-layout-grid",{"title":240,"path":241,"stem":242,"icon":243},"Nuxt","\u002Fintegrate\u002Fframeworks\u002Fnuxt","4.integrate\u002Fframeworks\u002F01.nuxt","i-simple-icons-nuxtdotjs",{"title":245,"path":246,"stem":247,"icon":248},"Next.js","\u002Fintegrate\u002Fframeworks\u002Fnextjs","4.integrate\u002Fframeworks\u002F02.nextjs","i-simple-icons-nextdotjs",{"title":250,"path":251,"stem":252,"icon":253},"SvelteKit","\u002Fintegrate\u002Fframeworks\u002Fsveltekit","4.integrate\u002Fframeworks\u002F03.sveltekit","i-simple-icons-svelte",{"title":255,"path":256,"stem":257,"icon":258},"Nitro","\u002Fintegrate\u002Fframeworks\u002Fnitro","4.integrate\u002Fframeworks\u002F04.nitro","i-custom-nitro",{"title":260,"path":261,"stem":262,"icon":263},"TanStack Start","\u002Fintegrate\u002Fframeworks\u002Ftanstack-start","4.integrate\u002Fframeworks\u002F05.tanstack-start","i-custom-tanstack",{"title":265,"path":266,"stem":267,"icon":268},"NestJS","\u002Fintegrate\u002Fframeworks\u002Fnestjs","4.integrate\u002Fframeworks\u002F06.nestjs","i-simple-icons-nestjs",{"title":270,"path":271,"stem":272,"icon":273},"Express","\u002Fintegrate\u002Fframeworks\u002Fexpress","4.integrate\u002Fframeworks\u002F07.express","i-simple-icons-express",{"title":275,"path":276,"stem":277,"icon":278},"Hono","\u002Fintegrate\u002Fframeworks\u002Fhono","4.integrate\u002Fframeworks\u002F08.hono","i-simple-icons-hono",{"title":280,"path":281,"stem":282,"icon":283},"Fastify","\u002Fintegrate\u002Fframeworks\u002Ffastify","4.integrate\u002Fframeworks\u002F09.fastify","i-simple-icons-fastify",{"title":285,"path":286,"stem":287,"icon":288},"Elysia","\u002Fintegrate\u002Fframeworks\u002Felysia","4.integrate\u002Fframeworks\u002F10.elysia","i-custom-elysia",{"title":290,"path":291,"stem":292,"icon":293},"React Router","\u002Fintegrate\u002Fframeworks\u002Freact-router","4.integrate\u002Fframeworks\u002F11.react-router","i-custom-reactrouter",{"title":295,"path":296,"stem":297,"icon":298},"Cloudflare Workers","\u002Fintegrate\u002Fframeworks\u002Fcloudflare-workers","4.integrate\u002Fframeworks\u002F12.cloudflare-workers","i-simple-icons-cloudflare",{"title":300,"path":301,"stem":302,"icon":79},"Standalone","\u002Fintegrate\u002Fframeworks\u002Fstandalone","4.integrate\u002Fframeworks\u002F13.standalone",{"title":304,"path":305,"stem":306,"icon":307},"Astro","\u002Fintegrate\u002Fframeworks\u002Fastro","4.integrate\u002Fframeworks\u002F14.astro","i-simple-icons-astro",{"title":309,"path":310,"stem":311,"icon":312},"oRPC","\u002Fintegrate\u002Fframeworks\u002Forpc","4.integrate\u002Fframeworks\u002F15.orpc","i-lucide-network",{"title":314,"path":315,"stem":316,"icon":317},"AWS Lambda","\u002Fintegrate\u002Fframeworks\u002Faws-lambda","4.integrate\u002Fframeworks\u002F16.aws-lambda","i-custom-lambda",{"title":319,"path":320,"stem":321,"children":322,"page":34},"Use Cases","\u002Fuse-cases","5.use-cases",[323,326,331,359,386,418,439,444,449],{"title":41,"path":324,"stem":325,"icon":107},"\u002Fuse-cases\u002Foverview","5.use-cases\u002F0.overview",{"title":327,"path":328,"stem":329,"icon":330},"Client Logging","\u002Fuse-cases\u002Fclient-logging","5.use-cases\u002F1.client-logging","i-lucide-monitor",{"title":332,"icon":333,"path":334,"stem":335,"children":336,"page":34},"AI SDK","i-simple-icons-vercel","\u002Fuse-cases\u002Fai-sdk","5.use-cases\u002F2.ai-sdk",[337,340,345,350,355],{"title":41,"path":338,"stem":339,"icon":44},"\u002Fuse-cases\u002Fai-sdk\u002Foverview","5.use-cases\u002F2.ai-sdk\u002F01.overview",{"title":341,"path":342,"stem":343,"icon":344},"Usage","\u002Fuse-cases\u002Fai-sdk\u002Fusage","5.use-cases\u002F2.ai-sdk\u002F02.usage","i-lucide-code",{"title":346,"path":347,"stem":348,"icon":349},"Options","\u002Fuse-cases\u002Fai-sdk\u002Foptions","5.use-cases\u002F2.ai-sdk\u002F03.options","i-lucide-sliders",{"title":351,"path":352,"stem":353,"icon":354},"Metadata","\u002Fuse-cases\u002Fai-sdk\u002Fmetadata","5.use-cases\u002F2.ai-sdk\u002F04.metadata","i-lucide-database",{"title":356,"path":357,"stem":358,"icon":137},"Telemetry","\u002Fuse-cases\u002Fai-sdk\u002Ftelemetry","5.use-cases\u002F2.ai-sdk\u002F05.telemetry",{"title":360,"icon":361,"path":362,"stem":363,"children":364,"page":34},"Better Auth","i-simple-icons-betterauth","\u002Fuse-cases\u002Fbetter-auth","5.use-cases\u002F3.better-auth",[365,368,373,378,382],{"title":41,"path":366,"stem":367,"icon":44},"\u002Fuse-cases\u002Fbetter-auth\u002Foverview","5.use-cases\u002F3.better-auth\u002F01.overview",{"title":369,"path":370,"stem":371,"icon":372},"Identify User","\u002Fuse-cases\u002Fbetter-auth\u002Fidentify-user","5.use-cases\u002F3.better-auth\u002F02.identify-user","i-lucide-user-check",{"title":374,"path":375,"stem":376,"icon":377},"Middleware","\u002Fuse-cases\u002Fbetter-auth\u002Fmiddleware","5.use-cases\u002F3.better-auth\u002F03.middleware","i-lucide-shield",{"title":379,"path":380,"stem":381,"icon":330},"Client Sync","\u002Fuse-cases\u002Fbetter-auth\u002Fclient-sync","5.use-cases\u002F3.better-auth\u002F04.client-sync",{"title":383,"path":384,"stem":385,"icon":112},"Performance","\u002Fuse-cases\u002Fbetter-auth\u002Fperformance","5.use-cases\u002F3.better-auth\u002F05.performance",{"title":387,"icon":388,"path":389,"stem":390,"children":391,"page":34},"Audit Logs","i-lucide-shield-check","\u002Fuse-cases\u002Faudit","5.use-cases\u002F4.audit",[392,395,400,405,410,414],{"title":41,"path":393,"stem":394,"icon":44},"\u002Fuse-cases\u002Faudit\u002Foverview","5.use-cases\u002F4.audit\u002F01.overview",{"title":396,"path":397,"stem":398,"icon":399},"Schema","\u002Fuse-cases\u002Faudit\u002Fschema","5.use-cases\u002F4.audit\u002F02.schema","i-lucide-file-text",{"title":401,"path":402,"stem":403,"icon":404},"Recording","\u002Fuse-cases\u002Faudit\u002Frecording","5.use-cases\u002F4.audit\u002F03.recording","i-lucide-pen-line",{"title":406,"path":407,"stem":408,"icon":409},"Drains","\u002Fuse-cases\u002Faudit\u002Fpipeline","5.use-cases\u002F4.audit\u002F04.pipeline","i-lucide-link",{"title":411,"path":412,"stem":413,"icon":388},"Compliance","\u002Fuse-cases\u002Faudit\u002Fcompliance","5.use-cases\u002F4.audit\u002F05.compliance",{"title":415,"path":416,"stem":417,"icon":84},"Recipes","\u002Fuse-cases\u002Faudit\u002Frecipes","5.use-cases\u002F4.audit\u002F06.recipes",{"title":356,"icon":112,"path":419,"stem":420,"children":421,"page":34},"\u002Fuse-cases\u002Ftelemetry","5.use-cases\u002F4.telemetry",[422,425,430,435],{"title":41,"path":423,"stem":424,"icon":44},"\u002Fuse-cases\u002Ftelemetry\u002Foverview","5.use-cases\u002F4.telemetry\u002F01.overview",{"title":426,"path":427,"stem":428,"icon":429},"Setup","\u002Fuse-cases\u002Ftelemetry\u002Fsetup","5.use-cases\u002F4.telemetry\u002F02.setup","i-lucide-wrench",{"title":431,"path":432,"stem":433,"icon":434},"Ingest","\u002Fuse-cases\u002Ftelemetry\u002Fingest","5.use-cases\u002F4.telemetry\u002F03.ingest","i-lucide-server",{"title":436,"path":437,"stem":438,"icon":84},"Reference","\u002Fuse-cases\u002Ftelemetry\u002Freference","5.use-cases\u002F4.telemetry\u002F04.reference",{"title":440,"path":441,"stem":442,"icon":443},"Enrichers","\u002Fuse-cases\u002Fenrichers","5.use-cases\u002F5.enrichers","i-lucide-sparkles",{"title":445,"path":446,"stem":447,"icon":448},"eve","\u002Fuse-cases\u002Feve","5.use-cases\u002F5.eve","i-custom-eve",{"title":450,"path":451,"stem":452,"icon":434},"Node.js request logging","\u002Fuse-cases\u002Fstructured-logging-nodejs","5.use-cases\u002F6.structured-logging-nodejs",{"title":454,"path":455,"stem":456,"children":457,"page":34},"Libraries","\u002Flibraries","6.libraries",[458,462,467,470],{"title":41,"path":459,"stem":460,"icon":461},"\u002Flibraries\u002Foverview","6.libraries\u002F0.overview","i-lucide-package",{"title":463,"path":464,"stem":465,"icon":466},"Emitting Events","\u002Flibraries\u002Femitting","6.libraries\u002F1.emitting","i-lucide-radio",{"title":56,"path":468,"stem":469,"icon":59},"\u002Flibraries\u002Ferrors","6.libraries\u002F2.errors",{"title":471,"path":472,"stem":473,"icon":474},"Testing","\u002Flibraries\u002Ftesting","6.libraries\u002F3.testing","i-lucide-flask-conical",{"title":476,"path":477,"stem":478,"children":479,"page":34},"Extend","\u002Fextend","7.extend",[480,484,489,494,498,503,507,511,515,519,524,529],{"title":41,"path":481,"stem":482,"icon":483},"\u002Fextend\u002Foverview","7.extend\u002F0.overview","i-lucide-blocks",{"title":485,"path":486,"stem":487,"icon":488},"Stream","\u002Fextend\u002Fstream","7.extend\u002F1.stream","i-lucide-radio-tower",{"title":490,"path":491,"stem":492,"icon":493},"Custom framework","\u002Fextend\u002Fcustom-framework","7.extend\u002F10.custom-framework","i-lucide-puzzle",{"title":495,"path":496,"stem":497,"icon":488},"Diagnostics channel","\u002Fextend\u002Fdiagnostics-channel","7.extend\u002F11.diagnostics-channel",{"title":499,"path":500,"stem":501,"icon":502},"FS reader","\u002Fextend\u002Ffs-reader","7.extend\u002F2.fs-reader","i-lucide-folder-search",{"title":415,"path":504,"stem":505,"icon":506},"\u002Fextend\u002Fconsumer-recipes","7.extend\u002F3.consumer-recipes","i-lucide-chef-hat",{"title":508,"path":509,"stem":510,"icon":483},"Plugins","\u002Fextend\u002Fplugins","7.extend\u002F4.plugins",{"title":512,"path":513,"stem":514,"icon":443},"Custom enrichers","\u002Fextend\u002Fcustom-enrichers","7.extend\u002F5.custom-enrichers",{"title":516,"path":517,"stem":518,"icon":69},"Tail sampling","\u002Fextend\u002Ftail-sampling","7.extend\u002F6.tail-sampling",{"title":520,"path":521,"stem":522,"icon":523},"Identity headers","\u002Fextend\u002Fidentity-headers","7.extend\u002F7.identity-headers","i-lucide-fingerprint",{"title":525,"path":526,"stem":527,"icon":528},"Custom drains","\u002Fextend\u002Fcustom-drains","7.extend\u002F8.custom-drains","i-lucide-share-2",{"title":530,"path":531,"stem":532,"icon":533},"Drain pipeline","\u002Fextend\u002Fdrain-pipeline","7.extend\u002F9.drain-pipeline","i-lucide-workflow",{"title":436,"path":535,"stem":536,"children":537,"page":34},"\u002Freference","8.reference",[538,542,547,550,555,559,564,568],{"title":41,"path":539,"stem":540,"icon":541},"\u002Freference\u002Foverview","8.reference\u002F0.overview","i-lucide-book-marked",{"title":543,"path":544,"stem":545,"icon":546},"Configuration","\u002Freference\u002Fconfiguration","8.reference\u002F1.configuration","i-lucide-settings",{"title":383,"path":548,"stem":549,"icon":112},"\u002Freference\u002Fperformance","8.reference\u002F2.performance",{"title":551,"path":552,"stem":553,"icon":554},"Vite Plugin","\u002Freference\u002Fvite-plugin","8.reference\u002F3.vite-plugin","i-custom-vite",{"title":556,"path":557,"stem":558,"icon":388},"Best Practices","\u002Freference\u002Fbest-practices","8.reference\u002F4.best-practices",{"title":560,"path":561,"stem":562,"icon":563},"vs Other Loggers","\u002Freference\u002Fvs-other-loggers","8.reference\u002F5.vs-other-loggers","i-lucide-scale",{"title":565,"path":566,"stem":567,"icon":443},"Agent Skills","\u002Freference\u002Fagent-skills","8.reference\u002F6.agent-skills",{"title":569,"path":570,"stem":571,"icon":572},"Cost","\u002Freference\u002Fcost","8.reference\u002F7.cost","i-lucide-receipt",{"title":574,"path":575,"stem":576,"children":577,"page":34},"Compare","\u002Fcompare","9.compare",[578,582,586,590,594],{"title":579,"path":580,"stem":581,"icon":563},"evlog vs Pino","\u002Fcompare\u002Fpino","9.compare\u002F1.pino",{"title":583,"path":584,"stem":585,"icon":204},"evlog vs OpenTelemetry","\u002Fcompare\u002Fopentelemetry","9.compare\u002F2.opentelemetry",{"title":587,"path":588,"stem":589,"icon":563},"evlog vs LogTape","\u002Fcompare\u002Flogtape","9.compare\u002F3.logtape",{"title":591,"path":592,"stem":593,"icon":563},"evlog vs Winston: formats and request events","\u002Fcompare\u002Fwinston","9.compare\u002F4.winston",{"title":595,"path":596,"stem":597,"icon":563},"evlog vs Consola: reporters and request context","\u002Fcompare\u002Fconsola","9.compare\u002F5.consola",{"id":599,"title":600,"body":601,"description":3448,"extension":3449,"links":3450,"meta":3455,"navigation":3456,"path":496,"seo":3457,"stem":497,"__hash__":3458},"docs\u002F7.extend\u002F11.diagnostics-channel.md","Diagnostics Channel",{"type":602,"value":603,"toc":3436},"minimark",[604,626,631,642,671,678,682,685,746,754,1596,1611,1622,1626,1629,1858,1872,1875,2065,2075,2079,2082,2368,2390,2403,2410,2414,2419,2425,2652,2669,2674,2678,2681,3078,3084,3087,3098,3326,3347,3351,3358,3426,3432],[605,606,607,617,618,621,622,625],"p",{},[608,609,613],"a",{"href":610,"rel":611},"https:\u002F\u002Fnodejs.org\u002Fapi\u002Fdiagnostics_channel.html",[612],"nofollow",[614,615,616],"code",{},"node:diagnostics_channel"," is the runtime's built-in pub\u002Fsub for instrumentation. evlog can publish every wide event on the ",[614,619,620],{},"evlog.event"," channel, so a consumer subscribes by channel name alone: no evlog import, no entry in ",[614,623,624],{},"initLogger()",".",[627,628,630],"h2",{"id":629},"what-its-for","What it's for",[605,632,633,634,637,638,641],{},"Two things you cannot do with a ",[608,635,636],{"href":509},"plugin"," or a ",[608,639,640],{"href":526},"drain",":",[643,644,645,656],"ul",{},[646,647,648,652,653,655],"li",{},[649,650,651],"strong",{},"Ship an evlog integration from a package that does not depend on evlog."," A subscriber only needs the channel name, so a vendor SDK, an internal shared library, or an APM agent can consume wide events without a peer dependency, a version constraint, or a line in your ",[614,654,624],{}," call.",[646,657,658,661,662,666,667,670],{},[649,659,660],{},"Get events out of a Cloudflare Worker without a drain."," Workers forwards every channel message to a ",[608,663,665],{"href":664},"#cloudflare-workers","Tail Worker",", which runs after the response with its own CPU budget, no ",[614,668,669],{},"waitUntil",", no drain competing with your request.",[605,672,673,674,625],{},"For everything else (batching, retry, adding fields, fanning out to several in-process consumers), a plugin or a drain is the better tool. There is a ",[608,675,677],{"href":676},"#when-a-plugin-is-the-better-tool","comparison at the bottom of this page",[627,679,681],{"id":680},"enabling-it","Enabling it",[605,683,684],{},"It is off by default. Turn it on once, at startup:",[686,687,692],"pre",{"className":688,"code":689,"language":690,"meta":691,"style":691},"language-typescript shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import { enableDiagnosticsChannel } from 'evlog\u002Fdiagnostics'\n\nawait enableDiagnosticsChannel()\n","typescript","",[614,693,694,727,734],{"__ignoreMap":691},[695,696,699,703,707,711,714,717,720,724],"span",{"class":697,"line":698},"line",1,[695,700,702],{"class":701},"s7zQu","import",[695,704,706],{"class":705},"sMK4o"," {",[695,708,710],{"class":709},"sTEyZ"," enableDiagnosticsChannel",[695,712,713],{"class":705}," }",[695,715,716],{"class":701}," from",[695,718,719],{"class":705}," '",[695,721,723],{"class":722},"sfazB","evlog\u002Fdiagnostics",[695,725,726],{"class":705},"'\n",[695,728,730],{"class":697,"line":729},2,[695,731,733],{"emptyLinePlaceholder":732},true,"\n",[695,735,737,740,743],{"class":697,"line":736},3,[695,738,739],{"class":701},"await",[695,741,710],{"class":742},"s2Zo4",[695,744,745],{"class":709},"()\n",[605,747,748,749,753],{},"The call takes no options and is the same on every framework. Only ",[750,751,752],"em",{},"where"," your app runs startup code differs:",[755,756,757,839,1085,1173,1298,1505],"code-group",{},[686,758,761],{"className":688,"code":759,"filename":760,"language":690,"meta":691,"style":691},"\u002F\u002F server\u002Fplugins\u002Fevlog-diagnostics.ts\nimport { enableDiagnosticsChannel } from 'evlog\u002Fdiagnostics'\n\nexport default defineNitroPlugin(async () => {\n  await enableDiagnosticsChannel()\n})\n","Nuxt \u002F Nitro",[614,762,763,769,787,791,819,830],{"__ignoreMap":691},[695,764,765],{"class":697,"line":698},[695,766,768],{"class":767},"sHwdD","\u002F\u002F server\u002Fplugins\u002Fevlog-diagnostics.ts\n",[695,770,771,773,775,777,779,781,783,785],{"class":697,"line":729},[695,772,702],{"class":701},[695,774,706],{"class":705},[695,776,710],{"class":709},[695,778,713],{"class":705},[695,780,716],{"class":701},[695,782,719],{"class":705},[695,784,723],{"class":722},[695,786,726],{"class":705},[695,788,789],{"class":697,"line":736},[695,790,733],{"emptyLinePlaceholder":732},[695,792,794,797,800,803,806,810,813,816],{"class":697,"line":793},4,[695,795,796],{"class":701},"export",[695,798,799],{"class":701}," default",[695,801,802],{"class":742}," defineNitroPlugin",[695,804,805],{"class":709},"(",[695,807,809],{"class":808},"spNyl","async",[695,811,812],{"class":705}," ()",[695,814,815],{"class":808}," =>",[695,817,818],{"class":705}," {\n",[695,820,822,825,827],{"class":697,"line":821},5,[695,823,824],{"class":701},"  await",[695,826,710],{"class":742},[695,828,745],{"class":829},"swJcz",[695,831,833,836],{"class":697,"line":832},6,[695,834,835],{"class":705},"}",[695,837,838],{"class":709},")\n",[686,840,842],{"className":688,"code":841,"filename":245,"language":690,"meta":691,"style":691},"\u002F\u002F instrumentation.ts\nimport { defineNodeInstrumentation } from 'evlog\u002Fnext\u002Finstrumentation'\n\nexport const { register, onRequestError } = defineNodeInstrumentation(async () => {\n  const { createInstrumentation } = await import('evlog\u002Fnext\u002Finstrumentation\u002Fcreate')\n  const { enableDiagnosticsChannel } = await import('evlog\u002Fdiagnostics')\n  const { register: evlogRegister, onRequestError } = createInstrumentation({ service: 'my-app' })\n\n  return {\n    async register() {\n      await evlogRegister()\n      await enableDiagnosticsChannel()\n    },\n    onRequestError,\n  }\n})\n",[614,843,844,849,869,873,908,940,966,1012,1017,1025,1038,1048,1057,1063,1072,1078],{"__ignoreMap":691},[695,845,846],{"class":697,"line":698},[695,847,848],{"class":767},"\u002F\u002F instrumentation.ts\n",[695,850,851,853,855,858,860,862,864,867],{"class":697,"line":729},[695,852,702],{"class":701},[695,854,706],{"class":705},[695,856,857],{"class":709}," defineNodeInstrumentation",[695,859,713],{"class":705},[695,861,716],{"class":701},[695,863,719],{"class":705},[695,865,866],{"class":722},"evlog\u002Fnext\u002Finstrumentation",[695,868,726],{"class":705},[695,870,871],{"class":697,"line":736},[695,872,733],{"emptyLinePlaceholder":732},[695,874,875,877,880,882,885,888,891,893,896,898,900,902,904,906],{"class":697,"line":793},[695,876,796],{"class":701},[695,878,879],{"class":808}," const",[695,881,706],{"class":705},[695,883,884],{"class":709}," register",[695,886,887],{"class":705},",",[695,889,890],{"class":709}," onRequestError ",[695,892,835],{"class":705},[695,894,895],{"class":705}," =",[695,897,857],{"class":742},[695,899,805],{"class":709},[695,901,809],{"class":808},[695,903,812],{"class":705},[695,905,815],{"class":808},[695,907,818],{"class":705},[695,909,910,913,915,918,920,922,925,928,930,933,936,938],{"class":697,"line":821},[695,911,912],{"class":808},"  const",[695,914,706],{"class":705},[695,916,917],{"class":709}," createInstrumentation",[695,919,713],{"class":705},[695,921,895],{"class":705},[695,923,924],{"class":701}," await",[695,926,927],{"class":705}," import",[695,929,805],{"class":829},[695,931,932],{"class":705},"'",[695,934,935],{"class":722},"evlog\u002Fnext\u002Finstrumentation\u002Fcreate",[695,937,932],{"class":705},[695,939,838],{"class":829},[695,941,942,944,946,948,950,952,954,956,958,960,962,964],{"class":697,"line":832},[695,943,912],{"class":808},[695,945,706],{"class":705},[695,947,710],{"class":709},[695,949,713],{"class":705},[695,951,895],{"class":705},[695,953,924],{"class":701},[695,955,927],{"class":705},[695,957,805],{"class":829},[695,959,932],{"class":705},[695,961,723],{"class":722},[695,963,932],{"class":705},[695,965,838],{"class":829},[695,967,969,971,973,975,977,980,982,985,987,989,991,993,996,999,1001,1003,1006,1008,1010],{"class":697,"line":968},7,[695,970,912],{"class":808},[695,972,706],{"class":705},[695,974,884],{"class":829},[695,976,641],{"class":705},[695,978,979],{"class":709}," evlogRegister",[695,981,887],{"class":705},[695,983,984],{"class":709}," onRequestError",[695,986,713],{"class":705},[695,988,895],{"class":705},[695,990,917],{"class":742},[695,992,805],{"class":829},[695,994,995],{"class":705},"{",[695,997,998],{"class":829}," service",[695,1000,641],{"class":705},[695,1002,719],{"class":705},[695,1004,1005],{"class":722},"my-app",[695,1007,932],{"class":705},[695,1009,713],{"class":705},[695,1011,838],{"class":829},[695,1013,1015],{"class":697,"line":1014},8,[695,1016,733],{"emptyLinePlaceholder":732},[695,1018,1020,1023],{"class":697,"line":1019},9,[695,1021,1022],{"class":701},"  return",[695,1024,818],{"class":705},[695,1026,1028,1031,1033,1036],{"class":697,"line":1027},10,[695,1029,1030],{"class":808},"    async",[695,1032,884],{"class":829},[695,1034,1035],{"class":705},"()",[695,1037,818],{"class":705},[695,1039,1041,1044,1046],{"class":697,"line":1040},11,[695,1042,1043],{"class":701},"      await",[695,1045,979],{"class":742},[695,1047,745],{"class":829},[695,1049,1051,1053,1055],{"class":697,"line":1050},12,[695,1052,1043],{"class":701},[695,1054,710],{"class":742},[695,1056,745],{"class":829},[695,1058,1060],{"class":697,"line":1059},13,[695,1061,1062],{"class":705},"    },\n",[695,1064,1066,1069],{"class":697,"line":1065},14,[695,1067,1068],{"class":709},"    onRequestError",[695,1070,1071],{"class":705},",\n",[695,1073,1075],{"class":697,"line":1074},15,[695,1076,1077],{"class":705},"  }\n",[695,1079,1081,1083],{"class":697,"line":1080},16,[695,1082,835],{"class":705},[695,1084,838],{"class":709},[686,1086,1088],{"className":688,"code":1087,"filename":250,"language":690,"meta":691,"style":691},"\u002F\u002F src\u002Fhooks.server.ts\nimport { createEvlogHooks } from 'evlog\u002Fsveltekit'\nimport { enableDiagnosticsChannel } from 'evlog\u002Fdiagnostics'\n\nawait enableDiagnosticsChannel()\n\nexport const { handle, handleError } = createEvlogHooks()\n",[614,1089,1090,1095,1115,1133,1137,1145,1149],{"__ignoreMap":691},[695,1091,1092],{"class":697,"line":698},[695,1093,1094],{"class":767},"\u002F\u002F src\u002Fhooks.server.ts\n",[695,1096,1097,1099,1101,1104,1106,1108,1110,1113],{"class":697,"line":729},[695,1098,702],{"class":701},[695,1100,706],{"class":705},[695,1102,1103],{"class":709}," createEvlogHooks",[695,1105,713],{"class":705},[695,1107,716],{"class":701},[695,1109,719],{"class":705},[695,1111,1112],{"class":722},"evlog\u002Fsveltekit",[695,1114,726],{"class":705},[695,1116,1117,1119,1121,1123,1125,1127,1129,1131],{"class":697,"line":736},[695,1118,702],{"class":701},[695,1120,706],{"class":705},[695,1122,710],{"class":709},[695,1124,713],{"class":705},[695,1126,716],{"class":701},[695,1128,719],{"class":705},[695,1130,723],{"class":722},[695,1132,726],{"class":705},[695,1134,1135],{"class":697,"line":793},[695,1136,733],{"emptyLinePlaceholder":732},[695,1138,1139,1141,1143],{"class":697,"line":821},[695,1140,739],{"class":701},[695,1142,710],{"class":742},[695,1144,745],{"class":709},[695,1146,1147],{"class":697,"line":832},[695,1148,733],{"emptyLinePlaceholder":732},[695,1150,1151,1153,1155,1157,1160,1162,1165,1167,1169,1171],{"class":697,"line":968},[695,1152,796],{"class":701},[695,1154,879],{"class":808},[695,1156,706],{"class":705},[695,1158,1159],{"class":709}," handle",[695,1161,887],{"class":705},[695,1163,1164],{"class":709}," handleError ",[695,1166,835],{"class":705},[695,1168,895],{"class":705},[695,1170,1103],{"class":742},[695,1172,745],{"class":709},[686,1174,1176],{"className":688,"code":1175,"filename":275,"language":690,"meta":691,"style":691},"\u002F\u002F Same shape for Express, Fastify, Elysia, NestJS and oRPC:\n\u002F\u002F enable once in the server entry, before the app starts serving.\nimport { Hono } from 'hono'\nimport { evlog } from 'evlog\u002Fhono'\nimport { enableDiagnosticsChannel } from 'evlog\u002Fdiagnostics'\n\nawait enableDiagnosticsChannel()\n\nconst app = new Hono()\napp.use(evlog())\n",[614,1177,1178,1183,1188,1208,1228,1246,1250,1258,1262,1280],{"__ignoreMap":691},[695,1179,1180],{"class":697,"line":698},[695,1181,1182],{"class":767},"\u002F\u002F Same shape for Express, Fastify, Elysia, NestJS and oRPC:\n",[695,1184,1185],{"class":697,"line":729},[695,1186,1187],{"class":767},"\u002F\u002F enable once in the server entry, before the app starts serving.\n",[695,1189,1190,1192,1194,1197,1199,1201,1203,1206],{"class":697,"line":736},[695,1191,702],{"class":701},[695,1193,706],{"class":705},[695,1195,1196],{"class":709}," Hono",[695,1198,713],{"class":705},[695,1200,716],{"class":701},[695,1202,719],{"class":705},[695,1204,1205],{"class":722},"hono",[695,1207,726],{"class":705},[695,1209,1210,1212,1214,1217,1219,1221,1223,1226],{"class":697,"line":793},[695,1211,702],{"class":701},[695,1213,706],{"class":705},[695,1215,1216],{"class":709}," evlog",[695,1218,713],{"class":705},[695,1220,716],{"class":701},[695,1222,719],{"class":705},[695,1224,1225],{"class":722},"evlog\u002Fhono",[695,1227,726],{"class":705},[695,1229,1230,1232,1234,1236,1238,1240,1242,1244],{"class":697,"line":821},[695,1231,702],{"class":701},[695,1233,706],{"class":705},[695,1235,710],{"class":709},[695,1237,713],{"class":705},[695,1239,716],{"class":701},[695,1241,719],{"class":705},[695,1243,723],{"class":722},[695,1245,726],{"class":705},[695,1247,1248],{"class":697,"line":832},[695,1249,733],{"emptyLinePlaceholder":732},[695,1251,1252,1254,1256],{"class":697,"line":968},[695,1253,739],{"class":701},[695,1255,710],{"class":742},[695,1257,745],{"class":709},[695,1259,1260],{"class":697,"line":1014},[695,1261,733],{"emptyLinePlaceholder":732},[695,1263,1264,1267,1270,1273,1276,1278],{"class":697,"line":1019},[695,1265,1266],{"class":808},"const",[695,1268,1269],{"class":709}," app ",[695,1271,1272],{"class":705},"=",[695,1274,1275],{"class":705}," new",[695,1277,1196],{"class":742},[695,1279,745],{"class":709},[695,1281,1282,1285,1287,1290,1292,1295],{"class":697,"line":1027},[695,1283,1284],{"class":709},"app",[695,1286,625],{"class":705},[695,1288,1289],{"class":742},"use",[695,1291,805],{"class":709},[695,1293,1294],{"class":742},"evlog",[695,1296,1297],{"class":709},"())\n",[686,1299,1301],{"className":688,"code":1300,"filename":295,"language":690,"meta":691,"style":691},"\u002F\u002F src\u002Fworker.ts — needs the nodejs_compat flag\nimport { initWorkersLogger, withEvlog } from 'evlog\u002Fworkers'\nimport { enableDiagnosticsChannel } from 'evlog\u002Fdiagnostics'\n\ninitWorkersLogger({ env: { service: 'my-worker' } })\nawait enableDiagnosticsChannel()\n\nexport default withEvlog(async (request, env, ctx, log) => {\n  log.set({ action: 'handle_request' })\n  return Response.json({ ok: true })\n})\n",[614,1302,1303,1308,1333,1351,1355,1388,1396,1400,1440,1470,1499],{"__ignoreMap":691},[695,1304,1305],{"class":697,"line":698},[695,1306,1307],{"class":767},"\u002F\u002F src\u002Fworker.ts — needs the nodejs_compat flag\n",[695,1309,1310,1312,1314,1317,1319,1322,1324,1326,1328,1331],{"class":697,"line":729},[695,1311,702],{"class":701},[695,1313,706],{"class":705},[695,1315,1316],{"class":709}," initWorkersLogger",[695,1318,887],{"class":705},[695,1320,1321],{"class":709}," withEvlog",[695,1323,713],{"class":705},[695,1325,716],{"class":701},[695,1327,719],{"class":705},[695,1329,1330],{"class":722},"evlog\u002Fworkers",[695,1332,726],{"class":705},[695,1334,1335,1337,1339,1341,1343,1345,1347,1349],{"class":697,"line":736},[695,1336,702],{"class":701},[695,1338,706],{"class":705},[695,1340,710],{"class":709},[695,1342,713],{"class":705},[695,1344,716],{"class":701},[695,1346,719],{"class":705},[695,1348,723],{"class":722},[695,1350,726],{"class":705},[695,1352,1353],{"class":697,"line":793},[695,1354,733],{"emptyLinePlaceholder":732},[695,1356,1357,1360,1362,1364,1367,1369,1371,1373,1375,1377,1380,1382,1384,1386],{"class":697,"line":821},[695,1358,1359],{"class":742},"initWorkersLogger",[695,1361,805],{"class":709},[695,1363,995],{"class":705},[695,1365,1366],{"class":829}," env",[695,1368,641],{"class":705},[695,1370,706],{"class":705},[695,1372,998],{"class":829},[695,1374,641],{"class":705},[695,1376,719],{"class":705},[695,1378,1379],{"class":722},"my-worker",[695,1381,932],{"class":705},[695,1383,713],{"class":705},[695,1385,713],{"class":705},[695,1387,838],{"class":709},[695,1389,1390,1392,1394],{"class":697,"line":832},[695,1391,739],{"class":701},[695,1393,710],{"class":742},[695,1395,745],{"class":709},[695,1397,1398],{"class":697,"line":968},[695,1399,733],{"emptyLinePlaceholder":732},[695,1401,1402,1404,1406,1408,1410,1412,1415,1419,1421,1423,1425,1428,1430,1433,1436,1438],{"class":697,"line":1014},[695,1403,796],{"class":701},[695,1405,799],{"class":701},[695,1407,1321],{"class":742},[695,1409,805],{"class":709},[695,1411,809],{"class":808},[695,1413,1414],{"class":705}," (",[695,1416,1418],{"class":1417},"sHdIc","request",[695,1420,887],{"class":705},[695,1422,1366],{"class":1417},[695,1424,887],{"class":705},[695,1426,1427],{"class":1417}," ctx",[695,1429,887],{"class":705},[695,1431,1432],{"class":1417}," log",[695,1434,1435],{"class":705},")",[695,1437,815],{"class":808},[695,1439,818],{"class":705},[695,1441,1442,1445,1447,1450,1452,1454,1457,1459,1461,1464,1466,1468],{"class":697,"line":1019},[695,1443,1444],{"class":709},"  log",[695,1446,625],{"class":705},[695,1448,1449],{"class":742},"set",[695,1451,805],{"class":829},[695,1453,995],{"class":705},[695,1455,1456],{"class":829}," action",[695,1458,641],{"class":705},[695,1460,719],{"class":705},[695,1462,1463],{"class":722},"handle_request",[695,1465,932],{"class":705},[695,1467,713],{"class":705},[695,1469,838],{"class":829},[695,1471,1472,1474,1477,1479,1482,1484,1486,1489,1491,1495,1497],{"class":697,"line":1027},[695,1473,1022],{"class":701},[695,1475,1476],{"class":709}," Response",[695,1478,625],{"class":705},[695,1480,1481],{"class":742},"json",[695,1483,805],{"class":829},[695,1485,995],{"class":705},[695,1487,1488],{"class":829}," ok",[695,1490,641],{"class":705},[695,1492,1494],{"class":1493},"sfNiH"," true",[695,1496,713],{"class":705},[695,1498,838],{"class":829},[695,1500,1501,1503],{"class":697,"line":1040},[695,1502,835],{"class":705},[695,1504,838],{"class":709},[686,1506,1508],{"className":688,"code":1507,"filename":300,"language":690,"meta":691,"style":691},"\u002F\u002F Any Node, Bun or Deno entry point\nimport { initLogger } from 'evlog'\nimport { enableDiagnosticsChannel } from 'evlog\u002Fdiagnostics'\n\ninitLogger({ env: { service: 'worker' } })\nawait enableDiagnosticsChannel()\n",[614,1509,1510,1515,1534,1552,1556,1588],{"__ignoreMap":691},[695,1511,1512],{"class":697,"line":698},[695,1513,1514],{"class":767},"\u002F\u002F Any Node, Bun or Deno entry point\n",[695,1516,1517,1519,1521,1524,1526,1528,1530,1532],{"class":697,"line":729},[695,1518,702],{"class":701},[695,1520,706],{"class":705},[695,1522,1523],{"class":709}," initLogger",[695,1525,713],{"class":705},[695,1527,716],{"class":701},[695,1529,719],{"class":705},[695,1531,1294],{"class":722},[695,1533,726],{"class":705},[695,1535,1536,1538,1540,1542,1544,1546,1548,1550],{"class":697,"line":736},[695,1537,702],{"class":701},[695,1539,706],{"class":705},[695,1541,710],{"class":709},[695,1543,713],{"class":705},[695,1545,716],{"class":701},[695,1547,719],{"class":705},[695,1549,723],{"class":722},[695,1551,726],{"class":705},[695,1553,1554],{"class":697,"line":793},[695,1555,733],{"emptyLinePlaceholder":732},[695,1557,1558,1561,1563,1565,1567,1569,1571,1573,1575,1577,1580,1582,1584,1586],{"class":697,"line":821},[695,1559,1560],{"class":742},"initLogger",[695,1562,805],{"class":709},[695,1564,995],{"class":705},[695,1566,1366],{"class":829},[695,1568,641],{"class":705},[695,1570,706],{"class":705},[695,1572,998],{"class":829},[695,1574,641],{"class":705},[695,1576,719],{"class":705},[695,1578,1579],{"class":722},"worker",[695,1581,932],{"class":705},[695,1583,713],{"class":705},[695,1585,713],{"class":705},[695,1587,838],{"class":709},[695,1589,1590,1592,1594],{"class":697,"line":832},[695,1591,739],{"class":701},[695,1593,710],{"class":742},[695,1595,745],{"class":709},[605,1597,1598,1601,1602,1604,1605,1607,1608,1610],{},[614,1599,1600],{},"enableDiagnosticsChannel()"," is async because it loads ",[614,1603,616],{}," lazily, which is what keeps the built-in out of the main bundle for Convex, workerd and other non-Node targets. Events emitted before the promise settles are not published, so call it at startup rather than inside a request. Frameworks whose entry point cannot use top-level ",[614,1606,739],{}," should call it from the same place they call ",[614,1609,624],{},", and await it there.",[1612,1613,1615,1616,1618,1619,1621],"callout",{"color":1614,"icon":13},"info","This is an observation side channel, not a transport. Subscribers run synchronously and are not awaited: no batching, no retry, no ",[614,1617,669],{},". For delivery to a backend, use a ",[608,1620,640],{"href":526},"; both see the same event.",[627,1623,1625],{"id":1624},"subscribing","Subscribing",[605,1627,1628],{},"The point of the channel is that a consumer needs nothing from evlog but the channel name:",[686,1630,1633],{"className":688,"code":1631,"filename":1632,"language":690,"meta":691,"style":691},"import { channel } from 'node:diagnostics_channel'\n\n\u002F** The published message. Declared locally so this file needs no evlog import. *\u002F\ntype EvlogMessage = { event: Record\u003Cstring, unknown> & { level: string; service: string } }\n\nchannel('evlog.event').subscribe((message) => {\n  const { event } = message as EvlogMessage\n  if (event.level === 'error') metrics.increment('errors', { path: String(event.path ?? 'unknown') })\n})\n","metrics.ts",[614,1634,1635,1654,1658,1663,1725,1729,1761,1782,1852],{"__ignoreMap":691},[695,1636,1637,1639,1641,1644,1646,1648,1650,1652],{"class":697,"line":698},[695,1638,702],{"class":701},[695,1640,706],{"class":705},[695,1642,1643],{"class":709}," channel",[695,1645,713],{"class":705},[695,1647,716],{"class":701},[695,1649,719],{"class":705},[695,1651,616],{"class":722},[695,1653,726],{"class":705},[695,1655,1656],{"class":697,"line":729},[695,1657,733],{"emptyLinePlaceholder":732},[695,1659,1660],{"class":697,"line":736},[695,1661,1662],{"class":767},"\u002F** The published message. Declared locally so this file needs no evlog import. *\u002F\n",[695,1664,1665,1668,1672,1674,1676,1679,1681,1684,1687,1690,1692,1695,1698,1701,1703,1706,1708,1711,1714,1716,1718,1720,1722],{"class":697,"line":793},[695,1666,1667],{"class":808},"type",[695,1669,1671],{"class":1670},"sBMFI"," EvlogMessage",[695,1673,895],{"class":705},[695,1675,706],{"class":705},[695,1677,1678],{"class":829}," event",[695,1680,641],{"class":705},[695,1682,1683],{"class":1670}," Record",[695,1685,1686],{"class":705},"\u003C",[695,1688,1689],{"class":1670},"string",[695,1691,887],{"class":705},[695,1693,1694],{"class":1670}," unknown",[695,1696,1697],{"class":705},">",[695,1699,1700],{"class":705}," &",[695,1702,706],{"class":705},[695,1704,1705],{"class":829}," level",[695,1707,641],{"class":705},[695,1709,1710],{"class":1670}," string",[695,1712,1713],{"class":705},";",[695,1715,998],{"class":829},[695,1717,641],{"class":705},[695,1719,1710],{"class":1670},[695,1721,713],{"class":705},[695,1723,1724],{"class":705}," }\n",[695,1726,1727],{"class":697,"line":821},[695,1728,733],{"emptyLinePlaceholder":732},[695,1730,1731,1734,1736,1738,1740,1742,1745,1748,1750,1752,1755,1757,1759],{"class":697,"line":832},[695,1732,1733],{"class":1670},"channel",[695,1735,805],{"class":709},[695,1737,932],{"class":705},[695,1739,620],{"class":722},[695,1741,932],{"class":705},[695,1743,1744],{"class":709},").",[695,1746,1747],{"class":1670},"subscribe",[695,1749,805],{"class":709},[695,1751,805],{"class":705},[695,1753,1754],{"class":1417},"message",[695,1756,1435],{"class":705},[695,1758,815],{"class":808},[695,1760,818],{"class":705},[695,1762,1763,1765,1767,1769,1771,1774,1776,1779],{"class":697,"line":968},[695,1764,912],{"class":1670},[695,1766,706],{"class":705},[695,1768,1678],{"class":829},[695,1770,713],{"class":705},[695,1772,1773],{"class":709}," = ",[695,1775,1754],{"class":1670},[695,1777,1778],{"class":1670}," as",[695,1780,1781],{"class":829}," EvlogMessage\n",[695,1783,1784,1787,1789,1792,1794,1797,1799,1801,1804,1807,1809,1811,1814,1816,1818,1820,1823,1825,1828,1831,1833,1836,1839,1841,1844,1846,1849],{"class":697,"line":1014},[695,1785,1786],{"class":829},"  if",[695,1788,1414],{"class":705},[695,1790,1791],{"class":709},"event.level === ",[695,1793,932],{"class":705},[695,1795,1796],{"class":722},"error",[695,1798,932],{"class":705},[695,1800,1435],{"class":705},[695,1802,1803],{"class":709}," metrics.",[695,1805,1806],{"class":829},"increment",[695,1808,805],{"class":705},[695,1810,932],{"class":705},[695,1812,1813],{"class":722},"errors",[695,1815,932],{"class":705},[695,1817,887],{"class":705},[695,1819,706],{"class":705},[695,1821,1822],{"class":829}," path",[695,1824,641],{"class":705},[695,1826,1827],{"class":1417}," String",[695,1829,1830],{"class":709},"(event",[695,1832,625],{"class":705},[695,1834,1835],{"class":709},"path ",[695,1837,1838],{"class":705},"??",[695,1840,719],{"class":705},[695,1842,1843],{"class":722},"unknown",[695,1845,932],{"class":705},[695,1847,1848],{"class":709},") ",[695,1850,1851],{"class":705},"})\n",[695,1853,1854,1856],{"class":697,"line":1019},[695,1855,835],{"class":705},[695,1857,838],{"class":709},[605,1859,1860,1861,1863,1864,1867,1868,1871],{},"Node types the published message as ",[614,1862,1843],{},", so narrow it once at the top of your handler. ",[614,1865,1866],{},"channel(name).subscribe()"," is used rather than the module-level ",[614,1869,1870],{},"subscribe()"," because it exists on every Node that evlog supports.",[605,1873,1874],{},"If you already depend on evlog and want the payload typed:",[686,1876,1879],{"className":688,"code":1877,"filename":1878,"language":690,"meta":691,"style":691},"import { subscribeToWideEvents } from 'evlog\u002Fdiagnostics'\n\nconst stop = await subscribeToWideEvents((event) => {\n  \u002F\u002F                                       ^? WideEvent\n  if (typeof event.status === 'number' && event.status >= 500) {\n    alerts.push({ path: String(event.path ?? '-'), requestId: String(event.requestId ?? '-') })\n  }\n})\n","alerts.ts",[614,1880,1881,1900,1904,1930,1935,1982,2055,2059],{"__ignoreMap":691},[695,1882,1883,1885,1887,1890,1892,1894,1896,1898],{"class":697,"line":698},[695,1884,702],{"class":701},[695,1886,706],{"class":705},[695,1888,1889],{"class":709}," subscribeToWideEvents",[695,1891,713],{"class":705},[695,1893,716],{"class":701},[695,1895,719],{"class":705},[695,1897,723],{"class":722},[695,1899,726],{"class":705},[695,1901,1902],{"class":697,"line":729},[695,1903,733],{"emptyLinePlaceholder":732},[695,1905,1906,1908,1911,1913,1915,1917,1919,1921,1924,1926,1928],{"class":697,"line":736},[695,1907,1266],{"class":808},[695,1909,1910],{"class":709}," stop ",[695,1912,1272],{"class":705},[695,1914,924],{"class":701},[695,1916,1889],{"class":742},[695,1918,805],{"class":709},[695,1920,805],{"class":705},[695,1922,1923],{"class":1417},"event",[695,1925,1435],{"class":705},[695,1927,815],{"class":808},[695,1929,818],{"class":705},[695,1931,1932],{"class":697,"line":793},[695,1933,1934],{"class":767},"  \u002F\u002F                                       ^? WideEvent\n",[695,1936,1937,1939,1941,1944,1946,1948,1951,1954,1956,1959,1961,1964,1966,1968,1970,1973,1977,1979],{"class":697,"line":821},[695,1938,1786],{"class":701},[695,1940,1414],{"class":829},[695,1942,1943],{"class":705},"typeof",[695,1945,1678],{"class":709},[695,1947,625],{"class":705},[695,1949,1950],{"class":709},"status",[695,1952,1953],{"class":705}," ===",[695,1955,719],{"class":705},[695,1957,1958],{"class":722},"number",[695,1960,932],{"class":705},[695,1962,1963],{"class":705}," &&",[695,1965,1678],{"class":709},[695,1967,625],{"class":705},[695,1969,1950],{"class":709},[695,1971,1972],{"class":705}," >=",[695,1974,1976],{"class":1975},"sbssI"," 500",[695,1978,1848],{"class":829},[695,1980,1981],{"class":705},"{\n",[695,1983,1984,1987,1989,1992,1994,1996,1998,2000,2002,2004,2006,2008,2011,2014,2016,2019,2021,2023,2025,2028,2030,2032,2034,2036,2038,2041,2043,2045,2047,2049,2051,2053],{"class":697,"line":832},[695,1985,1986],{"class":709},"    alerts",[695,1988,625],{"class":705},[695,1990,1991],{"class":742},"push",[695,1993,805],{"class":829},[695,1995,995],{"class":705},[695,1997,1822],{"class":829},[695,1999,641],{"class":705},[695,2001,1827],{"class":742},[695,2003,805],{"class":829},[695,2005,1923],{"class":709},[695,2007,625],{"class":705},[695,2009,2010],{"class":709},"path",[695,2012,2013],{"class":705}," ??",[695,2015,719],{"class":705},[695,2017,2018],{"class":722},"-",[695,2020,932],{"class":705},[695,2022,1435],{"class":829},[695,2024,887],{"class":705},[695,2026,2027],{"class":829}," requestId",[695,2029,641],{"class":705},[695,2031,1827],{"class":742},[695,2033,805],{"class":829},[695,2035,1923],{"class":709},[695,2037,625],{"class":705},[695,2039,2040],{"class":709},"requestId",[695,2042,2013],{"class":705},[695,2044,719],{"class":705},[695,2046,2018],{"class":722},[695,2048,932],{"class":705},[695,2050,1848],{"class":829},[695,2052,835],{"class":705},[695,2054,838],{"class":829},[695,2056,2057],{"class":697,"line":968},[695,2058,1077],{"class":705},[695,2060,2061,2063],{"class":697,"line":1014},[695,2062,835],{"class":705},[695,2064,838],{"class":709},[605,2066,2067,2068,2071,2072,2074],{},"Fields beyond the ",[608,2069,2070],{"href":52},"base event"," are typed ",[614,2073,1843],{},", and events emitted outside a request carry no HTTP fields at all, so narrow before using them rather than casting.",[627,2076,2078],{"id":2077},"what-a-subscriber-receives","What a subscriber receives",[605,2080,2081],{},"The same object a drain receives: post-audit, post-redaction, post-enrich. Requests carry everything enrichers added: geo, user agent, trace context:",[686,2083,2086],{"className":2084,"code":2085,"language":1481,"meta":691,"style":691},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"timestamp\": \"2026-08-02T10:23:45.612Z\",\n  \"level\": \"error\",\n  \"service\": \"checkout\",\n  \"environment\": \"production\",\n  \"method\": \"POST\",\n  \"path\": \"\u002Fapi\u002Fcheckout\",\n  \"status\": 500,\n  \"duration\": \"1.20s\",\n  \"requestId\": \"4a8ff3a8-...\",\n  \"user\": { \"id\": \"usr_123\", \"plan\": \"premium\" },\n  \"error\": { \"name\": \"PaymentDeclined\", \"message\": \"Card declined\" }\n}\n",[614,2087,2088,2092,2115,2134,2154,2174,2194,2213,2227,2247,2266,2316,2363],{"__ignoreMap":691},[695,2089,2090],{"class":697,"line":698},[695,2091,1981],{"class":705},[695,2093,2094,2097,2100,2103,2105,2108,2111,2113],{"class":697,"line":729},[695,2095,2096],{"class":705},"  \"",[695,2098,2099],{"class":808},"timestamp",[695,2101,2102],{"class":705},"\"",[695,2104,641],{"class":705},[695,2106,2107],{"class":705}," \"",[695,2109,2110],{"class":722},"2026-08-02T10:23:45.612Z",[695,2112,2102],{"class":705},[695,2114,1071],{"class":705},[695,2116,2117,2119,2122,2124,2126,2128,2130,2132],{"class":697,"line":736},[695,2118,2096],{"class":705},[695,2120,2121],{"class":808},"level",[695,2123,2102],{"class":705},[695,2125,641],{"class":705},[695,2127,2107],{"class":705},[695,2129,1796],{"class":722},[695,2131,2102],{"class":705},[695,2133,1071],{"class":705},[695,2135,2136,2138,2141,2143,2145,2147,2150,2152],{"class":697,"line":793},[695,2137,2096],{"class":705},[695,2139,2140],{"class":808},"service",[695,2142,2102],{"class":705},[695,2144,641],{"class":705},[695,2146,2107],{"class":705},[695,2148,2149],{"class":722},"checkout",[695,2151,2102],{"class":705},[695,2153,1071],{"class":705},[695,2155,2156,2158,2161,2163,2165,2167,2170,2172],{"class":697,"line":821},[695,2157,2096],{"class":705},[695,2159,2160],{"class":808},"environment",[695,2162,2102],{"class":705},[695,2164,641],{"class":705},[695,2166,2107],{"class":705},[695,2168,2169],{"class":722},"production",[695,2171,2102],{"class":705},[695,2173,1071],{"class":705},[695,2175,2176,2178,2181,2183,2185,2187,2190,2192],{"class":697,"line":832},[695,2177,2096],{"class":705},[695,2179,2180],{"class":808},"method",[695,2182,2102],{"class":705},[695,2184,641],{"class":705},[695,2186,2107],{"class":705},[695,2188,2189],{"class":722},"POST",[695,2191,2102],{"class":705},[695,2193,1071],{"class":705},[695,2195,2196,2198,2200,2202,2204,2206,2209,2211],{"class":697,"line":968},[695,2197,2096],{"class":705},[695,2199,2010],{"class":808},[695,2201,2102],{"class":705},[695,2203,641],{"class":705},[695,2205,2107],{"class":705},[695,2207,2208],{"class":722},"\u002Fapi\u002Fcheckout",[695,2210,2102],{"class":705},[695,2212,1071],{"class":705},[695,2214,2215,2217,2219,2221,2223,2225],{"class":697,"line":1014},[695,2216,2096],{"class":705},[695,2218,1950],{"class":808},[695,2220,2102],{"class":705},[695,2222,641],{"class":705},[695,2224,1976],{"class":1975},[695,2226,1071],{"class":705},[695,2228,2229,2231,2234,2236,2238,2240,2243,2245],{"class":697,"line":1019},[695,2230,2096],{"class":705},[695,2232,2233],{"class":808},"duration",[695,2235,2102],{"class":705},[695,2237,641],{"class":705},[695,2239,2107],{"class":705},[695,2241,2242],{"class":722},"1.20s",[695,2244,2102],{"class":705},[695,2246,1071],{"class":705},[695,2248,2249,2251,2253,2255,2257,2259,2262,2264],{"class":697,"line":1027},[695,2250,2096],{"class":705},[695,2252,2040],{"class":808},[695,2254,2102],{"class":705},[695,2256,641],{"class":705},[695,2258,2107],{"class":705},[695,2260,2261],{"class":722},"4a8ff3a8-...",[695,2263,2102],{"class":705},[695,2265,1071],{"class":705},[695,2267,2268,2270,2273,2275,2277,2279,2281,2284,2286,2288,2290,2293,2295,2297,2299,2302,2304,2306,2308,2311,2313],{"class":697,"line":1040},[695,2269,2096],{"class":705},[695,2271,2272],{"class":808},"user",[695,2274,2102],{"class":705},[695,2276,641],{"class":705},[695,2278,706],{"class":705},[695,2280,2107],{"class":705},[695,2282,2283],{"class":1670},"id",[695,2285,2102],{"class":705},[695,2287,641],{"class":705},[695,2289,2107],{"class":705},[695,2291,2292],{"class":722},"usr_123",[695,2294,2102],{"class":705},[695,2296,887],{"class":705},[695,2298,2107],{"class":705},[695,2300,2301],{"class":1670},"plan",[695,2303,2102],{"class":705},[695,2305,641],{"class":705},[695,2307,2107],{"class":705},[695,2309,2310],{"class":722},"premium",[695,2312,2102],{"class":705},[695,2314,2315],{"class":705}," },\n",[695,2317,2318,2320,2322,2324,2326,2328,2330,2333,2335,2337,2339,2342,2344,2346,2348,2350,2352,2354,2356,2359,2361],{"class":697,"line":1050},[695,2319,2096],{"class":705},[695,2321,1796],{"class":808},[695,2323,2102],{"class":705},[695,2325,641],{"class":705},[695,2327,706],{"class":705},[695,2329,2107],{"class":705},[695,2331,2332],{"class":1670},"name",[695,2334,2102],{"class":705},[695,2336,641],{"class":705},[695,2338,2107],{"class":705},[695,2340,2341],{"class":722},"PaymentDeclined",[695,2343,2102],{"class":705},[695,2345,887],{"class":705},[695,2347,2107],{"class":705},[695,2349,1754],{"class":1670},[695,2351,2102],{"class":705},[695,2353,641],{"class":705},[695,2355,2107],{"class":705},[695,2357,2358],{"class":722},"Card declined",[695,2360,2102],{"class":705},[695,2362,1724],{"class":705},[695,2364,2365],{"class":697,"line":1059},[695,2366,2367],{"class":705},"}\n",[605,2369,2370,2371,2374,2375,2378,2379,2382,2383,2386,2387,625],{},"Events emitted outside a request (",[614,2372,2373],{},"log.info({ ... })",", ",[614,2376,2377],{},"createLogger().emit()",") arrive without the HTTP fields, and events from ",[614,2380,2381],{},"log.fork()"," carry ",[614,2384,2385],{},"operation"," and ",[614,2388,2389],{},"_parentRequestId",[1612,2391,2394,2395,2398,2399,2402],{"color":2392,"icon":2393},"warning","i-lucide-triangle-alert","The event is the live object, not a copy, so mutating it mutates what drains receive. Treat it as read-only. And a subscriber that throws is ",[649,2396,2397],{},"not"," contained: ",[614,2400,2401],{},"Channel.publish()"," re-raises it as an uncaught exception on the next tick, which is fatal in most apps. Keep subscribers total.",[605,2404,2405,2406,2409],{},"In pretty mode (the dev default), tagged logs like ",[614,2407,2408],{},"log.info('auth', 'User logged in')"," are written straight to the console and never become wide events, so they do not appear on the channel. Wide events themselves are published in both modes.",[627,2411,2413],{"id":2412},"what-you-can-build","What you can build",[2415,2416,2418],"h3",{"id":2417},"an-integration-that-does-not-depend-on-evlog","An integration that does not depend on evlog",[605,2420,2421,2422,2424],{},"A package that subscribes needs the channel name and nothing else: no ",[614,2423,1294],{}," dependency, no peer range to keep in sync, no wiring in the host app beyond importing it:",[686,2426,2429],{"className":688,"code":2427,"filename":2428,"language":690,"meta":691,"style":691},"import { channel } from 'node:diagnostics_channel'\n\ntype EvlogMessage = {\n  event: Record\u003Cstring, unknown> & { timestamp: string; level: string; service: string }\n}\n\nchannel('evlog.event').subscribe((message) => {\n  const { event } = message as EvlogMessage\n\n  acme.ingest({\n    at: event.timestamp,\n    level: event.level,\n    service: event.service,\n    attributes: event,\n  })\n})\n","acme-apm\u002Fsrc\u002Fevlog.ts",[614,2430,2431,2449,2453,2463,2511,2515,2519,2547,2565,2569,2583,2598,2613,2628,2639,2646],{"__ignoreMap":691},[695,2432,2433,2435,2437,2439,2441,2443,2445,2447],{"class":697,"line":698},[695,2434,702],{"class":701},[695,2436,706],{"class":705},[695,2438,1643],{"class":709},[695,2440,713],{"class":705},[695,2442,716],{"class":701},[695,2444,719],{"class":705},[695,2446,616],{"class":722},[695,2448,726],{"class":705},[695,2450,2451],{"class":697,"line":729},[695,2452,733],{"emptyLinePlaceholder":732},[695,2454,2455,2457,2459,2461],{"class":697,"line":736},[695,2456,1667],{"class":808},[695,2458,1671],{"class":1670},[695,2460,895],{"class":705},[695,2462,818],{"class":705},[695,2464,2465,2468,2470,2472,2474,2476,2478,2480,2482,2484,2486,2489,2491,2493,2495,2497,2499,2501,2503,2505,2507,2509],{"class":697,"line":793},[695,2466,2467],{"class":829},"  event",[695,2469,641],{"class":705},[695,2471,1683],{"class":1670},[695,2473,1686],{"class":705},[695,2475,1689],{"class":1670},[695,2477,887],{"class":705},[695,2479,1694],{"class":1670},[695,2481,1697],{"class":705},[695,2483,1700],{"class":705},[695,2485,706],{"class":705},[695,2487,2488],{"class":829}," timestamp",[695,2490,641],{"class":705},[695,2492,1710],{"class":1670},[695,2494,1713],{"class":705},[695,2496,1705],{"class":829},[695,2498,641],{"class":705},[695,2500,1710],{"class":1670},[695,2502,1713],{"class":705},[695,2504,998],{"class":829},[695,2506,641],{"class":705},[695,2508,1710],{"class":1670},[695,2510,1724],{"class":705},[695,2512,2513],{"class":697,"line":821},[695,2514,2367],{"class":705},[695,2516,2517],{"class":697,"line":832},[695,2518,733],{"emptyLinePlaceholder":732},[695,2520,2521,2523,2525,2527,2529,2531,2533,2535,2537,2539,2541,2543,2545],{"class":697,"line":968},[695,2522,1733],{"class":1670},[695,2524,805],{"class":709},[695,2526,932],{"class":705},[695,2528,620],{"class":722},[695,2530,932],{"class":705},[695,2532,1744],{"class":709},[695,2534,1747],{"class":1670},[695,2536,805],{"class":709},[695,2538,805],{"class":705},[695,2540,1754],{"class":1417},[695,2542,1435],{"class":705},[695,2544,815],{"class":808},[695,2546,818],{"class":705},[695,2548,2549,2551,2553,2555,2557,2559,2561,2563],{"class":697,"line":1014},[695,2550,912],{"class":1670},[695,2552,706],{"class":705},[695,2554,1678],{"class":829},[695,2556,713],{"class":705},[695,2558,1773],{"class":709},[695,2560,1754],{"class":1670},[695,2562,1778],{"class":1670},[695,2564,1781],{"class":829},[695,2566,2567],{"class":697,"line":1019},[695,2568,733],{"emptyLinePlaceholder":732},[695,2570,2571,2574,2576,2579,2581],{"class":697,"line":1027},[695,2572,2573],{"class":1670},"  acme",[695,2575,625],{"class":705},[695,2577,2578],{"class":1670},"ingest",[695,2580,805],{"class":709},[695,2582,1981],{"class":705},[695,2584,2585,2588,2590,2592,2594,2596],{"class":697,"line":1040},[695,2586,2587],{"class":829},"    at",[695,2589,641],{"class":705},[695,2591,1678],{"class":1670},[695,2593,625],{"class":705},[695,2595,2099],{"class":1670},[695,2597,1071],{"class":705},[695,2599,2600,2603,2605,2607,2609,2611],{"class":697,"line":1050},[695,2601,2602],{"class":829},"    level",[695,2604,641],{"class":705},[695,2606,1678],{"class":1670},[695,2608,625],{"class":705},[695,2610,2121],{"class":1670},[695,2612,1071],{"class":705},[695,2614,2615,2618,2620,2622,2624,2626],{"class":697,"line":1059},[695,2616,2617],{"class":829},"    service",[695,2619,641],{"class":705},[695,2621,1678],{"class":1670},[695,2623,625],{"class":705},[695,2625,2140],{"class":1670},[695,2627,1071],{"class":705},[695,2629,2630,2633,2635,2637],{"class":697,"line":1065},[695,2631,2632],{"class":829},"    attributes",[695,2634,641],{"class":705},[695,2636,1678],{"class":1670},[695,2638,1071],{"class":705},[695,2640,2641,2644],{"class":697,"line":1074},[695,2642,2643],{"class":705},"  }",[695,2645,838],{"class":709},[695,2647,2648,2650],{"class":697,"line":1080},[695,2649,835],{"class":705},[695,2651,838],{"class":709},[686,2653,2656],{"className":688,"code":2654,"filename":2655,"language":690,"meta":691,"style":691},"import 'acme-apm\u002Fevlog'\n","the host app",[614,2657,2658],{"__ignoreMap":691},[695,2659,2660,2662,2664,2667],{"class":697,"line":698},[695,2661,702],{"class":701},[695,2663,719],{"class":705},[695,2665,2666],{"class":722},"acme-apm\u002Fevlog",[695,2668,726],{"class":705},[605,2670,2671,2672,625],{},"The same shape works for an internal library shared across services: one package subscribes, every service that imports it reports, and none of them touch ",[614,2673,624],{},[2415,2675,2677],{"id":2676},"counters-and-alerts-next-to-your-app","Counters and alerts next to your app",[605,2679,2680],{},"A subscriber is a plain function, so anything you can compute in-process you can compute here, without giving up the drain slot, which stays free for shipping events to your backend:",[686,2682,2685],{"className":688,"code":2683,"filename":2684,"language":690,"meta":691,"style":691},"import { channel } from 'node:diagnostics_channel'\n\nconst errorsByPath = new Map\u003Cstring, number>()\n\nchannel('evlog.event').subscribe((message) => {\n  const { event } = message as { event: Record\u003Cstring, unknown> & { level: string } }\n  if (event.level !== 'error') return\n\n  const path = String(event.path ?? 'unknown')\n  errorsByPath.set(path, (errorsByPath.get(path) ?? 0) + 1)\n\n  if (typeof event.status === 'number' && event.status >= 500) {\n    void pager.notify(`5xx on ${path}`, { requestId: event.requestId })\n  }\n})\n\nexport function errorCounts(): Record\u003Cstring, number> {\n  return Object.fromEntries(errorsByPath)\n}\n","observability.ts",[614,2686,2687,2705,2709,2736,2740,2770,2819,2845,2849,2877,2923,2927,2965,3012,3016,3022,3026,3054,3073],{"__ignoreMap":691},[695,2688,2689,2691,2693,2695,2697,2699,2701,2703],{"class":697,"line":698},[695,2690,702],{"class":701},[695,2692,706],{"class":705},[695,2694,1643],{"class":709},[695,2696,713],{"class":705},[695,2698,716],{"class":701},[695,2700,719],{"class":705},[695,2702,616],{"class":722},[695,2704,726],{"class":705},[695,2706,2707],{"class":697,"line":729},[695,2708,733],{"emptyLinePlaceholder":732},[695,2710,2711,2713,2716,2718,2720,2723,2725,2727,2729,2732,2734],{"class":697,"line":736},[695,2712,1266],{"class":808},[695,2714,2715],{"class":709}," errorsByPath ",[695,2717,1272],{"class":705},[695,2719,1275],{"class":705},[695,2721,2722],{"class":742}," Map",[695,2724,1686],{"class":705},[695,2726,1689],{"class":1670},[695,2728,887],{"class":705},[695,2730,2731],{"class":1670}," number",[695,2733,1697],{"class":705},[695,2735,745],{"class":709},[695,2737,2738],{"class":697,"line":793},[695,2739,733],{"emptyLinePlaceholder":732},[695,2741,2742,2744,2746,2748,2750,2752,2754,2756,2758,2760,2762,2764,2766,2768],{"class":697,"line":821},[695,2743,1733],{"class":742},[695,2745,805],{"class":709},[695,2747,932],{"class":705},[695,2749,620],{"class":722},[695,2751,932],{"class":705},[695,2753,1435],{"class":709},[695,2755,625],{"class":705},[695,2757,1747],{"class":742},[695,2759,805],{"class":709},[695,2761,805],{"class":705},[695,2763,1754],{"class":1417},[695,2765,1435],{"class":705},[695,2767,815],{"class":808},[695,2769,818],{"class":705},[695,2771,2772,2774,2776,2778,2780,2782,2785,2787,2789,2791,2793,2795,2797,2799,2801,2803,2805,2807,2809,2811,2813,2815,2817],{"class":697,"line":832},[695,2773,912],{"class":808},[695,2775,706],{"class":705},[695,2777,1678],{"class":709},[695,2779,713],{"class":705},[695,2781,895],{"class":705},[695,2783,2784],{"class":709}," message",[695,2786,1778],{"class":701},[695,2788,706],{"class":705},[695,2790,1678],{"class":829},[695,2792,641],{"class":705},[695,2794,1683],{"class":1670},[695,2796,1686],{"class":705},[695,2798,1689],{"class":1670},[695,2800,887],{"class":705},[695,2802,1694],{"class":1670},[695,2804,1697],{"class":705},[695,2806,1700],{"class":705},[695,2808,706],{"class":705},[695,2810,1705],{"class":829},[695,2812,641],{"class":705},[695,2814,1710],{"class":1670},[695,2816,713],{"class":705},[695,2818,1724],{"class":705},[695,2820,2821,2823,2825,2827,2829,2831,2834,2836,2838,2840,2842],{"class":697,"line":968},[695,2822,1786],{"class":701},[695,2824,1414],{"class":829},[695,2826,1923],{"class":709},[695,2828,625],{"class":705},[695,2830,2121],{"class":709},[695,2832,2833],{"class":705}," !==",[695,2835,719],{"class":705},[695,2837,1796],{"class":722},[695,2839,932],{"class":705},[695,2841,1848],{"class":829},[695,2843,2844],{"class":701},"return\n",[695,2846,2847],{"class":697,"line":1014},[695,2848,733],{"emptyLinePlaceholder":732},[695,2850,2851,2853,2855,2857,2859,2861,2863,2865,2867,2869,2871,2873,2875],{"class":697,"line":1019},[695,2852,912],{"class":808},[695,2854,1822],{"class":709},[695,2856,895],{"class":705},[695,2858,1827],{"class":742},[695,2860,805],{"class":829},[695,2862,1923],{"class":709},[695,2864,625],{"class":705},[695,2866,2010],{"class":709},[695,2868,2013],{"class":705},[695,2870,719],{"class":705},[695,2872,1843],{"class":722},[695,2874,932],{"class":705},[695,2876,838],{"class":829},[695,2878,2879,2882,2884,2886,2888,2890,2892,2894,2897,2899,2902,2904,2906,2908,2910,2913,2915,2918,2921],{"class":697,"line":1027},[695,2880,2881],{"class":709},"  errorsByPath",[695,2883,625],{"class":705},[695,2885,1449],{"class":742},[695,2887,805],{"class":829},[695,2889,2010],{"class":709},[695,2891,887],{"class":705},[695,2893,1414],{"class":829},[695,2895,2896],{"class":709},"errorsByPath",[695,2898,625],{"class":705},[695,2900,2901],{"class":742},"get",[695,2903,805],{"class":829},[695,2905,2010],{"class":709},[695,2907,1848],{"class":829},[695,2909,1838],{"class":705},[695,2911,2912],{"class":1975}," 0",[695,2914,1848],{"class":829},[695,2916,2917],{"class":705},"+",[695,2919,2920],{"class":1975}," 1",[695,2922,838],{"class":829},[695,2924,2925],{"class":697,"line":1040},[695,2926,733],{"emptyLinePlaceholder":732},[695,2928,2929,2931,2933,2935,2937,2939,2941,2943,2945,2947,2949,2951,2953,2955,2957,2959,2961,2963],{"class":697,"line":1050},[695,2930,1786],{"class":701},[695,2932,1414],{"class":829},[695,2934,1943],{"class":705},[695,2936,1678],{"class":709},[695,2938,625],{"class":705},[695,2940,1950],{"class":709},[695,2942,1953],{"class":705},[695,2944,719],{"class":705},[695,2946,1958],{"class":722},[695,2948,932],{"class":705},[695,2950,1963],{"class":705},[695,2952,1678],{"class":709},[695,2954,625],{"class":705},[695,2956,1950],{"class":709},[695,2958,1972],{"class":705},[695,2960,1976],{"class":1975},[695,2962,1848],{"class":829},[695,2964,1981],{"class":705},[695,2966,2967,2970,2973,2975,2978,2980,2983,2986,2989,2991,2994,2996,2998,3000,3002,3004,3006,3008,3010],{"class":697,"line":1059},[695,2968,2969],{"class":705},"    void",[695,2971,2972],{"class":709}," pager",[695,2974,625],{"class":705},[695,2976,2977],{"class":742},"notify",[695,2979,805],{"class":829},[695,2981,2982],{"class":705},"`",[695,2984,2985],{"class":722},"5xx on ",[695,2987,2988],{"class":705},"${",[695,2990,2010],{"class":709},[695,2992,2993],{"class":705},"}`",[695,2995,887],{"class":705},[695,2997,706],{"class":705},[695,2999,2027],{"class":829},[695,3001,641],{"class":705},[695,3003,1678],{"class":709},[695,3005,625],{"class":705},[695,3007,2040],{"class":709},[695,3009,713],{"class":705},[695,3011,838],{"class":829},[695,3013,3014],{"class":697,"line":1065},[695,3015,1077],{"class":705},[695,3017,3018,3020],{"class":697,"line":1074},[695,3019,835],{"class":705},[695,3021,838],{"class":709},[695,3023,3024],{"class":697,"line":1080},[695,3025,733],{"emptyLinePlaceholder":732},[695,3027,3029,3031,3034,3037,3040,3042,3044,3046,3048,3050,3052],{"class":697,"line":3028},17,[695,3030,796],{"class":701},[695,3032,3033],{"class":808}," function",[695,3035,3036],{"class":742}," errorCounts",[695,3038,3039],{"class":705},"():",[695,3041,1683],{"class":1670},[695,3043,1686],{"class":705},[695,3045,1689],{"class":1670},[695,3047,887],{"class":705},[695,3049,2731],{"class":1670},[695,3051,1697],{"class":705},[695,3053,818],{"class":705},[695,3055,3057,3059,3062,3064,3067,3069,3071],{"class":697,"line":3056},18,[695,3058,1022],{"class":701},[695,3060,3061],{"class":709}," Object",[695,3063,625],{"class":705},[695,3065,3066],{"class":742},"fromEntries",[695,3068,805],{"class":829},[695,3070,2896],{"class":709},[695,3072,838],{"class":829},[695,3074,3076],{"class":697,"line":3075},19,[695,3077,2367],{"class":705},[605,3079,3080,3081,3083],{},"A ",[608,3082,636],{"href":509}," does this too, and is the better choice when the code lives in your own app. The channel wins when the subscriber ships as a separate package, or when it has to attach without editing the app's logger configuration.",[627,3085,295],{"id":3086},"cloudflare-workers",[605,3088,3089,3090,3094,3095,3097],{},"Workers forwards every diagnostics channel message to a ",[608,3091,665],{"href":3092,"rel":3093},"https:\u002F\u002Fdevelopers.cloudflare.com\u002Fworkers\u002Fobservability\u002Flogs\u002Ftail-workers\u002F",[612],". Enable the channel in your Worker and the wide events leave the isolate with no drain, no ",[614,3096,669],{},", and their own CPU budget, and the Tail Worker does the shipping, after the response has already gone out:",[686,3099,3102],{"className":688,"code":3100,"filename":3101,"language":690,"meta":691,"style":691},"export default {\n  async tail(events) {\n    for (const event of events) {\n      for (const messageData of event.diagnosticsChannelEvents) {\n        if (messageData.channel !== 'evlog.event') continue\n\n        await fetch('https:\u002F\u002Flogs.example.com\u002Fingest', {\n          method: 'POST',\n          headers: { 'Content-Type': 'application\u002Fjson' },\n          body: JSON.stringify(messageData.message.event),\n        })\n      }\n    }\n  },\n}\n","tail-worker\u002Findex.ts",[614,3103,3104,3112,3129,3150,3175,3202,3206,3227,3242,3269,3300,3307,3312,3317,3322],{"__ignoreMap":691},[695,3105,3106,3108,3110],{"class":697,"line":698},[695,3107,796],{"class":701},[695,3109,799],{"class":701},[695,3111,818],{"class":705},[695,3113,3114,3117,3120,3122,3125,3127],{"class":697,"line":729},[695,3115,3116],{"class":808},"  async",[695,3118,3119],{"class":829}," tail",[695,3121,805],{"class":705},[695,3123,3124],{"class":1417},"events",[695,3126,1435],{"class":705},[695,3128,818],{"class":705},[695,3130,3131,3134,3136,3138,3140,3143,3146,3148],{"class":697,"line":736},[695,3132,3133],{"class":701},"    for",[695,3135,1414],{"class":829},[695,3137,1266],{"class":808},[695,3139,1678],{"class":709},[695,3141,3142],{"class":705}," of",[695,3144,3145],{"class":709}," events",[695,3147,1848],{"class":829},[695,3149,1981],{"class":705},[695,3151,3152,3155,3157,3159,3162,3164,3166,3168,3171,3173],{"class":697,"line":793},[695,3153,3154],{"class":701},"      for",[695,3156,1414],{"class":829},[695,3158,1266],{"class":808},[695,3160,3161],{"class":709}," messageData",[695,3163,3142],{"class":705},[695,3165,1678],{"class":709},[695,3167,625],{"class":705},[695,3169,3170],{"class":709},"diagnosticsChannelEvents",[695,3172,1848],{"class":829},[695,3174,1981],{"class":705},[695,3176,3177,3180,3182,3185,3187,3189,3191,3193,3195,3197,3199],{"class":697,"line":821},[695,3178,3179],{"class":701},"        if",[695,3181,1414],{"class":829},[695,3183,3184],{"class":709},"messageData",[695,3186,625],{"class":705},[695,3188,1733],{"class":709},[695,3190,2833],{"class":705},[695,3192,719],{"class":705},[695,3194,620],{"class":722},[695,3196,932],{"class":705},[695,3198,1848],{"class":829},[695,3200,3201],{"class":701},"continue\n",[695,3203,3204],{"class":697,"line":832},[695,3205,733],{"emptyLinePlaceholder":732},[695,3207,3208,3211,3214,3216,3218,3221,3223,3225],{"class":697,"line":968},[695,3209,3210],{"class":701},"        await",[695,3212,3213],{"class":742}," fetch",[695,3215,805],{"class":829},[695,3217,932],{"class":705},[695,3219,3220],{"class":722},"https:\u002F\u002Flogs.example.com\u002Fingest",[695,3222,932],{"class":705},[695,3224,887],{"class":705},[695,3226,818],{"class":705},[695,3228,3229,3232,3234,3236,3238,3240],{"class":697,"line":1014},[695,3230,3231],{"class":829},"          method",[695,3233,641],{"class":705},[695,3235,719],{"class":705},[695,3237,2189],{"class":722},[695,3239,932],{"class":705},[695,3241,1071],{"class":705},[695,3243,3244,3247,3249,3251,3253,3256,3258,3260,3262,3265,3267],{"class":697,"line":1019},[695,3245,3246],{"class":829},"          headers",[695,3248,641],{"class":705},[695,3250,706],{"class":705},[695,3252,719],{"class":705},[695,3254,3255],{"class":829},"Content-Type",[695,3257,932],{"class":705},[695,3259,641],{"class":705},[695,3261,719],{"class":705},[695,3263,3264],{"class":722},"application\u002Fjson",[695,3266,932],{"class":705},[695,3268,2315],{"class":705},[695,3270,3271,3274,3276,3279,3281,3284,3286,3288,3290,3292,3294,3296,3298],{"class":697,"line":1027},[695,3272,3273],{"class":829},"          body",[695,3275,641],{"class":705},[695,3277,3278],{"class":709}," JSON",[695,3280,625],{"class":705},[695,3282,3283],{"class":742},"stringify",[695,3285,805],{"class":829},[695,3287,3184],{"class":709},[695,3289,625],{"class":705},[695,3291,1754],{"class":709},[695,3293,625],{"class":705},[695,3295,1923],{"class":709},[695,3297,1435],{"class":829},[695,3299,1071],{"class":705},[695,3301,3302,3305],{"class":697,"line":1040},[695,3303,3304],{"class":705},"        }",[695,3306,838],{"class":829},[695,3308,3309],{"class":697,"line":1050},[695,3310,3311],{"class":705},"      }\n",[695,3313,3314],{"class":697,"line":1059},[695,3315,3316],{"class":705},"    }\n",[695,3318,3319],{"class":697,"line":1065},[695,3320,3321],{"class":705},"  },\n",[695,3323,3324],{"class":697,"line":1074},[695,3325,2367],{"class":705},[605,3327,3328,3329,2374,3331,2386,3333,3335,3336,3338,3339,3342,3343,3346],{},"Each entry carries ",[614,3330,2099],{},[614,3332,1733],{},[614,3334,1754],{},", with ",[614,3337,1754],{}," being what evlog published, so the wide event is at ",[614,3340,3341],{},"messageData.message.event",". Requires the ",[614,3344,3345],{},"nodejs_compat"," flag, and messages go through the structured clone algorithm, so only cloneable values survive.",[627,3348,3350],{"id":3349},"when-a-plugin-is-the-better-tool","When a plugin is the better tool",[605,3352,3353,3354,3357],{},"The channel is not a replacement for ",[608,3355,3356],{"href":509},"plugins",". It is narrower on purpose:",[3359,3360,3361,3374],"table",{},[3362,3363,3364],"thead",{},[3365,3366,3367,3371],"tr",{},[3368,3369,3370],"th",{},"You want to…",[3368,3372,3373],{},"Use",[3375,3376,3377,3388,3399,3411,3419],"tbody",{},[3365,3378,3379,3383],{},[3380,3381,3382],"td",{},"Ship events to a backend, with batching and retry",[3380,3384,3385],{},[608,3386,3387],{"href":526},"Custom drain",[3365,3389,3390,3393],{},[3380,3391,3392],{},"Add fields to the event before it drains",[3380,3394,3395,3398],{},[608,3396,3397],{"href":513},"Enricher"," or a plugin",[3365,3400,3401,3404],{},[3380,3402,3403],{},"Fan out to several in-process consumers",[3380,3405,3406,3407,3410],{},"Plugins — ",[614,3408,3409],{},"initLogger({ plugins: [a, b, c] })"," already does this",[3365,3412,3413,3416],{},[3380,3414,3415],{},"Subscribe from a package that must not depend on evlog",[3380,3417,3418],{},"This channel",[3365,3420,3421,3424],{},[3380,3422,3423],{},"Get events out of a Cloudflare Worker without a drain",[3380,3425,3418],{},[605,3427,3428,3431],{},[614,3429,3430],{},"diagnostics_channel"," is in-process: nothing attaches to a running process from the outside. A subscriber's code has to be loaded by your app either way, so the channel saves it a line of configuration, not a dependency.",[3433,3434,3435],"style",{},"html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sHdIc, html code.shiki .sHdIc{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic}html pre.shiki code .sfNiH, html code.shiki .sfNiH{--shiki-light:#FF5370;--shiki-default:#FF9CAC;--shiki-dark:#FF9CAC}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}",{"title":691,"searchDepth":729,"depth":729,"links":3437},[3438,3439,3440,3441,3442,3446,3447],{"id":629,"depth":729,"text":630},{"id":680,"depth":729,"text":681},{"id":1624,"depth":729,"text":1625},{"id":2077,"depth":729,"text":2078},{"id":2412,"depth":729,"text":2413,"children":3443},[3444,3445],{"id":2417,"depth":736,"text":2418},{"id":2676,"depth":736,"text":2677},{"id":3086,"depth":729,"text":295},{"id":3349,"depth":729,"text":3350},"Publish every wide event on a node:diagnostics_channel, so a consumer subscribes without importing evlog and Cloudflare can Tail Worker it.","md",[3451,3454],{"label":508,"icon":483,"to":509,"color":3452,"variant":3453},"neutral","subtle",{"label":485,"icon":466,"to":486,"color":3452,"variant":3453},{},{"title":495,"icon":488},{"title":600,"description":3448},"5oLaXxFOH7j00PASnXByKQDaOmgENXeu1FFujVl0TGY",[3460,3462],{"title":490,"path":491,"stem":492,"description":3461,"icon":493,"children":-1},"Build evlog support for a framework or runtime that has no integration, with defineFrameworkIntegration or the lower-level helpers.",{"title":499,"path":500,"stem":501,"description":3463,"icon":502,"children":-1},"Replay and tail the local NDJSON drain with readFsLogs and tailFsLogs — works in-process or from any external Node tool, survives restarts.",1789076918649]