[{"data":1,"prerenderedAt":3611},["ShallowReactive",2],{"navigation_docs":3,"-integrate-frameworks-express":534,"-integrate-frameworks-express-surround":3606},[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":3597,"extension":3598,"links":3599,"meta":3602,"navigation":3603,"path":261,"seo":3604,"stem":262,"__hash__":3605},"docs\u002F4.integrate\u002Fframeworks\u002F07.express.md",{"type":537,"value":538,"toc":3574},"minimark",[539,552,599,603,608,688,692,1014,1038,1044,1047,1050,1357,1360,1424,1428,1437,1622,1731,1747,1754,1789,2017,2021,2039,2377,2380,2427,2430,2440,2444,2447,2614,2618,2625,2817,2828,2832,2838,2942,2946,2956,3099,3103,3109,3113,3267,3271,3278,3458,3468,3472,3513,3521,3531,3535,3541,3570],[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,860],{},"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","Wide events — After emit",[612,1790,1792],{"className":694,"code":1791,"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,1793,1794,1816,1820,1834,1838,1872,1904,1940,1953,1982,1989,2011],{"__ignoreMap":618},[622,1795,1796,1798,1800,1802,1804,1806,1808,1810,1812,1814],{"class":624,"line":625},[622,1797,705],{"class":704},[622,1799,730],{"class":715},[622,1801,635],{"class":708},[622,1803,897],{"class":715},[622,1805,1451],{"class":708},[622,1807,736],{"class":715},[622,1809,739],{"class":704},[622,1811,716],{"class":715},[622,1813,546],{"class":631},[622,1815,722],{"class":715},[622,1817,1818],{"class":624,"line":725},[622,1819,772],{"emptyLinePlaceholder":771},[622,1821,1822,1824,1826,1828,1830,1832],{"class":624,"line":749},[622,1823,857],{"class":708},[622,1825,860],{"class":715},[622,1827,863],{"class":778},[622,1829,782],{"class":708},[622,1831,744],{"class":778},[622,1833,870],{"class":708},[622,1835,1836],{"class":624,"line":768},[622,1837,772],{"emptyLinePlaceholder":771},[622,1839,1840,1842,1844,1847,1849,1851,1854,1856,1858,1860,1862,1864,1866,1868,1870],{"class":624,"line":775},[622,1841,857],{"class":708},[622,1843,860],{"class":715},[622,1845,1846],{"class":778},"post",[622,1848,782],{"class":708},[622,1850,810],{"class":715},[622,1852,1853],{"class":631},"\u002Forders",[622,1855,810],{"class":715},[622,1857,897],{"class":715},[622,1859,900],{"class":715},[622,1861,904],{"class":903},[622,1863,897],{"class":715},[622,1865,909],{"class":903},[622,1867,912],{"class":715},[622,1869,915],{"class":833},[622,1871,918],{"class":715},[622,1873,1874,1876,1878,1880,1882,1884,1886,1888,1891,1893,1895,1898,1900,1902],{"class":624,"line":788},[622,1875,924],{"class":708},[622,1877,860],{"class":715},[622,1879,929],{"class":708},[622,1881,860],{"class":715},[622,1883,934],{"class":778},[622,1885,782],{"class":791},[622,1887,939],{"class":715},[622,1889,1890],{"class":791}," orderId",[622,1892,795],{"class":715},[622,1894,716],{"class":715},[622,1896,1897],{"class":631},"ord_1",[622,1899,810],{"class":715},[622,1901,736],{"class":715},[622,1903,822],{"class":791},[622,1905,1906,1908,1910,1912,1914,1917,1920,1922,1924,1927,1929,1931,1933,1936,1938],{"class":624,"line":816},[622,1907,924],{"class":708},[622,1909,860],{"class":715},[622,1911,929],{"class":708},[622,1913,860],{"class":715},[622,1915,1916],{"class":778},"fork",[622,1918,1919],{"class":715},"!",[622,1921,782],{"class":791},[622,1923,810],{"class":715},[622,1925,1926],{"class":631},"fulfill_order",[622,1928,810],{"class":715},[622,1930,897],{"class":715},[622,1932,1076],{"class":833},[622,1934,1935],{"class":715}," ()",[622,1937,915],{"class":833},[622,1939,918],{"class":715},[622,1941,1942,1945,1947,1949,1951],{"class":624,"line":825},[622,1943,1944],{"class":833},"    const",[622,1946,1499],{"class":708},[622,1948,1101],{"class":715},[622,1950,1451],{"class":778},[622,1952,846],{"class":791},[622,1954,1955,1958,1960,1962,1964,1966,1969,1971,1973,1976,1978,1980],{"class":624,"line":830},[622,1956,1957],{"class":708},"    log",[622,1959,860],{"class":715},[622,1961,934],{"class":778},[622,1963,782],{"class":791},[622,1965,939],{"class":715},[622,1967,1968],{"class":791}," step",[622,1970,795],{"class":715},[622,1972,716],{"class":715},[622,1974,1975],{"class":631},"inventory_ok",[622,1977,810],{"class":715},[622,1979,736],{"class":715},[622,1981,822],{"class":791},[622,1983,1984,1987],{"class":624,"line":849},[622,1985,1986],{"class":715},"  }",[622,1988,822],{"class":791},[622,1990,1991,1993,1995,1997,1999,2001,2003,2005,2007,2009],{"class":624,"line":854},[622,1992,961],{"class":708},[622,1994,860],{"class":715},[622,1996,966],{"class":778},[622,1998,782],{"class":791},[622,2000,939],{"class":715},[622,2002,973],{"class":791},[622,2004,795],{"class":715},[622,2006,979],{"class":978},[622,2008,736],{"class":715},[622,2010,822],{"class":791},[622,2012,2013,2015],{"class":624,"line":873},[622,2014,819],{"class":715},[622,2016,822],{"class":708},[600,2018,2020],{"id":2019},"error-handling","Error Handling",[540,2022,1430,2023,2026,2027,2030,2031,2034,2035,2038],{},[544,2024,2025],{},"createError"," for structured errors with ",[544,2028,2029],{},"why",", ",[544,2032,2033],{},"fix",", and ",[544,2036,2037],{},"link"," fields. Express uses a 4-argument error handler middleware:",[612,2040,2042],{"className":694,"code":2041,"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,2043,2044,2068,2072,2097,2108,2125,2137,2153,2169,2185,2191,2197,2201,2235,2254,2271,2275,2303,2318,2333,2348,2363,2370],{"__ignoreMap":618},[622,2045,2046,2048,2050,2053,2055,2058,2060,2062,2064,2066],{"class":624,"line":625},[622,2047,705],{"class":704},[622,2049,730],{"class":715},[622,2051,2052],{"class":708}," createError",[622,2054,897],{"class":715},[622,2056,2057],{"class":708}," parseError",[622,2059,736],{"class":715},[622,2061,739],{"class":704},[622,2063,716],{"class":715},[622,2065,744],{"class":631},[622,2067,722],{"class":715},[622,2069,2070],{"class":624,"line":725},[622,2071,772],{"emptyLinePlaceholder":771},[622,2073,2074,2076,2078,2080,2082,2084,2087,2089,2091,2093,2095],{"class":624,"line":749},[622,2075,857],{"class":708},[622,2077,860],{"class":715},[622,2079,885],{"class":778},[622,2081,782],{"class":708},[622,2083,810],{"class":715},[622,2085,2086],{"class":631},"\u002Fcheckout",[622,2088,810],{"class":715},[622,2090,897],{"class":715},[622,2092,1935],{"class":715},[622,2094,915],{"class":833},[622,2096,918],{"class":715},[622,2098,2099,2102,2104,2106],{"class":624,"line":768},[622,2100,2101],{"class":704},"  throw",[622,2103,2052],{"class":778},[622,2105,782],{"class":791},[622,2107,785],{"class":715},[622,2109,2110,2113,2115,2117,2120,2122],{"class":624,"line":775},[622,2111,2112],{"class":791},"    message",[622,2114,795],{"class":715},[622,2116,716],{"class":715},[622,2118,2119],{"class":631},"Payment failed",[622,2121,810],{"class":715},[622,2123,2124],{"class":715},",\n",[622,2126,2127,2130,2132,2135],{"class":624,"line":788},[622,2128,2129],{"class":791},"    status",[622,2131,795],{"class":715},[622,2133,2134],{"class":1010}," 402",[622,2136,2124],{"class":715},[622,2138,2139,2142,2144,2146,2149,2151],{"class":624,"line":816},[622,2140,2141],{"class":791},"    why",[622,2143,795],{"class":715},[622,2145,716],{"class":715},[622,2147,2148],{"class":631},"Card declined by issuer",[622,2150,810],{"class":715},[622,2152,2124],{"class":715},[622,2154,2155,2158,2160,2162,2165,2167],{"class":624,"line":825},[622,2156,2157],{"class":791},"    fix",[622,2159,795],{"class":715},[622,2161,716],{"class":715},[622,2163,2164],{"class":631},"Try a different payment method",[622,2166,810],{"class":715},[622,2168,2124],{"class":715},[622,2170,2171,2174,2176,2178,2181,2183],{"class":624,"line":830},[622,2172,2173],{"class":791},"    link",[622,2175,795],{"class":715},[622,2177,716],{"class":715},[622,2179,2180],{"class":631},"https:\u002F\u002Fdocs.example.com\u002Fpayments\u002Fdeclined",[622,2182,810],{"class":715},[622,2184,2124],{"class":715},[622,2186,2187,2189],{"class":624,"line":849},[622,2188,1986],{"class":715},[622,2190,822],{"class":791},[622,2192,2193,2195],{"class":624,"line":854},[622,2194,819],{"class":715},[622,2196,822],{"class":708},[622,2198,2199],{"class":624,"line":873},[622,2200,772],{"emptyLinePlaceholder":771},[622,2202,2203,2205,2207,2209,2211,2213,2216,2218,2220,2222,2224,2226,2229,2231,2233],{"class":624,"line":878},[622,2204,857],{"class":708},[622,2206,860],{"class":715},[622,2208,863],{"class":778},[622,2210,782],{"class":708},[622,2212,782],{"class":715},[622,2214,2215],{"class":903},"err",[622,2217,897],{"class":715},[622,2219,1104],{"class":903},[622,2221,897],{"class":715},[622,2223,909],{"class":903},[622,2225,897],{"class":715},[622,2227,2228],{"class":903}," next",[622,2230,912],{"class":715},[622,2232,915],{"class":833},[622,2234,918],{"class":715},[622,2236,2237,2239,2241,2243,2245,2248,2250,2252],{"class":624,"line":921},[622,2238,924],{"class":708},[622,2240,860],{"class":715},[622,2242,929],{"class":708},[622,2244,860],{"class":715},[622,2246,2247],{"class":778},"error",[622,2249,782],{"class":791},[622,2251,2215],{"class":708},[622,2253,822],{"class":791},[622,2255,2256,2258,2261,2263,2265,2267,2269],{"class":624,"line":958},[622,2257,1095],{"class":833},[622,2259,2260],{"class":708}," parsed",[622,2262,1101],{"class":715},[622,2264,2057],{"class":778},[622,2266,782],{"class":791},[622,2268,2215],{"class":708},[622,2270,822],{"class":791},[622,2272,2273],{"class":624,"line":986},[622,2274,772],{"emptyLinePlaceholder":771},[622,2276,2277,2279,2281,2284,2286,2289,2291,2293,2295,2297,2299,2301],{"class":624,"line":993},[622,2278,961],{"class":708},[622,2280,860],{"class":715},[622,2282,2283],{"class":778},"status",[622,2285,782],{"class":791},[622,2287,2288],{"class":708},"parsed",[622,2290,860],{"class":715},[622,2292,2283],{"class":708},[622,2294,912],{"class":791},[622,2296,860],{"class":715},[622,2298,966],{"class":778},[622,2300,782],{"class":791},[622,2302,785],{"class":715},[622,2304,2305,2307,2309,2311,2313,2316],{"class":624,"line":998},[622,2306,2112],{"class":791},[622,2308,795],{"class":715},[622,2310,2260],{"class":708},[622,2312,860],{"class":715},[622,2314,2315],{"class":708},"message",[622,2317,2124],{"class":715},[622,2319,2321,2323,2325,2327,2329,2331],{"class":624,"line":2320},19,[622,2322,2141],{"class":791},[622,2324,795],{"class":715},[622,2326,2260],{"class":708},[622,2328,860],{"class":715},[622,2330,2029],{"class":708},[622,2332,2124],{"class":715},[622,2334,2336,2338,2340,2342,2344,2346],{"class":624,"line":2335},20,[622,2337,2157],{"class":791},[622,2339,795],{"class":715},[622,2341,2260],{"class":708},[622,2343,860],{"class":715},[622,2345,2033],{"class":708},[622,2347,2124],{"class":715},[622,2349,2351,2353,2355,2357,2359,2361],{"class":624,"line":2350},21,[622,2352,2173],{"class":791},[622,2354,795],{"class":715},[622,2356,2260],{"class":708},[622,2358,860],{"class":715},[622,2360,2037],{"class":708},[622,2362,2124],{"class":715},[622,2364,2366,2368],{"class":624,"line":2365},22,[622,2367,1986],{"class":715},[622,2369,822],{"class":791},[622,2371,2373,2375],{"class":624,"line":2372},23,[622,2374,819],{"class":715},[622,2376,822],{"class":708},[540,2378,2379],{},"The error is captured and logged with both the custom context and structured error fields:",[612,2381,2383],{"className":614,"code":2382,"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,2384,2385,2396,2418],{"__ignoreMap":618},[622,2386,2387,2390,2393],{"class":624,"line":625},[622,2388,2389],{"class":628},"14:58:20",[622,2391,2392],{"class":631}," ERROR",[622,2394,2395],{"class":708}," [my-api] GET \u002Fcheckout 402 in 3ms\n",[622,2397,2398,2400,2403,2406,2409,2412,2415],{"class":624,"line":725},[622,2399,1381],{"class":628},[622,2401,2402],{"class":631}," error:",[622,2404,2405],{"class":631}," name=EvlogError",[622,2407,2408],{"class":631}," message=Payment",[622,2410,2411],{"class":631}," failed",[622,2413,2414],{"class":631}," status=",[622,2416,2417],{"class":1010},"402\n",[622,2419,2420,2422,2424],{"class":624,"line":749},[622,2421,1417],{"class":628},[622,2423,1420],{"class":631},[622,2425,2426],{"class":631}," 880a50ac-...\n",[600,2428,504],{"id":2429},"configuration",[540,2431,2432,2433,2436,2437,2439],{},"See the ",[589,2434,2435],{"href":505},"Configuration reference"," for all available options (",[544,2438,779],{},", middleware options, sampling, silent mode, etc.).",[600,2441,2443],{"id":2442},"drain-enrichers","Drain & Enrichers",[540,2445,2446],{},"Configure drain adapters and enrichers directly in the middleware options:",[612,2448,2450],{"className":694,"code":2449,"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,2451,2452,2472,2492,2496,2509,2513,2529,2543,2561,2572,2602,2607],{"__ignoreMap":618},[622,2453,2454,2456,2458,2461,2463,2465,2467,2470],{"class":624,"line":625},[622,2455,705],{"class":704},[622,2457,730],{"class":715},[622,2459,2460],{"class":708}," createAxiomDrain",[622,2462,736],{"class":715},[622,2464,739],{"class":704},[622,2466,716],{"class":715},[622,2468,2469],{"class":631},"evlog\u002Faxiom",[622,2471,722],{"class":715},[622,2473,2474,2476,2478,2481,2483,2485,2487,2490],{"class":624,"line":725},[622,2475,705],{"class":704},[622,2477,730],{"class":715},[622,2479,2480],{"class":708}," createUserAgentEnricher",[622,2482,736],{"class":715},[622,2484,739],{"class":704},[622,2486,716],{"class":715},[622,2488,2489],{"class":631},"evlog\u002Fenrichers",[622,2491,722],{"class":715},[622,2493,2494],{"class":624,"line":749},[622,2495,772],{"emptyLinePlaceholder":771},[622,2497,2498,2500,2503,2505,2507],{"class":624,"line":768},[622,2499,834],{"class":833},[622,2501,2502],{"class":708}," userAgent ",[622,2504,840],{"class":715},[622,2506,2480],{"class":778},[622,2508,846],{"class":708},[622,2510,2511],{"class":624,"line":775},[622,2512,772],{"emptyLinePlaceholder":771},[622,2514,2515,2517,2519,2521,2523,2525,2527],{"class":624,"line":788},[622,2516,857],{"class":708},[622,2518,860],{"class":715},[622,2520,863],{"class":778},[622,2522,782],{"class":708},[622,2524,744],{"class":778},[622,2526,782],{"class":708},[622,2528,785],{"class":715},[622,2530,2531,2534,2536,2538,2541],{"class":624,"line":816},[622,2532,2533],{"class":791},"  drain",[622,2535,795],{"class":715},[622,2537,2460],{"class":778},[622,2539,2540],{"class":708},"()",[622,2542,2124],{"class":715},[622,2544,2545,2548,2550,2552,2555,2557,2559],{"class":624,"line":825},[622,2546,2547],{"class":778},"  enrich",[622,2549,795],{"class":715},[622,2551,900],{"class":715},[622,2553,2554],{"class":903},"ctx",[622,2556,912],{"class":715},[622,2558,915],{"class":833},[622,2560,918],{"class":715},[622,2562,2563,2566,2568,2570],{"class":624,"line":830},[622,2564,2565],{"class":778},"    userAgent",[622,2567,782],{"class":791},[622,2569,2554],{"class":708},[622,2571,822],{"class":791},[622,2573,2574,2577,2579,2582,2584,2587,2589,2592,2594,2597,2599],{"class":624,"line":849},[622,2575,2576],{"class":708},"    ctx",[622,2578,860],{"class":715},[622,2580,2581],{"class":708},"event",[622,2583,860],{"class":715},[622,2585,2586],{"class":708},"region",[622,2588,1101],{"class":715},[622,2590,2591],{"class":708}," process",[622,2593,860],{"class":715},[622,2595,2596],{"class":708},"env",[622,2598,860],{"class":715},[622,2600,2601],{"class":708},"FLY_REGION\n",[622,2603,2604],{"class":624,"line":854},[622,2605,2606],{"class":715},"  },\n",[622,2608,2609,2611],{"class":624,"line":873},[622,2610,819],{"class":715},[622,2612,2613],{"class":708},"))\n",[604,2615,2617],{"id":2616},"pipeline-batching-retry","Pipeline (Batching & Retry)",[540,2619,2620,2621,2624],{},"For production, wrap your adapter with ",[544,2622,2623],{},"createDrainPipeline"," to batch events and retry on failure:",[612,2626,2628],{"className":694,"code":2627,"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,2629,2630,2652,2670,2690,2694,2718,2747,2766,2772,2791,2795],{"__ignoreMap":618},[622,2631,2632,2634,2637,2639,2642,2644,2646,2648,2650],{"class":624,"line":625},[622,2633,705],{"class":704},[622,2635,2636],{"class":704}," type",[622,2638,730],{"class":715},[622,2640,2641],{"class":708}," DrainContext",[622,2643,736],{"class":715},[622,2645,739],{"class":704},[622,2647,716],{"class":715},[622,2649,744],{"class":631},[622,2651,722],{"class":715},[622,2653,2654,2656,2658,2660,2662,2664,2666,2668],{"class":624,"line":725},[622,2655,705],{"class":704},[622,2657,730],{"class":715},[622,2659,2460],{"class":708},[622,2661,736],{"class":715},[622,2663,739],{"class":704},[622,2665,716],{"class":715},[622,2667,2469],{"class":631},[622,2669,722],{"class":715},[622,2671,2672,2674,2676,2679,2681,2683,2685,2688],{"class":624,"line":749},[622,2673,705],{"class":704},[622,2675,730],{"class":715},[622,2677,2678],{"class":708}," createDrainPipeline",[622,2680,736],{"class":715},[622,2682,739],{"class":704},[622,2684,716],{"class":715},[622,2686,2687],{"class":631},"evlog\u002Fpipeline",[622,2689,722],{"class":715},[622,2691,2692],{"class":624,"line":768},[622,2693,772],{"emptyLinePlaceholder":771},[622,2695,2696,2698,2701,2703,2705,2708,2711,2714,2716],{"class":624,"line":775},[622,2697,834],{"class":833},[622,2699,2700],{"class":708}," pipeline ",[622,2702,840],{"class":715},[622,2704,2678],{"class":778},[622,2706,2707],{"class":715},"\u003C",[622,2709,2710],{"class":628},"DrainContext",[622,2712,2713],{"class":715},">",[622,2715,782],{"class":708},[622,2717,785],{"class":715},[622,2719,2720,2723,2725,2727,2730,2732,2735,2737,2740,2742,2745],{"class":624,"line":788},[622,2721,2722],{"class":791},"  batch",[622,2724,795],{"class":715},[622,2726,730],{"class":715},[622,2728,2729],{"class":791}," size",[622,2731,795],{"class":715},[622,2733,2734],{"class":1010}," 50",[622,2736,897],{"class":715},[622,2738,2739],{"class":791}," intervalMs",[622,2741,795],{"class":715},[622,2743,2744],{"class":1010}," 5000",[622,2746,813],{"class":715},[622,2748,2749,2752,2754,2756,2759,2761,2764],{"class":624,"line":816},[622,2750,2751],{"class":791},"  retry",[622,2753,795],{"class":715},[622,2755,730],{"class":715},[622,2757,2758],{"class":791}," maxAttempts",[622,2760,795],{"class":715},[622,2762,2763],{"class":1010}," 3",[622,2765,813],{"class":715},[622,2767,2768,2770],{"class":624,"line":825},[622,2769,819],{"class":715},[622,2771,822],{"class":708},[622,2773,2774,2776,2779,2781,2784,2786,2789],{"class":624,"line":830},[622,2775,834],{"class":833},[622,2777,2778],{"class":708}," drain ",[622,2780,840],{"class":715},[622,2782,2783],{"class":778}," pipeline",[622,2785,782],{"class":708},[622,2787,2788],{"class":778},"createAxiomDrain",[622,2790,870],{"class":708},[622,2792,2793],{"class":624,"line":849},[622,2794,772],{"emptyLinePlaceholder":771},[622,2796,2797,2799,2801,2803,2805,2807,2809,2811,2813,2815],{"class":624,"line":854},[622,2798,857],{"class":708},[622,2800,860],{"class":715},[622,2802,863],{"class":778},[622,2804,782],{"class":708},[622,2806,744],{"class":778},[622,2808,782],{"class":708},[622,2810,939],{"class":715},[622,2812,2778],{"class":708},[622,2814,819],{"class":715},[622,2816,2613],{"class":708},[1015,2818,2819,2820,2823,2824,2827],{"color":1017,"icon":13},"Call ",[544,2821,2822],{},"drain.flush()"," on server shutdown to ensure all buffered events are sent. See the ",[589,2825,2826],{"href":496},"Pipeline docs"," for all options.",[600,2829,2831],{"id":2830},"tail-sampling","Tail Sampling",[540,2833,1430,2834,2837],{},[544,2835,2836],{},"keep"," to force-retain specific events regardless of head sampling:",[612,2839,2841],{"className":694,"code":2840,"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,2842,2843,2859,2871,2888,2932,2936],{"__ignoreMap":618},[622,2844,2845,2847,2849,2851,2853,2855,2857],{"class":624,"line":625},[622,2846,857],{"class":708},[622,2848,860],{"class":715},[622,2850,863],{"class":778},[622,2852,782],{"class":708},[622,2854,744],{"class":778},[622,2856,782],{"class":708},[622,2858,785],{"class":715},[622,2860,2861,2863,2865,2867,2869],{"class":624,"line":725},[622,2862,2533],{"class":791},[622,2864,795],{"class":715},[622,2866,2460],{"class":778},[622,2868,2540],{"class":708},[622,2870,2124],{"class":715},[622,2872,2873,2876,2878,2880,2882,2884,2886],{"class":624,"line":749},[622,2874,2875],{"class":778},"  keep",[622,2877,795],{"class":715},[622,2879,900],{"class":715},[622,2881,2554],{"class":903},[622,2883,912],{"class":715},[622,2885,915],{"class":833},[622,2887,918],{"class":715},[622,2889,2890,2893,2895,2897,2899,2902,2905,2908,2910,2912,2915,2918,2920,2922,2924,2927,2929],{"class":624,"line":768},[622,2891,2892],{"class":704},"    if",[622,2894,900],{"class":791},[622,2896,2554],{"class":708},[622,2898,860],{"class":715},[622,2900,2901],{"class":708},"duration",[622,2903,2904],{"class":715}," &&",[622,2906,2907],{"class":708}," ctx",[622,2909,860],{"class":715},[622,2911,2901],{"class":708},[622,2913,2914],{"class":715}," >",[622,2916,2917],{"class":1010}," 2000",[622,2919,1318],{"class":791},[622,2921,2554],{"class":708},[622,2923,860],{"class":715},[622,2925,2926],{"class":708},"shouldKeep",[622,2928,1101],{"class":715},[622,2930,2931],{"class":978}," true\n",[622,2933,2934],{"class":624,"line":775},[622,2935,2606],{"class":715},[622,2937,2938,2940],{"class":624,"line":788},[622,2939,819],{"class":715},[622,2941,2613],{"class":708},[600,2943,2945],{"id":2944},"route-filtering","Route Filtering",[540,2947,2948,2949,1736,2952,2955],{},"Control which routes are logged with ",[544,2950,2951],{},"include",[544,2953,2954],{},"exclude"," patterns:",[612,2957,2959],{"className":694,"code":2958,"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,2960,2961,2977,2999,3027,3036,3063,3089,3093],{"__ignoreMap":618},[622,2962,2963,2965,2967,2969,2971,2973,2975],{"class":624,"line":625},[622,2964,857],{"class":708},[622,2966,860],{"class":715},[622,2968,863],{"class":778},[622,2970,782],{"class":708},[622,2972,744],{"class":778},[622,2974,782],{"class":708},[622,2976,785],{"class":715},[622,2978,2979,2982,2984,2987,2989,2992,2994,2997],{"class":624,"line":725},[622,2980,2981],{"class":791},"  include",[622,2983,795],{"class":715},[622,2985,2986],{"class":708}," [",[622,2988,810],{"class":715},[622,2990,2991],{"class":631},"\u002Fapi\u002F**",[622,2993,810],{"class":715},[622,2995,2996],{"class":708},"]",[622,2998,2124],{"class":715},[622,3000,3001,3004,3006,3008,3010,3013,3015,3017,3019,3021,3023,3025],{"class":624,"line":749},[622,3002,3003],{"class":791},"  exclude",[622,3005,795],{"class":715},[622,3007,2986],{"class":708},[622,3009,810],{"class":715},[622,3011,3012],{"class":631},"\u002F_internal\u002F**",[622,3014,810],{"class":715},[622,3016,897],{"class":715},[622,3018,716],{"class":715},[622,3020,892],{"class":631},[622,3022,810],{"class":715},[622,3024,2996],{"class":708},[622,3026,2124],{"class":715},[622,3028,3029,3032,3034],{"class":624,"line":768},[622,3030,3031],{"class":791},"  routes",[622,3033,795],{"class":715},[622,3035,918],{"class":715},[622,3037,3038,3041,3044,3046,3048,3050,3052,3054,3056,3059,3061],{"class":624,"line":775},[622,3039,3040],{"class":715},"    '",[622,3042,3043],{"class":791},"\u002Fapi\u002Fauth\u002F**",[622,3045,810],{"class":715},[622,3047,795],{"class":715},[622,3049,730],{"class":715},[622,3051,800],{"class":791},[622,3053,795],{"class":715},[622,3055,716],{"class":715},[622,3057,3058],{"class":631},"auth-service",[622,3060,810],{"class":715},[622,3062,813],{"class":715},[622,3064,3065,3067,3070,3072,3074,3076,3078,3080,3082,3085,3087],{"class":624,"line":788},[622,3066,3040],{"class":715},[622,3068,3069],{"class":791},"\u002Fapi\u002Fpayment\u002F**",[622,3071,810],{"class":715},[622,3073,795],{"class":715},[622,3075,730],{"class":715},[622,3077,800],{"class":791},[622,3079,795],{"class":715},[622,3081,716],{"class":715},[622,3083,3084],{"class":631},"payment-service",[622,3086,810],{"class":715},[622,3088,813],{"class":715},[622,3090,3091],{"class":624,"line":816},[622,3092,2606],{"class":715},[622,3094,3095,3097],{"class":624,"line":825},[622,3096,819],{"class":715},[622,3098,2613],{"class":708},[600,3100,3102],{"id":3101},"client-side-logging","Client-Side Logging",[540,3104,1430,3105,3108],{},[544,3106,3107],{},"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,3110,3112],{"id":3111},"browser-setup","Browser setup",[612,3114,3117],{"className":694,"code":3115,"filename":3116,"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,3118,3119,3141,3160,3164,3178,3200,3206,3220,3224],{"__ignoreMap":618},[622,3120,3121,3123,3125,3127,3129,3131,3133,3135,3137,3139],{"class":624,"line":625},[622,3122,705],{"class":704},[622,3124,730],{"class":715},[622,3126,733],{"class":708},[622,3128,897],{"class":715},[622,3130,1499],{"class":708},[622,3132,736],{"class":715},[622,3134,739],{"class":704},[622,3136,716],{"class":715},[622,3138,744],{"class":631},[622,3140,722],{"class":715},[622,3142,3143,3145,3147,3150,3152,3154,3156,3158],{"class":624,"line":725},[622,3144,705],{"class":704},[622,3146,730],{"class":715},[622,3148,3149],{"class":708}," createHttpLogDrain",[622,3151,736],{"class":715},[622,3153,739],{"class":704},[622,3155,716],{"class":715},[622,3157,3107],{"class":631},[622,3159,722],{"class":715},[622,3161,3162],{"class":624,"line":749},[622,3163,772],{"emptyLinePlaceholder":771},[622,3165,3166,3168,3170,3172,3174,3176],{"class":624,"line":768},[622,3167,834],{"class":833},[622,3169,2778],{"class":708},[622,3171,840],{"class":715},[622,3173,3149],{"class":778},[622,3175,782],{"class":708},[622,3177,785],{"class":715},[622,3179,3180,3182,3184,3186,3189,3191,3193,3196,3198],{"class":624,"line":775},[622,3181,2533],{"class":791},[622,3183,795],{"class":715},[622,3185,730],{"class":715},[622,3187,3188],{"class":791}," endpoint",[622,3190,795],{"class":715},[622,3192,716],{"class":715},[622,3194,3195],{"class":631},"\u002Fv1\u002Fingest",[622,3197,810],{"class":715},[622,3199,813],{"class":715},[622,3201,3202,3204],{"class":624,"line":788},[622,3203,819],{"class":715},[622,3205,822],{"class":708},[622,3207,3208,3210,3212,3214,3216,3218],{"class":624,"line":816},[622,3209,779],{"class":778},[622,3211,782],{"class":708},[622,3213,939],{"class":715},[622,3215,2778],{"class":708},[622,3217,819],{"class":715},[622,3219,822],{"class":708},[622,3221,3222],{"class":624,"line":825},[622,3223,772],{"emptyLinePlaceholder":771},[622,3225,3226,3228,3230,3232,3234,3236,3239,3241,3243,3246,3248,3250,3253,3255,3258,3260,3263,3265],{"class":624,"line":830},[622,3227,929],{"class":708},[622,3229,860],{"class":715},[622,3231,1017],{"class":778},[622,3233,782],{"class":708},[622,3235,939],{"class":715},[622,3237,3238],{"class":791}," action",[622,3240,795],{"class":715},[622,3242,716],{"class":715},[622,3244,3245],{"class":631},"page_view",[622,3247,810],{"class":715},[622,3249,897],{"class":715},[622,3251,3252],{"class":791}," path",[622,3254,795],{"class":715},[622,3256,3257],{"class":708}," location",[622,3259,860],{"class":715},[622,3261,3262],{"class":708},"pathname ",[622,3264,819],{"class":715},[622,3266,822],{"class":708},[604,3268,3270],{"id":3269},"ingest-endpoint","Ingest endpoint",[540,3272,3273,3274,3277],{},"Add a POST route to receive batched ",[544,3275,3276],{},"DrainContext[]"," from the browser:",[612,3279,3281],{"className":694,"code":3280,"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,3282,3283,3303,3307,3349,3373,3393,3431,3436,3452],{"__ignoreMap":618},[622,3284,3285,3287,3289,3291,3293,3295,3297,3299,3301],{"class":624,"line":625},[622,3286,705],{"class":704},[622,3288,2636],{"class":704},[622,3290,730],{"class":715},[622,3292,2641],{"class":708},[622,3294,736],{"class":715},[622,3296,739],{"class":704},[622,3298,716],{"class":715},[622,3300,744],{"class":631},[622,3302,722],{"class":715},[622,3304,3305],{"class":624,"line":725},[622,3306,772],{"emptyLinePlaceholder":771},[622,3308,3309,3311,3313,3315,3317,3319,3321,3323,3325,3327,3329,3331,3333,3335,3337,3339,3341,3343,3345,3347],{"class":624,"line":749},[622,3310,857],{"class":708},[622,3312,860],{"class":715},[622,3314,1846],{"class":778},[622,3316,782],{"class":708},[622,3318,810],{"class":715},[622,3320,3195],{"class":631},[622,3322,810],{"class":715},[622,3324,897],{"class":715},[622,3326,843],{"class":708},[622,3328,860],{"class":715},[622,3330,966],{"class":778},[622,3332,2540],{"class":708},[622,3334,897],{"class":715},[622,3336,900],{"class":715},[622,3338,904],{"class":903},[622,3340,897],{"class":715},[622,3342,909],{"class":903},[622,3344,912],{"class":715},[622,3346,915],{"class":833},[622,3348,918],{"class":715},[622,3350,3351,3353,3356,3358,3360,3362,3365,3368,3370],{"class":624,"line":768},[622,3352,1095],{"class":833},[622,3354,3355],{"class":708}," batch",[622,3357,1101],{"class":715},[622,3359,1104],{"class":708},[622,3361,860],{"class":715},[622,3363,3364],{"class":708},"body",[622,3366,3367],{"class":704}," as",[622,3369,2641],{"class":628},[622,3371,3372],{"class":791},"[]\n",[622,3374,3375,3378,3380,3382,3384,3387,3389,3391],{"class":624,"line":775},[622,3376,3377],{"class":704},"  for",[622,3379,900],{"class":791},[622,3381,834],{"class":833},[622,3383,2907],{"class":708},[622,3385,3386],{"class":715}," of",[622,3388,3355],{"class":708},[622,3390,1318],{"class":791},[622,3392,785],{"class":715},[622,3394,3395,3398,3400,3402,3404,3406,3409,3411,3413,3416,3418,3421,3423,3425,3427,3429],{"class":624,"line":788},[622,3396,3397],{"class":708},"    console",[622,3399,860],{"class":715},[622,3401,929],{"class":778},[622,3403,782],{"class":791},[622,3405,810],{"class":715},[622,3407,3408],{"class":631},"[BROWSER]",[622,3410,810],{"class":715},[622,3412,897],{"class":715},[622,3414,3415],{"class":708}," JSON",[622,3417,860],{"class":715},[622,3419,3420],{"class":778},"stringify",[622,3422,782],{"class":791},[622,3424,2554],{"class":708},[622,3426,860],{"class":715},[622,3428,2581],{"class":708},[622,3430,2613],{"class":791},[622,3432,3433],{"class":624,"line":816},[622,3434,3435],{"class":715},"  }\n",[622,3437,3438,3440,3442,3445,3447,3450],{"class":624,"line":825},[622,3439,961],{"class":708},[622,3441,860],{"class":715},[622,3443,3444],{"class":778},"sendStatus",[622,3446,782],{"class":791},[622,3448,3449],{"class":1010},"204",[622,3451,822],{"class":791},[622,3453,3454,3456],{"class":624,"line":830},[622,3455,819],{"class":715},[622,3457,822],{"class":708},[1015,3459,3462,3463,3467],{"color":3460,"icon":3461},"neutral","i-lucide-globe","See the full ",[589,3464,3466],{"href":3465},"\u002Fextend\u002Fdrain-pipeline#http-drain-browser-to-server","HTTP drain"," adapter docs for batching, retry, sendBeacon fallback, and authentication options.",[600,3469,3471],{"id":3470},"run-locally","Run Locally",[612,3473,3476],{"className":614,"code":3474,"filename":3475,"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,3477,3478,3489,3497,3504],{"__ignoreMap":618},[622,3479,3480,3483,3486],{"class":624,"line":625},[622,3481,3482],{"class":628},"git",[622,3484,3485],{"class":631}," clone",[622,3487,3488],{"class":631}," https:\u002F\u002Fgithub.com\u002Fhugorcd\u002Fevlog.git\n",[622,3490,3491,3494],{"class":624,"line":725},[622,3492,3493],{"class":778},"cd",[622,3495,3496],{"class":631}," evlog\n",[622,3498,3499,3501],{"class":624,"line":749},[622,3500,616],{"class":628},[622,3502,3503],{"class":631}," install\n",[622,3505,3506,3508,3511],{"class":624,"line":768},[622,3507,616],{"class":628},[622,3509,3510],{"class":631}," example",[622,3512,638],{"class":631},[540,3514,3515,3516,3520],{},"Open ",[589,3517,3518],{"href":3518,"rel":3519},"http:\u002F\u002Flocalhost:3000",[593]," to explore the interactive test UI.",[3522,3523,3524],"card-group",{},[3525,3526,3530],"card",{"icon":3527,"title":3528,"to":3529},"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,3532,3534],{"id":3533},"next-steps","Next Steps",[540,3536,3537,3538,3540],{},"Deepen your ",[1019,3539,260],{}," integration:",[561,3542,3543,3548,3553,3558],{},[564,3544,3545,3547],{},[589,3546,46],{"href":47},": Design comprehensive events with context layering",[564,3549,3550,3552],{},[589,3551,138],{"href":143},": Send logs to Axiom, Sentry, PostHog, and more",[564,3554,3555,3557],{},[589,3556,61],{"href":62},": Control log volume with head and tail sampling",[564,3559,3560,3562,3563,2030,3565,2034,3567,3569],{},[589,3561,51],{"href":52},": Throw errors with ",[544,3564,2029],{},[544,3566,2033],{},[544,3568,2037],{}," fields",[3571,3572,3573],"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":3575},[3576,3580,3581,3582,3584,3585,3586,3589,3590,3591,3595,3596],{"id":602,"depth":725,"text":25,"children":3577},[3578,3579],{"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":3583},"Background work (log.fork)",{"id":2019,"depth":725,"text":2020},{"id":2429,"depth":725,"text":504},{"id":2442,"depth":725,"text":2443,"children":3587},[3588],{"id":2616,"depth":749,"text":2617},{"id":2830,"depth":725,"text":2831},{"id":2944,"depth":725,"text":2945},{"id":3101,"depth":725,"text":3102,"children":3592},[3593,3594],{"id":3111,"depth":749,"text":3112},{"id":3269,"depth":749,"text":3270},{"id":3470,"depth":725,"text":3471},{"id":3533,"depth":725,"text":3534},"Automatic wide events, structured errors, drain adapters, enrichers, and tail sampling in Express applications.","md",[3600],{"label":3528,"icon":3527,"to":3529,"color":3460,"variant":3601},"subtle",{},{"title":260,"icon":263},{"title":260,"description":3597},"Wv0cOEi12wkTLyYPM_MnvX1x8lF-ynyKQWV5ZUxsno0",[3607,3609],{"title":255,"path":256,"stem":257,"description":3608,"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":3610,"icon":268,"children":-1},"Automatic wide events, structured errors, drain adapters, enrichers, and tail sampling in Hono applications.",1786743661786]