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