[{"data":1,"prerenderedAt":3612},["ShallowReactive",2],{"navigation_docs":3,"-integrate-frameworks-express":534,"-integrate-frameworks-express-surround":3607},[4,30,80,128,308,440,499],{"title":5,"path":6,"stem":7,"children":8,"page":29},"Start","\u002Fstart","1.start",[9,14,19,24],{"title":10,"path":11,"stem":12,"icon":13},"Introduction","\u002Fstart\u002Fintroduction","1.start\u002F1.introduction","i-lucide-info",{"title":15,"path":16,"stem":17,"icon":18},"Why start with evlog","\u002Fstart\u002Fwhy-evlog","1.start\u002F2.why-evlog","i-lucide-rocket",{"title":20,"path":21,"stem":22,"icon":23},"Installation","\u002Fstart\u002Finstallation","1.start\u002F3.installation","i-lucide-download",{"title":25,"path":26,"stem":27,"icon":28},"Quick Start","\u002Fstart\u002Fquick-start","1.start\u002F4.quick-start","i-lucide-zap",false,{"title":31,"path":32,"stem":33,"children":34,"page":29},"Learn","\u002Flearn","2.learn",[35,40,45,50,55,60,65,70,75],{"title":36,"path":37,"stem":38,"icon":39},"Overview","\u002Flearn\u002Foverview","2.learn\u002F0.overview","i-lucide-list",{"title":41,"path":42,"stem":43,"icon":44},"Simple Logging","\u002Flearn\u002Fsimple-logging","2.learn\u002F1.simple-logging","i-lucide-terminal",{"title":46,"path":47,"stem":48,"icon":49},"Wide Events","\u002Flearn\u002Fwide-events","2.learn\u002F2.wide-events","i-lucide-layers",{"title":51,"path":52,"stem":53,"icon":54},"Structured Errors","\u002Flearn\u002Fstructured-errors","2.learn\u002F3.structured-errors","i-lucide-shield-alert",{"title":56,"path":57,"stem":58,"icon":59},"Lifecycle","\u002Flearn\u002Flifecycle","2.learn\u002F4.lifecycle","i-lucide-arrow-right-left",{"title":61,"path":62,"stem":63,"icon":64},"Sampling","\u002Flearn\u002Fsampling","2.learn\u002F5.sampling","i-lucide-filter",{"title":66,"path":67,"stem":68,"icon":69},"Auto-Redaction","\u002Flearn\u002Fredaction","2.learn\u002F6.redaction","i-lucide-eye-off",{"title":71,"path":72,"stem":73,"icon":74},"Typed Fields","\u002Flearn\u002Ftyped-fields","2.learn\u002F7.typed-fields","i-simple-icons-typescript",{"title":76,"path":77,"stem":78,"icon":79},"Catalogs","\u002Flearn\u002Fcatalogs","2.learn\u002F8.catalogs","i-lucide-book-open",{"title":81,"path":82,"stem":83,"children":84,"page":29},"CLI","\u002Fcli","3.cli",[85,88,93,98,103,108,113,118,123],{"title":36,"path":86,"stem":87,"icon":44},"\u002Fcli\u002Foverview","3.cli\u002F0.overview",{"title":89,"path":90,"stem":91,"icon":92},"init","\u002Fcli\u002Finit","3.cli\u002F1.init","i-lucide-wand-sparkles",{"title":94,"path":95,"stem":96,"icon":97},"map","\u002Fcli\u002Fmap","3.cli\u002F2.map","i-lucide-radar",{"title":99,"path":100,"stem":101,"icon":102},"Rules","\u002Fcli\u002Frules","3.cli\u002F3.rules","i-lucide-list-checks",{"title":104,"path":105,"stem":106,"icon":107},"Scoring","\u002Fcli\u002Fscoring","3.cli\u002F4.scoring","i-lucide-gauge",{"title":109,"path":110,"stem":111,"icon":112},"CI","\u002Fcli\u002Fci","3.cli\u002F5.ci","i-lucide-git-pull-request",{"title":114,"path":115,"stem":116,"icon":117},"doctor","\u002Fcli\u002Fdoctor","3.cli\u002F6.doctor","i-lucide-stethoscope",{"title":119,"path":120,"stem":121,"icon":122},"telemetry","\u002Fcli\u002Ftelemetry","3.cli\u002F7.telemetry","i-lucide-bar-chart-3",{"title":124,"path":125,"stem":126,"icon":127},"agents","\u002Fcli\u002Fagents","3.cli\u002F8.agents","i-lucide-bot",{"title":129,"path":130,"stem":131,"children":132,"page":29},"Integrate","\u002Fintegrate","4.integrate",[133,137,220],{"title":36,"path":134,"stem":135,"icon":136},"\u002Fintegrate\u002Foverview","4.integrate\u002F0.overview","i-lucide-plug",{"title":138,"path":139,"stem":140,"children":141,"page":29},"Adapters","\u002Fintegrate\u002Fadapters","4.integrate\u002Fadapters",[142,145,175,200],{"title":36,"path":143,"stem":144,"icon":39},"\u002Fintegrate\u002Fadapters\u002Foverview","4.integrate\u002Fadapters\u002F01.overview",{"title":146,"path":147,"stem":148,"children":149,"page":29},"Cloud","\u002Fintegrate\u002Fadapters\u002Fcloud","4.integrate\u002Fadapters\u002Fcloud",[150,155,160,165,170],{"title":151,"path":152,"stem":153,"icon":154},"Axiom","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Faxiom","4.integrate\u002Fadapters\u002Fcloud\u002F01.axiom","i-custom-axiom",{"title":156,"path":157,"stem":158,"icon":159},"PostHog","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fposthog","4.integrate\u002Fadapters\u002Fcloud\u002F02.posthog","i-simple-icons-posthog",{"title":161,"path":162,"stem":163,"icon":164},"Sentry","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fsentry","4.integrate\u002Fadapters\u002Fcloud\u002F03.sentry","i-simple-icons-sentry",{"title":166,"path":167,"stem":168,"icon":169},"Better Stack","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fbetter-stack","4.integrate\u002Fadapters\u002Fcloud\u002F04.better-stack","i-simple-icons-betterstack",{"title":171,"path":172,"stem":173,"icon":174},"Datadog","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fdatadog","4.integrate\u002Fadapters\u002Fcloud\u002F05.datadog","i-simple-icons-datadog",{"title":176,"path":177,"stem":178,"children":179,"page":29},"Cloud or Self-Hosted","\u002Fintegrate\u002Fadapters\u002Fhybrid","4.integrate\u002Fadapters\u002Fhybrid",[180,185,190,195],{"title":181,"path":182,"stem":183,"icon":184},"Grafana Loki","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Floki","4.integrate\u002Fadapters\u002Fhybrid\u002F01.loki","i-simple-icons-grafana",{"title":186,"path":187,"stem":188,"icon":189},"ClickHouse","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Fclickhouse","4.integrate\u002Fadapters\u002Fhybrid\u002F02.clickhouse","i-simple-icons-clickhouse",{"title":191,"path":192,"stem":193,"icon":194},"OTLP","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Fotlp","4.integrate\u002Fadapters\u002Fhybrid\u002F03.otlp","i-simple-icons-opentelemetry",{"title":196,"path":197,"stem":198,"icon":199},"HyperDX","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Fhyperdx","4.integrate\u002Fadapters\u002Fhybrid\u002F04.hyperdx","i-custom-hyperdx",{"title":201,"path":202,"stem":203,"children":204,"page":29},"Self-Hosted","\u002Fintegrate\u002Fadapters\u002Fself-hosted","4.integrate\u002Fadapters\u002Fself-hosted",[205,210,215],{"title":206,"path":207,"stem":208,"icon":209},"File System","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Ffs","4.integrate\u002Fadapters\u002Fself-hosted\u002F01.fs","i-lucide-hard-drive",{"title":211,"path":212,"stem":213,"icon":214},"NuxtHub","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Fnuxthub","4.integrate\u002Fadapters\u002Fself-hosted\u002F02.nuxthub","i-simple-icons-nuxt",{"title":216,"path":217,"stem":218,"icon":219},"Memory","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Fmemory","4.integrate\u002Fadapters\u002Fself-hosted\u002F03.memory","i-lucide-cpu",{"title":221,"path":222,"stem":223,"children":224,"page":29},"Frameworks","\u002Fintegrate\u002Fframeworks","4.integrate\u002Fframeworks",[225,229,234,239,244,249,254,259,264,269,274,279,284,289,293,298,303],{"title":36,"path":226,"stem":227,"icon":228},"\u002Fintegrate\u002Fframeworks\u002Foverview","4.integrate\u002Fframeworks\u002F00.overview","i-lucide-layout-grid",{"title":230,"path":231,"stem":232,"icon":233},"Nuxt","\u002Fintegrate\u002Fframeworks\u002Fnuxt","4.integrate\u002Fframeworks\u002F01.nuxt","i-simple-icons-nuxtdotjs",{"title":235,"path":236,"stem":237,"icon":238},"Next.js","\u002Fintegrate\u002Fframeworks\u002Fnextjs","4.integrate\u002Fframeworks\u002F02.nextjs","i-simple-icons-nextdotjs",{"title":240,"path":241,"stem":242,"icon":243},"SvelteKit","\u002Fintegrate\u002Fframeworks\u002Fsveltekit","4.integrate\u002Fframeworks\u002F03.sveltekit","i-simple-icons-svelte",{"title":245,"path":246,"stem":247,"icon":248},"Nitro","\u002Fintegrate\u002Fframeworks\u002Fnitro","4.integrate\u002Fframeworks\u002F04.nitro","i-custom-nitro",{"title":250,"path":251,"stem":252,"icon":253},"TanStack Start","\u002Fintegrate\u002Fframeworks\u002Ftanstack-start","4.integrate\u002Fframeworks\u002F05.tanstack-start","i-custom-tanstack",{"title":255,"path":256,"stem":257,"icon":258},"NestJS","\u002Fintegrate\u002Fframeworks\u002Fnestjs","4.integrate\u002Fframeworks\u002F06.nestjs","i-simple-icons-nestjs",{"title":260,"path":261,"stem":262,"icon":263},"Express","\u002Fintegrate\u002Fframeworks\u002Fexpress","4.integrate\u002Fframeworks\u002F07.express","i-simple-icons-express",{"title":265,"path":266,"stem":267,"icon":268},"Hono","\u002Fintegrate\u002Fframeworks\u002Fhono","4.integrate\u002Fframeworks\u002F08.hono","i-simple-icons-hono",{"title":270,"path":271,"stem":272,"icon":273},"Fastify","\u002Fintegrate\u002Fframeworks\u002Ffastify","4.integrate\u002Fframeworks\u002F09.fastify","i-simple-icons-fastify",{"title":275,"path":276,"stem":277,"icon":278},"Elysia","\u002Fintegrate\u002Fframeworks\u002Felysia","4.integrate\u002Fframeworks\u002F10.elysia","i-custom-elysia",{"title":280,"path":281,"stem":282,"icon":283},"React Router","\u002Fintegrate\u002Fframeworks\u002Freact-router","4.integrate\u002Fframeworks\u002F11.react-router","i-custom-reactrouter",{"title":285,"path":286,"stem":287,"icon":288},"Cloudflare Workers","\u002Fintegrate\u002Fframeworks\u002Fcloudflare-workers","4.integrate\u002Fframeworks\u002F12.cloudflare-workers","i-simple-icons-cloudflare",{"title":290,"path":291,"stem":292,"icon":74},"Standalone","\u002Fintegrate\u002Fframeworks\u002Fstandalone","4.integrate\u002Fframeworks\u002F13.standalone",{"title":294,"path":295,"stem":296,"icon":297},"Astro","\u002Fintegrate\u002Fframeworks\u002Fastro","4.integrate\u002Fframeworks\u002F14.astro","i-simple-icons-astro",{"title":299,"path":300,"stem":301,"icon":302},"oRPC","\u002Fintegrate\u002Fframeworks\u002Forpc","4.integrate\u002Fframeworks\u002F15.orpc","i-lucide-network",{"title":304,"path":305,"stem":306,"icon":307},"AWS Lambda","\u002Fintegrate\u002Fframeworks\u002Faws-lambda","4.integrate\u002Fframeworks\u002F16.aws-lambda","i-custom-lambda",{"title":309,"path":310,"stem":311,"children":312,"page":29},"Use Cases","\u002Fuse-cases","5.use-cases",[313,316,321,350,377,409,430,435],{"title":36,"path":314,"stem":315,"icon":102},"\u002Fuse-cases\u002Foverview","5.use-cases\u002F0.overview",{"title":317,"path":318,"stem":319,"icon":320},"Client Logging","\u002Fuse-cases\u002Fclient-logging","5.use-cases\u002F1.client-logging","i-lucide-monitor",{"title":322,"icon":323,"path":324,"stem":325,"children":326,"page":29},"AI SDK","i-simple-icons-vercel","\u002Fuse-cases\u002Fai-sdk","5.use-cases\u002F2.ai-sdk",[327,330,335,340,345],{"title":36,"path":328,"stem":329,"icon":39},"\u002Fuse-cases\u002Fai-sdk\u002Foverview","5.use-cases\u002F2.ai-sdk\u002F01.overview",{"title":331,"path":332,"stem":333,"icon":334},"Usage","\u002Fuse-cases\u002Fai-sdk\u002Fusage","5.use-cases\u002F2.ai-sdk\u002F02.usage","i-lucide-code",{"title":336,"path":337,"stem":338,"icon":339},"Options","\u002Fuse-cases\u002Fai-sdk\u002Foptions","5.use-cases\u002F2.ai-sdk\u002F03.options","i-lucide-sliders",{"title":341,"path":342,"stem":343,"icon":344},"Metadata","\u002Fuse-cases\u002Fai-sdk\u002Fmetadata","5.use-cases\u002F2.ai-sdk\u002F04.metadata","i-lucide-database",{"title":346,"path":347,"stem":348,"icon":349},"Telemetry","\u002Fuse-cases\u002Fai-sdk\u002Ftelemetry","5.use-cases\u002F2.ai-sdk\u002F05.telemetry","i-lucide-activity",{"title":351,"icon":352,"path":353,"stem":354,"children":355,"page":29},"Better Auth","i-simple-icons-betterauth","\u002Fuse-cases\u002Fbetter-auth","5.use-cases\u002F3.better-auth",[356,359,364,369,373],{"title":36,"path":357,"stem":358,"icon":39},"\u002Fuse-cases\u002Fbetter-auth\u002Foverview","5.use-cases\u002F3.better-auth\u002F01.overview",{"title":360,"path":361,"stem":362,"icon":363},"Identify User","\u002Fuse-cases\u002Fbetter-auth\u002Fidentify-user","5.use-cases\u002F3.better-auth\u002F02.identify-user","i-lucide-user-check",{"title":365,"path":366,"stem":367,"icon":368},"Middleware","\u002Fuse-cases\u002Fbetter-auth\u002Fmiddleware","5.use-cases\u002F3.better-auth\u002F03.middleware","i-lucide-shield",{"title":370,"path":371,"stem":372,"icon":320},"Client Sync","\u002Fuse-cases\u002Fbetter-auth\u002Fclient-sync","5.use-cases\u002F3.better-auth\u002F04.client-sync",{"title":374,"path":375,"stem":376,"icon":107},"Performance","\u002Fuse-cases\u002Fbetter-auth\u002Fperformance","5.use-cases\u002F3.better-auth\u002F05.performance",{"title":378,"icon":379,"path":380,"stem":381,"children":382,"page":29},"Audit Logs","i-lucide-shield-check","\u002Fuse-cases\u002Faudit","5.use-cases\u002F4.audit",[383,386,391,396,401,405],{"title":36,"path":384,"stem":385,"icon":39},"\u002Fuse-cases\u002Faudit\u002Foverview","5.use-cases\u002F4.audit\u002F01.overview",{"title":387,"path":388,"stem":389,"icon":390},"Schema","\u002Fuse-cases\u002Faudit\u002Fschema","5.use-cases\u002F4.audit\u002F02.schema","i-lucide-file-text",{"title":392,"path":393,"stem":394,"icon":395},"Recording","\u002Fuse-cases\u002Faudit\u002Frecording","5.use-cases\u002F4.audit\u002F03.recording","i-lucide-pen-line",{"title":397,"path":398,"stem":399,"icon":400},"Drains","\u002Fuse-cases\u002Faudit\u002Fpipeline","5.use-cases\u002F4.audit\u002F04.pipeline","i-lucide-link",{"title":402,"path":403,"stem":404,"icon":379},"Compliance","\u002Fuse-cases\u002Faudit\u002Fcompliance","5.use-cases\u002F4.audit\u002F05.compliance",{"title":406,"path":407,"stem":408,"icon":79},"Recipes","\u002Fuse-cases\u002Faudit\u002Frecipes","5.use-cases\u002F4.audit\u002F06.recipes",{"title":346,"icon":107,"path":410,"stem":411,"children":412,"page":29},"\u002Fuse-cases\u002Ftelemetry","5.use-cases\u002F4.telemetry",[413,416,421,426],{"title":36,"path":414,"stem":415,"icon":39},"\u002Fuse-cases\u002Ftelemetry\u002Foverview","5.use-cases\u002F4.telemetry\u002F01.overview",{"title":417,"path":418,"stem":419,"icon":420},"Setup","\u002Fuse-cases\u002Ftelemetry\u002Fsetup","5.use-cases\u002F4.telemetry\u002F02.setup","i-lucide-wrench",{"title":422,"path":423,"stem":424,"icon":425},"Ingest","\u002Fuse-cases\u002Ftelemetry\u002Fingest","5.use-cases\u002F4.telemetry\u002F03.ingest","i-lucide-server",{"title":427,"path":428,"stem":429,"icon":79},"Reference","\u002Fuse-cases\u002Ftelemetry\u002Freference","5.use-cases\u002F4.telemetry\u002F04.reference",{"title":431,"path":432,"stem":433,"icon":434},"Enrichers","\u002Fuse-cases\u002Fenrichers","5.use-cases\u002F5.enrichers","i-lucide-sparkles",{"title":436,"path":437,"stem":438,"icon":439},"eve","\u002Fuse-cases\u002Feve","5.use-cases\u002F5.eve","i-custom-eve",{"title":441,"path":442,"stem":443,"children":444,"page":29},"Extend","\u002Fextend","6.extend",[445,449,454,459,463,468,472,476,480,484,489,494],{"title":36,"path":446,"stem":447,"icon":448},"\u002Fextend\u002Foverview","6.extend\u002F0.overview","i-lucide-blocks",{"title":450,"path":451,"stem":452,"icon":453},"Stream","\u002Fextend\u002Fstream","6.extend\u002F1.stream","i-lucide-radio-tower",{"title":455,"path":456,"stem":457,"icon":458},"Custom framework","\u002Fextend\u002Fcustom-framework","6.extend\u002F10.custom-framework","i-lucide-puzzle",{"title":460,"path":461,"stem":462,"icon":453},"Diagnostics channel","\u002Fextend\u002Fdiagnostics-channel","6.extend\u002F11.diagnostics-channel",{"title":464,"path":465,"stem":466,"icon":467},"FS reader","\u002Fextend\u002Ffs-reader","6.extend\u002F2.fs-reader","i-lucide-folder-search",{"title":406,"path":469,"stem":470,"icon":471},"\u002Fextend\u002Fconsumer-recipes","6.extend\u002F3.consumer-recipes","i-lucide-chef-hat",{"title":473,"path":474,"stem":475,"icon":448},"Plugins","\u002Fextend\u002Fplugins","6.extend\u002F4.plugins",{"title":477,"path":478,"stem":479,"icon":434},"Custom enrichers","\u002Fextend\u002Fcustom-enrichers","6.extend\u002F5.custom-enrichers",{"title":481,"path":482,"stem":483,"icon":64},"Tail sampling","\u002Fextend\u002Ftail-sampling","6.extend\u002F6.tail-sampling",{"title":485,"path":486,"stem":487,"icon":488},"Identity headers","\u002Fextend\u002Fidentity-headers","6.extend\u002F7.identity-headers","i-lucide-fingerprint",{"title":490,"path":491,"stem":492,"icon":493},"Custom drains","\u002Fextend\u002Fcustom-drains","6.extend\u002F8.custom-drains","i-lucide-share-2",{"title":495,"path":496,"stem":497,"icon":498},"Drain pipeline","\u002Fextend\u002Fdrain-pipeline","6.extend\u002F9.drain-pipeline","i-lucide-workflow",{"title":427,"path":500,"stem":501,"children":502,"page":29},"\u002Freference","7.reference",[503,508,511,516,520,525,529],{"title":504,"path":505,"stem":506,"icon":507},"Configuration","\u002Freference\u002Fconfiguration","7.reference\u002F1.configuration","i-lucide-settings",{"title":374,"path":509,"stem":510,"icon":107},"\u002Freference\u002Fperformance","7.reference\u002F2.performance",{"title":512,"path":513,"stem":514,"icon":515},"Vite Plugin","\u002Freference\u002Fvite-plugin","7.reference\u002F3.vite-plugin","i-custom-vite",{"title":517,"path":518,"stem":519,"icon":379},"Best Practices","\u002Freference\u002Fbest-practices","7.reference\u002F4.best-practices",{"title":521,"path":522,"stem":523,"icon":524},"vs Other Loggers","\u002Freference\u002Fvs-other-loggers","7.reference\u002F5.vs-other-loggers","i-lucide-scale",{"title":526,"path":527,"stem":528,"icon":434},"Agent Skills","\u002Freference\u002Fagent-skills","7.reference\u002F6.agent-skills",{"title":530,"path":531,"stem":532,"icon":533},"Cost","\u002Freference\u002Fcost","7.reference\u002F7.cost","i-lucide-receipt",{"id":535,"title":260,"body":536,"description":3598,"extension":3599,"links":3600,"meta":3603,"navigation":3604,"path":261,"seo":3605,"stem":262,"__hash__":3606},"docs\u002F4.integrate\u002Fframeworks\u002F07.express.md",{"type":537,"value":538,"toc":3575},"minimark",[539,552,599,603,608,688,692,1014,1038,1044,1047,1050,1357,1360,1424,1428,1437,1622,1731,1747,1754,1790,2018,2022,2040,2378,2381,2428,2431,2441,2445,2448,2615,2619,2626,2818,2829,2833,2839,2943,2947,2957,3100,3104,3110,3114,3268,3272,3279,3459,3469,3473,3514,3522,3532,3536,3542,3571],[540,541,542,543,547,548,551],"p",{},"The ",[544,545,546],"code",{},"evlog\u002Fexpress"," middleware auto-creates a request-scoped logger on ",[544,549,550],{},"req.log"," and emits a wide event when the response finishes.",[553,554,557,560,585],"prompt",{":actions":555,"description":556,"icon":263},"[\"copy\",\"cursor\",\"claude\"]","Set up evlog in my Express app",[540,558,559],{},"Set up evlog in my Express app.",[561,562,563,567,570,573,576,579,582],"ul",{},[564,565,566],"li",{},"Install evlog: pnpm add evlog",[564,568,569],{},"Call initLogger({ env: { service: 'my-api' } }) at startup",[564,571,572],{},"Alternatively, use evlog\u002Fvite plugin in vite.config.ts for auto-init (replaces initLogger)",[564,574,575],{},"Import evlog middleware from 'evlog\u002Fexpress' and add app.use(evlog())",[564,577,578],{},"Access the logger via req.log in routes or useLogger() anywhere in the call stack",[564,580,581],{},"Use log.set() to accumulate context, throw createError() for structured errors",[564,583,584],{},"Optionally pass drain, enrich, include, and keep options to evlog()",[540,586,587,588,594,595],{},"Docs: ",[589,590,591],"a",{"href":591,"rel":592},"https:\u002F\u002Fwww.evlog.dev\u002Fintegrate\u002Fframeworks\u002Fexpress",[593],"nofollow","\nAdapters: ",[589,596,597],{"href":597,"rel":598},"https:\u002F\u002Fwww.evlog.dev\u002Fintegrate\u002Fadapters\u002Foverview",[593],[600,601,25],"h2",{"id":602},"quick-start",[604,605,607],"h3",{"id":606},"_1-install","1. Install",[609,610,611,639,655,671],"code-group",{},[612,613,619],"pre",{"className":614,"code":615,"filename":616,"language":617,"meta":618,"style":618},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","pnpm add evlog express\n","pnpm","bash","",[544,620,621],{"__ignoreMap":618},[622,623,626,629,633,636],"span",{"class":624,"line":625},"line",1,[622,627,616],{"class":628},"sBMFI",[622,630,632],{"class":631},"sfazB"," add",[622,634,635],{"class":631}," evlog",[622,637,638],{"class":631}," express\n",[612,640,643],{"className":614,"code":641,"filename":642,"language":617,"meta":618,"style":618},"bun add evlog express\n","bun",[544,644,645],{"__ignoreMap":618},[622,646,647,649,651,653],{"class":624,"line":625},[622,648,642],{"class":628},[622,650,632],{"class":631},[622,652,635],{"class":631},[622,654,638],{"class":631},[612,656,659],{"className":614,"code":657,"filename":658,"language":617,"meta":618,"style":618},"yarn add evlog express\n","yarn",[544,660,661],{"__ignoreMap":618},[622,662,663,665,667,669],{"class":624,"line":625},[622,664,658],{"class":628},[622,666,632],{"class":631},[622,668,635],{"class":631},[622,670,638],{"class":631},[612,672,675],{"className":614,"code":673,"filename":674,"language":617,"meta":618,"style":618},"npm install evlog express\n","npm",[544,676,677],{"__ignoreMap":618},[622,678,679,681,684,686],{"class":624,"line":625},[622,680,674],{"class":628},[622,682,683],{"class":631}," install",[622,685,635],{"class":631},[622,687,638],{"class":631},[604,689,691],{"id":690},"_2-initialize-and-register-the-middleware","2. Initialize and register the middleware",[612,693,698],{"className":694,"code":695,"filename":696,"language":697,"meta":618,"style":618},"language-typescript shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import express from 'express'\nimport { initLogger } from 'evlog'\nimport { evlog } from 'evlog\u002Fexpress'\n\ninitLogger({\n  env: { service: 'my-api' },\n})\n\nconst app = express()\n\napp.use(evlog())\n\napp.get('\u002Fhealth', (req, res) => {\n  req.log.set({ route: 'health' })\n  res.json({ ok: true })\n})\n\napp.listen(3000)\n","src\u002Findex.ts","typescript",[544,699,700,723,747,766,773,786,814,823,828,847,852,871,876,919,956,984,991,996],{"__ignoreMap":618},[622,701,702,706,710,713,717,720],{"class":624,"line":625},[622,703,705],{"class":704},"s7zQu","import",[622,707,709],{"class":708},"sTEyZ"," express ",[622,711,712],{"class":704},"from",[622,714,716],{"class":715},"sMK4o"," '",[622,718,719],{"class":631},"express",[622,721,722],{"class":715},"'\n",[622,724,726,728,731,734,737,740,742,745],{"class":624,"line":725},2,[622,727,705],{"class":704},[622,729,730],{"class":715}," {",[622,732,733],{"class":708}," initLogger",[622,735,736],{"class":715}," }",[622,738,739],{"class":704}," from",[622,741,716],{"class":715},[622,743,744],{"class":631},"evlog",[622,746,722],{"class":715},[622,748,750,752,754,756,758,760,762,764],{"class":624,"line":749},3,[622,751,705],{"class":704},[622,753,730],{"class":715},[622,755,635],{"class":708},[622,757,736],{"class":715},[622,759,739],{"class":704},[622,761,716],{"class":715},[622,763,546],{"class":631},[622,765,722],{"class":715},[622,767,769],{"class":624,"line":768},4,[622,770,772],{"emptyLinePlaceholder":771},true,"\n",[622,774,776,780,783],{"class":624,"line":775},5,[622,777,779],{"class":778},"s2Zo4","initLogger",[622,781,782],{"class":708},"(",[622,784,785],{"class":715},"{\n",[622,787,789,793,796,798,801,803,805,808,811],{"class":624,"line":788},6,[622,790,792],{"class":791},"swJcz","  env",[622,794,795],{"class":715},":",[622,797,730],{"class":715},[622,799,800],{"class":791}," service",[622,802,795],{"class":715},[622,804,716],{"class":715},[622,806,807],{"class":631},"my-api",[622,809,810],{"class":715},"'",[622,812,813],{"class":715}," },\n",[622,815,817,820],{"class":624,"line":816},7,[622,818,819],{"class":715},"}",[622,821,822],{"class":708},")\n",[622,824,826],{"class":624,"line":825},8,[622,827,772],{"emptyLinePlaceholder":771},[622,829,831,835,838,841,844],{"class":624,"line":830},9,[622,832,834],{"class":833},"spNyl","const",[622,836,837],{"class":708}," app ",[622,839,840],{"class":715},"=",[622,842,843],{"class":778}," express",[622,845,846],{"class":708},"()\n",[622,848,850],{"class":624,"line":849},10,[622,851,772],{"emptyLinePlaceholder":771},[622,853,855,858,861,864,866,868],{"class":624,"line":854},11,[622,856,857],{"class":708},"app",[622,859,860],{"class":715},".",[622,862,863],{"class":778},"use",[622,865,782],{"class":708},[622,867,744],{"class":778},[622,869,870],{"class":708},"())\n",[622,872,874],{"class":624,"line":873},12,[622,875,772],{"emptyLinePlaceholder":771},[622,877,879,881,883,886,888,890,893,895,898,901,905,907,910,913,916],{"class":624,"line":878},13,[622,880,857],{"class":708},[622,882,860],{"class":715},[622,884,885],{"class":778},"get",[622,887,782],{"class":708},[622,889,810],{"class":715},[622,891,892],{"class":631},"\u002Fhealth",[622,894,810],{"class":715},[622,896,897],{"class":715},",",[622,899,900],{"class":715}," (",[622,902,904],{"class":903},"sHdIc","req",[622,906,897],{"class":715},[622,908,909],{"class":903}," res",[622,911,912],{"class":715},")",[622,914,915],{"class":833}," =>",[622,917,918],{"class":715}," {\n",[622,920,922,925,927,930,932,935,937,940,943,945,947,950,952,954],{"class":624,"line":921},14,[622,923,924],{"class":708},"  req",[622,926,860],{"class":715},[622,928,929],{"class":708},"log",[622,931,860],{"class":715},[622,933,934],{"class":778},"set",[622,936,782],{"class":791},[622,938,939],{"class":715},"{",[622,941,942],{"class":791}," route",[622,944,795],{"class":715},[622,946,716],{"class":715},[622,948,949],{"class":631},"health",[622,951,810],{"class":715},[622,953,736],{"class":715},[622,955,822],{"class":791},[622,957,959,962,964,967,969,971,974,976,980,982],{"class":624,"line":958},15,[622,960,961],{"class":708},"  res",[622,963,860],{"class":715},[622,965,966],{"class":778},"json",[622,968,782],{"class":791},[622,970,939],{"class":715},[622,972,973],{"class":791}," ok",[622,975,795],{"class":715},[622,977,979],{"class":978},"sfNiH"," true",[622,981,736],{"class":715},[622,983,822],{"class":791},[622,985,987,989],{"class":624,"line":986},16,[622,988,819],{"class":715},[622,990,822],{"class":708},[622,992,994],{"class":624,"line":993},17,[622,995,772],{"emptyLinePlaceholder":771},[622,997,999,1001,1003,1006,1008,1012],{"class":624,"line":998},18,[622,1000,857],{"class":708},[622,1002,860],{"class":715},[622,1004,1005],{"class":778},"listen",[622,1007,782],{"class":708},[622,1009,1011],{"class":1010},"sbssI","3000",[622,1013,822],{"class":708},[1015,1016,1018,1022,1023,1029,1030,1033,1034,1037],"callout",{"color":1017,"icon":515},"info",[1019,1020,1021],"strong",{},"Using Vite?"," The ",[589,1024,1025,1028],{"href":513},[544,1026,1027],{},"evlog\u002Fvite"," plugin"," replaces the ",[544,1031,1032],{},"initLogger()"," call with compile-time auto-initialization, strips ",[544,1035,1036],{},"log.debug()"," from production builds, and injects source locations.",[540,1039,1040,1041,1043],{},"The logger is available on ",[544,1042,550],{}," with full TypeScript support via module augmentation, so no extra type annotations are needed.",[600,1045,46],{"id":1046},"wide-events",[540,1048,1049],{},"Build up context progressively through your handler. One request = one wide event:",[612,1051,1053],{"className":694,"code":1052,"filename":696,"language":697,"meta":618,"style":618},"app.get('\u002Fusers\u002F:id', async (req, res) => {\n  const userId = req.params.id\n\n  req.log.set({ user: { id: userId } })\n\n  const user = await db.findUser(userId)\n  req.log.set({ user: { name: user.name, plan: user.plan } })\n\n  const orders = await db.findOrders(userId)\n  req.log.set({ orders: { count: orders.length, totalRevenue: sum(orders) } })\n\n  res.json({ user, orders })\n})\n",[544,1054,1055,1091,1115,1119,1155,1159,1185,1239,1243,1267,1325,1329,1351],{"__ignoreMap":618},[622,1056,1057,1059,1061,1063,1065,1067,1070,1072,1074,1077,1079,1081,1083,1085,1087,1089],{"class":624,"line":625},[622,1058,857],{"class":708},[622,1060,860],{"class":715},[622,1062,885],{"class":778},[622,1064,782],{"class":708},[622,1066,810],{"class":715},[622,1068,1069],{"class":631},"\u002Fusers\u002F:id",[622,1071,810],{"class":715},[622,1073,897],{"class":715},[622,1075,1076],{"class":833}," async",[622,1078,900],{"class":715},[622,1080,904],{"class":903},[622,1082,897],{"class":715},[622,1084,909],{"class":903},[622,1086,912],{"class":715},[622,1088,915],{"class":833},[622,1090,918],{"class":715},[622,1092,1093,1096,1099,1102,1105,1107,1110,1112],{"class":624,"line":725},[622,1094,1095],{"class":833},"  const",[622,1097,1098],{"class":708}," userId",[622,1100,1101],{"class":715}," =",[622,1103,1104],{"class":708}," req",[622,1106,860],{"class":715},[622,1108,1109],{"class":708},"params",[622,1111,860],{"class":715},[622,1113,1114],{"class":708},"id\n",[622,1116,1117],{"class":624,"line":749},[622,1118,772],{"emptyLinePlaceholder":771},[622,1120,1121,1123,1125,1127,1129,1131,1133,1135,1138,1140,1142,1145,1147,1149,1151,1153],{"class":624,"line":768},[622,1122,924],{"class":708},[622,1124,860],{"class":715},[622,1126,929],{"class":708},[622,1128,860],{"class":715},[622,1130,934],{"class":778},[622,1132,782],{"class":791},[622,1134,939],{"class":715},[622,1136,1137],{"class":791}," user",[622,1139,795],{"class":715},[622,1141,730],{"class":715},[622,1143,1144],{"class":791}," id",[622,1146,795],{"class":715},[622,1148,1098],{"class":708},[622,1150,736],{"class":715},[622,1152,736],{"class":715},[622,1154,822],{"class":791},[622,1156,1157],{"class":624,"line":775},[622,1158,772],{"emptyLinePlaceholder":771},[622,1160,1161,1163,1165,1167,1170,1173,1175,1178,1180,1183],{"class":624,"line":788},[622,1162,1095],{"class":833},[622,1164,1137],{"class":708},[622,1166,1101],{"class":715},[622,1168,1169],{"class":704}," await",[622,1171,1172],{"class":708}," db",[622,1174,860],{"class":715},[622,1176,1177],{"class":778},"findUser",[622,1179,782],{"class":791},[622,1181,1182],{"class":708},"userId",[622,1184,822],{"class":791},[622,1186,1187,1189,1191,1193,1195,1197,1199,1201,1203,1205,1207,1210,1212,1214,1216,1219,1221,1224,1226,1228,1230,1233,1235,1237],{"class":624,"line":816},[622,1188,924],{"class":708},[622,1190,860],{"class":715},[622,1192,929],{"class":708},[622,1194,860],{"class":715},[622,1196,934],{"class":778},[622,1198,782],{"class":791},[622,1200,939],{"class":715},[622,1202,1137],{"class":791},[622,1204,795],{"class":715},[622,1206,730],{"class":715},[622,1208,1209],{"class":791}," name",[622,1211,795],{"class":715},[622,1213,1137],{"class":708},[622,1215,860],{"class":715},[622,1217,1218],{"class":708},"name",[622,1220,897],{"class":715},[622,1222,1223],{"class":791}," plan",[622,1225,795],{"class":715},[622,1227,1137],{"class":708},[622,1229,860],{"class":715},[622,1231,1232],{"class":708},"plan",[622,1234,736],{"class":715},[622,1236,736],{"class":715},[622,1238,822],{"class":791},[622,1240,1241],{"class":624,"line":825},[622,1242,772],{"emptyLinePlaceholder":771},[622,1244,1245,1247,1250,1252,1254,1256,1258,1261,1263,1265],{"class":624,"line":830},[622,1246,1095],{"class":833},[622,1248,1249],{"class":708}," orders",[622,1251,1101],{"class":715},[622,1253,1169],{"class":704},[622,1255,1172],{"class":708},[622,1257,860],{"class":715},[622,1259,1260],{"class":778},"findOrders",[622,1262,782],{"class":791},[622,1264,1182],{"class":708},[622,1266,822],{"class":791},[622,1268,1269,1271,1273,1275,1277,1279,1281,1283,1285,1287,1289,1292,1294,1296,1298,1301,1303,1306,1308,1311,1313,1316,1319,1321,1323],{"class":624,"line":849},[622,1270,924],{"class":708},[622,1272,860],{"class":715},[622,1274,929],{"class":708},[622,1276,860],{"class":715},[622,1278,934],{"class":778},[622,1280,782],{"class":791},[622,1282,939],{"class":715},[622,1284,1249],{"class":791},[622,1286,795],{"class":715},[622,1288,730],{"class":715},[622,1290,1291],{"class":791}," count",[622,1293,795],{"class":715},[622,1295,1249],{"class":708},[622,1297,860],{"class":715},[622,1299,1300],{"class":708},"length",[622,1302,897],{"class":715},[622,1304,1305],{"class":791}," totalRevenue",[622,1307,795],{"class":715},[622,1309,1310],{"class":778}," sum",[622,1312,782],{"class":791},[622,1314,1315],{"class":708},"orders",[622,1317,1318],{"class":791},") ",[622,1320,819],{"class":715},[622,1322,736],{"class":715},[622,1324,822],{"class":791},[622,1326,1327],{"class":624,"line":854},[622,1328,772],{"emptyLinePlaceholder":771},[622,1330,1331,1333,1335,1337,1339,1341,1343,1345,1347,1349],{"class":624,"line":873},[622,1332,961],{"class":708},[622,1334,860],{"class":715},[622,1336,966],{"class":778},[622,1338,782],{"class":791},[622,1340,939],{"class":715},[622,1342,1137],{"class":708},[622,1344,897],{"class":715},[622,1346,1249],{"class":708},[622,1348,736],{"class":715},[622,1350,822],{"class":791},[622,1352,1353,1355],{"class":624,"line":878},[622,1354,819],{"class":715},[622,1356,822],{"class":708},[540,1358,1359],{},"All fields are merged into a single wide event emitted when the response finishes:",[612,1361,1364],{"className":614,"code":1362,"filename":1363,"language":617,"meta":618,"style":618},"14:58:15 INFO [my-api] GET \u002Fusers\u002Fusr_123 200 in 12ms\n  ├─ orders: count=2 totalRevenue=6298\n  ├─ user: id=usr_123 name=Alice plan=pro\n  └─ requestId: 4a8ff3a8-...\n","Terminal output",[544,1365,1366,1377,1397,1413],{"__ignoreMap":618},[622,1367,1368,1371,1374],{"class":624,"line":625},[622,1369,1370],{"class":628},"14:58:15",[622,1372,1373],{"class":631}," INFO",[622,1375,1376],{"class":708}," [my-api] GET \u002Fusers\u002Fusr_123 200 in 12ms\n",[622,1378,1379,1382,1385,1388,1391,1394],{"class":624,"line":725},[622,1380,1381],{"class":628},"  ├─",[622,1383,1384],{"class":631}," orders:",[622,1386,1387],{"class":631}," count=",[622,1389,1390],{"class":1010},"2",[622,1392,1393],{"class":631}," totalRevenue=",[622,1395,1396],{"class":1010},"6298\n",[622,1398,1399,1401,1404,1407,1410],{"class":624,"line":749},[622,1400,1381],{"class":628},[622,1402,1403],{"class":631}," user:",[622,1405,1406],{"class":631}," id=usr_123",[622,1408,1409],{"class":631}," name=Alice",[622,1411,1412],{"class":631}," plan=pro\n",[622,1414,1415,1418,1421],{"class":624,"line":768},[622,1416,1417],{"class":628},"  └─",[622,1419,1420],{"class":631}," requestId:",[622,1422,1423],{"class":631}," 4a8ff3a8-...\n",[600,1425,1427],{"id":1426},"uselogger","useLogger()",[540,1429,1430,1431,1433,1434,1436],{},"Use ",[544,1432,1427],{}," to access the request-scoped logger from anywhere in the call stack without passing ",[544,1435,904],{}," through your service layer:",[612,1438,1441],{"className":694,"code":1439,"filename":1440,"language":697,"meta":618,"style":618},"import { useLogger } from 'evlog\u002Fexpress'\n\nexport async function findUser(id: string) {\n  const log = useLogger()\n  log.set({ user: { id } })\n\n  const user = await db.findUser(id)\n  log.set({ user: { name: user.name, plan: user.plan } })\n\n  return user\n}\n","src\u002Fservices\u002Fuser.ts",[544,1442,1443,1462,1466,1493,1506,1533,1537,1559,1605,1609,1617],{"__ignoreMap":618},[622,1444,1445,1447,1449,1452,1454,1456,1458,1460],{"class":624,"line":625},[622,1446,705],{"class":704},[622,1448,730],{"class":715},[622,1450,1451],{"class":708}," useLogger",[622,1453,736],{"class":715},[622,1455,739],{"class":704},[622,1457,716],{"class":715},[622,1459,546],{"class":631},[622,1461,722],{"class":715},[622,1463,1464],{"class":624,"line":725},[622,1465,772],{"emptyLinePlaceholder":771},[622,1467,1468,1471,1473,1476,1479,1481,1484,1486,1489,1491],{"class":624,"line":749},[622,1469,1470],{"class":704},"export",[622,1472,1076],{"class":833},[622,1474,1475],{"class":833}," function",[622,1477,1478],{"class":778}," findUser",[622,1480,782],{"class":715},[622,1482,1483],{"class":903},"id",[622,1485,795],{"class":715},[622,1487,1488],{"class":628}," string",[622,1490,912],{"class":715},[622,1492,918],{"class":715},[622,1494,1495,1497,1500,1502,1504],{"class":624,"line":768},[622,1496,1095],{"class":833},[622,1498,1499],{"class":708}," log",[622,1501,1101],{"class":715},[622,1503,1451],{"class":778},[622,1505,846],{"class":791},[622,1507,1508,1511,1513,1515,1517,1519,1521,1523,1525,1527,1529,1531],{"class":624,"line":775},[622,1509,1510],{"class":708},"  log",[622,1512,860],{"class":715},[622,1514,934],{"class":778},[622,1516,782],{"class":791},[622,1518,939],{"class":715},[622,1520,1137],{"class":791},[622,1522,795],{"class":715},[622,1524,730],{"class":715},[622,1526,1144],{"class":708},[622,1528,736],{"class":715},[622,1530,736],{"class":715},[622,1532,822],{"class":791},[622,1534,1535],{"class":624,"line":788},[622,1536,772],{"emptyLinePlaceholder":771},[622,1538,1539,1541,1543,1545,1547,1549,1551,1553,1555,1557],{"class":624,"line":816},[622,1540,1095],{"class":833},[622,1542,1137],{"class":708},[622,1544,1101],{"class":715},[622,1546,1169],{"class":704},[622,1548,1172],{"class":708},[622,1550,860],{"class":715},[622,1552,1177],{"class":778},[622,1554,782],{"class":791},[622,1556,1483],{"class":708},[622,1558,822],{"class":791},[622,1560,1561,1563,1565,1567,1569,1571,1573,1575,1577,1579,1581,1583,1585,1587,1589,1591,1593,1595,1597,1599,1601,1603],{"class":624,"line":825},[622,1562,1510],{"class":708},[622,1564,860],{"class":715},[622,1566,934],{"class":778},[622,1568,782],{"class":791},[622,1570,939],{"class":715},[622,1572,1137],{"class":791},[622,1574,795],{"class":715},[622,1576,730],{"class":715},[622,1578,1209],{"class":791},[622,1580,795],{"class":715},[622,1582,1137],{"class":708},[622,1584,860],{"class":715},[622,1586,1218],{"class":708},[622,1588,897],{"class":715},[622,1590,1223],{"class":791},[622,1592,795],{"class":715},[622,1594,1137],{"class":708},[622,1596,860],{"class":715},[622,1598,1232],{"class":708},[622,1600,736],{"class":715},[622,1602,736],{"class":715},[622,1604,822],{"class":791},[622,1606,1607],{"class":624,"line":830},[622,1608,772],{"emptyLinePlaceholder":771},[622,1610,1611,1614],{"class":624,"line":849},[622,1612,1613],{"class":704},"  return",[622,1615,1616],{"class":708}," user\n",[622,1618,1619],{"class":624,"line":854},[622,1620,1621],{"class":715},"}\n",[612,1623,1625],{"className":694,"code":1624,"filename":696,"language":697,"meta":618,"style":618},"import { findUser } from '.\u002Fservices\u002Fuser'\n\napp.get('\u002Fusers\u002F:id', async (req, res) => {\n  const user = await findUser(req.params.id)\n  res.json(user)\n})\n",[544,1626,1627,1646,1650,1684,1710,1725],{"__ignoreMap":618},[622,1628,1629,1631,1633,1635,1637,1639,1641,1644],{"class":624,"line":625},[622,1630,705],{"class":704},[622,1632,730],{"class":715},[622,1634,1478],{"class":708},[622,1636,736],{"class":715},[622,1638,739],{"class":704},[622,1640,716],{"class":715},[622,1642,1643],{"class":631},".\u002Fservices\u002Fuser",[622,1645,722],{"class":715},[622,1647,1648],{"class":624,"line":725},[622,1649,772],{"emptyLinePlaceholder":771},[622,1651,1652,1654,1656,1658,1660,1662,1664,1666,1668,1670,1672,1674,1676,1678,1680,1682],{"class":624,"line":749},[622,1653,857],{"class":708},[622,1655,860],{"class":715},[622,1657,885],{"class":778},[622,1659,782],{"class":708},[622,1661,810],{"class":715},[622,1663,1069],{"class":631},[622,1665,810],{"class":715},[622,1667,897],{"class":715},[622,1669,1076],{"class":833},[622,1671,900],{"class":715},[622,1673,904],{"class":903},[622,1675,897],{"class":715},[622,1677,909],{"class":903},[622,1679,912],{"class":715},[622,1681,915],{"class":833},[622,1683,918],{"class":715},[622,1685,1686,1688,1690,1692,1694,1696,1698,1700,1702,1704,1706,1708],{"class":624,"line":768},[622,1687,1095],{"class":833},[622,1689,1137],{"class":708},[622,1691,1101],{"class":715},[622,1693,1169],{"class":704},[622,1695,1478],{"class":778},[622,1697,782],{"class":791},[622,1699,904],{"class":708},[622,1701,860],{"class":715},[622,1703,1109],{"class":708},[622,1705,860],{"class":715},[622,1707,1483],{"class":708},[622,1709,822],{"class":791},[622,1711,1712,1714,1716,1718,1720,1723],{"class":624,"line":775},[622,1713,961],{"class":708},[622,1715,860],{"class":715},[622,1717,966],{"class":778},[622,1719,782],{"class":791},[622,1721,1722],{"class":708},"user",[622,1724,822],{"class":791},[622,1726,1727,1729],{"class":624,"line":788},[622,1728,819],{"class":715},[622,1730,822],{"class":708},[540,1732,1733,1734,1736,1737,1739,1740,1742,1743,1746],{},"Both ",[544,1735,550],{}," and ",[544,1738,1427],{}," return the same logger instance. ",[544,1741,1427],{}," uses ",[544,1744,1745],{},"AsyncLocalStorage"," to propagate the logger across async boundaries.",[600,1748,1750,1751,912],{"id":1749},"background-work-logfork","Background work (",[544,1752,1753],{},"log.fork",[540,1755,1756,1757,1760,1761,1766,1767,1769,1770,1773,1774,1777,1778,1736,1781,1784,1785,1789],{},"Fire-and-forget async work that finishes ",[1019,1758,1759],{},"after"," the response can no longer update the request wide event (the logger is sealed after emit). Use ",[1019,1762,1763],{},[544,1764,1765],{},"req.log.fork(label, fn)"," so ",[544,1768,1427],{}," inside ",[544,1771,1772],{},"fn"," targets a ",[1019,1775,1776],{},"child"," logger that emits its own event with ",[544,1779,1780],{},"operation",[544,1782,1783],{},"_parentRequestId",". See ",[589,1786,1788],{"href":1787},"\u002Flearn\u002Fwide-events#after-emit-sealing-and-background-work","After emit"," in Wide events.",[612,1791,1793],{"className":694,"code":1792,"filename":696,"language":697,"meta":618,"style":618},"import { evlog, useLogger } from 'evlog\u002Fexpress'\n\napp.use(evlog())\n\napp.post('\u002Forders', (req, res) => {\n  req.log.set({ orderId: 'ord_1' })\n  req.log.fork!('fulfill_order', async () => {\n    const log = useLogger()\n    log.set({ step: 'inventory_ok' })\n  })\n  res.json({ ok: true })\n})\n",[544,1794,1795,1817,1821,1835,1839,1873,1905,1941,1954,1983,1990,2012],{"__ignoreMap":618},[622,1796,1797,1799,1801,1803,1805,1807,1809,1811,1813,1815],{"class":624,"line":625},[622,1798,705],{"class":704},[622,1800,730],{"class":715},[622,1802,635],{"class":708},[622,1804,897],{"class":715},[622,1806,1451],{"class":708},[622,1808,736],{"class":715},[622,1810,739],{"class":704},[622,1812,716],{"class":715},[622,1814,546],{"class":631},[622,1816,722],{"class":715},[622,1818,1819],{"class":624,"line":725},[622,1820,772],{"emptyLinePlaceholder":771},[622,1822,1823,1825,1827,1829,1831,1833],{"class":624,"line":749},[622,1824,857],{"class":708},[622,1826,860],{"class":715},[622,1828,863],{"class":778},[622,1830,782],{"class":708},[622,1832,744],{"class":778},[622,1834,870],{"class":708},[622,1836,1837],{"class":624,"line":768},[622,1838,772],{"emptyLinePlaceholder":771},[622,1840,1841,1843,1845,1848,1850,1852,1855,1857,1859,1861,1863,1865,1867,1869,1871],{"class":624,"line":775},[622,1842,857],{"class":708},[622,1844,860],{"class":715},[622,1846,1847],{"class":778},"post",[622,1849,782],{"class":708},[622,1851,810],{"class":715},[622,1853,1854],{"class":631},"\u002Forders",[622,1856,810],{"class":715},[622,1858,897],{"class":715},[622,1860,900],{"class":715},[622,1862,904],{"class":903},[622,1864,897],{"class":715},[622,1866,909],{"class":903},[622,1868,912],{"class":715},[622,1870,915],{"class":833},[622,1872,918],{"class":715},[622,1874,1875,1877,1879,1881,1883,1885,1887,1889,1892,1894,1896,1899,1901,1903],{"class":624,"line":788},[622,1876,924],{"class":708},[622,1878,860],{"class":715},[622,1880,929],{"class":708},[622,1882,860],{"class":715},[622,1884,934],{"class":778},[622,1886,782],{"class":791},[622,1888,939],{"class":715},[622,1890,1891],{"class":791}," orderId",[622,1893,795],{"class":715},[622,1895,716],{"class":715},[622,1897,1898],{"class":631},"ord_1",[622,1900,810],{"class":715},[622,1902,736],{"class":715},[622,1904,822],{"class":791},[622,1906,1907,1909,1911,1913,1915,1918,1921,1923,1925,1928,1930,1932,1934,1937,1939],{"class":624,"line":816},[622,1908,924],{"class":708},[622,1910,860],{"class":715},[622,1912,929],{"class":708},[622,1914,860],{"class":715},[622,1916,1917],{"class":778},"fork",[622,1919,1920],{"class":715},"!",[622,1922,782],{"class":791},[622,1924,810],{"class":715},[622,1926,1927],{"class":631},"fulfill_order",[622,1929,810],{"class":715},[622,1931,897],{"class":715},[622,1933,1076],{"class":833},[622,1935,1936],{"class":715}," ()",[622,1938,915],{"class":833},[622,1940,918],{"class":715},[622,1942,1943,1946,1948,1950,1952],{"class":624,"line":825},[622,1944,1945],{"class":833},"    const",[622,1947,1499],{"class":708},[622,1949,1101],{"class":715},[622,1951,1451],{"class":778},[622,1953,846],{"class":791},[622,1955,1956,1959,1961,1963,1965,1967,1970,1972,1974,1977,1979,1981],{"class":624,"line":830},[622,1957,1958],{"class":708},"    log",[622,1960,860],{"class":715},[622,1962,934],{"class":778},[622,1964,782],{"class":791},[622,1966,939],{"class":715},[622,1968,1969],{"class":791}," step",[622,1971,795],{"class":715},[622,1973,716],{"class":715},[622,1975,1976],{"class":631},"inventory_ok",[622,1978,810],{"class":715},[622,1980,736],{"class":715},[622,1982,822],{"class":791},[622,1984,1985,1988],{"class":624,"line":849},[622,1986,1987],{"class":715},"  }",[622,1989,822],{"class":791},[622,1991,1992,1994,1996,1998,2000,2002,2004,2006,2008,2010],{"class":624,"line":854},[622,1993,961],{"class":708},[622,1995,860],{"class":715},[622,1997,966],{"class":778},[622,1999,782],{"class":791},[622,2001,939],{"class":715},[622,2003,973],{"class":791},[622,2005,795],{"class":715},[622,2007,979],{"class":978},[622,2009,736],{"class":715},[622,2011,822],{"class":791},[622,2013,2014,2016],{"class":624,"line":873},[622,2015,819],{"class":715},[622,2017,822],{"class":708},[600,2019,2021],{"id":2020},"error-handling","Error Handling",[540,2023,1430,2024,2027,2028,2031,2032,2035,2036,2039],{},[544,2025,2026],{},"createError"," for structured errors with ",[544,2029,2030],{},"why",", ",[544,2033,2034],{},"fix",", and ",[544,2037,2038],{},"link"," fields. Express uses a 4-argument error handler middleware:",[612,2041,2043],{"className":694,"code":2042,"filename":696,"language":697,"meta":618,"style":618},"import { createError, parseError } from 'evlog'\n\napp.get('\u002Fcheckout', () => {\n  throw createError({\n    message: 'Payment failed',\n    status: 402,\n    why: 'Card declined by issuer',\n    fix: 'Try a different payment method',\n    link: 'https:\u002F\u002Fdocs.example.com\u002Fpayments\u002Fdeclined',\n  })\n})\n\napp.use((err, req, res, next) => {\n  req.log.error(err)\n  const parsed = parseError(err)\n\n  res.status(parsed.status).json({\n    message: parsed.message,\n    why: parsed.why,\n    fix: parsed.fix,\n    link: parsed.link,\n  })\n})\n",[544,2044,2045,2069,2073,2098,2109,2126,2138,2154,2170,2186,2192,2198,2202,2236,2255,2272,2276,2304,2319,2334,2349,2364,2371],{"__ignoreMap":618},[622,2046,2047,2049,2051,2054,2056,2059,2061,2063,2065,2067],{"class":624,"line":625},[622,2048,705],{"class":704},[622,2050,730],{"class":715},[622,2052,2053],{"class":708}," createError",[622,2055,897],{"class":715},[622,2057,2058],{"class":708}," parseError",[622,2060,736],{"class":715},[622,2062,739],{"class":704},[622,2064,716],{"class":715},[622,2066,744],{"class":631},[622,2068,722],{"class":715},[622,2070,2071],{"class":624,"line":725},[622,2072,772],{"emptyLinePlaceholder":771},[622,2074,2075,2077,2079,2081,2083,2085,2088,2090,2092,2094,2096],{"class":624,"line":749},[622,2076,857],{"class":708},[622,2078,860],{"class":715},[622,2080,885],{"class":778},[622,2082,782],{"class":708},[622,2084,810],{"class":715},[622,2086,2087],{"class":631},"\u002Fcheckout",[622,2089,810],{"class":715},[622,2091,897],{"class":715},[622,2093,1936],{"class":715},[622,2095,915],{"class":833},[622,2097,918],{"class":715},[622,2099,2100,2103,2105,2107],{"class":624,"line":768},[622,2101,2102],{"class":704},"  throw",[622,2104,2053],{"class":778},[622,2106,782],{"class":791},[622,2108,785],{"class":715},[622,2110,2111,2114,2116,2118,2121,2123],{"class":624,"line":775},[622,2112,2113],{"class":791},"    message",[622,2115,795],{"class":715},[622,2117,716],{"class":715},[622,2119,2120],{"class":631},"Payment failed",[622,2122,810],{"class":715},[622,2124,2125],{"class":715},",\n",[622,2127,2128,2131,2133,2136],{"class":624,"line":788},[622,2129,2130],{"class":791},"    status",[622,2132,795],{"class":715},[622,2134,2135],{"class":1010}," 402",[622,2137,2125],{"class":715},[622,2139,2140,2143,2145,2147,2150,2152],{"class":624,"line":816},[622,2141,2142],{"class":791},"    why",[622,2144,795],{"class":715},[622,2146,716],{"class":715},[622,2148,2149],{"class":631},"Card declined by issuer",[622,2151,810],{"class":715},[622,2153,2125],{"class":715},[622,2155,2156,2159,2161,2163,2166,2168],{"class":624,"line":825},[622,2157,2158],{"class":791},"    fix",[622,2160,795],{"class":715},[622,2162,716],{"class":715},[622,2164,2165],{"class":631},"Try a different payment method",[622,2167,810],{"class":715},[622,2169,2125],{"class":715},[622,2171,2172,2175,2177,2179,2182,2184],{"class":624,"line":830},[622,2173,2174],{"class":791},"    link",[622,2176,795],{"class":715},[622,2178,716],{"class":715},[622,2180,2181],{"class":631},"https:\u002F\u002Fdocs.example.com\u002Fpayments\u002Fdeclined",[622,2183,810],{"class":715},[622,2185,2125],{"class":715},[622,2187,2188,2190],{"class":624,"line":849},[622,2189,1987],{"class":715},[622,2191,822],{"class":791},[622,2193,2194,2196],{"class":624,"line":854},[622,2195,819],{"class":715},[622,2197,822],{"class":708},[622,2199,2200],{"class":624,"line":873},[622,2201,772],{"emptyLinePlaceholder":771},[622,2203,2204,2206,2208,2210,2212,2214,2217,2219,2221,2223,2225,2227,2230,2232,2234],{"class":624,"line":878},[622,2205,857],{"class":708},[622,2207,860],{"class":715},[622,2209,863],{"class":778},[622,2211,782],{"class":708},[622,2213,782],{"class":715},[622,2215,2216],{"class":903},"err",[622,2218,897],{"class":715},[622,2220,1104],{"class":903},[622,2222,897],{"class":715},[622,2224,909],{"class":903},[622,2226,897],{"class":715},[622,2228,2229],{"class":903}," next",[622,2231,912],{"class":715},[622,2233,915],{"class":833},[622,2235,918],{"class":715},[622,2237,2238,2240,2242,2244,2246,2249,2251,2253],{"class":624,"line":921},[622,2239,924],{"class":708},[622,2241,860],{"class":715},[622,2243,929],{"class":708},[622,2245,860],{"class":715},[622,2247,2248],{"class":778},"error",[622,2250,782],{"class":791},[622,2252,2216],{"class":708},[622,2254,822],{"class":791},[622,2256,2257,2259,2262,2264,2266,2268,2270],{"class":624,"line":958},[622,2258,1095],{"class":833},[622,2260,2261],{"class":708}," parsed",[622,2263,1101],{"class":715},[622,2265,2058],{"class":778},[622,2267,782],{"class":791},[622,2269,2216],{"class":708},[622,2271,822],{"class":791},[622,2273,2274],{"class":624,"line":986},[622,2275,772],{"emptyLinePlaceholder":771},[622,2277,2278,2280,2282,2285,2287,2290,2292,2294,2296,2298,2300,2302],{"class":624,"line":993},[622,2279,961],{"class":708},[622,2281,860],{"class":715},[622,2283,2284],{"class":778},"status",[622,2286,782],{"class":791},[622,2288,2289],{"class":708},"parsed",[622,2291,860],{"class":715},[622,2293,2284],{"class":708},[622,2295,912],{"class":791},[622,2297,860],{"class":715},[622,2299,966],{"class":778},[622,2301,782],{"class":791},[622,2303,785],{"class":715},[622,2305,2306,2308,2310,2312,2314,2317],{"class":624,"line":998},[622,2307,2113],{"class":791},[622,2309,795],{"class":715},[622,2311,2261],{"class":708},[622,2313,860],{"class":715},[622,2315,2316],{"class":708},"message",[622,2318,2125],{"class":715},[622,2320,2322,2324,2326,2328,2330,2332],{"class":624,"line":2321},19,[622,2323,2142],{"class":791},[622,2325,795],{"class":715},[622,2327,2261],{"class":708},[622,2329,860],{"class":715},[622,2331,2030],{"class":708},[622,2333,2125],{"class":715},[622,2335,2337,2339,2341,2343,2345,2347],{"class":624,"line":2336},20,[622,2338,2158],{"class":791},[622,2340,795],{"class":715},[622,2342,2261],{"class":708},[622,2344,860],{"class":715},[622,2346,2034],{"class":708},[622,2348,2125],{"class":715},[622,2350,2352,2354,2356,2358,2360,2362],{"class":624,"line":2351},21,[622,2353,2174],{"class":791},[622,2355,795],{"class":715},[622,2357,2261],{"class":708},[622,2359,860],{"class":715},[622,2361,2038],{"class":708},[622,2363,2125],{"class":715},[622,2365,2367,2369],{"class":624,"line":2366},22,[622,2368,1987],{"class":715},[622,2370,822],{"class":791},[622,2372,2374,2376],{"class":624,"line":2373},23,[622,2375,819],{"class":715},[622,2377,822],{"class":708},[540,2379,2380],{},"The error is captured and logged with both the custom context and structured error fields:",[612,2382,2384],{"className":614,"code":2383,"filename":1363,"language":617,"meta":618,"style":618},"14:58:20 ERROR [my-api] GET \u002Fcheckout 402 in 3ms\n  ├─ error: name=EvlogError message=Payment failed status=402\n  └─ requestId: 880a50ac-...\n",[544,2385,2386,2397,2419],{"__ignoreMap":618},[622,2387,2388,2391,2394],{"class":624,"line":625},[622,2389,2390],{"class":628},"14:58:20",[622,2392,2393],{"class":631}," ERROR",[622,2395,2396],{"class":708}," [my-api] GET \u002Fcheckout 402 in 3ms\n",[622,2398,2399,2401,2404,2407,2410,2413,2416],{"class":624,"line":725},[622,2400,1381],{"class":628},[622,2402,2403],{"class":631}," error:",[622,2405,2406],{"class":631}," name=EvlogError",[622,2408,2409],{"class":631}," message=Payment",[622,2411,2412],{"class":631}," failed",[622,2414,2415],{"class":631}," status=",[622,2417,2418],{"class":1010},"402\n",[622,2420,2421,2423,2425],{"class":624,"line":749},[622,2422,1417],{"class":628},[622,2424,1420],{"class":631},[622,2426,2427],{"class":631}," 880a50ac-...\n",[600,2429,504],{"id":2430},"configuration",[540,2432,2433,2434,2437,2438,2440],{},"See the ",[589,2435,2436],{"href":505},"Configuration reference"," for all available options (",[544,2439,779],{},", middleware options, sampling, silent mode, etc.).",[600,2442,2444],{"id":2443},"drain-enrichers","Drain & Enrichers",[540,2446,2447],{},"Configure drain adapters and enrichers directly in the middleware options:",[612,2449,2451],{"className":694,"code":2450,"filename":696,"language":697,"meta":618,"style":618},"import { createAxiomDrain } from 'evlog\u002Faxiom'\nimport { createUserAgentEnricher } from 'evlog\u002Fenrichers'\n\nconst userAgent = createUserAgentEnricher()\n\napp.use(evlog({\n  drain: createAxiomDrain(),\n  enrich: (ctx) => {\n    userAgent(ctx)\n    ctx.event.region = process.env.FLY_REGION\n  },\n}))\n",[544,2452,2453,2473,2493,2497,2510,2514,2530,2544,2562,2573,2603,2608],{"__ignoreMap":618},[622,2454,2455,2457,2459,2462,2464,2466,2468,2471],{"class":624,"line":625},[622,2456,705],{"class":704},[622,2458,730],{"class":715},[622,2460,2461],{"class":708}," createAxiomDrain",[622,2463,736],{"class":715},[622,2465,739],{"class":704},[622,2467,716],{"class":715},[622,2469,2470],{"class":631},"evlog\u002Faxiom",[622,2472,722],{"class":715},[622,2474,2475,2477,2479,2482,2484,2486,2488,2491],{"class":624,"line":725},[622,2476,705],{"class":704},[622,2478,730],{"class":715},[622,2480,2481],{"class":708}," createUserAgentEnricher",[622,2483,736],{"class":715},[622,2485,739],{"class":704},[622,2487,716],{"class":715},[622,2489,2490],{"class":631},"evlog\u002Fenrichers",[622,2492,722],{"class":715},[622,2494,2495],{"class":624,"line":749},[622,2496,772],{"emptyLinePlaceholder":771},[622,2498,2499,2501,2504,2506,2508],{"class":624,"line":768},[622,2500,834],{"class":833},[622,2502,2503],{"class":708}," userAgent ",[622,2505,840],{"class":715},[622,2507,2481],{"class":778},[622,2509,846],{"class":708},[622,2511,2512],{"class":624,"line":775},[622,2513,772],{"emptyLinePlaceholder":771},[622,2515,2516,2518,2520,2522,2524,2526,2528],{"class":624,"line":788},[622,2517,857],{"class":708},[622,2519,860],{"class":715},[622,2521,863],{"class":778},[622,2523,782],{"class":708},[622,2525,744],{"class":778},[622,2527,782],{"class":708},[622,2529,785],{"class":715},[622,2531,2532,2535,2537,2539,2542],{"class":624,"line":816},[622,2533,2534],{"class":791},"  drain",[622,2536,795],{"class":715},[622,2538,2461],{"class":778},[622,2540,2541],{"class":708},"()",[622,2543,2125],{"class":715},[622,2545,2546,2549,2551,2553,2556,2558,2560],{"class":624,"line":825},[622,2547,2548],{"class":778},"  enrich",[622,2550,795],{"class":715},[622,2552,900],{"class":715},[622,2554,2555],{"class":903},"ctx",[622,2557,912],{"class":715},[622,2559,915],{"class":833},[622,2561,918],{"class":715},[622,2563,2564,2567,2569,2571],{"class":624,"line":830},[622,2565,2566],{"class":778},"    userAgent",[622,2568,782],{"class":791},[622,2570,2555],{"class":708},[622,2572,822],{"class":791},[622,2574,2575,2578,2580,2583,2585,2588,2590,2593,2595,2598,2600],{"class":624,"line":849},[622,2576,2577],{"class":708},"    ctx",[622,2579,860],{"class":715},[622,2581,2582],{"class":708},"event",[622,2584,860],{"class":715},[622,2586,2587],{"class":708},"region",[622,2589,1101],{"class":715},[622,2591,2592],{"class":708}," process",[622,2594,860],{"class":715},[622,2596,2597],{"class":708},"env",[622,2599,860],{"class":715},[622,2601,2602],{"class":708},"FLY_REGION\n",[622,2604,2605],{"class":624,"line":854},[622,2606,2607],{"class":715},"  },\n",[622,2609,2610,2612],{"class":624,"line":873},[622,2611,819],{"class":715},[622,2613,2614],{"class":708},"))\n",[604,2616,2618],{"id":2617},"pipeline-batching-retry","Pipeline (Batching & Retry)",[540,2620,2621,2622,2625],{},"For production, wrap your adapter with ",[544,2623,2624],{},"createDrainPipeline"," to batch events and retry on failure:",[612,2627,2629],{"className":694,"code":2628,"filename":696,"language":697,"meta":618,"style":618},"import type { DrainContext } from 'evlog'\nimport { createAxiomDrain } from 'evlog\u002Faxiom'\nimport { createDrainPipeline } from 'evlog\u002Fpipeline'\n\nconst pipeline = createDrainPipeline\u003CDrainContext>({\n  batch: { size: 50, intervalMs: 5000 },\n  retry: { maxAttempts: 3 },\n})\nconst drain = pipeline(createAxiomDrain())\n\napp.use(evlog({ drain }))\n",[544,2630,2631,2653,2671,2691,2695,2719,2748,2767,2773,2792,2796],{"__ignoreMap":618},[622,2632,2633,2635,2638,2640,2643,2645,2647,2649,2651],{"class":624,"line":625},[622,2634,705],{"class":704},[622,2636,2637],{"class":704}," type",[622,2639,730],{"class":715},[622,2641,2642],{"class":708}," DrainContext",[622,2644,736],{"class":715},[622,2646,739],{"class":704},[622,2648,716],{"class":715},[622,2650,744],{"class":631},[622,2652,722],{"class":715},[622,2654,2655,2657,2659,2661,2663,2665,2667,2669],{"class":624,"line":725},[622,2656,705],{"class":704},[622,2658,730],{"class":715},[622,2660,2461],{"class":708},[622,2662,736],{"class":715},[622,2664,739],{"class":704},[622,2666,716],{"class":715},[622,2668,2470],{"class":631},[622,2670,722],{"class":715},[622,2672,2673,2675,2677,2680,2682,2684,2686,2689],{"class":624,"line":749},[622,2674,705],{"class":704},[622,2676,730],{"class":715},[622,2678,2679],{"class":708}," createDrainPipeline",[622,2681,736],{"class":715},[622,2683,739],{"class":704},[622,2685,716],{"class":715},[622,2687,2688],{"class":631},"evlog\u002Fpipeline",[622,2690,722],{"class":715},[622,2692,2693],{"class":624,"line":768},[622,2694,772],{"emptyLinePlaceholder":771},[622,2696,2697,2699,2702,2704,2706,2709,2712,2715,2717],{"class":624,"line":775},[622,2698,834],{"class":833},[622,2700,2701],{"class":708}," pipeline ",[622,2703,840],{"class":715},[622,2705,2679],{"class":778},[622,2707,2708],{"class":715},"\u003C",[622,2710,2711],{"class":628},"DrainContext",[622,2713,2714],{"class":715},">",[622,2716,782],{"class":708},[622,2718,785],{"class":715},[622,2720,2721,2724,2726,2728,2731,2733,2736,2738,2741,2743,2746],{"class":624,"line":788},[622,2722,2723],{"class":791},"  batch",[622,2725,795],{"class":715},[622,2727,730],{"class":715},[622,2729,2730],{"class":791}," size",[622,2732,795],{"class":715},[622,2734,2735],{"class":1010}," 50",[622,2737,897],{"class":715},[622,2739,2740],{"class":791}," intervalMs",[622,2742,795],{"class":715},[622,2744,2745],{"class":1010}," 5000",[622,2747,813],{"class":715},[622,2749,2750,2753,2755,2757,2760,2762,2765],{"class":624,"line":816},[622,2751,2752],{"class":791},"  retry",[622,2754,795],{"class":715},[622,2756,730],{"class":715},[622,2758,2759],{"class":791}," maxAttempts",[622,2761,795],{"class":715},[622,2763,2764],{"class":1010}," 3",[622,2766,813],{"class":715},[622,2768,2769,2771],{"class":624,"line":825},[622,2770,819],{"class":715},[622,2772,822],{"class":708},[622,2774,2775,2777,2780,2782,2785,2787,2790],{"class":624,"line":830},[622,2776,834],{"class":833},[622,2778,2779],{"class":708}," drain ",[622,2781,840],{"class":715},[622,2783,2784],{"class":778}," pipeline",[622,2786,782],{"class":708},[622,2788,2789],{"class":778},"createAxiomDrain",[622,2791,870],{"class":708},[622,2793,2794],{"class":624,"line":849},[622,2795,772],{"emptyLinePlaceholder":771},[622,2797,2798,2800,2802,2804,2806,2808,2810,2812,2814,2816],{"class":624,"line":854},[622,2799,857],{"class":708},[622,2801,860],{"class":715},[622,2803,863],{"class":778},[622,2805,782],{"class":708},[622,2807,744],{"class":778},[622,2809,782],{"class":708},[622,2811,939],{"class":715},[622,2813,2779],{"class":708},[622,2815,819],{"class":715},[622,2817,2614],{"class":708},[1015,2819,2820,2821,2824,2825,2828],{"color":1017,"icon":13},"Call ",[544,2822,2823],{},"drain.flush()"," on server shutdown to ensure all buffered events are sent. See the ",[589,2826,2827],{"href":496},"Pipeline docs"," for all options.",[600,2830,2832],{"id":2831},"tail-sampling","Tail Sampling",[540,2834,1430,2835,2838],{},[544,2836,2837],{},"keep"," to force-retain specific events regardless of head sampling:",[612,2840,2842],{"className":694,"code":2841,"filename":696,"language":697,"meta":618,"style":618},"app.use(evlog({\n  drain: createAxiomDrain(),\n  keep: (ctx) => {\n    if (ctx.duration && ctx.duration > 2000) ctx.shouldKeep = true\n  },\n}))\n",[544,2843,2844,2860,2872,2889,2933,2937],{"__ignoreMap":618},[622,2845,2846,2848,2850,2852,2854,2856,2858],{"class":624,"line":625},[622,2847,857],{"class":708},[622,2849,860],{"class":715},[622,2851,863],{"class":778},[622,2853,782],{"class":708},[622,2855,744],{"class":778},[622,2857,782],{"class":708},[622,2859,785],{"class":715},[622,2861,2862,2864,2866,2868,2870],{"class":624,"line":725},[622,2863,2534],{"class":791},[622,2865,795],{"class":715},[622,2867,2461],{"class":778},[622,2869,2541],{"class":708},[622,2871,2125],{"class":715},[622,2873,2874,2877,2879,2881,2883,2885,2887],{"class":624,"line":749},[622,2875,2876],{"class":778},"  keep",[622,2878,795],{"class":715},[622,2880,900],{"class":715},[622,2882,2555],{"class":903},[622,2884,912],{"class":715},[622,2886,915],{"class":833},[622,2888,918],{"class":715},[622,2890,2891,2894,2896,2898,2900,2903,2906,2909,2911,2913,2916,2919,2921,2923,2925,2928,2930],{"class":624,"line":768},[622,2892,2893],{"class":704},"    if",[622,2895,900],{"class":791},[622,2897,2555],{"class":708},[622,2899,860],{"class":715},[622,2901,2902],{"class":708},"duration",[622,2904,2905],{"class":715}," &&",[622,2907,2908],{"class":708}," ctx",[622,2910,860],{"class":715},[622,2912,2902],{"class":708},[622,2914,2915],{"class":715}," >",[622,2917,2918],{"class":1010}," 2000",[622,2920,1318],{"class":791},[622,2922,2555],{"class":708},[622,2924,860],{"class":715},[622,2926,2927],{"class":708},"shouldKeep",[622,2929,1101],{"class":715},[622,2931,2932],{"class":978}," true\n",[622,2934,2935],{"class":624,"line":775},[622,2936,2607],{"class":715},[622,2938,2939,2941],{"class":624,"line":788},[622,2940,819],{"class":715},[622,2942,2614],{"class":708},[600,2944,2946],{"id":2945},"route-filtering","Route Filtering",[540,2948,2949,2950,1736,2953,2956],{},"Control which routes are logged with ",[544,2951,2952],{},"include",[544,2954,2955],{},"exclude"," patterns:",[612,2958,2960],{"className":694,"code":2959,"filename":696,"language":697,"meta":618,"style":618},"app.use(evlog({\n  include: ['\u002Fapi\u002F**'],\n  exclude: ['\u002F_internal\u002F**', '\u002Fhealth'],\n  routes: {\n    '\u002Fapi\u002Fauth\u002F**': { service: 'auth-service' },\n    '\u002Fapi\u002Fpayment\u002F**': { service: 'payment-service' },\n  },\n}))\n",[544,2961,2962,2978,3000,3028,3037,3064,3090,3094],{"__ignoreMap":618},[622,2963,2964,2966,2968,2970,2972,2974,2976],{"class":624,"line":625},[622,2965,857],{"class":708},[622,2967,860],{"class":715},[622,2969,863],{"class":778},[622,2971,782],{"class":708},[622,2973,744],{"class":778},[622,2975,782],{"class":708},[622,2977,785],{"class":715},[622,2979,2980,2983,2985,2988,2990,2993,2995,2998],{"class":624,"line":725},[622,2981,2982],{"class":791},"  include",[622,2984,795],{"class":715},[622,2986,2987],{"class":708}," [",[622,2989,810],{"class":715},[622,2991,2992],{"class":631},"\u002Fapi\u002F**",[622,2994,810],{"class":715},[622,2996,2997],{"class":708},"]",[622,2999,2125],{"class":715},[622,3001,3002,3005,3007,3009,3011,3014,3016,3018,3020,3022,3024,3026],{"class":624,"line":749},[622,3003,3004],{"class":791},"  exclude",[622,3006,795],{"class":715},[622,3008,2987],{"class":708},[622,3010,810],{"class":715},[622,3012,3013],{"class":631},"\u002F_internal\u002F**",[622,3015,810],{"class":715},[622,3017,897],{"class":715},[622,3019,716],{"class":715},[622,3021,892],{"class":631},[622,3023,810],{"class":715},[622,3025,2997],{"class":708},[622,3027,2125],{"class":715},[622,3029,3030,3033,3035],{"class":624,"line":768},[622,3031,3032],{"class":791},"  routes",[622,3034,795],{"class":715},[622,3036,918],{"class":715},[622,3038,3039,3042,3045,3047,3049,3051,3053,3055,3057,3060,3062],{"class":624,"line":775},[622,3040,3041],{"class":715},"    '",[622,3043,3044],{"class":791},"\u002Fapi\u002Fauth\u002F**",[622,3046,810],{"class":715},[622,3048,795],{"class":715},[622,3050,730],{"class":715},[622,3052,800],{"class":791},[622,3054,795],{"class":715},[622,3056,716],{"class":715},[622,3058,3059],{"class":631},"auth-service",[622,3061,810],{"class":715},[622,3063,813],{"class":715},[622,3065,3066,3068,3071,3073,3075,3077,3079,3081,3083,3086,3088],{"class":624,"line":788},[622,3067,3041],{"class":715},[622,3069,3070],{"class":791},"\u002Fapi\u002Fpayment\u002F**",[622,3072,810],{"class":715},[622,3074,795],{"class":715},[622,3076,730],{"class":715},[622,3078,800],{"class":791},[622,3080,795],{"class":715},[622,3082,716],{"class":715},[622,3084,3085],{"class":631},"payment-service",[622,3087,810],{"class":715},[622,3089,813],{"class":715},[622,3091,3092],{"class":624,"line":816},[622,3093,2607],{"class":715},[622,3095,3096,3098],{"class":624,"line":825},[622,3097,819],{"class":715},[622,3099,2614],{"class":708},[600,3101,3103],{"id":3102},"client-side-logging","Client-Side Logging",[540,3105,1430,3106,3109],{},[544,3107,3108],{},"evlog\u002Fhttp"," to send structured logs from any frontend to your Express server. This works with any client framework (React, Vue, Svelte, vanilla JS).",[604,3111,3113],{"id":3112},"browser-setup","Browser setup",[612,3115,3118],{"className":694,"code":3116,"filename":3117,"language":697,"meta":618,"style":618},"import { initLogger, log } from 'evlog'\nimport { createHttpLogDrain } from 'evlog\u002Fhttp'\n\nconst drain = createHttpLogDrain({\n  drain: { endpoint: '\u002Fv1\u002Fingest' },\n})\ninitLogger({ drain })\n\nlog.info({ action: 'page_view', path: location.pathname })\n","client.ts",[544,3119,3120,3142,3161,3165,3179,3201,3207,3221,3225],{"__ignoreMap":618},[622,3121,3122,3124,3126,3128,3130,3132,3134,3136,3138,3140],{"class":624,"line":625},[622,3123,705],{"class":704},[622,3125,730],{"class":715},[622,3127,733],{"class":708},[622,3129,897],{"class":715},[622,3131,1499],{"class":708},[622,3133,736],{"class":715},[622,3135,739],{"class":704},[622,3137,716],{"class":715},[622,3139,744],{"class":631},[622,3141,722],{"class":715},[622,3143,3144,3146,3148,3151,3153,3155,3157,3159],{"class":624,"line":725},[622,3145,705],{"class":704},[622,3147,730],{"class":715},[622,3149,3150],{"class":708}," createHttpLogDrain",[622,3152,736],{"class":715},[622,3154,739],{"class":704},[622,3156,716],{"class":715},[622,3158,3108],{"class":631},[622,3160,722],{"class":715},[622,3162,3163],{"class":624,"line":749},[622,3164,772],{"emptyLinePlaceholder":771},[622,3166,3167,3169,3171,3173,3175,3177],{"class":624,"line":768},[622,3168,834],{"class":833},[622,3170,2779],{"class":708},[622,3172,840],{"class":715},[622,3174,3150],{"class":778},[622,3176,782],{"class":708},[622,3178,785],{"class":715},[622,3180,3181,3183,3185,3187,3190,3192,3194,3197,3199],{"class":624,"line":775},[622,3182,2534],{"class":791},[622,3184,795],{"class":715},[622,3186,730],{"class":715},[622,3188,3189],{"class":791}," endpoint",[622,3191,795],{"class":715},[622,3193,716],{"class":715},[622,3195,3196],{"class":631},"\u002Fv1\u002Fingest",[622,3198,810],{"class":715},[622,3200,813],{"class":715},[622,3202,3203,3205],{"class":624,"line":788},[622,3204,819],{"class":715},[622,3206,822],{"class":708},[622,3208,3209,3211,3213,3215,3217,3219],{"class":624,"line":816},[622,3210,779],{"class":778},[622,3212,782],{"class":708},[622,3214,939],{"class":715},[622,3216,2779],{"class":708},[622,3218,819],{"class":715},[622,3220,822],{"class":708},[622,3222,3223],{"class":624,"line":825},[622,3224,772],{"emptyLinePlaceholder":771},[622,3226,3227,3229,3231,3233,3235,3237,3240,3242,3244,3247,3249,3251,3254,3256,3259,3261,3264,3266],{"class":624,"line":830},[622,3228,929],{"class":708},[622,3230,860],{"class":715},[622,3232,1017],{"class":778},[622,3234,782],{"class":708},[622,3236,939],{"class":715},[622,3238,3239],{"class":791}," action",[622,3241,795],{"class":715},[622,3243,716],{"class":715},[622,3245,3246],{"class":631},"page_view",[622,3248,810],{"class":715},[622,3250,897],{"class":715},[622,3252,3253],{"class":791}," path",[622,3255,795],{"class":715},[622,3257,3258],{"class":708}," location",[622,3260,860],{"class":715},[622,3262,3263],{"class":708},"pathname ",[622,3265,819],{"class":715},[622,3267,822],{"class":708},[604,3269,3271],{"id":3270},"ingest-endpoint","Ingest endpoint",[540,3273,3274,3275,3278],{},"Add a POST route to receive batched ",[544,3276,3277],{},"DrainContext[]"," from the browser:",[612,3280,3282],{"className":694,"code":3281,"filename":696,"language":697,"meta":618,"style":618},"import type { DrainContext } from 'evlog'\n\napp.post('\u002Fv1\u002Fingest', express.json(), (req, res) => {\n  const batch = req.body as DrainContext[]\n  for (const ctx of batch) {\n    console.log('[BROWSER]', JSON.stringify(ctx.event))\n  }\n  res.sendStatus(204)\n})\n",[544,3283,3284,3304,3308,3350,3374,3394,3432,3437,3453],{"__ignoreMap":618},[622,3285,3286,3288,3290,3292,3294,3296,3298,3300,3302],{"class":624,"line":625},[622,3287,705],{"class":704},[622,3289,2637],{"class":704},[622,3291,730],{"class":715},[622,3293,2642],{"class":708},[622,3295,736],{"class":715},[622,3297,739],{"class":704},[622,3299,716],{"class":715},[622,3301,744],{"class":631},[622,3303,722],{"class":715},[622,3305,3306],{"class":624,"line":725},[622,3307,772],{"emptyLinePlaceholder":771},[622,3309,3310,3312,3314,3316,3318,3320,3322,3324,3326,3328,3330,3332,3334,3336,3338,3340,3342,3344,3346,3348],{"class":624,"line":749},[622,3311,857],{"class":708},[622,3313,860],{"class":715},[622,3315,1847],{"class":778},[622,3317,782],{"class":708},[622,3319,810],{"class":715},[622,3321,3196],{"class":631},[622,3323,810],{"class":715},[622,3325,897],{"class":715},[622,3327,843],{"class":708},[622,3329,860],{"class":715},[622,3331,966],{"class":778},[622,3333,2541],{"class":708},[622,3335,897],{"class":715},[622,3337,900],{"class":715},[622,3339,904],{"class":903},[622,3341,897],{"class":715},[622,3343,909],{"class":903},[622,3345,912],{"class":715},[622,3347,915],{"class":833},[622,3349,918],{"class":715},[622,3351,3352,3354,3357,3359,3361,3363,3366,3369,3371],{"class":624,"line":768},[622,3353,1095],{"class":833},[622,3355,3356],{"class":708}," batch",[622,3358,1101],{"class":715},[622,3360,1104],{"class":708},[622,3362,860],{"class":715},[622,3364,3365],{"class":708},"body",[622,3367,3368],{"class":704}," as",[622,3370,2642],{"class":628},[622,3372,3373],{"class":791},"[]\n",[622,3375,3376,3379,3381,3383,3385,3388,3390,3392],{"class":624,"line":775},[622,3377,3378],{"class":704},"  for",[622,3380,900],{"class":791},[622,3382,834],{"class":833},[622,3384,2908],{"class":708},[622,3386,3387],{"class":715}," of",[622,3389,3356],{"class":708},[622,3391,1318],{"class":791},[622,3393,785],{"class":715},[622,3395,3396,3399,3401,3403,3405,3407,3410,3412,3414,3417,3419,3422,3424,3426,3428,3430],{"class":624,"line":788},[622,3397,3398],{"class":708},"    console",[622,3400,860],{"class":715},[622,3402,929],{"class":778},[622,3404,782],{"class":791},[622,3406,810],{"class":715},[622,3408,3409],{"class":631},"[BROWSER]",[622,3411,810],{"class":715},[622,3413,897],{"class":715},[622,3415,3416],{"class":708}," JSON",[622,3418,860],{"class":715},[622,3420,3421],{"class":778},"stringify",[622,3423,782],{"class":791},[622,3425,2555],{"class":708},[622,3427,860],{"class":715},[622,3429,2582],{"class":708},[622,3431,2614],{"class":791},[622,3433,3434],{"class":624,"line":816},[622,3435,3436],{"class":715},"  }\n",[622,3438,3439,3441,3443,3446,3448,3451],{"class":624,"line":825},[622,3440,961],{"class":708},[622,3442,860],{"class":715},[622,3444,3445],{"class":778},"sendStatus",[622,3447,782],{"class":791},[622,3449,3450],{"class":1010},"204",[622,3452,822],{"class":791},[622,3454,3455,3457],{"class":624,"line":830},[622,3456,819],{"class":715},[622,3458,822],{"class":708},[1015,3460,3463,3464,3468],{"color":3461,"icon":3462},"neutral","i-lucide-globe","See the full ",[589,3465,3467],{"href":3466},"\u002Fextend\u002Fdrain-pipeline#http-drain-browser-to-server","HTTP drain"," adapter docs for batching, retry, sendBeacon fallback, and authentication options.",[600,3470,3472],{"id":3471},"run-locally","Run Locally",[612,3474,3477],{"className":614,"code":3475,"filename":3476,"language":617,"meta":618,"style":618},"git clone https:\u002F\u002Fgithub.com\u002Fhugorcd\u002Fevlog.git\ncd evlog\npnpm install\npnpm example express\n","Terminal",[544,3478,3479,3490,3498,3505],{"__ignoreMap":618},[622,3480,3481,3484,3487],{"class":624,"line":625},[622,3482,3483],{"class":628},"git",[622,3485,3486],{"class":631}," clone",[622,3488,3489],{"class":631}," https:\u002F\u002Fgithub.com\u002Fhugorcd\u002Fevlog.git\n",[622,3491,3492,3495],{"class":624,"line":725},[622,3493,3494],{"class":778},"cd",[622,3496,3497],{"class":631}," evlog\n",[622,3499,3500,3502],{"class":624,"line":749},[622,3501,616],{"class":628},[622,3503,3504],{"class":631}," install\n",[622,3506,3507,3509,3512],{"class":624,"line":768},[622,3508,616],{"class":628},[622,3510,3511],{"class":631}," example",[622,3513,638],{"class":631},[540,3515,3516,3517,3521],{},"Open ",[589,3518,3519],{"href":3519,"rel":3520},"http:\u002F\u002Flocalhost:3000",[593]," to explore the interactive test UI.",[3523,3524,3525],"card-group",{},[3526,3527,3531],"card",{"icon":3528,"title":3529,"to":3530},"i-simple-icons-github","Source Code","https:\u002F\u002Fgithub.com\u002Fhugorcd\u002Fevlog\u002Ftree\u002Fmain\u002Fexamples\u002Fexpress","Browse the complete Express example source on GitHub.",[600,3533,3535],{"id":3534},"next-steps","Next Steps",[540,3537,3538,3539,3541],{},"Deepen your ",[1019,3540,260],{}," integration:",[561,3543,3544,3549,3554,3559],{},[564,3545,3546,3548],{},[589,3547,46],{"href":47},": Design comprehensive events with context layering",[564,3550,3551,3553],{},[589,3552,138],{"href":143},": Send logs to Axiom, Sentry, PostHog, and more",[564,3555,3556,3558],{},[589,3557,61],{"href":62},": Control log volume with head and tail sampling",[564,3560,3561,3563,3564,2031,3566,2035,3568,3570],{},[589,3562,51],{"href":52},": Throw errors with ",[544,3565,2030],{},[544,3567,2034],{},[544,3569,2038],{}," fields",[3572,3573,3574],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}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 .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 .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}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 .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sHdIc, html code.shiki .sHdIc{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic}html pre.shiki code .sfNiH, html code.shiki .sfNiH{--shiki-light:#FF5370;--shiki-default:#FF9CAC;--shiki-dark:#FF9CAC}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}",{"title":618,"searchDepth":725,"depth":725,"links":3576},[3577,3581,3582,3583,3585,3586,3587,3590,3591,3592,3596,3597],{"id":602,"depth":725,"text":25,"children":3578},[3579,3580],{"id":606,"depth":749,"text":607},{"id":690,"depth":749,"text":691},{"id":1046,"depth":725,"text":46},{"id":1426,"depth":725,"text":1427},{"id":1749,"depth":725,"text":3584},"Background work (log.fork)",{"id":2020,"depth":725,"text":2021},{"id":2430,"depth":725,"text":504},{"id":2443,"depth":725,"text":2444,"children":3588},[3589],{"id":2617,"depth":749,"text":2618},{"id":2831,"depth":725,"text":2832},{"id":2945,"depth":725,"text":2946},{"id":3102,"depth":725,"text":3103,"children":3593},[3594,3595],{"id":3112,"depth":749,"text":3113},{"id":3270,"depth":749,"text":3271},{"id":3471,"depth":725,"text":3472},{"id":3534,"depth":725,"text":3535},"Automatic wide events, structured errors, drain adapters, enrichers, and tail sampling in Express applications.","md",[3601],{"label":3529,"icon":3528,"to":3530,"color":3461,"variant":3602},"subtle",{},{"title":260,"icon":263},{"title":260,"description":3598},"HjcTN6KtcQzGHU_wjwbMt8QFOQdCN55JsHt-Ro4RrAo",[3608,3610],{"title":255,"path":256,"stem":257,"description":3609,"icon":258,"children":-1},"Automatic wide events, structured errors, drain adapters, enrichers, and tail sampling in NestJS applications.",{"title":265,"path":266,"stem":267,"description":3611,"icon":268,"children":-1},"Automatic wide events, structured errors, drain adapters, enrichers, and tail sampling in Hono applications.",1786790008492]