[{"data":1,"prerenderedAt":1983},["ShallowReactive",2],{"navigation_docs":3,"-extend-plugins":515,"-extend-plugins-surround":1978},[4,30,80,123,298,430,485],{"title":5,"path":6,"stem":7,"children":8,"page":29},"Start","\u002Fstart","1.start",[9,14,19,24],{"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",false,{"title":31,"path":32,"stem":33,"children":34,"page":29},"Learn","\u002Flearn","2.learn",[35,40,45,50,55,60,65,70,75],{"title":36,"path":37,"stem":38,"icon":39},"Overview","\u002Flearn\u002Foverview","2.learn\u002F0.overview","i-lucide-list",{"title":41,"path":42,"stem":43,"icon":44},"Simple Logging","\u002Flearn\u002Fsimple-logging","2.learn\u002F1.simple-logging","i-lucide-terminal",{"title":46,"path":47,"stem":48,"icon":49},"Wide Events","\u002Flearn\u002Fwide-events","2.learn\u002F2.wide-events","i-lucide-layers",{"title":51,"path":52,"stem":53,"icon":54},"Structured Errors","\u002Flearn\u002Fstructured-errors","2.learn\u002F3.structured-errors","i-lucide-shield-alert",{"title":56,"path":57,"stem":58,"icon":59},"Lifecycle","\u002Flearn\u002Flifecycle","2.learn\u002F4.lifecycle","i-lucide-arrow-right-left",{"title":61,"path":62,"stem":63,"icon":64},"Sampling","\u002Flearn\u002Fsampling","2.learn\u002F5.sampling","i-lucide-filter",{"title":66,"path":67,"stem":68,"icon":69},"Auto-Redaction","\u002Flearn\u002Fredaction","2.learn\u002F6.redaction","i-lucide-eye-off",{"title":71,"path":72,"stem":73,"icon":74},"Typed Fields","\u002Flearn\u002Ftyped-fields","2.learn\u002F7.typed-fields","i-simple-icons-typescript",{"title":76,"path":77,"stem":78,"icon":79},"Catalogs","\u002Flearn\u002Fcatalogs","2.learn\u002F8.catalogs","i-lucide-book-open",{"title":81,"path":82,"stem":83,"children":84,"page":29},"CLI","\u002Fcli","3.cli",[85,88,93,98,103,108,113,118],{"title":36,"path":86,"stem":87,"icon":44},"\u002Fcli\u002Foverview","3.cli\u002F0.overview",{"title":89,"path":90,"stem":91,"icon":92},"init","\u002Fcli\u002Finit","3.cli\u002F1.init","i-lucide-wand-sparkles",{"title":94,"path":95,"stem":96,"icon":97},"map","\u002Fcli\u002Fmap","3.cli\u002F2.map","i-lucide-radar",{"title":99,"path":100,"stem":101,"icon":102},"Rules","\u002Fcli\u002Frules","3.cli\u002F3.rules","i-lucide-list-checks",{"title":104,"path":105,"stem":106,"icon":107},"Scoring","\u002Fcli\u002Fscoring","3.cli\u002F4.scoring","i-lucide-gauge",{"title":109,"path":110,"stem":111,"icon":112},"CI","\u002Fcli\u002Fci","3.cli\u002F5.ci","i-lucide-git-pull-request",{"title":114,"path":115,"stem":116,"icon":117},"doctor","\u002Fcli\u002Fdoctor","3.cli\u002F6.doctor","i-lucide-stethoscope",{"title":119,"path":120,"stem":121,"icon":122},"telemetry","\u002Fcli\u002Ftelemetry","3.cli\u002F7.telemetry","i-lucide-bar-chart-3",{"title":124,"path":125,"stem":126,"children":127,"page":29},"Integrate","\u002Fintegrate","4.integrate",[128,132,210],{"title":36,"path":129,"stem":130,"icon":131},"\u002Fintegrate\u002Foverview","4.integrate\u002F0.overview","i-lucide-plug",{"title":133,"path":134,"stem":135,"children":136,"page":29},"Adapters","\u002Fintegrate\u002Fadapters","4.integrate\u002Fadapters",[137,140,180,190],{"title":36,"path":138,"stem":139,"icon":39},"\u002Fintegrate\u002Fadapters\u002Foverview","4.integrate\u002Fadapters\u002F01.overview",{"title":141,"path":142,"stem":143,"children":144,"page":29},"Cloud","\u002Fintegrate\u002Fadapters\u002Fcloud","4.integrate\u002Fadapters\u002Fcloud",[145,150,155,160,165,170,175],{"title":146,"path":147,"stem":148,"icon":149},"Axiom","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Faxiom","4.integrate\u002Fadapters\u002Fcloud\u002F01.axiom","i-custom-axiom",{"title":151,"path":152,"stem":153,"icon":154},"OTLP","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fotlp","4.integrate\u002Fadapters\u002Fcloud\u002F02.otlp","i-simple-icons-opentelemetry",{"title":156,"path":157,"stem":158,"icon":159},"PostHog","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fposthog","4.integrate\u002Fadapters\u002Fcloud\u002F03.posthog","i-simple-icons-posthog",{"title":161,"path":162,"stem":163,"icon":164},"Sentry","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fsentry","4.integrate\u002Fadapters\u002Fcloud\u002F04.sentry","i-simple-icons-sentry",{"title":166,"path":167,"stem":168,"icon":169},"Better Stack","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fbetter-stack","4.integrate\u002Fadapters\u002Fcloud\u002F05.better-stack","i-simple-icons-betterstack",{"title":171,"path":172,"stem":173,"icon":174},"Datadog","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fdatadog","4.integrate\u002Fadapters\u002Fcloud\u002F06.datadog","i-simple-icons-datadog",{"title":176,"path":177,"stem":178,"icon":179},"HyperDX","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fhyperdx","4.integrate\u002Fadapters\u002Fcloud\u002F07.hyperdx","i-custom-hyperdx",{"title":181,"path":182,"stem":183,"children":184,"page":29},"Cloud or Self-Hosted","\u002Fintegrate\u002Fadapters\u002Fhybrid","4.integrate\u002Fadapters\u002Fhybrid",[185],{"title":186,"path":187,"stem":188,"icon":189},"Grafana Loki","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Floki","4.integrate\u002Fadapters\u002Fhybrid\u002F01.loki","i-simple-icons-grafana",{"title":191,"path":192,"stem":193,"children":194,"page":29},"Self-Hosted","\u002Fintegrate\u002Fadapters\u002Fself-hosted","4.integrate\u002Fadapters\u002Fself-hosted",[195,200,205],{"title":196,"path":197,"stem":198,"icon":199},"File System","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Ffs","4.integrate\u002Fadapters\u002Fself-hosted\u002F01.fs","i-lucide-hard-drive",{"title":201,"path":202,"stem":203,"icon":204},"NuxtHub","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Fnuxthub","4.integrate\u002Fadapters\u002Fself-hosted\u002F02.nuxthub","i-simple-icons-nuxt",{"title":206,"path":207,"stem":208,"icon":209},"Memory","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Fmemory","4.integrate\u002Fadapters\u002Fself-hosted\u002F03.memory","i-lucide-cpu",{"title":211,"path":212,"stem":213,"children":214,"page":29},"Frameworks","\u002Fintegrate\u002Fframeworks","4.integrate\u002Fframeworks",[215,219,224,229,234,239,244,249,254,259,264,269,274,279,283,288,293],{"title":36,"path":216,"stem":217,"icon":218},"\u002Fintegrate\u002Fframeworks\u002Foverview","4.integrate\u002Fframeworks\u002F00.overview","i-lucide-layout-grid",{"title":220,"path":221,"stem":222,"icon":223},"Nuxt","\u002Fintegrate\u002Fframeworks\u002Fnuxt","4.integrate\u002Fframeworks\u002F01.nuxt","i-simple-icons-nuxtdotjs",{"title":225,"path":226,"stem":227,"icon":228},"Next.js","\u002Fintegrate\u002Fframeworks\u002Fnextjs","4.integrate\u002Fframeworks\u002F02.nextjs","i-simple-icons-nextdotjs",{"title":230,"path":231,"stem":232,"icon":233},"SvelteKit","\u002Fintegrate\u002Fframeworks\u002Fsveltekit","4.integrate\u002Fframeworks\u002F03.sveltekit","i-simple-icons-svelte",{"title":235,"path":236,"stem":237,"icon":238},"Nitro","\u002Fintegrate\u002Fframeworks\u002Fnitro","4.integrate\u002Fframeworks\u002F04.nitro","i-custom-nitro",{"title":240,"path":241,"stem":242,"icon":243},"TanStack Start","\u002Fintegrate\u002Fframeworks\u002Ftanstack-start","4.integrate\u002Fframeworks\u002F05.tanstack-start","i-custom-tanstack",{"title":245,"path":246,"stem":247,"icon":248},"NestJS","\u002Fintegrate\u002Fframeworks\u002Fnestjs","4.integrate\u002Fframeworks\u002F06.nestjs","i-simple-icons-nestjs",{"title":250,"path":251,"stem":252,"icon":253},"Express","\u002Fintegrate\u002Fframeworks\u002Fexpress","4.integrate\u002Fframeworks\u002F07.express","i-simple-icons-express",{"title":255,"path":256,"stem":257,"icon":258},"Hono","\u002Fintegrate\u002Fframeworks\u002Fhono","4.integrate\u002Fframeworks\u002F08.hono","i-simple-icons-hono",{"title":260,"path":261,"stem":262,"icon":263},"Fastify","\u002Fintegrate\u002Fframeworks\u002Ffastify","4.integrate\u002Fframeworks\u002F09.fastify","i-simple-icons-fastify",{"title":265,"path":266,"stem":267,"icon":268},"Elysia","\u002Fintegrate\u002Fframeworks\u002Felysia","4.integrate\u002Fframeworks\u002F10.elysia","i-custom-elysia",{"title":270,"path":271,"stem":272,"icon":273},"React Router","\u002Fintegrate\u002Fframeworks\u002Freact-router","4.integrate\u002Fframeworks\u002F11.react-router","i-custom-reactrouter",{"title":275,"path":276,"stem":277,"icon":278},"Cloudflare Workers","\u002Fintegrate\u002Fframeworks\u002Fcloudflare-workers","4.integrate\u002Fframeworks\u002F12.cloudflare-workers","i-simple-icons-cloudflare",{"title":280,"path":281,"stem":282,"icon":74},"Standalone","\u002Fintegrate\u002Fframeworks\u002Fstandalone","4.integrate\u002Fframeworks\u002F13.standalone",{"title":284,"path":285,"stem":286,"icon":287},"Astro","\u002Fintegrate\u002Fframeworks\u002Fastro","4.integrate\u002Fframeworks\u002F14.astro","i-simple-icons-astro",{"title":289,"path":290,"stem":291,"icon":292},"oRPC","\u002Fintegrate\u002Fframeworks\u002Forpc","4.integrate\u002Fframeworks\u002F15.orpc","i-lucide-network",{"title":294,"path":295,"stem":296,"icon":297},"AWS Lambda","\u002Fintegrate\u002Fframeworks\u002Faws-lambda","4.integrate\u002Fframeworks\u002F16.aws-lambda","i-custom-lambda",{"title":299,"path":300,"stem":301,"children":302,"page":29},"Use Cases","\u002Fuse-cases","5.use-cases",[303,306,311,340,367,399,420,425],{"title":36,"path":304,"stem":305,"icon":102},"\u002Fuse-cases\u002Foverview","5.use-cases\u002F0.overview",{"title":307,"path":308,"stem":309,"icon":310},"Client Logging","\u002Fuse-cases\u002Fclient-logging","5.use-cases\u002F1.client-logging","i-lucide-monitor",{"title":312,"icon":313,"path":314,"stem":315,"children":316,"page":29},"AI SDK","i-simple-icons-vercel","\u002Fuse-cases\u002Fai-sdk","5.use-cases\u002F2.ai-sdk",[317,320,325,330,335],{"title":36,"path":318,"stem":319,"icon":39},"\u002Fuse-cases\u002Fai-sdk\u002Foverview","5.use-cases\u002F2.ai-sdk\u002F01.overview",{"title":321,"path":322,"stem":323,"icon":324},"Usage","\u002Fuse-cases\u002Fai-sdk\u002Fusage","5.use-cases\u002F2.ai-sdk\u002F02.usage","i-lucide-code",{"title":326,"path":327,"stem":328,"icon":329},"Options","\u002Fuse-cases\u002Fai-sdk\u002Foptions","5.use-cases\u002F2.ai-sdk\u002F03.options","i-lucide-sliders",{"title":331,"path":332,"stem":333,"icon":334},"Metadata","\u002Fuse-cases\u002Fai-sdk\u002Fmetadata","5.use-cases\u002F2.ai-sdk\u002F04.metadata","i-lucide-database",{"title":336,"path":337,"stem":338,"icon":339},"Telemetry","\u002Fuse-cases\u002Fai-sdk\u002Ftelemetry","5.use-cases\u002F2.ai-sdk\u002F05.telemetry","i-lucide-activity",{"title":341,"icon":342,"path":343,"stem":344,"children":345,"page":29},"Better Auth","i-simple-icons-betterauth","\u002Fuse-cases\u002Fbetter-auth","5.use-cases\u002F3.better-auth",[346,349,354,359,363],{"title":36,"path":347,"stem":348,"icon":39},"\u002Fuse-cases\u002Fbetter-auth\u002Foverview","5.use-cases\u002F3.better-auth\u002F01.overview",{"title":350,"path":351,"stem":352,"icon":353},"Identify User","\u002Fuse-cases\u002Fbetter-auth\u002Fidentify-user","5.use-cases\u002F3.better-auth\u002F02.identify-user","i-lucide-user-check",{"title":355,"path":356,"stem":357,"icon":358},"Middleware","\u002Fuse-cases\u002Fbetter-auth\u002Fmiddleware","5.use-cases\u002F3.better-auth\u002F03.middleware","i-lucide-shield",{"title":360,"path":361,"stem":362,"icon":310},"Client Sync","\u002Fuse-cases\u002Fbetter-auth\u002Fclient-sync","5.use-cases\u002F3.better-auth\u002F04.client-sync",{"title":364,"path":365,"stem":366,"icon":107},"Performance","\u002Fuse-cases\u002Fbetter-auth\u002Fperformance","5.use-cases\u002F3.better-auth\u002F05.performance",{"title":368,"icon":369,"path":370,"stem":371,"children":372,"page":29},"Audit Logs","i-lucide-shield-check","\u002Fuse-cases\u002Faudit","5.use-cases\u002F4.audit",[373,376,381,386,391,395],{"title":36,"path":374,"stem":375,"icon":39},"\u002Fuse-cases\u002Faudit\u002Foverview","5.use-cases\u002F4.audit\u002F01.overview",{"title":377,"path":378,"stem":379,"icon":380},"Schema","\u002Fuse-cases\u002Faudit\u002Fschema","5.use-cases\u002F4.audit\u002F02.schema","i-lucide-file-text",{"title":382,"path":383,"stem":384,"icon":385},"Recording","\u002Fuse-cases\u002Faudit\u002Frecording","5.use-cases\u002F4.audit\u002F03.recording","i-lucide-pen-line",{"title":387,"path":388,"stem":389,"icon":390},"Drains","\u002Fuse-cases\u002Faudit\u002Fpipeline","5.use-cases\u002F4.audit\u002F04.pipeline","i-lucide-link",{"title":392,"path":393,"stem":394,"icon":369},"Compliance","\u002Fuse-cases\u002Faudit\u002Fcompliance","5.use-cases\u002F4.audit\u002F05.compliance",{"title":396,"path":397,"stem":398,"icon":79},"Recipes","\u002Fuse-cases\u002Faudit\u002Frecipes","5.use-cases\u002F4.audit\u002F06.recipes",{"title":336,"icon":107,"path":400,"stem":401,"children":402,"page":29},"\u002Fuse-cases\u002Ftelemetry","5.use-cases\u002F4.telemetry",[403,406,411,416],{"title":36,"path":404,"stem":405,"icon":39},"\u002Fuse-cases\u002Ftelemetry\u002Foverview","5.use-cases\u002F4.telemetry\u002F01.overview",{"title":407,"path":408,"stem":409,"icon":410},"Setup","\u002Fuse-cases\u002Ftelemetry\u002Fsetup","5.use-cases\u002F4.telemetry\u002F02.setup","i-lucide-wrench",{"title":412,"path":413,"stem":414,"icon":415},"Ingest","\u002Fuse-cases\u002Ftelemetry\u002Fingest","5.use-cases\u002F4.telemetry\u002F03.ingest","i-lucide-server",{"title":417,"path":418,"stem":419,"icon":79},"Reference","\u002Fuse-cases\u002Ftelemetry\u002Freference","5.use-cases\u002F4.telemetry\u002F04.reference",{"title":421,"path":422,"stem":423,"icon":424},"Enrichers","\u002Fuse-cases\u002Fenrichers","5.use-cases\u002F5.enrichers","i-lucide-sparkles",{"title":426,"path":427,"stem":428,"icon":429},"eve","\u002Fuse-cases\u002Feve","5.use-cases\u002F5.eve","i-custom-eve",{"title":431,"path":432,"stem":433,"children":434,"page":29},"Extend","\u002Fextend","6.extend",[435,439,444,449,454,458,462,466,470,475,480],{"title":36,"path":436,"stem":437,"icon":438},"\u002Fextend\u002Foverview","6.extend\u002F0.overview","i-lucide-blocks",{"title":440,"path":441,"stem":442,"icon":443},"Stream","\u002Fextend\u002Fstream","6.extend\u002F1.stream","i-lucide-radio-tower",{"title":445,"path":446,"stem":447,"icon":448},"Custom framework","\u002Fextend\u002Fcustom-framework","6.extend\u002F10.custom-framework","i-lucide-puzzle",{"title":450,"path":451,"stem":452,"icon":453},"FS reader","\u002Fextend\u002Ffs-reader","6.extend\u002F2.fs-reader","i-lucide-folder-search",{"title":396,"path":455,"stem":456,"icon":457},"\u002Fextend\u002Fconsumer-recipes","6.extend\u002F3.consumer-recipes","i-lucide-chef-hat",{"title":459,"path":460,"stem":461,"icon":438},"Plugins","\u002Fextend\u002Fplugins","6.extend\u002F4.plugins",{"title":463,"path":464,"stem":465,"icon":424},"Custom enrichers","\u002Fextend\u002Fcustom-enrichers","6.extend\u002F5.custom-enrichers",{"title":467,"path":468,"stem":469,"icon":64},"Tail sampling","\u002Fextend\u002Ftail-sampling","6.extend\u002F6.tail-sampling",{"title":471,"path":472,"stem":473,"icon":474},"Identity headers","\u002Fextend\u002Fidentity-headers","6.extend\u002F7.identity-headers","i-lucide-fingerprint",{"title":476,"path":477,"stem":478,"icon":479},"Custom drains","\u002Fextend\u002Fcustom-drains","6.extend\u002F8.custom-drains","i-lucide-share-2",{"title":481,"path":482,"stem":483,"icon":484},"Drain pipeline","\u002Fextend\u002Fdrain-pipeline","6.extend\u002F9.drain-pipeline","i-lucide-workflow",{"title":417,"path":486,"stem":487,"children":488,"page":29},"\u002Freference","7.reference",[489,494,497,502,506,511],{"title":490,"path":491,"stem":492,"icon":493},"Configuration","\u002Freference\u002Fconfiguration","7.reference\u002F1.configuration","i-lucide-settings",{"title":364,"path":495,"stem":496,"icon":107},"\u002Freference\u002Fperformance","7.reference\u002F2.performance",{"title":498,"path":499,"stem":500,"icon":501},"Vite Plugin","\u002Freference\u002Fvite-plugin","7.reference\u002F3.vite-plugin","i-custom-vite",{"title":503,"path":504,"stem":505,"icon":369},"Best Practices","\u002Freference\u002Fbest-practices","7.reference\u002F4.best-practices",{"title":507,"path":508,"stem":509,"icon":510},"vs Other Loggers","\u002Freference\u002Fvs-other-loggers","7.reference\u002F5.vs-other-loggers","i-lucide-scale",{"title":512,"path":513,"stem":514,"icon":424},"Agent Skills","\u002Freference\u002Fagent-skills","7.reference\u002F6.agent-skills",{"id":516,"title":459,"body":517,"description":1966,"extension":1967,"links":1968,"meta":1974,"navigation":1975,"path":460,"seo":1976,"stem":461,"__hash__":1977},"docs\u002F6.extend\u002F4.plugins.md",{"type":518,"value":519,"toc":1958},"minimark",[520,523,536,556,643,648,907,910,1142,1145,1287,1301,1305,1320,1752,1756,1765,1856,1863,1867,1924,1928,1954],[521,522],"lifecycle-flow",{},[524,525,526,530,531,535],"p",{},[527,528,529],"code",{},"definePlugin()"," is the ",[532,533,534],"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 (e.g. enrich on every event + side-effect on drain + keep decision on tail sampling, all reading the same shared state).",[524,537,538,539,545,546,551,552,555],{},"When the extension only does one thing, prefer the single-purpose ",[540,541,542],"a",{"href":464},[527,543,544],{},"enricherPlugin()"," \u002F ",[540,547,548],{"href":477},[527,549,550],{},"drainPlugin()"," wrappers. Reach for ",[527,553,554],{},"definePlugin"," when several hooks share state.",[557,558,561,564,635],"prompt",{":actions":559,"description":560,"icon":438},"[\"copy\",\"cursor\",\"claude\"]","Build a multi-hook evlog plugin",[524,562,563],{},"Build an evlog plugin that hooks into more than one lifecycle stage.",[565,566,567,601,607,610,624],"ul",{},[568,569,570,571,573,574,577,578,581,582,581,585,581,588,581,591,581,594,581,597,600],"li",{},"Import ",[527,572,554],{}," from ",[527,575,576],{},"evlog"," and pick the hooks I need (",[527,579,580],{},"onRequestStart",", ",[527,583,584],{},"enrich",[527,586,587],{},"drain",[527,589,590],{},"extendLogger",[527,592,593],{},"keep",[527,595,596],{},"onClientLog",[527,598,599],{},"onRequestFinish",")",[568,602,603,604,606],{},"Keep ",[527,605,584],{}," pure (no I\u002FO, no throwing — use try\u002Fcatch internally)",[568,608,609],{},"For drains, batch and ship to the destination; respect backpressure if the sink is slow",[568,611,612,613,616,617,620,621,600],{},"Register the plugin via the framework config: Next\u002Fstandalone ",[527,614,615],{},"initLogger({ plugins: [myPlugin] })",", Hono\u002FExpress\u002FFastify\u002FElysia middleware option ",[527,618,619],{},"{ plugins: [myPlugin] }",". For Nitro, register the individual hooks directly (",[527,622,623],{},"nitroApp.hooks.hook('evlog:enrich' | 'evlog:drain' | …)",[568,625,626,627,545,629,631,632,634],{},"Prefer single-purpose ",[527,628,544],{},[527,630,550],{}," wrappers for simple extensions; use ",[527,633,554],{}," only when several hooks are needed",[524,636,637,638],{},"Docs: ",[540,639,640],{"href":640,"rel":641},"https:\u002F\u002Fwww.evlog.dev\u002Fextend\u002Fplugins",[642],"nofollow",[644,645,647],"h2",{"id":646},"minimal-example","Minimal example",[649,650,655],"pre",{"className":651,"code":652,"language":653,"meta":654,"style":654},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import { definePlugin } from 'evlog'\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","ts","",[527,656,657,689,696,721,742,767,797,847,853,868,894,899],{"__ignoreMap":654},[658,659,662,666,670,674,677,680,683,686],"span",{"class":660,"line":661},"line",1,[658,663,665],{"class":664},"s7zQu","import",[658,667,669],{"class":668},"sMK4o"," {",[658,671,673],{"class":672},"sTEyZ"," definePlugin",[658,675,676],{"class":668}," }",[658,678,679],{"class":664}," from",[658,681,682],{"class":668}," '",[658,684,576],{"class":685},"sfazB",[658,687,688],{"class":668},"'\n",[658,690,692],{"class":660,"line":691},2,[658,693,695],{"emptyLinePlaceholder":694},true,"\n",[658,697,699,702,706,709,712,715,718],{"class":660,"line":698},3,[658,700,701],{"class":664},"export",[658,703,705],{"class":704},"spNyl"," const",[658,707,708],{"class":672}," tenantPlugin ",[658,710,711],{"class":668},"=",[658,713,673],{"class":714},"s2Zo4",[658,716,717],{"class":672},"(",[658,719,720],{"class":668},"{\n",[658,722,724,728,731,733,736,739],{"class":660,"line":723},4,[658,725,727],{"class":726},"swJcz","  name",[658,729,730],{"class":668},":",[658,732,682],{"class":668},[658,734,735],{"class":685},"tenant",[658,737,738],{"class":668},"'",[658,740,741],{"class":668},",\n",[658,743,745,748,751,755,758,761,764],{"class":660,"line":744},5,[658,746,747],{"class":726},"  onRequestStart",[658,749,750],{"class":668},"({",[658,752,754],{"class":753},"sHdIc"," logger",[658,756,757],{"class":668},",",[658,759,760],{"class":753}," headers",[658,762,763],{"class":668}," })",[658,765,766],{"class":668}," {\n",[658,768,770,773,776,779,781,784,787,789,792,794],{"class":660,"line":769},6,[658,771,772],{"class":704},"    const",[658,774,775],{"class":672}," tenantId",[658,777,778],{"class":668}," =",[658,780,760],{"class":672},[658,782,783],{"class":668},"?.",[658,785,786],{"class":726},"[",[658,788,738],{"class":668},[658,790,791],{"class":685},"x-tenant-id",[658,793,738],{"class":668},[658,795,796],{"class":726},"]\n",[658,798,800,803,806,809,812,815,818,821,823,826,829,831,833,836,838,840,842,844],{"class":660,"line":799},7,[658,801,802],{"class":664},"    if",[658,804,805],{"class":726}," (",[658,807,808],{"class":672},"tenantId",[658,810,811],{"class":726},") ",[658,813,814],{"class":672},"logger",[658,816,817],{"class":668},".",[658,819,820],{"class":714},"set",[658,822,717],{"class":726},[658,824,825],{"class":668},"{",[658,827,828],{"class":726}," tenant",[658,830,730],{"class":668},[658,832,669],{"class":668},[658,834,835],{"class":726}," id",[658,837,730],{"class":668},[658,839,775],{"class":672},[658,841,676],{"class":668},[658,843,676],{"class":668},[658,845,846],{"class":726},")\n",[658,848,850],{"class":660,"line":849},8,[658,851,852],{"class":668},"  },\n",[658,854,856,859,861,864,866],{"class":660,"line":855},9,[658,857,858],{"class":726},"  enrich",[658,860,750],{"class":668},[658,862,863],{"class":753}," event",[658,865,763],{"class":668},[658,867,766],{"class":668},[658,869,871,874,876,879,881,884,886,889,891],{"class":660,"line":870},10,[658,872,873],{"class":672},"    event",[658,875,817],{"class":668},[658,877,878],{"class":672},"region",[658,880,778],{"class":668},[658,882,883],{"class":672}," process",[658,885,817],{"class":668},[658,887,888],{"class":672},"env",[658,890,817],{"class":668},[658,892,893],{"class":672},"REGION\n",[658,895,897],{"class":660,"line":896},11,[658,898,852],{"class":668},[658,900,902,905],{"class":660,"line":901},12,[658,903,904],{"class":668},"}",[658,906,846],{"class":672},[524,908,909],{},"Register the plugin where you bootstrap evlog. The shape depends on your runtime:",[911,912,913,983,1061],"code-group",{},[649,914,917],{"className":651,"code":915,"filename":916,"language":653,"meta":654,"style":654},"import { initLogger } from 'evlog'\nimport { tenantPlugin } from '.\u002Fplugins\u002Ftenant'\n\ninitLogger({ plugins: [tenantPlugin] })\n","Next.js \u002F standalone",[527,918,919,938,958,962],{"__ignoreMap":654},[658,920,921,923,925,928,930,932,934,936],{"class":660,"line":661},[658,922,665],{"class":664},[658,924,669],{"class":668},[658,926,927],{"class":672}," initLogger",[658,929,676],{"class":668},[658,931,679],{"class":664},[658,933,682],{"class":668},[658,935,576],{"class":685},[658,937,688],{"class":668},[658,939,940,942,944,947,949,951,953,956],{"class":660,"line":691},[658,941,665],{"class":664},[658,943,669],{"class":668},[658,945,946],{"class":672}," tenantPlugin",[658,948,676],{"class":668},[658,950,679],{"class":664},[658,952,682],{"class":668},[658,954,955],{"class":685},".\u002Fplugins\u002Ftenant",[658,957,688],{"class":668},[658,959,960],{"class":660,"line":698},[658,961,695],{"emptyLinePlaceholder":694},[658,963,964,967,969,971,974,976,979,981],{"class":660,"line":723},[658,965,966],{"class":714},"initLogger",[658,968,717],{"class":672},[658,970,825],{"class":668},[658,972,973],{"class":726}," plugins",[658,975,730],{"class":668},[658,977,978],{"class":672}," [tenantPlugin] ",[658,980,904],{"class":668},[658,982,846],{"class":672},[649,984,987],{"className":651,"code":985,"filename":986,"language":653,"meta":654,"style":654},"import { evlogMiddleware } from 'evlog\u002F\u003Cframework>'\nimport { tenantPlugin } from '.\u002Fplugins\u002Ftenant'\n\napp.use(evlogMiddleware({ plugins: [tenantPlugin] }))\n","Hono \u002F Express \u002F Fastify \u002F Elysia",[527,988,989,1009,1027,1031],{"__ignoreMap":654},[658,990,991,993,995,998,1000,1002,1004,1007],{"class":660,"line":661},[658,992,665],{"class":664},[658,994,669],{"class":668},[658,996,997],{"class":672}," evlogMiddleware",[658,999,676],{"class":668},[658,1001,679],{"class":664},[658,1003,682],{"class":668},[658,1005,1006],{"class":685},"evlog\u002F\u003Cframework>",[658,1008,688],{"class":668},[658,1010,1011,1013,1015,1017,1019,1021,1023,1025],{"class":660,"line":691},[658,1012,665],{"class":664},[658,1014,669],{"class":668},[658,1016,946],{"class":672},[658,1018,676],{"class":668},[658,1020,679],{"class":664},[658,1022,682],{"class":668},[658,1024,955],{"class":685},[658,1026,688],{"class":668},[658,1028,1029],{"class":660,"line":698},[658,1030,695],{"emptyLinePlaceholder":694},[658,1032,1033,1036,1038,1041,1043,1046,1048,1050,1052,1054,1056,1058],{"class":660,"line":723},[658,1034,1035],{"class":672},"app",[658,1037,817],{"class":668},[658,1039,1040],{"class":714},"use",[658,1042,717],{"class":672},[658,1044,1045],{"class":714},"evlogMiddleware",[658,1047,717],{"class":672},[658,1049,825],{"class":668},[658,1051,973],{"class":726},[658,1053,730],{"class":668},[658,1055,978],{"class":672},[658,1057,904],{"class":668},[658,1059,1060],{"class":672},"))\n",[649,1062,1064],{"className":651,"code":1063,"filename":235,"language":653,"meta":654,"style":654},"\u002F\u002F Register the hooks you actually use directly:\nnitroApp.hooks.hook('evlog:enrich', tenantPlugin.enrich!)\nnitroApp.hooks.hook('evlog:request:start', tenantPlugin.onRequestStart!)\n",[527,1065,1066,1072,1109],{"__ignoreMap":654},[658,1067,1068],{"class":660,"line":661},[658,1069,1071],{"class":1070},"sHwdD","\u002F\u002F Register the hooks you actually use directly:\n",[658,1073,1074,1077,1079,1082,1084,1087,1089,1091,1094,1096,1098,1100,1102,1104,1107],{"class":660,"line":691},[658,1075,1076],{"class":672},"nitroApp",[658,1078,817],{"class":668},[658,1080,1081],{"class":672},"hooks",[658,1083,817],{"class":668},[658,1085,1086],{"class":714},"hook",[658,1088,717],{"class":672},[658,1090,738],{"class":668},[658,1092,1093],{"class":685},"evlog:enrich",[658,1095,738],{"class":668},[658,1097,757],{"class":668},[658,1099,946],{"class":672},[658,1101,817],{"class":668},[658,1103,584],{"class":672},[658,1105,1106],{"class":668},"!",[658,1108,846],{"class":672},[658,1110,1111,1113,1115,1117,1119,1121,1123,1125,1128,1130,1132,1134,1136,1138,1140],{"class":660,"line":698},[658,1112,1076],{"class":672},[658,1114,817],{"class":668},[658,1116,1081],{"class":672},[658,1118,817],{"class":668},[658,1120,1086],{"class":714},[658,1122,717],{"class":672},[658,1124,738],{"class":668},[658,1126,1127],{"class":685},"evlog:request:start",[658,1129,738],{"class":668},[658,1131,757],{"class":668},[658,1133,946],{"class":672},[658,1135,817],{"class":668},[658,1137,580],{"class":672},[658,1139,1106],{"class":668},[658,1141,846],{"class":672},[644,1143,1144],{"id":1081},"Hooks",[1146,1147,1148,1164],"table",{},[1149,1150,1151],"thead",{},[1152,1153,1154,1158,1161],"tr",{},[1155,1156,1157],"th",{},"Hook",[1155,1159,1160],{},"When",[1155,1162,1163],{},"Use it for",[1165,1166,1167,1184,1199,1212,1232,1245,1258,1271],"tbody",{},[1152,1168,1169,1175,1178],{},[1170,1171,1172],"td",{},[527,1173,1174],{},"setup(ctx)",[1170,1176,1177],{},"Once when registered",[1170,1179,1180,1181,1183],{},"Read ",[527,1182,888],{},", set up shared state",[1152,1185,1186,1191,1194],{},[1170,1187,1188],{},[527,1189,1190],{},"onRequestStart(ctx)",[1170,1192,1193],{},"Each request, before any handler runs",[1170,1195,1196,1197],{},"Pull values from headers into ",[527,1198,814],{},[1152,1200,1201,1206,1209],{},[1170,1202,1203],{},[527,1204,1205],{},"enrich(ctx)",[1170,1207,1208],{},"Every event, before drain",[1170,1210,1211],{},"Add derived fields (geo, deploy id…)",[1152,1213,1214,1219,1222],{},[1170,1215,1216],{},[527,1217,1218],{},"keep(ctx)",[1170,1220,1221],{},"Tail sampling decision",[1170,1223,1224,1225,581,1228,1231],{},"Force-keep based on outcome (",[527,1226,1227],{},"status >= 400",[527,1229,1230],{},"duration > 500",", …)",[1152,1233,1234,1239,1242],{},[1170,1235,1236],{},[527,1237,1238],{},"drain(ctx)",[1170,1240,1241],{},"Every emitted event",[1170,1243,1244],{},"Side-effect: alert, mirror to a queue, etc.",[1152,1246,1247,1252,1255],{},[1170,1248,1249],{},[527,1250,1251],{},"onRequestFinish(ctx)",[1170,1253,1254],{},"After response",[1170,1256,1257],{},"Per-request post-processing",[1152,1259,1260,1265,1268],{},[1170,1261,1262],{},[527,1263,1264],{},"onClientLog(ctx)",[1170,1266,1267],{},"Browser-submitted event hits the ingest endpoint",[1170,1269,1270],{},"Observe \u002F reject client traffic",[1152,1272,1273,1278,1281],{},[1170,1274,1275],{},[527,1276,1277],{},"extendLogger(logger)",[1170,1279,1280],{},"Each request",[1170,1282,1283,1284,600],{},"Add custom methods (e.g. ",[527,1285,1286],{},"logger.audit.refund()",[524,1288,1289,1290,1293,1294,817],{},"Every hook is ",[532,1291,1292],{},"optional",". A plugin can implement any subset. The full type lives in ",[540,1295,1298],{"href":1296,"rel":1297},"https:\u002F\u002Fgithub.com\u002FHugoRCD\u002Fevlog\u002Fblob\u002Fmain\u002Fpackages\u002Fevlog\u002Fsrc\u002Fshared\u002Fplugin.ts",[642],[527,1299,1300],{},"packages\u002Fevlog\u002Fsrc\u002Fshared\u002Fplugin.ts",[644,1302,1304],{"id":1303},"a-multi-hook-example","A multi-hook example",[524,1306,1307,1308,1311,1312,581,1315,1317,1318,730],{},"Plugins shine when several concerns share state. Here, a single ",[527,1309,1310],{},"request-metrics"," plugin tracks per-request timing through ",[527,1313,1314],{},"setup",[527,1316,580],{},", and ",[527,1319,587],{},[649,1321,1323],{"className":651,"code":1322,"language":653,"meta":654,"style":654},"import { definePlugin } from 'evlog\u002Ftoolkit'\n\nexport const requestMetricsPlugin = definePlugin({\n  name: 'request-metrics',\n\n  setup({ env }) {\n    statsd.init({ service: env.service })\n  },\n\n  enrich({ event }) {\n    event.tier = event.duration && event.duration > 1000 ? 'slow' : 'fast'\n  },\n\n  drain({ event }) {\n    statsd.timing('http.request', event.duration as number, { path: event.path as string })\n  },\n\n  onRequestStart({ logger, request }) {\n    logger.set({ trace: { startedAt: Date.now() } })\n  },\n\n  onRequestFinish({ event, durationMs }) {\n    if (event && (event.level === 'error' || durationMs > 5000)) {\n      \u002F\u002F alert \u002F forward \u002F etc.\n    }\n  },\n})\n",[527,1324,1325,1344,1348,1365,1379,1383,1397,1426,1430,1434,1446,1500,1504,1509,1523,1582,1587,1592,1610,1653,1658,1663,1682,1728,1734,1740,1745],{"__ignoreMap":654},[658,1326,1327,1329,1331,1333,1335,1337,1339,1342],{"class":660,"line":661},[658,1328,665],{"class":664},[658,1330,669],{"class":668},[658,1332,673],{"class":672},[658,1334,676],{"class":668},[658,1336,679],{"class":664},[658,1338,682],{"class":668},[658,1340,1341],{"class":685},"evlog\u002Ftoolkit",[658,1343,688],{"class":668},[658,1345,1346],{"class":660,"line":691},[658,1347,695],{"emptyLinePlaceholder":694},[658,1349,1350,1352,1354,1357,1359,1361,1363],{"class":660,"line":698},[658,1351,701],{"class":664},[658,1353,705],{"class":704},[658,1355,1356],{"class":672}," requestMetricsPlugin ",[658,1358,711],{"class":668},[658,1360,673],{"class":714},[658,1362,717],{"class":672},[658,1364,720],{"class":668},[658,1366,1367,1369,1371,1373,1375,1377],{"class":660,"line":723},[658,1368,727],{"class":726},[658,1370,730],{"class":668},[658,1372,682],{"class":668},[658,1374,1310],{"class":685},[658,1376,738],{"class":668},[658,1378,741],{"class":668},[658,1380,1381],{"class":660,"line":744},[658,1382,695],{"emptyLinePlaceholder":694},[658,1384,1385,1388,1390,1393,1395],{"class":660,"line":769},[658,1386,1387],{"class":726},"  setup",[658,1389,750],{"class":668},[658,1391,1392],{"class":753}," env",[658,1394,763],{"class":668},[658,1396,766],{"class":668},[658,1398,1399,1402,1404,1406,1408,1410,1413,1415,1417,1419,1422,1424],{"class":660,"line":799},[658,1400,1401],{"class":672},"    statsd",[658,1403,817],{"class":668},[658,1405,89],{"class":714},[658,1407,717],{"class":726},[658,1409,825],{"class":668},[658,1411,1412],{"class":726}," service",[658,1414,730],{"class":668},[658,1416,1392],{"class":672},[658,1418,817],{"class":668},[658,1420,1421],{"class":672},"service",[658,1423,676],{"class":668},[658,1425,846],{"class":726},[658,1427,1428],{"class":660,"line":849},[658,1429,852],{"class":668},[658,1431,1432],{"class":660,"line":855},[658,1433,695],{"emptyLinePlaceholder":694},[658,1435,1436,1438,1440,1442,1444],{"class":660,"line":870},[658,1437,858],{"class":726},[658,1439,750],{"class":668},[658,1441,863],{"class":753},[658,1443,763],{"class":668},[658,1445,766],{"class":668},[658,1447,1448,1450,1452,1455,1457,1459,1461,1464,1467,1469,1471,1473,1476,1480,1483,1485,1488,1490,1493,1495,1498],{"class":660,"line":896},[658,1449,873],{"class":672},[658,1451,817],{"class":668},[658,1453,1454],{"class":672},"tier",[658,1456,778],{"class":668},[658,1458,863],{"class":672},[658,1460,817],{"class":668},[658,1462,1463],{"class":672},"duration",[658,1465,1466],{"class":668}," &&",[658,1468,863],{"class":672},[658,1470,817],{"class":668},[658,1472,1463],{"class":672},[658,1474,1475],{"class":668}," >",[658,1477,1479],{"class":1478},"sbssI"," 1000",[658,1481,1482],{"class":668}," ?",[658,1484,682],{"class":668},[658,1486,1487],{"class":685},"slow",[658,1489,738],{"class":668},[658,1491,1492],{"class":668}," :",[658,1494,682],{"class":668},[658,1496,1497],{"class":685},"fast",[658,1499,688],{"class":668},[658,1501,1502],{"class":660,"line":901},[658,1503,852],{"class":668},[658,1505,1507],{"class":660,"line":1506},13,[658,1508,695],{"emptyLinePlaceholder":694},[658,1510,1512,1515,1517,1519,1521],{"class":660,"line":1511},14,[658,1513,1514],{"class":726},"  drain",[658,1516,750],{"class":668},[658,1518,863],{"class":753},[658,1520,763],{"class":668},[658,1522,766],{"class":668},[658,1524,1526,1528,1530,1533,1535,1537,1540,1542,1544,1546,1548,1550,1553,1557,1559,1561,1564,1566,1568,1570,1573,1575,1578,1580],{"class":660,"line":1525},15,[658,1527,1401],{"class":672},[658,1529,817],{"class":668},[658,1531,1532],{"class":714},"timing",[658,1534,717],{"class":726},[658,1536,738],{"class":668},[658,1538,1539],{"class":685},"http.request",[658,1541,738],{"class":668},[658,1543,757],{"class":668},[658,1545,863],{"class":672},[658,1547,817],{"class":668},[658,1549,1463],{"class":672},[658,1551,1552],{"class":664}," as",[658,1554,1556],{"class":1555},"sBMFI"," number",[658,1558,757],{"class":668},[658,1560,669],{"class":668},[658,1562,1563],{"class":726}," path",[658,1565,730],{"class":668},[658,1567,863],{"class":672},[658,1569,817],{"class":668},[658,1571,1572],{"class":672},"path",[658,1574,1552],{"class":664},[658,1576,1577],{"class":1555}," string",[658,1579,676],{"class":668},[658,1581,846],{"class":726},[658,1583,1585],{"class":660,"line":1584},16,[658,1586,852],{"class":668},[658,1588,1590],{"class":660,"line":1589},17,[658,1591,695],{"emptyLinePlaceholder":694},[658,1593,1595,1597,1599,1601,1603,1606,1608],{"class":660,"line":1594},18,[658,1596,747],{"class":726},[658,1598,750],{"class":668},[658,1600,754],{"class":753},[658,1602,757],{"class":668},[658,1604,1605],{"class":753}," request",[658,1607,763],{"class":668},[658,1609,766],{"class":668},[658,1611,1613,1616,1618,1620,1622,1624,1627,1629,1631,1634,1636,1639,1641,1644,1647,1649,1651],{"class":660,"line":1612},19,[658,1614,1615],{"class":672},"    logger",[658,1617,817],{"class":668},[658,1619,820],{"class":714},[658,1621,717],{"class":726},[658,1623,825],{"class":668},[658,1625,1626],{"class":726}," trace",[658,1628,730],{"class":668},[658,1630,669],{"class":668},[658,1632,1633],{"class":726}," startedAt",[658,1635,730],{"class":668},[658,1637,1638],{"class":672}," Date",[658,1640,817],{"class":668},[658,1642,1643],{"class":714},"now",[658,1645,1646],{"class":726},"() ",[658,1648,904],{"class":668},[658,1650,676],{"class":668},[658,1652,846],{"class":726},[658,1654,1656],{"class":660,"line":1655},20,[658,1657,852],{"class":668},[658,1659,1661],{"class":660,"line":1660},21,[658,1662,695],{"emptyLinePlaceholder":694},[658,1664,1666,1669,1671,1673,1675,1678,1680],{"class":660,"line":1665},22,[658,1667,1668],{"class":726},"  onRequestFinish",[658,1670,750],{"class":668},[658,1672,863],{"class":753},[658,1674,757],{"class":668},[658,1676,1677],{"class":753}," durationMs",[658,1679,763],{"class":668},[658,1681,766],{"class":668},[658,1683,1685,1687,1689,1692,1694,1696,1698,1700,1703,1706,1708,1711,1713,1716,1718,1720,1723,1726],{"class":660,"line":1684},23,[658,1686,802],{"class":664},[658,1688,805],{"class":726},[658,1690,1691],{"class":672},"event",[658,1693,1466],{"class":668},[658,1695,805],{"class":726},[658,1697,1691],{"class":672},[658,1699,817],{"class":668},[658,1701,1702],{"class":672},"level",[658,1704,1705],{"class":668}," ===",[658,1707,682],{"class":668},[658,1709,1710],{"class":685},"error",[658,1712,738],{"class":668},[658,1714,1715],{"class":668}," ||",[658,1717,1677],{"class":672},[658,1719,1475],{"class":668},[658,1721,1722],{"class":1478}," 5000",[658,1724,1725],{"class":726},")) ",[658,1727,720],{"class":668},[658,1729,1731],{"class":660,"line":1730},24,[658,1732,1733],{"class":1070},"      \u002F\u002F alert \u002F forward \u002F etc.\n",[658,1735,1737],{"class":660,"line":1736},25,[658,1738,1739],{"class":668},"    }\n",[658,1741,1743],{"class":660,"line":1742},26,[658,1744,852],{"class":668},[658,1746,1748,1750],{"class":660,"line":1747},27,[658,1749,904],{"class":668},[658,1751,846],{"class":672},[644,1753,1755],{"id":1754},"sugar-plugins","Sugar plugins",[524,1757,1758,1759,1761,1762,1764],{},"For single-hook extensions, the toolkit offers ",[527,1760,550],{}," and ",[527,1763,544],{}," wrappers:",[649,1766,1770],{"className":1767,"code":1768,"language":1769,"meta":654,"style":654},"language-typescript shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import { drainPlugin, enricherPlugin } from 'evlog\u002Ftoolkit'\n\nconst drainOnly = drainPlugin('axiom', createAxiomDrain())\nconst enricherOnly = enricherPlugin('user-agent', createUserAgentEnricher())\n","typescript",[527,1771,1772,1796,1800,1829],{"__ignoreMap":654},[658,1773,1774,1776,1778,1781,1783,1786,1788,1790,1792,1794],{"class":660,"line":661},[658,1775,665],{"class":664},[658,1777,669],{"class":668},[658,1779,1780],{"class":672}," drainPlugin",[658,1782,757],{"class":668},[658,1784,1785],{"class":672}," enricherPlugin",[658,1787,676],{"class":668},[658,1789,679],{"class":664},[658,1791,682],{"class":668},[658,1793,1341],{"class":685},[658,1795,688],{"class":668},[658,1797,1798],{"class":660,"line":691},[658,1799,695],{"emptyLinePlaceholder":694},[658,1801,1802,1805,1808,1810,1812,1814,1816,1819,1821,1823,1826],{"class":660,"line":698},[658,1803,1804],{"class":704},"const",[658,1806,1807],{"class":672}," drainOnly ",[658,1809,711],{"class":668},[658,1811,1780],{"class":714},[658,1813,717],{"class":672},[658,1815,738],{"class":668},[658,1817,1818],{"class":685},"axiom",[658,1820,738],{"class":668},[658,1822,757],{"class":668},[658,1824,1825],{"class":714}," createAxiomDrain",[658,1827,1828],{"class":672},"())\n",[658,1830,1831,1833,1836,1838,1840,1842,1844,1847,1849,1851,1854],{"class":660,"line":723},[658,1832,1804],{"class":704},[658,1834,1835],{"class":672}," enricherOnly ",[658,1837,711],{"class":668},[658,1839,1785],{"class":714},[658,1841,717],{"class":672},[658,1843,738],{"class":668},[658,1845,1846],{"class":685},"user-agent",[658,1848,738],{"class":668},[658,1850,757],{"class":668},[658,1852,1853],{"class":714}," createUserAgentEnricher",[658,1855,1828],{"class":672},[524,1857,1858,1859,1862],{},"These are equivalent to a ",[527,1860,1861],{},"definePlugin({ name, drain | enrich })"," shape but read more clearly when intent is obvious.",[644,1864,1866],{"id":1865},"common-pitfalls","Common pitfalls",[565,1868,1869,1878,1889,1912],{},[568,1870,1871,1874,1875,1877],{},[532,1872,1873],{},"Don't throw from a hook."," The plugin runner catches and logs errors with the plugin name, but a thrown error from ",[527,1876,584],{}," won't propagate the event downstream. Keep hooks defensive.",[568,1879,1880,1885,1886,1888],{},[532,1881,1882,1884],{},[527,1883,587],{}," runs for every event"," — not just per-request. If you only care about per-request lifecycle, use ",[527,1887,599],{}," instead.",[568,1890,1891,1896,1897,1900,1901,1904,1905,1908,1909,817],{},[532,1892,1893,1895],{},[527,1894,590],{}," mutates the logger object"," — augment ",[527,1898,1899],{},"RequestLogger"," in a ",[527,1902,1903],{},".d.ts"," so ",[527,1906,1907],{},"useLogger(event)"," exposes the new methods to TypeScript. See ",[540,1910,1911],{"href":72},"typed fields",[568,1913,1914,1920,1921,1923],{},[532,1915,1916,1917],{},"Plugins are de-duplicated by ",[527,1918,1919],{},"name",". Re-registering with the same ",[527,1922,1919],{}," replaces the previous version (last registration wins).",[644,1925,1927],{"id":1926},"next-steps","Next steps",[565,1929,1930,1936,1942,1948],{},[568,1931,1932,1935],{},[540,1933,1934],{"href":464},"Custom Enrichers"," — single-hook enrichment",[568,1937,1938,1941],{},[540,1939,1940],{"href":477},"Custom Drains"," — single-destination output",[568,1943,1944,1947],{},[540,1945,1946],{"href":468},"Tail Sampling"," — outcome-aware keep decisions",[568,1949,1950,1953],{},[540,1951,1952],{"href":472},"Identity Headers"," — tag every drain request",[1955,1956,1957],"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 .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 .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}",{"title":654,"searchDepth":691,"depth":691,"links":1959},[1960,1961,1962,1963,1964,1965],{"id":646,"depth":691,"text":647},{"id":1081,"depth":691,"text":1144},{"id":1303,"depth":691,"text":1304},{"id":1754,"depth":691,"text":1755},{"id":1865,"depth":691,"text":1866},{"id":1926,"depth":691,"text":1927},"definePlugin is the canonical extension point for evlog — opt into any subset of setup, onRequestStart, enrich, keep, drain, onRequestFinish, onClientLog, extendLogger from a single cohesive object.","md",[1969,1972,1973],{"label":1934,"icon":424,"to":464,"color":1970,"variant":1971},"neutral","subtle",{"label":1940,"icon":479,"to":477,"color":1970,"variant":1971},{"label":1946,"icon":64,"to":468,"color":1970,"variant":1971},{},{"title":459,"icon":438},{"title":459,"description":1966},"v2Aog_IXN8Fomm3EKL6yQ7ykeoavhqOV_WI_KJJ8MN8",[1979,1981],{"title":396,"path":455,"stem":456,"description":1980,"icon":457,"children":-1},"Concrete copy-paste recipes — build your own minimal devtool, pipe to curl + jq, replay history then go live, and aggregate on the consumer side.",{"title":463,"path":464,"stem":465,"description":1982,"icon":424,"children":-1},"Write custom enrichers to add derived context to your wide events. Add deployment metadata, tenant IDs, feature flags, geo, or any computed data — the toolkit handles error isolation, undefined skipping, and the merge step.",1785609682466]