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