[{"data":1,"prerenderedAt":1438},["ShallowReactive",2],{"navigation_docs":3,"-build-on-top-pipeline-plugins":547,"-build-on-top-pipeline-plugins-surround":1433},[4,35,159,201,289,446,531],{"title":5,"path":6,"stem":7,"children":8,"page":34},"Getting Started","\u002Fgetting-started","1.getting-started",[9,14,19,24,29],{"title":10,"path":11,"stem":12,"icon":13},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F1.introduction","i-lucide-info",{"title":15,"path":16,"stem":17,"icon":18},"Installation","\u002Fgetting-started\u002Finstallation","1.getting-started\u002F2.installation","i-lucide-download",{"title":20,"path":21,"stem":22,"icon":23},"Quick Start","\u002Fgetting-started\u002Fquick-start","1.getting-started\u002F3.quick-start","i-lucide-zap",{"title":25,"path":26,"stem":27,"icon":28},"Agent Skills","\u002Fgetting-started\u002Fagent-skills","1.getting-started\u002F4.agent-skills","i-lucide-sparkles",{"title":30,"path":31,"stem":32,"icon":33},"vs Other Loggers","\u002Fgetting-started\u002Fvs-other-loggers","1.getting-started\u002F5.vs-other-loggers","i-lucide-scale",false,{"title":36,"path":37,"stem":38,"children":39,"page":34},"Logging","\u002Flogging","2.logging",[40,45,50,55,60,65,70,99,127],{"title":41,"path":42,"stem":43,"icon":44},"Overview","\u002Flogging\u002Foverview","2.logging\u002F0.overview","i-lucide-list",{"title":46,"path":47,"stem":48,"icon":49},"Simple Logging","\u002Flogging\u002Fsimple-logging","2.logging\u002F1.simple-logging","i-lucide-terminal",{"title":51,"path":52,"stem":53,"icon":54},"Wide Events","\u002Flogging\u002Fwide-events","2.logging\u002F2.wide-events","i-lucide-layers",{"title":56,"path":57,"stem":58,"icon":59},"Structured Errors","\u002Flogging\u002Fstructured-errors","2.logging\u002F3.structured-errors","i-lucide-shield-alert",{"title":61,"path":62,"stem":63,"icon":64},"Catalogs","\u002Flogging\u002Fcatalogs","2.logging\u002F4.catalogs","i-lucide-book-open",{"title":66,"path":67,"stem":68,"icon":69},"Client Logging","\u002Flogging\u002Fclient-logging","2.logging\u002F5.client-logging","i-lucide-monitor",{"title":71,"icon":72,"path":73,"stem":74,"children":75,"page":34},"AI SDK","i-simple-icons-vercel","\u002Flogging\u002Fai-sdk","2.logging\u002F6.ai-sdk",[76,79,84,89,94],{"title":41,"path":77,"stem":78,"icon":44},"\u002Flogging\u002Fai-sdk\u002Foverview","2.logging\u002F6.ai-sdk\u002F01.overview",{"title":80,"path":81,"stem":82,"icon":83},"Usage","\u002Flogging\u002Fai-sdk\u002Fusage","2.logging\u002F6.ai-sdk\u002F02.usage","i-lucide-code",{"title":85,"path":86,"stem":87,"icon":88},"Options","\u002Flogging\u002Fai-sdk\u002Foptions","2.logging\u002F6.ai-sdk\u002F03.options","i-lucide-sliders",{"title":90,"path":91,"stem":92,"icon":93},"Metadata","\u002Flogging\u002Fai-sdk\u002Fmetadata","2.logging\u002F6.ai-sdk\u002F04.metadata","i-lucide-database",{"title":95,"path":96,"stem":97,"icon":98},"Telemetry","\u002Flogging\u002Fai-sdk\u002Ftelemetry","2.logging\u002F6.ai-sdk\u002F05.telemetry","i-lucide-activity",{"title":100,"icon":101,"path":102,"stem":103,"children":104,"page":34},"Better Auth","i-simple-icons-betterauth","\u002Flogging\u002Fbetter-auth","2.logging\u002F7.better-auth",[105,108,113,118,122],{"title":41,"path":106,"stem":107,"icon":44},"\u002Flogging\u002Fbetter-auth\u002Foverview","2.logging\u002F7.better-auth\u002F01.overview",{"title":109,"path":110,"stem":111,"icon":112},"Identify User","\u002Flogging\u002Fbetter-auth\u002Fidentify-user","2.logging\u002F7.better-auth\u002F02.identify-user","i-lucide-user-check",{"title":114,"path":115,"stem":116,"icon":117},"Middleware","\u002Flogging\u002Fbetter-auth\u002Fmiddleware","2.logging\u002F7.better-auth\u002F03.middleware","i-lucide-shield",{"title":119,"path":120,"stem":121,"icon":69},"Client Sync","\u002Flogging\u002Fbetter-auth\u002Fclient-sync","2.logging\u002F7.better-auth\u002F04.client-sync",{"title":123,"path":124,"stem":125,"icon":126},"Performance","\u002Flogging\u002Fbetter-auth\u002Fperformance","2.logging\u002F7.better-auth\u002F05.performance","i-lucide-gauge",{"title":128,"icon":129,"path":130,"stem":131,"children":132,"page":34},"Audit Logs","i-lucide-shield-check","\u002Flogging\u002Faudit","2.logging\u002F8.audit",[133,136,141,146,151,155],{"title":41,"path":134,"stem":135,"icon":44},"\u002Flogging\u002Faudit\u002Foverview","2.logging\u002F8.audit\u002F01.overview",{"title":137,"path":138,"stem":139,"icon":140},"Schema","\u002Flogging\u002Faudit\u002Fschema","2.logging\u002F8.audit\u002F02.schema","i-lucide-file-text",{"title":142,"path":143,"stem":144,"icon":145},"Recording","\u002Flogging\u002Faudit\u002Frecording","2.logging\u002F8.audit\u002F03.recording","i-lucide-pen-line",{"title":147,"path":148,"stem":149,"icon":150},"Drains","\u002Flogging\u002Faudit\u002Fpipeline","2.logging\u002F8.audit\u002F04.pipeline","i-lucide-link",{"title":152,"path":153,"stem":154,"icon":129},"Compliance","\u002Flogging\u002Faudit\u002Fcompliance","2.logging\u002F8.audit\u002F05.compliance",{"title":156,"path":157,"stem":158,"icon":64},"Recipes","\u002Flogging\u002Faudit\u002Frecipes","2.logging\u002F8.audit\u002F06.recipes",{"title":160,"path":161,"stem":162,"children":163,"page":34},"Core Concepts","\u002Fcore-concepts","3.core-concepts",[164,169,174,179,184,188,191,196],{"title":165,"path":166,"stem":167,"icon":168},"Lifecycle","\u002Fcore-concepts\u002Flifecycle","3.core-concepts\u002F0.lifecycle","i-lucide-arrow-right-left",{"title":170,"path":171,"stem":172,"icon":173},"Configuration","\u002Fcore-concepts\u002Fconfiguration","3.core-concepts\u002F1.configuration","i-lucide-settings",{"title":175,"path":176,"stem":177,"icon":178},"Sampling","\u002Fcore-concepts\u002Fsampling","3.core-concepts\u002F2.sampling","i-lucide-filter",{"title":180,"path":181,"stem":182,"icon":183},"Typed Fields","\u002Fcore-concepts\u002Ftyped-fields","3.core-concepts\u002F3.typed-fields","i-simple-icons-typescript",{"title":185,"path":186,"stem":187,"icon":129},"Best Practices","\u002Fcore-concepts\u002Fbest-practices","3.core-concepts\u002F4.best-practices",{"title":123,"path":189,"stem":190,"icon":126},"\u002Fcore-concepts\u002Fperformance","3.core-concepts\u002F5.performance",{"title":192,"path":193,"stem":194,"icon":195},"Vite Plugin","\u002Fcore-concepts\u002Fvite-plugin","3.core-concepts\u002F6.vite-plugin","i-custom-vite",{"title":197,"path":198,"stem":199,"icon":200},"Auto-Redaction","\u002Fcore-concepts\u002Fredaction","3.core-concepts\u002F7.redaction","i-lucide-eye-off",{"title":202,"path":203,"stem":204,"children":205,"page":34},"Frameworks","\u002Fframeworks","4.frameworks",[206,210,215,220,225,230,235,240,245,250,255,260,265,270,274,279,284],{"title":41,"path":207,"stem":208,"icon":209},"\u002Fframeworks\u002Foverview","4.frameworks\u002F00.overview","i-lucide-layout-grid",{"title":211,"path":212,"stem":213,"icon":214},"Nuxt","\u002Fframeworks\u002Fnuxt","4.frameworks\u002F01.nuxt","i-simple-icons-nuxtdotjs",{"title":216,"path":217,"stem":218,"icon":219},"Next.js","\u002Fframeworks\u002Fnextjs","4.frameworks\u002F02.nextjs","i-simple-icons-nextdotjs",{"title":221,"path":222,"stem":223,"icon":224},"SvelteKit","\u002Fframeworks\u002Fsveltekit","4.frameworks\u002F03.sveltekit","i-simple-icons-svelte",{"title":226,"path":227,"stem":228,"icon":229},"Nitro","\u002Fframeworks\u002Fnitro","4.frameworks\u002F04.nitro","i-custom-nitro",{"title":231,"path":232,"stem":233,"icon":234},"TanStack Start","\u002Fframeworks\u002Ftanstack-start","4.frameworks\u002F05.tanstack-start","i-custom-tanstack",{"title":236,"path":237,"stem":238,"icon":239},"NestJS","\u002Fframeworks\u002Fnestjs","4.frameworks\u002F06.nestjs","i-simple-icons-nestjs",{"title":241,"path":242,"stem":243,"icon":244},"Express","\u002Fframeworks\u002Fexpress","4.frameworks\u002F07.express","i-simple-icons-express",{"title":246,"path":247,"stem":248,"icon":249},"Hono","\u002Fframeworks\u002Fhono","4.frameworks\u002F08.hono","i-simple-icons-hono",{"title":251,"path":252,"stem":253,"icon":254},"Fastify","\u002Fframeworks\u002Ffastify","4.frameworks\u002F09.fastify","i-simple-icons-fastify",{"title":256,"path":257,"stem":258,"icon":259},"Elysia","\u002Fframeworks\u002Felysia","4.frameworks\u002F10.elysia","i-custom-elysia",{"title":261,"path":262,"stem":263,"icon":264},"React Router","\u002Fframeworks\u002Freact-router","4.frameworks\u002F11.react-router","i-custom-reactrouter",{"title":266,"path":267,"stem":268,"icon":269},"Cloudflare Workers","\u002Fframeworks\u002Fcloudflare-workers","4.frameworks\u002F12.cloudflare-workers","i-simple-icons-cloudflare",{"title":271,"path":272,"stem":273,"icon":183},"Standalone","\u002Fframeworks\u002Fstandalone","4.frameworks\u002F13.standalone",{"title":275,"path":276,"stem":277,"icon":278},"Astro","\u002Fframeworks\u002Fastro","4.frameworks\u002F14.astro","i-simple-icons-astro",{"title":280,"path":281,"stem":282,"icon":283},"AWS Lambda","\u002Fframeworks\u002Faws-lambda","4.frameworks\u002F16.aws-lambda","i-custom-lambda",{"title":285,"path":286,"stem":287,"icon":288},"Custom Integration","\u002Fframeworks\u002Fcustom-integration","4.frameworks\u002F17.custom-integration","i-lucide-puzzle",{"title":290,"path":291,"stem":292,"children":293,"page":34},"Build on top","\u002Fbuild-on-top","5.build-on-top",[294,297,325,346,373,400,428],{"title":41,"path":295,"stem":296,"icon":54},"\u002Fbuild-on-top\u002Foverview","5.build-on-top\u002F0.overview",{"title":298,"path":299,"stem":300,"children":301,"page":34},"Observers","\u002Fbuild-on-top\u002Fobservers","5.build-on-top\u002Fobservers",[302,306,311,316,321],{"title":41,"path":303,"stem":304,"icon":305},"\u002Fbuild-on-top\u002Fobservers\u002Foverview","5.build-on-top\u002Fobservers\u002F1.overview","i-lucide-eye",{"title":307,"path":308,"stem":309,"icon":310},"Stream API","\u002Fbuild-on-top\u002Fobservers\u002Fin-process-stream","5.build-on-top\u002Fobservers\u002F2.in-process-stream","i-lucide-radio-tower",{"title":312,"path":313,"stem":314,"icon":315},"Stream server","\u002Fbuild-on-top\u002Fobservers\u002Fstream-server","5.build-on-top\u002Fobservers\u002F3.stream-server","i-lucide-radio",{"title":317,"path":318,"stem":319,"icon":320},"FS reader","\u002Fbuild-on-top\u002Fobservers\u002Ffs-reader","5.build-on-top\u002Fobservers\u002F4.fs-reader","i-lucide-folder-search",{"title":156,"path":322,"stem":323,"icon":324},"\u002Fbuild-on-top\u002Fobservers\u002Fconsumer-recipes","5.build-on-top\u002Fobservers\u002F5.consumer-recipes","i-lucide-chef-hat",{"title":326,"path":327,"stem":328,"children":329,"page":34},"Pipeline","\u002Fbuild-on-top\u002Fpipeline","5.build-on-top\u002Fpipeline",[330,334,338,342],{"title":41,"path":331,"stem":332,"icon":333},"\u002Fbuild-on-top\u002Fpipeline\u002Foverview","5.build-on-top\u002Fpipeline\u002F1.overview","i-lucide-workflow",{"title":335,"path":336,"stem":337,"icon":288},"Plugins","\u002Fbuild-on-top\u002Fpipeline\u002Fplugins","5.build-on-top\u002Fpipeline\u002F2.plugins",{"title":339,"path":340,"stem":341,"icon":28},"Custom enrichers","\u002Fbuild-on-top\u002Fpipeline\u002Fcustom-enrichers","5.build-on-top\u002Fpipeline\u002F3.custom-enrichers",{"title":343,"path":344,"stem":345,"icon":178},"Tail sampling","\u002Fbuild-on-top\u002Fpipeline\u002Ftail-sampling","5.build-on-top\u002Fpipeline\u002F4.tail-sampling",{"title":347,"path":348,"stem":349,"children":350,"page":34},"Scenarios","\u002Fbuild-on-top\u002Fscenarios","5.build-on-top\u002Fscenarios",[351,355,359,364,368],{"title":41,"path":352,"stem":353,"icon":354},"\u002Fbuild-on-top\u002Fscenarios\u002Foverview","5.build-on-top\u002Fscenarios\u002F0.overview","i-lucide-clipboard-list",{"title":356,"path":357,"stem":358,"icon":49},"Local debugging toolkit","\u002Fbuild-on-top\u002Fscenarios\u002Flocal-debugging-toolkit","5.build-on-top\u002Fscenarios\u002F1.local-debugging-toolkit",{"title":360,"path":361,"stem":362,"icon":363},"Tenant-aware logging","\u002Fbuild-on-top\u002Fscenarios\u002Ftenant-aware-logging","5.build-on-top\u002Fscenarios\u002F2.tenant-aware-logging","i-lucide-users",{"title":365,"path":366,"stem":367,"icon":129},"Compliance audit","\u002Fbuild-on-top\u002Fscenarios\u002Fcompliance-audit","5.build-on-top\u002Fscenarios\u002F3.compliance-audit",{"title":369,"path":370,"stem":371,"icon":372},"Cross-app error vocab","\u002Fbuild-on-top\u002Fscenarios\u002Fcross-app-error-vocab","5.build-on-top\u002Fscenarios\u002F4.cross-app-error-vocab","i-lucide-book",{"title":374,"path":375,"stem":376,"children":377,"page":34},"Shared packages","\u002Fbuild-on-top\u002Fshared","5.build-on-top\u002Fshared",[378,382,386,391,395],{"title":41,"path":379,"stem":380,"icon":381},"\u002Fbuild-on-top\u002Fshared\u002Foverview","5.build-on-top\u002Fshared\u002F1.overview","i-lucide-package",{"title":383,"path":384,"stem":385,"icon":381},"Catalogs as packages","\u002Fbuild-on-top\u002Fshared\u002Fcatalogs-as-packages","5.build-on-top\u002Fshared\u002F2.catalogs-as-packages",{"title":387,"path":388,"stem":389,"icon":390},"Drains as packages","\u002Fbuild-on-top\u002Fshared\u002Fdrains-as-packages","5.build-on-top\u002Fshared\u002F3.drains-as-packages","i-lucide-package-2",{"title":392,"path":393,"stem":394,"icon":28},"Enrichers as packages","\u002Fbuild-on-top\u002Fshared\u002Fenrichers-as-packages","5.build-on-top\u002Fshared\u002F4.enrichers-as-packages",{"title":396,"path":397,"stem":398,"icon":399},"Integration as package","\u002Fbuild-on-top\u002Fshared\u002Fintegration-as-package","5.build-on-top\u002Fshared\u002F5.integration-as-package","i-lucide-package-check",{"title":401,"path":402,"stem":403,"children":404,"page":34},"Sinks","\u002Fbuild-on-top\u002Fsinks","5.build-on-top\u002Fsinks",[405,409,414,418,423],{"title":41,"path":406,"stem":407,"icon":408},"\u002Fbuild-on-top\u002Fsinks\u002Foverview","5.build-on-top\u002Fsinks\u002F1.overview","i-lucide-arrow-up-from-line",{"title":410,"path":411,"stem":412,"icon":413},"Custom drains","\u002Fbuild-on-top\u002Fsinks\u002Fcustom-drains","5.build-on-top\u002Fsinks\u002F2.custom-drains","i-lucide-code-2",{"title":415,"path":416,"stem":417,"icon":333},"Drain pipeline","\u002Fbuild-on-top\u002Fsinks\u002Fdrain-pipeline","5.build-on-top\u002Fsinks\u002F3.drain-pipeline",{"title":419,"path":420,"stem":421,"icon":422},"Identity headers","\u002Fbuild-on-top\u002Fsinks\u002Fidentity-headers","5.build-on-top\u002Fsinks\u002F4.identity-headers","i-lucide-fingerprint",{"title":424,"path":425,"stem":426,"icon":427},"Fanout","\u002Fbuild-on-top\u002Fsinks\u002Ffanout-and-multi-drain","5.build-on-top\u002Fsinks\u002F5.fanout-and-multi-drain","i-lucide-share-2",{"title":429,"path":430,"stem":431,"children":432,"page":34},"Sources","\u002Fbuild-on-top\u002Fsources","5.build-on-top\u002Fsources",[433,437,441],{"title":41,"path":434,"stem":435,"icon":436},"\u002Fbuild-on-top\u002Fsources\u002Foverview","5.build-on-top\u002Fsources\u002F1.overview","i-lucide-arrow-down-to-line",{"title":438,"path":439,"stem":440,"icon":288},"Custom framework","\u002Fbuild-on-top\u002Fsources\u002Fcustom-framework","5.build-on-top\u002Fsources\u002F2.custom-framework",{"title":442,"path":443,"stem":444,"icon":445},"Middleware toolkit","\u002Fbuild-on-top\u002Fsources\u002Fmiddleware-toolkit","5.build-on-top\u002Fsources\u002F3.middleware-toolkit","i-lucide-wrench",{"title":447,"path":448,"stem":449,"children":450,"page":34},"Adapters","\u002Fadapters","6.adapters",[451,454,494,509],{"title":41,"path":452,"stem":453,"icon":44},"\u002Fadapters\u002Foverview","6.adapters\u002F01.overview",{"title":455,"path":456,"stem":457,"children":458,"page":34},"Cloud destinations","\u002Fadapters\u002Fcloud","6.adapters\u002F02.cloud",[459,464,469,474,479,484,489],{"title":460,"path":461,"stem":462,"icon":463},"Axiom","\u002Fadapters\u002Fcloud\u002Faxiom","6.adapters\u002F02.cloud\u002F01.axiom","i-custom-axiom",{"title":465,"path":466,"stem":467,"icon":468},"OTLP","\u002Fadapters\u002Fcloud\u002Fotlp","6.adapters\u002F02.cloud\u002F02.otlp","i-simple-icons-opentelemetry",{"title":470,"path":471,"stem":472,"icon":473},"PostHog","\u002Fadapters\u002Fcloud\u002Fposthog","6.adapters\u002F02.cloud\u002F03.posthog","i-simple-icons-posthog",{"title":475,"path":476,"stem":477,"icon":478},"Sentry","\u002Fadapters\u002Fcloud\u002Fsentry","6.adapters\u002F02.cloud\u002F04.sentry","i-simple-icons-sentry",{"title":480,"path":481,"stem":482,"icon":483},"Better Stack","\u002Fadapters\u002Fcloud\u002Fbetter-stack","6.adapters\u002F02.cloud\u002F05.better-stack","i-simple-icons-betterstack",{"title":485,"path":486,"stem":487,"icon":488},"Datadog","\u002Fadapters\u002Fcloud\u002Fdatadog","6.adapters\u002F02.cloud\u002F06.datadog","i-simple-icons-datadog",{"title":490,"path":491,"stem":492,"icon":493},"HyperDX","\u002Fadapters\u002Fcloud\u002Fhyperdx","6.adapters\u002F02.cloud\u002F07.hyperdx","i-custom-hyperdx",{"title":495,"path":496,"stem":497,"children":498,"page":34},"Self-hosted","\u002Fadapters\u002Fself-hosted","6.adapters\u002F03.self-hosted",[499,504],{"title":500,"path":501,"stem":502,"icon":503},"File System","\u002Fadapters\u002Fself-hosted\u002Ffs","6.adapters\u002F03.self-hosted\u002F01.fs","i-lucide-hard-drive",{"title":505,"path":506,"stem":507,"icon":508},"NuxtHub","\u002Fadapters\u002Fself-hosted\u002Fnuxthub","6.adapters\u002F03.self-hosted\u002F02.nuxthub","i-simple-icons-nuxt",{"title":510,"path":511,"stem":512,"children":513,"page":34},"Building blocks","\u002Fadapters\u002Fbuilding-blocks","6.adapters\u002F04.building-blocks",[514,517,522,526],{"title":326,"path":515,"stem":516,"icon":333},"\u002Fadapters\u002Fbuilding-blocks\u002Fpipeline","6.adapters\u002F04.building-blocks\u002F01.pipeline",{"title":518,"path":519,"stem":520,"icon":521},"HTTP","\u002Fadapters\u002Fbuilding-blocks\u002Fhttp","6.adapters\u002F04.building-blocks\u002F02.http","i-lucide-globe",{"title":523,"path":524,"stem":525,"icon":83},"Custom Adapters","\u002Fadapters\u002Fbuilding-blocks\u002Fcustom","6.adapters\u002F04.building-blocks\u002F03.custom",{"title":527,"path":528,"stem":529,"icon":530},"Toolkit","\u002Fadapters\u002Fbuilding-blocks\u002Ftoolkit","6.adapters\u002F04.building-blocks\u002F04.toolkit","i-lucide-blocks",{"title":532,"path":533,"stem":534,"children":535,"page":34},"Enrichers","\u002Fenrichers","7.enrichers",[536,539,543],{"title":41,"path":537,"stem":538,"icon":28},"\u002Fenrichers\u002Foverview","7.enrichers\u002F1.overview",{"title":540,"path":541,"stem":542,"icon":288},"Built-in","\u002Fenrichers\u002Fbuilt-in","7.enrichers\u002F2.built-in",{"title":544,"path":545,"stem":546,"icon":83},"Custom","\u002Fenrichers\u002Fcustom","7.enrichers\u002F3.custom",{"id":548,"title":335,"body":549,"description":1426,"extension":1427,"links":1428,"meta":1429,"navigation":1430,"path":336,"seo":1431,"stem":337,"__hash__":1432},"docs\u002F5.build-on-top\u002Fpipeline\u002F2.plugins.md",{"type":550,"value":551,"toc":1419},"minimark",[552,565,570,577,601,612,616,909,913,1061,1068,1324,1328,1388,1392,1415],[553,554,555,559,560,564],"p",{},[556,557,558],"code",{},"definePlugin()"," is the ",[561,562,563],"strong",{},"canonical extension point"," for evlog. Drains and enrichers are special cases of plugins, but a single plugin can opt into multiple hooks at once — the right shape for any non-trivial extension that mixes several concerns.",[566,567,569],"h2",{"id":568},"what-is-this-and-when-do-i-want-it","What is this and when do I want it?",[553,571,572,573,576],{},"Use a plugin when your feature touches ",[561,574,575],{},"more than one"," point in the pipeline:",[578,579,580,588,591],"ul",{},[581,582,583,584,587],"li",{},"\"On every request, copy ",[556,585,586],{},"x-tenant-id"," from headers into a context field, AND tag the event with the tenant's plan, AND alert when an error event has plan=enterprise\" → one plugin",[581,589,590],{},"\"Add Sentry breadcrumbs every time we drain a wide event with level=error\" → one plugin",[581,592,593,594,597,598],{},"\"Decorate the request logger with a custom ",[556,595,596],{},"audit.refund(...)"," method\" → one plugin's ",[556,599,600],{},"extendLogger",[553,602,603,604,607,608,611],{},"Single-purpose extensions (just an enricher, just a drain) can use the dedicated wrappers ",[556,605,606],{},"enricherPlugin()"," \u002F ",[556,609,610],{},"drainPlugin()"," instead.",[566,613,615],{"id":614},"minimal-example","Minimal example",[617,618,623],"pre",{"className":619,"code":620,"language":621,"meta":622,"style":622},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import { definePlugin, getGlobalPluginRunner } from 'evlog\u002Ftoolkit'\n\nexport const tenantPlugin = definePlugin({\n  name: 'tenant',\n  onRequestStart({ logger, headers }) {\n    const tenantId = headers?.['x-tenant-id']\n    if (tenantId) logger.set({ tenant: { id: tenantId } })\n  },\n  enrich({ event }) {\n    event.region = process.env.REGION\n  },\n})\n\n\u002F\u002F Register on the global runner (typically once at startup):\ngetGlobalPluginRunner().add(tenantPlugin)\n","ts","",[556,624,625,664,671,696,717,741,770,820,826,841,867,872,880,885,892],{"__ignoreMap":622},[626,627,630,634,638,642,645,648,651,654,657,661],"span",{"class":628,"line":629},"line",1,[626,631,633],{"class":632},"s7zQu","import",[626,635,637],{"class":636},"sMK4o"," {",[626,639,641],{"class":640},"sTEyZ"," definePlugin",[626,643,644],{"class":636},",",[626,646,647],{"class":640}," getGlobalPluginRunner",[626,649,650],{"class":636}," }",[626,652,653],{"class":632}," from",[626,655,656],{"class":636}," '",[626,658,660],{"class":659},"sfazB","evlog\u002Ftoolkit",[626,662,663],{"class":636},"'\n",[626,665,667],{"class":628,"line":666},2,[626,668,670],{"emptyLinePlaceholder":669},true,"\n",[626,672,674,677,681,684,687,690,693],{"class":628,"line":673},3,[626,675,676],{"class":632},"export",[626,678,680],{"class":679},"spNyl"," const",[626,682,683],{"class":640}," tenantPlugin ",[626,685,686],{"class":636},"=",[626,688,641],{"class":689},"s2Zo4",[626,691,692],{"class":640},"(",[626,694,695],{"class":636},"{\n",[626,697,699,703,706,708,711,714],{"class":628,"line":698},4,[626,700,702],{"class":701},"swJcz","  name",[626,704,705],{"class":636},":",[626,707,656],{"class":636},[626,709,710],{"class":659},"tenant",[626,712,713],{"class":636},"'",[626,715,716],{"class":636},",\n",[626,718,720,723,726,730,732,735,738],{"class":628,"line":719},5,[626,721,722],{"class":701},"  onRequestStart",[626,724,725],{"class":636},"({",[626,727,729],{"class":728},"sHdIc"," logger",[626,731,644],{"class":636},[626,733,734],{"class":728}," headers",[626,736,737],{"class":636}," })",[626,739,740],{"class":636}," {\n",[626,742,744,747,750,753,755,758,761,763,765,767],{"class":628,"line":743},6,[626,745,746],{"class":679},"    const",[626,748,749],{"class":640}," tenantId",[626,751,752],{"class":636}," =",[626,754,734],{"class":640},[626,756,757],{"class":636},"?.",[626,759,760],{"class":701},"[",[626,762,713],{"class":636},[626,764,586],{"class":659},[626,766,713],{"class":636},[626,768,769],{"class":701},"]\n",[626,771,773,776,779,782,785,788,791,794,796,799,802,804,806,809,811,813,815,817],{"class":628,"line":772},7,[626,774,775],{"class":632},"    if",[626,777,778],{"class":701}," (",[626,780,781],{"class":640},"tenantId",[626,783,784],{"class":701},") ",[626,786,787],{"class":640},"logger",[626,789,790],{"class":636},".",[626,792,793],{"class":689},"set",[626,795,692],{"class":701},[626,797,798],{"class":636},"{",[626,800,801],{"class":701}," tenant",[626,803,705],{"class":636},[626,805,637],{"class":636},[626,807,808],{"class":701}," id",[626,810,705],{"class":636},[626,812,749],{"class":640},[626,814,650],{"class":636},[626,816,650],{"class":636},[626,818,819],{"class":701},")\n",[626,821,823],{"class":628,"line":822},8,[626,824,825],{"class":636},"  },\n",[626,827,829,832,834,837,839],{"class":628,"line":828},9,[626,830,831],{"class":701},"  enrich",[626,833,725],{"class":636},[626,835,836],{"class":728}," event",[626,838,737],{"class":636},[626,840,740],{"class":636},[626,842,844,847,849,852,854,857,859,862,864],{"class":628,"line":843},10,[626,845,846],{"class":640},"    event",[626,848,790],{"class":636},[626,850,851],{"class":640},"region",[626,853,752],{"class":636},[626,855,856],{"class":640}," process",[626,858,790],{"class":636},[626,860,861],{"class":640},"env",[626,863,790],{"class":636},[626,865,866],{"class":640},"REGION\n",[626,868,870],{"class":628,"line":869},11,[626,871,825],{"class":636},[626,873,875,878],{"class":628,"line":874},12,[626,876,877],{"class":636},"}",[626,879,819],{"class":640},[626,881,883],{"class":628,"line":882},13,[626,884,670],{"emptyLinePlaceholder":669},[626,886,888],{"class":628,"line":887},14,[626,889,891],{"class":890},"sHwdD","\u002F\u002F Register on the global runner (typically once at startup):\n",[626,893,895,898,901,903,906],{"class":628,"line":894},15,[626,896,897],{"class":689},"getGlobalPluginRunner",[626,899,900],{"class":640},"()",[626,902,790],{"class":636},[626,904,905],{"class":689},"add",[626,907,908],{"class":640},"(tenantPlugin)\n",[566,910,912],{"id":911},"full-api","Full API",[914,915,916,932],"table",{},[917,918,919],"thead",{},[920,921,922,926,929],"tr",{},[923,924,925],"th",{},"Hook",[923,927,928],{},"When",[923,930,931],{},"Use it for",[933,934,935,952,967,980,1001,1014,1031,1044],"tbody",{},[920,936,937,943,946],{},[938,939,940],"td",{},[556,941,942],{},"setup(ctx)",[938,944,945],{},"Once when registered",[938,947,948,949,951],{},"Read ",[556,950,861],{},", set up shared state",[920,953,954,959,962],{},[938,955,956],{},[556,957,958],{},"onRequestStart(ctx)",[938,960,961],{},"Each request, before any handler runs",[938,963,964,965],{},"Pull values from headers into ",[556,966,787],{},[920,968,969,974,977],{},[938,970,971],{},[556,972,973],{},"enrich(ctx)",[938,975,976],{},"Every event, before drain",[938,978,979],{},"Add derived fields (geo, deploy id…)",[920,981,982,987,990],{},[938,983,984],{},[556,985,986],{},"keep(ctx)",[938,988,989],{},"Tail sampling decision",[938,991,992,993,996,997,1000],{},"Force-keep based on outcome (",[556,994,995],{},"status >= 400",", ",[556,998,999],{},"duration > 500",", …)",[920,1002,1003,1008,1011],{},[938,1004,1005],{},[556,1006,1007],{},"drain(ctx)",[938,1009,1010],{},"Every emitted event",[938,1012,1013],{},"Side-effect: alert, mirror to a queue, etc.",[920,1015,1016,1021,1028],{},[938,1017,1018],{},[556,1019,1020],{},"onRequestFinish(ctx)",[938,1022,1023,1024,1027],{},"After response, includes the emitted event (or ",[556,1025,1026],{},"null"," if sampled out)",[938,1029,1030],{},"Per-request post-processing",[920,1032,1033,1038,1041],{},[938,1034,1035],{},[556,1036,1037],{},"onClientLog(ctx)",[938,1039,1040],{},"Browser-submitted event hits the ingest endpoint",[938,1042,1043],{},"Observe \u002F reject client traffic",[920,1045,1046,1051,1054],{},[938,1047,1048],{},[556,1049,1050],{},"extendLogger(logger)",[938,1052,1053],{},"Each request",[938,1055,1056,1057,1060],{},"Add custom methods (e.g. ",[556,1058,1059],{},"logger.audit.refund()",")",[553,1062,1063,1064,1067],{},"Every hook is ",[561,1065,1066],{},"optional",". A plugin can implement any subset.",[617,1069,1071],{"className":619,"code":1070,"language":621,"meta":622,"style":622},"export interface EvlogPlugin {\n  name: string\n  setup?: (ctx: PluginSetupContext) => void | Promise\u003Cvoid>\n  enrich?: (ctx: EnrichContext) => void | Promise\u003Cvoid>\n  drain?: (ctx: DrainContext) => void | Promise\u003Cvoid>\n  keep?: (ctx: TailSamplingContext) => void | Promise\u003Cvoid>\n  onRequestStart?: (ctx: RequestLifecycleContext) => void\n  onRequestFinish?: (ctx: RequestFinishContext) => void\n  onClientLog?: (ctx: ClientLogContext) => void\n  extendLogger?: (logger: RequestLogger) => void\n}\n",[556,1072,1073,1086,1095,1136,1167,1199,1231,1253,1275,1297,1319],{"__ignoreMap":622},[626,1074,1075,1077,1080,1084],{"class":628,"line":629},[626,1076,676],{"class":632},[626,1078,1079],{"class":679}," interface",[626,1081,1083],{"class":1082},"sBMFI"," EvlogPlugin",[626,1085,740],{"class":636},[626,1087,1088,1090,1092],{"class":628,"line":666},[626,1089,702],{"class":701},[626,1091,705],{"class":636},[626,1093,1094],{"class":1082}," string\n",[626,1096,1097,1100,1103,1105,1108,1110,1113,1115,1118,1121,1124,1127,1130,1133],{"class":628,"line":673},[626,1098,1099],{"class":701},"  setup",[626,1101,1102],{"class":636},"?:",[626,1104,778],{"class":636},[626,1106,1107],{"class":728},"ctx",[626,1109,705],{"class":636},[626,1111,1112],{"class":1082}," PluginSetupContext",[626,1114,1060],{"class":636},[626,1116,1117],{"class":679}," =>",[626,1119,1120],{"class":1082}," void",[626,1122,1123],{"class":636}," |",[626,1125,1126],{"class":1082}," Promise",[626,1128,1129],{"class":636},"\u003C",[626,1131,1132],{"class":1082},"void",[626,1134,1135],{"class":636},">\n",[626,1137,1138,1140,1142,1144,1146,1148,1151,1153,1155,1157,1159,1161,1163,1165],{"class":628,"line":698},[626,1139,831],{"class":701},[626,1141,1102],{"class":636},[626,1143,778],{"class":636},[626,1145,1107],{"class":728},[626,1147,705],{"class":636},[626,1149,1150],{"class":1082}," EnrichContext",[626,1152,1060],{"class":636},[626,1154,1117],{"class":679},[626,1156,1120],{"class":1082},[626,1158,1123],{"class":636},[626,1160,1126],{"class":1082},[626,1162,1129],{"class":636},[626,1164,1132],{"class":1082},[626,1166,1135],{"class":636},[626,1168,1169,1172,1174,1176,1178,1180,1183,1185,1187,1189,1191,1193,1195,1197],{"class":628,"line":719},[626,1170,1171],{"class":701},"  drain",[626,1173,1102],{"class":636},[626,1175,778],{"class":636},[626,1177,1107],{"class":728},[626,1179,705],{"class":636},[626,1181,1182],{"class":1082}," DrainContext",[626,1184,1060],{"class":636},[626,1186,1117],{"class":679},[626,1188,1120],{"class":1082},[626,1190,1123],{"class":636},[626,1192,1126],{"class":1082},[626,1194,1129],{"class":636},[626,1196,1132],{"class":1082},[626,1198,1135],{"class":636},[626,1200,1201,1204,1206,1208,1210,1212,1215,1217,1219,1221,1223,1225,1227,1229],{"class":628,"line":743},[626,1202,1203],{"class":701},"  keep",[626,1205,1102],{"class":636},[626,1207,778],{"class":636},[626,1209,1107],{"class":728},[626,1211,705],{"class":636},[626,1213,1214],{"class":1082}," TailSamplingContext",[626,1216,1060],{"class":636},[626,1218,1117],{"class":679},[626,1220,1120],{"class":1082},[626,1222,1123],{"class":636},[626,1224,1126],{"class":1082},[626,1226,1129],{"class":636},[626,1228,1132],{"class":1082},[626,1230,1135],{"class":636},[626,1232,1233,1235,1237,1239,1241,1243,1246,1248,1250],{"class":628,"line":772},[626,1234,722],{"class":701},[626,1236,1102],{"class":636},[626,1238,778],{"class":636},[626,1240,1107],{"class":728},[626,1242,705],{"class":636},[626,1244,1245],{"class":1082}," RequestLifecycleContext",[626,1247,1060],{"class":636},[626,1249,1117],{"class":679},[626,1251,1252],{"class":1082}," void\n",[626,1254,1255,1258,1260,1262,1264,1266,1269,1271,1273],{"class":628,"line":822},[626,1256,1257],{"class":701},"  onRequestFinish",[626,1259,1102],{"class":636},[626,1261,778],{"class":636},[626,1263,1107],{"class":728},[626,1265,705],{"class":636},[626,1267,1268],{"class":1082}," RequestFinishContext",[626,1270,1060],{"class":636},[626,1272,1117],{"class":679},[626,1274,1252],{"class":1082},[626,1276,1277,1280,1282,1284,1286,1288,1291,1293,1295],{"class":628,"line":828},[626,1278,1279],{"class":701},"  onClientLog",[626,1281,1102],{"class":636},[626,1283,778],{"class":636},[626,1285,1107],{"class":728},[626,1287,705],{"class":636},[626,1289,1290],{"class":1082}," ClientLogContext",[626,1292,1060],{"class":636},[626,1294,1117],{"class":679},[626,1296,1252],{"class":1082},[626,1298,1299,1302,1304,1306,1308,1310,1313,1315,1317],{"class":628,"line":843},[626,1300,1301],{"class":701},"  extendLogger",[626,1303,1102],{"class":636},[626,1305,778],{"class":636},[626,1307,787],{"class":728},[626,1309,705],{"class":636},[626,1311,1312],{"class":1082}," RequestLogger",[626,1314,1060],{"class":636},[626,1316,1117],{"class":679},[626,1318,1252],{"class":1082},[626,1320,1321],{"class":628,"line":869},[626,1322,1323],{"class":636},"}\n",[566,1325,1327],{"id":1326},"common-pitfalls","Common pitfalls",[578,1329,1330,1340,1352,1376],{},[581,1331,1332,1335,1336,1339],{},[561,1333,1334],{},"Don't throw from a hook",". The plugin runner catches and logs errors with the plugin name, but a thrown error from ",[556,1337,1338],{},"enrich"," won't propagate the event downstream. Keep hooks defensive.",[581,1341,1342,1348,1349,611],{},[561,1343,1344,1347],{},[556,1345,1346],{},"drain"," runs for every event"," — not just per-request. If you only care about per-request lifecycle, use ",[556,1350,1351],{},"onRequestFinish",[581,1353,1354,1359,1360,1363,1364,1367,1368,1371,1372,790],{},[561,1355,1356,1358],{},[556,1357,600],{}," mutates the logger object"," — augment ",[556,1361,1362],{},"RequestLogger"," in a ",[556,1365,1366],{},".d.ts"," so ",[556,1369,1370],{},"useLogger(event)"," exposes the new methods to TypeScript. See ",[1373,1374,1375],"a",{"href":181},"typed fields",[581,1377,1378,1384,1385,1387],{},[561,1379,1380,1381],{},"Plugins are de-duplicated by ",[556,1382,1383],{},"name",". Re-registering with the same ",[556,1386,1383],{}," replaces the previous version (last registration wins).",[566,1389,1391],{"id":1390},"going-further","Going further",[578,1393,1394,1399,1404,1409],{},[581,1395,1396,1397],{},"Single-purpose enricher → ",[1373,1398,339],{"href":340},[581,1400,1401,1402],{},"Tail-only logic → ",[1373,1403,343],{"href":344},[581,1405,1406,1407],{},"Drain-only side effect → ",[1373,1408,410],{"href":411},[581,1410,1411,1412,1414],{},"Package your plugin for reuse → ",[1373,1413,392],{"href":393}," (same scaffolding pattern)",[1416,1417,1418],"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 .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}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 .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 .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 .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}",{"title":622,"searchDepth":666,"depth":666,"links":1420},[1421,1422,1423,1424,1425],{"id":568,"depth":666,"text":569},{"id":614,"depth":666,"text":615},{"id":911,"depth":666,"text":912},{"id":1326,"depth":666,"text":1327},{"id":1390,"depth":666,"text":1391},"definePlugin is the canonical extension contract for evlog. One plugin can opt into any subset of lifecycle hooks — enrich, drain, tail sampling, request lifecycle, client log observation.","md",null,{},{"title":335,"icon":288},{"title":335,"description":1426},"BSjyMNdGruCU1O0qS66t78DCDasQzS-Wn77DA7YG4eE",[1434,1436],{"title":41,"path":331,"stem":332,"description":1435,"icon":333,"children":-1},"The pipeline is everything that happens between an event being emitted and a drain receiving it — plugins, enrichers, sampling, redaction, fork.",{"title":339,"path":340,"stem":341,"description":1437,"icon":28,"children":-1},"defineEnricher derives context from request headers, env, or anything else, and adds it to every wide event before drain — without touching call sites.",1778338249656]