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