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