[{"data":1,"prerenderedAt":3077},["ShallowReactive",2],{"navigation_docs":3,"-extend-custom-framework":529,"-extend-custom-framework-surround":3072},[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],{"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",{"id":530,"title":531,"body":532,"description":3062,"extension":3063,"links":3064,"meta":3068,"navigation":3069,"path":456,"seo":3070,"stem":457,"__hash__":3071},"docs\u002F6.extend\u002F10.custom-framework.md","Custom Framework Integration",{"type":533,"value":534,"toc":3049},"minimark",[535,548,556,566,649,812,817,888,892,1108,1131,1135,1144,1969,1975,1983,1986,2046,2049,2053,2065,2175,2189,2193,2205,2213,2330,2345,2587,2597,2601,2608,2858,2865,2869,2872,2996,3007,3011,3045],[536,537,538,539,543,544,547],"p",{},"When the framework you use doesn't have an ",[540,541,542],"code",{},"evlog\u002F\u003Cframework>"," package yet, you build the integration yourself. ",[540,545,546],{},"evlog\u002Ftoolkit"," ships the same building blocks that power every built-in integration (Hono, Express, Fastify, Elysia, NestJS, SvelteKit) — you only write the framework-specific glue.",[536,549,550,551,555],{},"The mental model is always the same: ",[552,553,554],"strong",{},"request lifecycle → logger creation → enrich → drain",". The toolkit handles the request-context plumbing.",[557,558,561,562,565],"callout",{"color":559,"icon":560},"warning","i-lucide-flask-conical","The toolkit API is marked as ",[552,563,564],{},"beta",". The surface is stable (used by all built-in integrations) but may evolve based on community feedback.",[567,568,569,585],"table",{},[570,571,572],"thead",{},[573,574,575,579,582],"tr",{},[576,577,578],"th",{},"Surface",[576,580,581],{},"What it does",[576,583,584],{},"When to use",[586,587,588,610,633],"tbody",{},[573,589,590,600,603],{},[591,592,593],"td",{},[594,595,597],"a",{"href":596},"#manifest-mode-recommended",[540,598,599],{},"defineFrameworkIntegration()",[591,601,602],{},"Declaratively wire request extraction + logger attachment",[591,604,605,606,609],{},"HTTP frameworks with a ",[540,607,608],{},"(ctx, next)"," middleware shape (Hono, Express, Fastify, Elysia, NestJS-shaped)",[573,611,612,620,623],{},[591,613,614],{},[594,615,617],{"href":616},"#custom-mode",[540,618,619],{},"createMiddlewareLogger()",[591,621,622],{},"Imperative path: create the logger at request start, emit on response end",[591,624,625,626,628,629,632],{},"Frameworks whose lifecycle doesn't fit ",[540,627,608],{}," (NestJS interceptors, Next.js App Router, SvelteKit ",[540,630,631],{},"handle",")",[573,634,635,643,646],{},[591,636,637],{},[594,638,640],{"href":639},"#non-http-runtimes",[540,641,642],{},"createRequestLogger()",[591,644,645],{},"Wrap any unit of work in a logger lifecycle",[591,647,648],{},"Non-HTTP runtimes (queue workers, CLI, cron, durable workflows)",[650,651,654,657,804],"prompt",{":actions":652,"description":653,"icon":458},"[\"copy\",\"cursor\",\"claude\"]","Build an evlog integration for a custom framework",[536,655,656],{},"Wire evlog into an HTTP framework (or non-HTTP runtime) that doesn't have a built-in integration.",[658,659,660,694,708,718,732,747,758,784,795],"ul",{},[661,662,663,664,666,667,670,671,673,674,677,678,681,682,685,686,689,690,693],"li",{},"For HTTP frameworks with ",[540,665,608],{},", use ",[540,668,669],{},"defineFrameworkIntegration"," from ",[540,672,546],{}," — declare ",[540,675,676],{},"extractRequest(ctx)"," returning ",[540,679,680],{},"{ method, path, headers, requestId? }",", ",[540,683,684],{},"attachLogger(ctx, logger)",", and an optional storage from ",[540,687,688],{},"createLoggerStorage()"," (prefer ",[540,691,692],{},"evlog\u002Ftoolkit\u002Fstorage"," on Workers \u002F edge)",[661,695,696,697,700,701,704,705,707],{},"Headers may be either Web ",[540,698,699],{},"Headers"," or Node ",[540,702,703],{},"IncomingHttpHeaders"," — ",[540,706,669],{}," normalizes both",[661,709,710,711,714,715],{},"In your middleware, call ",[540,712,713],{},"integration.start(ctx, options)"," which returns ",[540,716,717],{},"{ skipped, finish, runWith, logger, middlewareOptions }",[661,719,720,721,724,725,728,729],{},"If ",[540,722,723],{},"skipped"," is ",[540,726,727],{},"true",", skip directly to ",[540,730,731],{},"next",[661,733,734,735,738,739,742,743,746],{},"Run downstream handlers inside ",[540,736,737],{},"runWith(() => next())"," so ",[540,740,741],{},"AsyncLocalStorage"," and ",[540,744,745],{},"log.fork()"," work",[661,748,749,750,753,754,757],{},"On success: ",[540,751,752],{},"await finish({ status })","; on error: ",[540,755,756],{},"await finish({ error })"," then re-throw",[661,759,760,761,681,764,681,767,681,770,681,773,681,776,779,780,783],{},"Expose ",[540,762,763],{},"drain",[540,765,766],{},"enrich",[540,768,769],{},"keep",[540,771,772],{},"include",[540,774,775],{},"exclude",[540,777,778],{},"routes",", and ",[540,781,782],{},"plugins"," options",[661,785,786,787,790,791,794],{},"On Cloudflare Workers \u002F Vercel Edge, pass ",[540,788,789],{},"waitUntil"," (or ",[540,792,793],{},"extractWaitUntil"," on the manifest) so async drains complete after the response",[661,796,797,798,670,801,803],{},"For non-HTTP runtimes (queue workers, CLI, cron), use ",[540,799,800],{},"createRequestLogger",[540,802,546],{}," directly — wrap each unit of work in a logger lifecycle",[536,805,806,807],{},"Docs: ",[594,808,809],{"href":809,"rel":810},"https:\u002F\u002Fwww.evlog.dev\u002Fextend\u002Fcustom-framework",[811],"nofollow",[813,814,816],"h2",{"id":815},"install","Install",[818,819,820,845,859,873],"code-group",{},[821,822,828],"pre",{"className":823,"code":824,"filename":825,"language":826,"meta":827,"style":827},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","pnpm add evlog\n","pnpm","bash","",[540,829,830],{"__ignoreMap":827},[831,832,835,838,842],"span",{"class":833,"line":834},"line",1,[831,836,825],{"class":837},"sBMFI",[831,839,841],{"class":840},"sfazB"," add",[831,843,844],{"class":840}," evlog\n",[821,846,849],{"className":823,"code":847,"filename":848,"language":826,"meta":827,"style":827},"bun add evlog\n","bun",[540,850,851],{"__ignoreMap":827},[831,852,853,855,857],{"class":833,"line":834},[831,854,848],{"class":837},[831,856,841],{"class":840},[831,858,844],{"class":840},[821,860,863],{"className":823,"code":861,"filename":862,"language":826,"meta":827,"style":827},"yarn add evlog\n","yarn",[540,864,865],{"__ignoreMap":827},[831,866,867,869,871],{"class":833,"line":834},[831,868,862],{"class":837},[831,870,841],{"class":840},[831,872,844],{"class":840},[821,874,877],{"className":823,"code":875,"filename":876,"language":826,"meta":827,"style":827},"npm install evlog\n","npm",[540,878,879],{"__ignoreMap":827},[831,880,881,883,886],{"class":833,"line":834},[831,882,876],{"class":837},[831,884,885],{"class":840}," install",[831,887,844],{"class":840},[813,889,891],{"id":890},"whats-in-the-toolkit","What's in the toolkit",[567,893,894,904],{},[570,895,896],{},[573,897,898,901],{},[576,899,900],{},"Export",[576,902,903],{},"Purpose",[586,905,906,916,926,940,950,974,987,1000,1012,1035,1053,1067,1098],{},[573,907,908,913],{},[591,909,910],{},[540,911,912],{},"defineFrameworkIntegration(spec)",[591,914,915],{},"Manifest factory — extract request, create logger, attach, run with ALS",[573,917,918,923],{},[591,919,920],{},[540,921,922],{},"createMiddlewareLogger(opts)",[591,924,925],{},"Lower-level lifecycle (custom mode)",[573,927,928,933],{},[591,929,930,932],{},[540,931,789],{}," on middleware options",[591,934,935,936,632],{},"Defer drain on Cloudflare Workers \u002F Vercel Edge (see ",[594,937,939],{"href":938},"#serverless-workers-edge","Serverless",[573,941,942,947],{},[591,943,944],{},[540,945,946],{},"createRequestLogger(opts)",[591,948,949],{},"Wrap a non-HTTP unit of work in a logger lifecycle",[573,951,952,957],{},[591,953,954],{},[540,955,956],{},"BaseEvlogOptions",[591,958,959,960,681,962,681,964,681,966,681,968,681,970,681,972],{},"Base user-facing options — ",[540,961,763],{},[540,963,766],{},[540,965,769],{},[540,967,772],{},[540,969,775],{},[540,971,778],{},[540,973,782],{},[573,975,976,981],{},[591,977,978],{},[540,979,980],{},"MiddlewareLoggerResult",[591,982,983,984],{},"Return type: ",[540,985,986],{},"{ logger, finish, skipped }",[573,988,989,994],{},[591,990,991],{},[540,992,993],{},"extractSafeHeaders(headers)",[591,995,996,997,999],{},"Filter sensitive headers from a Web API ",[540,998,699],{}," object",[573,1001,1002,1007],{},[591,1003,1004],{},[540,1005,1006],{},"extractSafeNodeHeaders(headers)",[591,1008,1009,1010],{},"Filter sensitive headers from Node.js ",[540,1011,703],{},[573,1013,1014,1019],{},[591,1015,1016],{},[540,1017,1018],{},"createLoggerStorage(hint)",[591,1020,1021,1022,1025,1026,1028,1029,1031,1032,632],{},"Factory returning ",[540,1023,1024],{},"{ storage, useLogger }"," backed by ",[540,1027,741],{}," — also on ",[540,1030,692],{}," (prefer that entry on Workers \u002F edge to isolate ",[540,1033,1034],{},"node:async_hooks",[573,1036,1037,1042],{},[591,1038,1039],{},[540,1040,1041],{},"attachForkToLogger(storage, parent, opts)",[591,1043,1044,1045,1048,1049,1052],{},"Wires ",[540,1046,1047],{},"log.fork(label, fn)"," onto the request logger so consumers can spawn correlated background work — used by manifest mode automatically; call manually in custom mode after ",[540,1050,1051],{},"createMiddlewareLogger"," returns the logger and before the lifecycle finishes",[573,1054,1055,1060],{},[591,1056,1057],{},[540,1058,1059],{},"defineEvlog(config)",[591,1061,1062,1063,1066],{},"Canonical config object — works for ",[540,1064,1065],{},"initLogger"," and middleware options",[573,1068,1069,1074],{},[591,1070,1071],{},[540,1072,1073],{},"definePlugin(plugin)",[591,1075,1076,1077,681,1080,681,1082,681,1084,681,1086,681,1089,681,1092,681,1095],{},"Plugin contract — opt into any subset of ",[540,1078,1079],{},"setup",[540,1081,766],{},[540,1083,763],{},[540,1085,769],{},[540,1087,1088],{},"onRequestStart",[540,1090,1091],{},"onRequestFinish",[540,1093,1094],{},"onClientLog",[540,1096,1097],{},"extendLogger",[573,1099,1100,1105],{},[591,1101,1102],{},[540,1103,1104],{},"composeEnrichers \u002F composeDrains \u002F composeKeep \u002F composePlugins",[591,1106,1107],{},"Combine multiple extensions into one",[536,1109,1110,1111,681,1114,681,1117,681,1120,779,1123,1126,1127,1130],{},"Types like ",[540,1112,1113],{},"RequestLogger",[540,1115,1116],{},"DrainContext",[540,1118,1119],{},"EnrichContext",[540,1121,1122],{},"WideEvent",[540,1124,1125],{},"TailSamplingContext"," are exported from the main ",[540,1128,1129],{},"evlog"," package.",[813,1132,1134],{"id":1133},"manifest-mode-recommended","Manifest mode (recommended)",[536,1136,1137,1138,1140,1141,1143],{},"Most frameworks fit a ",[540,1139,608],{}," middleware shape. For those, write a manifest describing how to extract the request and attach the logger — ",[540,1142,669],{}," does the rest.",[1145,1146,1147],"code-collapse",{},[821,1148,1153],{"className":1149,"code":1150,"filename":1151,"language":1152,"meta":827,"style":827},"language-typescript shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import type { IncomingMessage, ServerResponse } from 'node:http'\nimport {\n  createLoggerStorage,\n  defineFrameworkIntegration,\n  type BaseEvlogOptions,\n} from 'evlog\u002Ftoolkit'\n\u002F\u002F On Workers \u002F edge, prefer: import { createLoggerStorage } from 'evlog\u002Ftoolkit\u002Fstorage'\nimport type { RequestLogger } from 'evlog'\n\nexport type MyFrameworkEvlogOptions = BaseEvlogOptions\n\nconst { storage, useLogger } = createLoggerStorage(\n  'Cannot access logger outside of middleware context. Make sure evlog middleware is registered before your routes.',\n)\n\nexport { useLogger }\n\nconst integration = defineFrameworkIntegration\u003CIncomingMessage>({\n  name: 'my-framework',\n  extractRequest: (req) => ({\n    method: req.method || 'GET',\n    path: req.url || '\u002F',\n    headers: req.headers,\n    requestId: typeof req.headers['x-request-id'] === 'string'\n      ? req.headers['x-request-id']\n      : undefined,\n  }),\n  attachLogger: (req, logger) => {\n    (req as IncomingMessage & { log: RequestLogger }).log = logger\n  },\n  storage,\n})\n\nexport function evlog(options: MyFrameworkEvlogOptions = {}) {\n  return async (req: IncomingMessage, res: ServerResponse, next: () => Promise\u003Cvoid>) => {\n    const { skipped, finish, runWith } = integration.start(req, options)\n    if (skipped) {\n      await next()\n      return\n    }\n    try {\n      await runWith(() => next())\n      await finish({ status: res.statusCode })\n    } catch (error) {\n      await finish({ error: error as Error })\n      throw error\n    }\n  }\n}\n","my-framework-evlog.ts","typescript",[540,1154,1155,1193,1201,1210,1218,1229,1243,1250,1272,1279,1297,1302,1329,1343,1349,1354,1367,1372,1401,1420,1444,1473,1499,1516,1554,1575,1584,1594,1617,1656,1662,1670,1677,1682,1709,1762,1805,1820,1831,1837,1843,1851,1870,1898,1916,1943,1952,1957,1963],{"__ignoreMap":827},[831,1156,1157,1161,1164,1168,1172,1175,1178,1181,1184,1187,1190],{"class":833,"line":834},[831,1158,1160],{"class":1159},"s7zQu","import",[831,1162,1163],{"class":1159}," type",[831,1165,1167],{"class":1166},"sMK4o"," {",[831,1169,1171],{"class":1170},"sTEyZ"," IncomingMessage",[831,1173,1174],{"class":1166},",",[831,1176,1177],{"class":1170}," ServerResponse",[831,1179,1180],{"class":1166}," }",[831,1182,1183],{"class":1159}," from",[831,1185,1186],{"class":1166}," '",[831,1188,1189],{"class":840},"node:http",[831,1191,1192],{"class":1166},"'\n",[831,1194,1196,1198],{"class":833,"line":1195},2,[831,1197,1160],{"class":1159},[831,1199,1200],{"class":1166}," {\n",[831,1202,1204,1207],{"class":833,"line":1203},3,[831,1205,1206],{"class":1170},"  createLoggerStorage",[831,1208,1209],{"class":1166},",\n",[831,1211,1213,1216],{"class":833,"line":1212},4,[831,1214,1215],{"class":1170},"  defineFrameworkIntegration",[831,1217,1209],{"class":1166},[831,1219,1221,1224,1227],{"class":833,"line":1220},5,[831,1222,1223],{"class":1159},"  type",[831,1225,1226],{"class":1170}," BaseEvlogOptions",[831,1228,1209],{"class":1166},[831,1230,1232,1235,1237,1239,1241],{"class":833,"line":1231},6,[831,1233,1234],{"class":1166},"}",[831,1236,1183],{"class":1159},[831,1238,1186],{"class":1166},[831,1240,546],{"class":840},[831,1242,1192],{"class":1166},[831,1244,1246],{"class":833,"line":1245},7,[831,1247,1249],{"class":1248},"sHwdD","\u002F\u002F On Workers \u002F edge, prefer: import { createLoggerStorage } from 'evlog\u002Ftoolkit\u002Fstorage'\n",[831,1251,1253,1255,1257,1259,1262,1264,1266,1268,1270],{"class":833,"line":1252},8,[831,1254,1160],{"class":1159},[831,1256,1163],{"class":1159},[831,1258,1167],{"class":1166},[831,1260,1261],{"class":1170}," RequestLogger",[831,1263,1180],{"class":1166},[831,1265,1183],{"class":1159},[831,1267,1186],{"class":1166},[831,1269,1129],{"class":840},[831,1271,1192],{"class":1166},[831,1273,1275],{"class":833,"line":1274},9,[831,1276,1278],{"emptyLinePlaceholder":1277},true,"\n",[831,1280,1282,1285,1288,1291,1294],{"class":833,"line":1281},10,[831,1283,1284],{"class":1159},"export",[831,1286,1163],{"class":1287},"spNyl",[831,1289,1290],{"class":837}," MyFrameworkEvlogOptions",[831,1292,1293],{"class":1166}," =",[831,1295,1296],{"class":837}," BaseEvlogOptions\n",[831,1298,1300],{"class":833,"line":1299},11,[831,1301,1278],{"emptyLinePlaceholder":1277},[831,1303,1305,1308,1310,1313,1315,1318,1320,1322,1326],{"class":833,"line":1304},12,[831,1306,1307],{"class":1287},"const",[831,1309,1167],{"class":1166},[831,1311,1312],{"class":1170}," storage",[831,1314,1174],{"class":1166},[831,1316,1317],{"class":1170}," useLogger ",[831,1319,1234],{"class":1166},[831,1321,1293],{"class":1166},[831,1323,1325],{"class":1324},"s2Zo4"," createLoggerStorage",[831,1327,1328],{"class":1170},"(\n",[831,1330,1332,1335,1338,1341],{"class":833,"line":1331},13,[831,1333,1334],{"class":1166},"  '",[831,1336,1337],{"class":840},"Cannot access logger outside of middleware context. Make sure evlog middleware is registered before your routes.",[831,1339,1340],{"class":1166},"'",[831,1342,1209],{"class":1166},[831,1344,1346],{"class":833,"line":1345},14,[831,1347,1348],{"class":1170},")\n",[831,1350,1352],{"class":833,"line":1351},15,[831,1353,1278],{"emptyLinePlaceholder":1277},[831,1355,1357,1359,1361,1364],{"class":833,"line":1356},16,[831,1358,1284],{"class":1159},[831,1360,1167],{"class":1166},[831,1362,1363],{"class":1170}," useLogger",[831,1365,1366],{"class":1166}," }\n",[831,1368,1370],{"class":833,"line":1369},17,[831,1371,1278],{"emptyLinePlaceholder":1277},[831,1373,1375,1377,1380,1383,1386,1389,1392,1395,1398],{"class":833,"line":1374},18,[831,1376,1307],{"class":1287},[831,1378,1379],{"class":1170}," integration ",[831,1381,1382],{"class":1166},"=",[831,1384,1385],{"class":1324}," defineFrameworkIntegration",[831,1387,1388],{"class":1166},"\u003C",[831,1390,1391],{"class":837},"IncomingMessage",[831,1393,1394],{"class":1166},">",[831,1396,1397],{"class":1170},"(",[831,1399,1400],{"class":1166},"{\n",[831,1402,1404,1408,1411,1413,1416,1418],{"class":833,"line":1403},19,[831,1405,1407],{"class":1406},"swJcz","  name",[831,1409,1410],{"class":1166},":",[831,1412,1186],{"class":1166},[831,1414,1415],{"class":840},"my-framework",[831,1417,1340],{"class":1166},[831,1419,1209],{"class":1166},[831,1421,1423,1426,1428,1431,1435,1437,1440,1442],{"class":833,"line":1422},20,[831,1424,1425],{"class":1324},"  extractRequest",[831,1427,1410],{"class":1166},[831,1429,1430],{"class":1166}," (",[831,1432,1434],{"class":1433},"sHdIc","req",[831,1436,632],{"class":1166},[831,1438,1439],{"class":1287}," =>",[831,1441,1430],{"class":1170},[831,1443,1400],{"class":1166},[831,1445,1447,1450,1452,1455,1458,1461,1464,1466,1469,1471],{"class":833,"line":1446},21,[831,1448,1449],{"class":1406},"    method",[831,1451,1410],{"class":1166},[831,1453,1454],{"class":1170}," req",[831,1456,1457],{"class":1166},".",[831,1459,1460],{"class":1170},"method ",[831,1462,1463],{"class":1166},"||",[831,1465,1186],{"class":1166},[831,1467,1468],{"class":840},"GET",[831,1470,1340],{"class":1166},[831,1472,1209],{"class":1166},[831,1474,1476,1479,1481,1483,1485,1488,1490,1492,1495,1497],{"class":833,"line":1475},22,[831,1477,1478],{"class":1406},"    path",[831,1480,1410],{"class":1166},[831,1482,1454],{"class":1170},[831,1484,1457],{"class":1166},[831,1486,1487],{"class":1170},"url ",[831,1489,1463],{"class":1166},[831,1491,1186],{"class":1166},[831,1493,1494],{"class":840},"\u002F",[831,1496,1340],{"class":1166},[831,1498,1209],{"class":1166},[831,1500,1502,1505,1507,1509,1511,1514],{"class":833,"line":1501},23,[831,1503,1504],{"class":1406},"    headers",[831,1506,1410],{"class":1166},[831,1508,1454],{"class":1170},[831,1510,1457],{"class":1166},[831,1512,1513],{"class":1170},"headers",[831,1515,1209],{"class":1166},[831,1517,1519,1522,1524,1527,1529,1531,1534,1536,1539,1541,1544,1547,1549,1552],{"class":833,"line":1518},24,[831,1520,1521],{"class":1406},"    requestId",[831,1523,1410],{"class":1166},[831,1525,1526],{"class":1166}," typeof",[831,1528,1454],{"class":1170},[831,1530,1457],{"class":1166},[831,1532,1533],{"class":1170},"headers[",[831,1535,1340],{"class":1166},[831,1537,1538],{"class":840},"x-request-id",[831,1540,1340],{"class":1166},[831,1542,1543],{"class":1170},"] ",[831,1545,1546],{"class":1166},"===",[831,1548,1186],{"class":1166},[831,1550,1551],{"class":840},"string",[831,1553,1192],{"class":1166},[831,1555,1557,1560,1562,1564,1566,1568,1570,1572],{"class":833,"line":1556},25,[831,1558,1559],{"class":1166},"      ?",[831,1561,1454],{"class":1170},[831,1563,1457],{"class":1166},[831,1565,1533],{"class":1170},[831,1567,1340],{"class":1166},[831,1569,1538],{"class":840},[831,1571,1340],{"class":1166},[831,1573,1574],{"class":1170},"]\n",[831,1576,1578,1581],{"class":833,"line":1577},26,[831,1579,1580],{"class":1166},"      :",[831,1582,1583],{"class":1166}," undefined,\n",[831,1585,1587,1590,1592],{"class":833,"line":1586},27,[831,1588,1589],{"class":1166},"  }",[831,1591,632],{"class":1170},[831,1593,1209],{"class":1166},[831,1595,1597,1600,1602,1604,1606,1608,1611,1613,1615],{"class":833,"line":1596},28,[831,1598,1599],{"class":1324},"  attachLogger",[831,1601,1410],{"class":1166},[831,1603,1430],{"class":1166},[831,1605,1434],{"class":1433},[831,1607,1174],{"class":1166},[831,1609,1610],{"class":1433}," logger",[831,1612,632],{"class":1166},[831,1614,1439],{"class":1287},[831,1616,1200],{"class":1166},[831,1618,1620,1623,1625,1628,1630,1633,1635,1638,1640,1642,1644,1646,1648,1651,1653],{"class":833,"line":1619},29,[831,1621,1622],{"class":1406},"    (",[831,1624,1434],{"class":1170},[831,1626,1627],{"class":1159}," as",[831,1629,1171],{"class":837},[831,1631,1632],{"class":1166}," &",[831,1634,1167],{"class":1166},[831,1636,1637],{"class":1406}," log",[831,1639,1410],{"class":1166},[831,1641,1261],{"class":837},[831,1643,1180],{"class":1166},[831,1645,632],{"class":1406},[831,1647,1457],{"class":1166},[831,1649,1650],{"class":1170},"log",[831,1652,1293],{"class":1166},[831,1654,1655],{"class":1170}," logger\n",[831,1657,1659],{"class":833,"line":1658},30,[831,1660,1661],{"class":1166},"  },\n",[831,1663,1665,1668],{"class":833,"line":1664},31,[831,1666,1667],{"class":1170},"  storage",[831,1669,1209],{"class":1166},[831,1671,1673,1675],{"class":833,"line":1672},32,[831,1674,1234],{"class":1166},[831,1676,1348],{"class":1170},[831,1678,1680],{"class":833,"line":1679},33,[831,1681,1278],{"emptyLinePlaceholder":1277},[831,1683,1685,1687,1690,1693,1695,1698,1700,1702,1704,1707],{"class":833,"line":1684},34,[831,1686,1284],{"class":1159},[831,1688,1689],{"class":1287}," function",[831,1691,1692],{"class":1324}," evlog",[831,1694,1397],{"class":1166},[831,1696,1697],{"class":1433},"options",[831,1699,1410],{"class":1166},[831,1701,1290],{"class":837},[831,1703,1293],{"class":1166},[831,1705,1706],{"class":1166}," {})",[831,1708,1200],{"class":1166},[831,1710,1712,1715,1718,1720,1722,1724,1726,1728,1731,1733,1735,1737,1740,1742,1745,1747,1750,1752,1755,1758,1760],{"class":833,"line":1711},35,[831,1713,1714],{"class":1159},"  return",[831,1716,1717],{"class":1287}," async",[831,1719,1430],{"class":1166},[831,1721,1434],{"class":1433},[831,1723,1410],{"class":1166},[831,1725,1171],{"class":837},[831,1727,1174],{"class":1166},[831,1729,1730],{"class":1433}," res",[831,1732,1410],{"class":1166},[831,1734,1177],{"class":837},[831,1736,1174],{"class":1166},[831,1738,1739],{"class":1324}," next",[831,1741,1410],{"class":1166},[831,1743,1744],{"class":1166}," ()",[831,1746,1439],{"class":1287},[831,1748,1749],{"class":837}," Promise",[831,1751,1388],{"class":1166},[831,1753,1754],{"class":837},"void",[831,1756,1757],{"class":1166},">)",[831,1759,1439],{"class":1287},[831,1761,1200],{"class":1166},[831,1763,1765,1768,1770,1773,1775,1778,1780,1783,1785,1787,1790,1792,1795,1797,1799,1801,1803],{"class":833,"line":1764},36,[831,1766,1767],{"class":1287},"    const",[831,1769,1167],{"class":1166},[831,1771,1772],{"class":1170}," skipped",[831,1774,1174],{"class":1166},[831,1776,1777],{"class":1170}," finish",[831,1779,1174],{"class":1166},[831,1781,1782],{"class":1170}," runWith",[831,1784,1180],{"class":1166},[831,1786,1293],{"class":1166},[831,1788,1789],{"class":1170}," integration",[831,1791,1457],{"class":1166},[831,1793,1794],{"class":1324},"start",[831,1796,1397],{"class":1406},[831,1798,1434],{"class":1170},[831,1800,1174],{"class":1166},[831,1802,783],{"class":1170},[831,1804,1348],{"class":1406},[831,1806,1808,1811,1813,1815,1818],{"class":833,"line":1807},37,[831,1809,1810],{"class":1159},"    if",[831,1812,1430],{"class":1406},[831,1814,723],{"class":1170},[831,1816,1817],{"class":1406},") ",[831,1819,1400],{"class":1166},[831,1821,1823,1826,1828],{"class":833,"line":1822},38,[831,1824,1825],{"class":1159},"      await",[831,1827,1739],{"class":1324},[831,1829,1830],{"class":1406},"()\n",[831,1832,1834],{"class":833,"line":1833},39,[831,1835,1836],{"class":1159},"      return\n",[831,1838,1840],{"class":833,"line":1839},40,[831,1841,1842],{"class":1166},"    }\n",[831,1844,1846,1849],{"class":833,"line":1845},41,[831,1847,1848],{"class":1159},"    try",[831,1850,1200],{"class":1166},[831,1852,1854,1856,1858,1860,1863,1865,1867],{"class":833,"line":1853},42,[831,1855,1825],{"class":1159},[831,1857,1782],{"class":1324},[831,1859,1397],{"class":1406},[831,1861,1862],{"class":1166},"()",[831,1864,1439],{"class":1287},[831,1866,1739],{"class":1324},[831,1868,1869],{"class":1406},"())\n",[831,1871,1873,1875,1877,1879,1882,1885,1887,1889,1891,1894,1896],{"class":833,"line":1872},43,[831,1874,1825],{"class":1159},[831,1876,1777],{"class":1324},[831,1878,1397],{"class":1406},[831,1880,1881],{"class":1166},"{",[831,1883,1884],{"class":1406}," status",[831,1886,1410],{"class":1166},[831,1888,1730],{"class":1170},[831,1890,1457],{"class":1166},[831,1892,1893],{"class":1170},"statusCode",[831,1895,1180],{"class":1166},[831,1897,1348],{"class":1406},[831,1899,1901,1904,1907,1909,1912,1914],{"class":833,"line":1900},44,[831,1902,1903],{"class":1166},"    }",[831,1905,1906],{"class":1159}," catch",[831,1908,1430],{"class":1406},[831,1910,1911],{"class":1170},"error",[831,1913,1817],{"class":1406},[831,1915,1400],{"class":1166},[831,1917,1919,1921,1923,1925,1927,1930,1932,1934,1936,1939,1941],{"class":833,"line":1918},45,[831,1920,1825],{"class":1159},[831,1922,1777],{"class":1324},[831,1924,1397],{"class":1406},[831,1926,1881],{"class":1166},[831,1928,1929],{"class":1406}," error",[831,1931,1410],{"class":1166},[831,1933,1929],{"class":1170},[831,1935,1627],{"class":1159},[831,1937,1938],{"class":837}," Error",[831,1940,1180],{"class":1166},[831,1942,1348],{"class":1406},[831,1944,1946,1949],{"class":833,"line":1945},46,[831,1947,1948],{"class":1159},"      throw",[831,1950,1951],{"class":1170}," error\n",[831,1953,1955],{"class":833,"line":1954},47,[831,1956,1842],{"class":1166},[831,1958,1960],{"class":833,"line":1959},48,[831,1961,1962],{"class":1166},"  }\n",[831,1964,1966],{"class":833,"line":1965},49,[831,1967,1968],{"class":1166},"}\n",[536,1970,1971,1972,1974],{},"That's it. This middleware gets every feature for free: route filtering, drain adapters, enrichers, tail sampling, error capture, plugin lifecycle hooks, ",[540,1973,745],{},", and duration tracking.",[1976,1977,1979,1980,1982],"h3",{"id":1978},"what-defineframeworkintegration-does","What ",[540,1981,669],{}," does",[536,1984,1985],{},"Given the manifest above, the helper:",[1987,1988,1989,1998,2009,2015,2019,2029],"ol",{},[661,1990,1991,1992,1994,1995,1997],{},"Normalizes headers (auto-detects ",[540,1993,699],{}," vs ",[540,1996,703],{},").",[661,1999,2000,2001,2004,2005,2008],{},"Generates a ",[540,2002,2003],{},"requestId"," if ",[540,2006,2007],{},"extractRequest"," doesn't return one.",[661,2010,2011,2012,2014],{},"Calls ",[540,2013,1051],{}," with the merged options.",[661,2016,2011,2017,1457],{},[540,2018,684],{},[661,2020,2021,2022,2024,2025,2028],{},"Attaches ",[540,2023,745],{}," to the logger when ",[540,2026,2027],{},"storage"," is provided (so users can spawn correlated background work).",[661,2030,2031,2032,2035,2036,2039,2040,2043,2044,1457],{},"Exposes ",[540,2033,2034],{},"runWith(fn)"," — runs ",[540,2037,2038],{},"fn()"," inside ",[540,2041,2042],{},"storage.run(logger, …)"," if storage is configured, otherwise just calls ",[540,2045,2038],{},[536,2047,2048],{},"You're left with only the framework-specific glue: where to read the request from, where to attach the logger, and how to compute the response status.",[813,2050,2052],{"id":2051},"custom-mode","Custom mode",[536,2054,2055,2056,2058,2059,2061,2062,2064],{},"If your framework's lifecycle doesn't fit a clean ",[540,2057,608],{}," shape (NestJS interceptors, Next.js App Router, SvelteKit ",[540,2060,631],{},"), drop one level lower and call ",[540,2063,1051],{}," directly:",[821,2066,2068],{"className":1149,"code":2067,"language":1152,"meta":827,"style":827},"import { createMiddlewareLogger, extractSafeNodeHeaders } from 'evlog\u002Ftoolkit'\n\nconst { logger, finish, skipped } = createMiddlewareLogger({\n  method,\n  path,\n  requestId,\n  headers: extractSafeNodeHeaders(rawHeaders),\n  ...options,\n})\n",[540,2069,2070,2094,2098,2125,2132,2139,2146,2160,2169],{"__ignoreMap":827},[831,2071,2072,2074,2076,2079,2081,2084,2086,2088,2090,2092],{"class":833,"line":834},[831,2073,1160],{"class":1159},[831,2075,1167],{"class":1166},[831,2077,2078],{"class":1170}," createMiddlewareLogger",[831,2080,1174],{"class":1166},[831,2082,2083],{"class":1170}," extractSafeNodeHeaders",[831,2085,1180],{"class":1166},[831,2087,1183],{"class":1159},[831,2089,1186],{"class":1166},[831,2091,546],{"class":840},[831,2093,1192],{"class":1166},[831,2095,2096],{"class":833,"line":1195},[831,2097,1278],{"emptyLinePlaceholder":1277},[831,2099,2100,2102,2104,2106,2108,2110,2112,2115,2117,2119,2121,2123],{"class":833,"line":1203},[831,2101,1307],{"class":1287},[831,2103,1167],{"class":1166},[831,2105,1610],{"class":1170},[831,2107,1174],{"class":1166},[831,2109,1777],{"class":1170},[831,2111,1174],{"class":1166},[831,2113,2114],{"class":1170}," skipped ",[831,2116,1234],{"class":1166},[831,2118,1293],{"class":1166},[831,2120,2078],{"class":1324},[831,2122,1397],{"class":1170},[831,2124,1400],{"class":1166},[831,2126,2127,2130],{"class":833,"line":1212},[831,2128,2129],{"class":1170},"  method",[831,2131,1209],{"class":1166},[831,2133,2134,2137],{"class":833,"line":1220},[831,2135,2136],{"class":1170},"  path",[831,2138,1209],{"class":1166},[831,2140,2141,2144],{"class":833,"line":1231},[831,2142,2143],{"class":1170},"  requestId",[831,2145,1209],{"class":1166},[831,2147,2148,2151,2153,2155,2158],{"class":833,"line":1245},[831,2149,2150],{"class":1406},"  headers",[831,2152,1410],{"class":1166},[831,2154,2083],{"class":1324},[831,2156,2157],{"class":1170},"(rawHeaders)",[831,2159,1209],{"class":1166},[831,2161,2162,2165,2167],{"class":833,"line":1252},[831,2163,2164],{"class":1166},"  ...",[831,2166,1697],{"class":1170},[831,2168,1209],{"class":1166},[831,2170,2171,2173],{"class":833,"line":1274},[831,2172,1234],{"class":1166},[831,2174,1348],{"class":1170},[536,2176,2177,2178,2181,2182,2184,2185,2188],{},"You'll be responsible for ALS wrapping (",[540,2179,2180],{},"storage.run","), ",[540,2183,745],{}," attachment (via ",[540,2186,2187],{},"attachForkToLogger","), and finishing the lifecycle — but you keep the full pipeline (route filtering, sampling, emit, enrich, drain, plugins) for free.",[813,2190,2192],{"id":2191},"serverless-workers-edge","Serverless (Workers \u002F Edge)",[536,2194,2195,2196,2198,2199,2204],{},"On Cloudflare Workers and Vercel Edge, the runtime can terminate as soon as the response is returned. If your drain sends HTTP to an observability backend, pass ",[540,2197,789],{}," so enrich still runs inline but drain work survives after the response — the same behavior as ",[594,2200,2201],{"href":286},[540,2202,2203],{},"evlog\u002Fworkers"," and the Nitro plugin.",[536,2206,2207,2209,2210,2212],{},[552,2208,2052],{}," — pass ",[540,2211,789],{}," per request:",[821,2214,2216],{"className":1149,"code":2215,"language":1152,"meta":827,"style":827},"import { waitUntil } from '@vercel\u002Ffunctions'\n\u002F\u002F import { waitUntil } from 'cloudflare:workers' \u002F\u002F Vercel-style global on some runtimes\n\nconst { logger, finish, skipped } = createMiddlewareLogger({\n  method,\n  path,\n  requestId,\n  headers: extractSafeNodeHeaders(rawHeaders),\n  waitUntil, \u002F\u002F or ctx.waitUntil.bind(ctx) on Cloudflare\n  ...options,\n})\n",[540,2217,2218,2238,2246,2250,2276,2282,2288,2294,2306,2316,2324],{"__ignoreMap":827},[831,2219,2220,2222,2224,2227,2229,2231,2233,2236],{"class":833,"line":834},[831,2221,1160],{"class":1159},[831,2223,1167],{"class":1166},[831,2225,2226],{"class":1170}," waitUntil",[831,2228,1180],{"class":1166},[831,2230,1183],{"class":1159},[831,2232,1186],{"class":1166},[831,2234,2235],{"class":840},"@vercel\u002Ffunctions",[831,2237,1192],{"class":1166},[831,2239,2240,2243],{"class":833,"line":1195},[831,2241,2242],{"class":1248},"\u002F\u002F import { waitUntil } from 'cloudflare:workers'",[831,2244,2245],{"class":1248}," \u002F\u002F Vercel-style global on some runtimes\n",[831,2247,2248],{"class":833,"line":1203},[831,2249,1278],{"emptyLinePlaceholder":1277},[831,2251,2252,2254,2256,2258,2260,2262,2264,2266,2268,2270,2272,2274],{"class":833,"line":1212},[831,2253,1307],{"class":1287},[831,2255,1167],{"class":1166},[831,2257,1610],{"class":1170},[831,2259,1174],{"class":1166},[831,2261,1777],{"class":1170},[831,2263,1174],{"class":1166},[831,2265,2114],{"class":1170},[831,2267,1234],{"class":1166},[831,2269,1293],{"class":1166},[831,2271,2078],{"class":1324},[831,2273,1397],{"class":1170},[831,2275,1400],{"class":1166},[831,2277,2278,2280],{"class":833,"line":1220},[831,2279,2129],{"class":1170},[831,2281,1209],{"class":1166},[831,2283,2284,2286],{"class":833,"line":1231},[831,2285,2136],{"class":1170},[831,2287,1209],{"class":1166},[831,2289,2290,2292],{"class":833,"line":1245},[831,2291,2143],{"class":1170},[831,2293,1209],{"class":1166},[831,2295,2296,2298,2300,2302,2304],{"class":833,"line":1252},[831,2297,2150],{"class":1406},[831,2299,1410],{"class":1166},[831,2301,2083],{"class":1324},[831,2303,2157],{"class":1170},[831,2305,1209],{"class":1166},[831,2307,2308,2311,2313],{"class":833,"line":1274},[831,2309,2310],{"class":1170},"  waitUntil",[831,2312,1174],{"class":1166},[831,2314,2315],{"class":1248}," \u002F\u002F or ctx.waitUntil.bind(ctx) on Cloudflare\n",[831,2317,2318,2320,2322],{"class":833,"line":1281},[831,2319,2164],{"class":1166},[831,2321,1697],{"class":1170},[831,2323,1209],{"class":1166},[831,2325,2326,2328],{"class":833,"line":1299},[831,2327,1234],{"class":1166},[831,2329,1348],{"class":1170},[536,2331,2332,2335,2336,2338,2339,2341,2342,2344],{},[552,2333,2334],{},"Manifest mode"," — either pass ",[540,2337,789],{}," in ",[540,2340,713],{}," or declare ",[540,2343,793],{}," on the manifest when the hook lives on the framework context:",[821,2346,2348],{"className":1149,"code":2347,"language":1152,"meta":827,"style":827},"const integration = defineFrameworkIntegration\u003CWorkerContext>({\n  name: 'my-framework',\n  extractRequest: (ctx) => ({ \u002F* … *\u002F }),\n  attachLogger: (ctx, logger) => { \u002F* … *\u002F },\n  extractWaitUntil: ctx => ctx.executionCtx.waitUntil.bind(ctx.executionCtx),\n})\n\nexport function evlog(options: BaseEvlogOptions = {}) {\n  return async (ctx, next) => {\n    const { skipped, finish, runWith } = integration.start(ctx, options)\n    \u002F\u002F Per-request override still works:\n    \u002F\u002F integration.start(ctx, { ...options, waitUntil: ctx.executionCtx.waitUntil.bind(ctx.executionCtx) })\n    \u002F\u002F …\n  }\n}\n",[540,2349,2350,2371,2385,2413,2438,2476,2482,2486,2508,2528,2564,2569,2574,2579,2583],{"__ignoreMap":827},[831,2351,2352,2354,2356,2358,2360,2362,2365,2367,2369],{"class":833,"line":834},[831,2353,1307],{"class":1287},[831,2355,1379],{"class":1170},[831,2357,1382],{"class":1166},[831,2359,1385],{"class":1324},[831,2361,1388],{"class":1166},[831,2363,2364],{"class":837},"WorkerContext",[831,2366,1394],{"class":1166},[831,2368,1397],{"class":1170},[831,2370,1400],{"class":1166},[831,2372,2373,2375,2377,2379,2381,2383],{"class":833,"line":1195},[831,2374,1407],{"class":1406},[831,2376,1410],{"class":1166},[831,2378,1186],{"class":1166},[831,2380,1415],{"class":840},[831,2382,1340],{"class":1166},[831,2384,1209],{"class":1166},[831,2386,2387,2389,2391,2393,2396,2398,2400,2402,2404,2407,2409,2411],{"class":833,"line":1203},[831,2388,1425],{"class":1324},[831,2390,1410],{"class":1166},[831,2392,1430],{"class":1166},[831,2394,2395],{"class":1433},"ctx",[831,2397,632],{"class":1166},[831,2399,1439],{"class":1287},[831,2401,1430],{"class":1170},[831,2403,1881],{"class":1166},[831,2405,2406],{"class":1248}," \u002F* … *\u002F",[831,2408,1180],{"class":1166},[831,2410,632],{"class":1170},[831,2412,1209],{"class":1166},[831,2414,2415,2417,2419,2421,2423,2425,2427,2429,2431,2433,2435],{"class":833,"line":1212},[831,2416,1599],{"class":1324},[831,2418,1410],{"class":1166},[831,2420,1430],{"class":1166},[831,2422,2395],{"class":1433},[831,2424,1174],{"class":1166},[831,2426,1610],{"class":1433},[831,2428,632],{"class":1166},[831,2430,1439],{"class":1287},[831,2432,1167],{"class":1166},[831,2434,2406],{"class":1248},[831,2436,2437],{"class":1166}," },\n",[831,2439,2440,2443,2445,2448,2450,2452,2454,2457,2459,2461,2463,2466,2469,2471,2474],{"class":833,"line":1220},[831,2441,2442],{"class":1324},"  extractWaitUntil",[831,2444,1410],{"class":1166},[831,2446,2447],{"class":1433}," ctx",[831,2449,1439],{"class":1287},[831,2451,2447],{"class":1170},[831,2453,1457],{"class":1166},[831,2455,2456],{"class":1170},"executionCtx",[831,2458,1457],{"class":1166},[831,2460,789],{"class":1170},[831,2462,1457],{"class":1166},[831,2464,2465],{"class":1324},"bind",[831,2467,2468],{"class":1170},"(ctx",[831,2470,1457],{"class":1166},[831,2472,2473],{"class":1170},"executionCtx)",[831,2475,1209],{"class":1166},[831,2477,2478,2480],{"class":833,"line":1231},[831,2479,1234],{"class":1166},[831,2481,1348],{"class":1170},[831,2483,2484],{"class":833,"line":1245},[831,2485,1278],{"emptyLinePlaceholder":1277},[831,2487,2488,2490,2492,2494,2496,2498,2500,2502,2504,2506],{"class":833,"line":1252},[831,2489,1284],{"class":1159},[831,2491,1689],{"class":1287},[831,2493,1692],{"class":1324},[831,2495,1397],{"class":1166},[831,2497,1697],{"class":1433},[831,2499,1410],{"class":1166},[831,2501,1226],{"class":837},[831,2503,1293],{"class":1166},[831,2505,1706],{"class":1166},[831,2507,1200],{"class":1166},[831,2509,2510,2512,2514,2516,2518,2520,2522,2524,2526],{"class":833,"line":1274},[831,2511,1714],{"class":1159},[831,2513,1717],{"class":1287},[831,2515,1430],{"class":1166},[831,2517,2395],{"class":1433},[831,2519,1174],{"class":1166},[831,2521,1739],{"class":1433},[831,2523,632],{"class":1166},[831,2525,1439],{"class":1287},[831,2527,1200],{"class":1166},[831,2529,2530,2532,2534,2536,2538,2540,2542,2544,2546,2548,2550,2552,2554,2556,2558,2560,2562],{"class":833,"line":1281},[831,2531,1767],{"class":1287},[831,2533,1167],{"class":1166},[831,2535,1772],{"class":1170},[831,2537,1174],{"class":1166},[831,2539,1777],{"class":1170},[831,2541,1174],{"class":1166},[831,2543,1782],{"class":1170},[831,2545,1180],{"class":1166},[831,2547,1293],{"class":1166},[831,2549,1789],{"class":1170},[831,2551,1457],{"class":1166},[831,2553,1794],{"class":1324},[831,2555,1397],{"class":1406},[831,2557,2395],{"class":1170},[831,2559,1174],{"class":1166},[831,2561,783],{"class":1170},[831,2563,1348],{"class":1406},[831,2565,2566],{"class":833,"line":1299},[831,2567,2568],{"class":1248},"    \u002F\u002F Per-request override still works:\n",[831,2570,2571],{"class":833,"line":1304},[831,2572,2573],{"class":1248},"    \u002F\u002F integration.start(ctx, { ...options, waitUntil: ctx.executionCtx.waitUntil.bind(ctx.executionCtx) })\n",[831,2575,2576],{"class":833,"line":1331},[831,2577,2578],{"class":1248},"    \u002F\u002F …\n",[831,2580,2581],{"class":833,"line":1345},[831,2582,1962],{"class":1166},[831,2584,2585],{"class":833,"line":1351},[831,2586,1968],{"class":1166},[536,2588,2589,2590,2593,2594,2596],{},"Per-request ",[540,2591,2592],{},"options.waitUntil"," takes precedence over ",[540,2595,793],{},". Without either, drains are awaited (correct for traditional Node.js servers).",[813,2598,2600],{"id":2599},"non-http-runtimes","Non-HTTP runtimes",[536,2602,2603,2604,670,2606,2064],{},"For queue workers, CLI drivers, cron jobs, or durable execution engines, skip the HTTP-shaped helpers and use ",[540,2605,800],{},[540,2607,546],{},[821,2609,2613],{"className":2610,"code":2611,"language":2612,"meta":827,"style":827},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import { createRequestLogger } from 'evlog\u002Ftoolkit'\n\nasync function processJob(job: Job) {\n  const logger = createRequestLogger({\n    service: 'jobs',\n    context: { jobId: job.id, queue: job.queue },\n  })\n\n  try {\n    await runJob(job)\n    logger.set({ status: 'success' })\n  } catch (err) {\n    logger.error(err)\n    throw err\n  } finally {\n    await logger.emit()\n  }\n}\n","ts",[540,2614,2615,2634,2638,2662,2677,2693,2731,2737,2741,2748,2762,2791,2806,2820,2828,2837,2850,2854],{"__ignoreMap":827},[831,2616,2617,2619,2621,2624,2626,2628,2630,2632],{"class":833,"line":834},[831,2618,1160],{"class":1159},[831,2620,1167],{"class":1166},[831,2622,2623],{"class":1170}," createRequestLogger",[831,2625,1180],{"class":1166},[831,2627,1183],{"class":1159},[831,2629,1186],{"class":1166},[831,2631,546],{"class":840},[831,2633,1192],{"class":1166},[831,2635,2636],{"class":833,"line":1195},[831,2637,1278],{"emptyLinePlaceholder":1277},[831,2639,2640,2643,2645,2648,2650,2653,2655,2658,2660],{"class":833,"line":1203},[831,2641,2642],{"class":1287},"async",[831,2644,1689],{"class":1287},[831,2646,2647],{"class":1324}," processJob",[831,2649,1397],{"class":1166},[831,2651,2652],{"class":1433},"job",[831,2654,1410],{"class":1166},[831,2656,2657],{"class":837}," Job",[831,2659,632],{"class":1166},[831,2661,1200],{"class":1166},[831,2663,2664,2667,2669,2671,2673,2675],{"class":833,"line":1212},[831,2665,2666],{"class":1287},"  const",[831,2668,1610],{"class":1170},[831,2670,1293],{"class":1166},[831,2672,2623],{"class":1324},[831,2674,1397],{"class":1406},[831,2676,1400],{"class":1166},[831,2678,2679,2682,2684,2686,2689,2691],{"class":833,"line":1220},[831,2680,2681],{"class":1406},"    service",[831,2683,1410],{"class":1166},[831,2685,1186],{"class":1166},[831,2687,2688],{"class":840},"jobs",[831,2690,1340],{"class":1166},[831,2692,1209],{"class":1166},[831,2694,2695,2698,2700,2702,2705,2707,2710,2712,2715,2717,2720,2722,2724,2726,2729],{"class":833,"line":1231},[831,2696,2697],{"class":1406},"    context",[831,2699,1410],{"class":1166},[831,2701,1167],{"class":1166},[831,2703,2704],{"class":1406}," jobId",[831,2706,1410],{"class":1166},[831,2708,2709],{"class":1170}," job",[831,2711,1457],{"class":1166},[831,2713,2714],{"class":1170},"id",[831,2716,1174],{"class":1166},[831,2718,2719],{"class":1406}," queue",[831,2721,1410],{"class":1166},[831,2723,2709],{"class":1170},[831,2725,1457],{"class":1166},[831,2727,2728],{"class":1170},"queue",[831,2730,2437],{"class":1166},[831,2732,2733,2735],{"class":833,"line":1245},[831,2734,1589],{"class":1166},[831,2736,1348],{"class":1406},[831,2738,2739],{"class":833,"line":1252},[831,2740,1278],{"emptyLinePlaceholder":1277},[831,2742,2743,2746],{"class":833,"line":1274},[831,2744,2745],{"class":1159},"  try",[831,2747,1200],{"class":1166},[831,2749,2750,2753,2756,2758,2760],{"class":833,"line":1281},[831,2751,2752],{"class":1159},"    await",[831,2754,2755],{"class":1324}," runJob",[831,2757,1397],{"class":1406},[831,2759,2652],{"class":1170},[831,2761,1348],{"class":1406},[831,2763,2764,2767,2769,2772,2774,2776,2778,2780,2782,2785,2787,2789],{"class":833,"line":1299},[831,2765,2766],{"class":1170},"    logger",[831,2768,1457],{"class":1166},[831,2770,2771],{"class":1324},"set",[831,2773,1397],{"class":1406},[831,2775,1881],{"class":1166},[831,2777,1884],{"class":1406},[831,2779,1410],{"class":1166},[831,2781,1186],{"class":1166},[831,2783,2784],{"class":840},"success",[831,2786,1340],{"class":1166},[831,2788,1180],{"class":1166},[831,2790,1348],{"class":1406},[831,2792,2793,2795,2797,2799,2802,2804],{"class":833,"line":1304},[831,2794,1589],{"class":1166},[831,2796,1906],{"class":1159},[831,2798,1430],{"class":1406},[831,2800,2801],{"class":1170},"err",[831,2803,1817],{"class":1406},[831,2805,1400],{"class":1166},[831,2807,2808,2810,2812,2814,2816,2818],{"class":833,"line":1331},[831,2809,2766],{"class":1170},[831,2811,1457],{"class":1166},[831,2813,1911],{"class":1324},[831,2815,1397],{"class":1406},[831,2817,2801],{"class":1170},[831,2819,1348],{"class":1406},[831,2821,2822,2825],{"class":833,"line":1345},[831,2823,2824],{"class":1159},"    throw",[831,2826,2827],{"class":1170}," err\n",[831,2829,2830,2832,2835],{"class":833,"line":1351},[831,2831,1589],{"class":1166},[831,2833,2834],{"class":1159}," finally",[831,2836,1200],{"class":1166},[831,2838,2839,2841,2843,2845,2848],{"class":833,"line":1356},[831,2840,2752],{"class":1159},[831,2842,1610],{"class":1170},[831,2844,1457],{"class":1166},[831,2846,2847],{"class":1324},"emit",[831,2849,1830],{"class":1406},[831,2851,2852],{"class":833,"line":1369},[831,2853,1962],{"class":1166},[831,2855,2856],{"class":833,"line":1374},[831,2857,1968],{"class":1166},[536,2859,2860,2861,2864],{},"Same enrichers, same drain hook, same ",[594,2862,2863],{"href":486},"identity headers"," on outbound HTTP drain requests — only the entry point shape changes.",[813,2866,2868],{"id":2867},"reference-implementations","Reference implementations",[536,2870,2871],{},"Study these built-in integrations for framework-specific patterns:",[567,2873,2874,2890],{},[570,2875,2876],{},[573,2877,2878,2881,2884,2887],{},[576,2879,2880],{},"Framework",[576,2882,2883],{},"Lines",[576,2885,2886],{},"Mode",[576,2888,2889],{},"Source",[586,2891,2892,2909,2925,2942,2959,2976],{},[573,2893,2894,2896,2899,2902],{},[591,2895,265],{},[591,2897,2898],{},"~50",[591,2900,2901],{},"manifest",[591,2903,2904],{},[594,2905,2908],{"href":2906,"rel":2907},"https:\u002F\u002Fgithub.com\u002Fhugorcd\u002Fevlog\u002Fblob\u002Fmain\u002Fpackages\u002Fevlog\u002Fsrc\u002Fhono\u002Findex.ts",[811],"hono\u002Findex.ts",[573,2910,2911,2913,2915,2918],{},[591,2912,260],{},[591,2914,2898],{},[591,2916,2917],{},"manifest + ALS",[591,2919,2920],{},[594,2921,2924],{"href":2922,"rel":2923},"https:\u002F\u002Fgithub.com\u002Fhugorcd\u002Fevlog\u002Fblob\u002Fmain\u002Fpackages\u002Fevlog\u002Fsrc\u002Fexpress\u002Findex.ts",[811],"express\u002Findex.ts",[573,2926,2927,2929,2932,2935],{},[591,2928,270],{},[591,2930,2931],{},"~70",[591,2933,2934],{},"manifest + Fastify hooks",[591,2936,2937],{},[594,2938,2941],{"href":2939,"rel":2940},"https:\u002F\u002Fgithub.com\u002Fhugorcd\u002Fevlog\u002Fblob\u002Fmain\u002Fpackages\u002Fevlog\u002Fsrc\u002Ffastify\u002Findex.ts",[811],"fastify\u002Findex.ts",[573,2943,2944,2946,2949,2952],{},[591,2945,275],{},[591,2947,2948],{},"~80",[591,2950,2951],{},"manifest + custom ALS scoping",[591,2953,2954],{},[594,2955,2958],{"href":2956,"rel":2957},"https:\u002F\u002Fgithub.com\u002Fhugorcd\u002Fevlog\u002Fblob\u002Fmain\u002Fpackages\u002Fevlog\u002Fsrc\u002Felysia\u002Findex.ts",[811],"elysia\u002Findex.ts",[573,2960,2961,2963,2966,2969],{},[591,2962,255],{},[591,2964,2965],{},"~120",[591,2967,2968],{},"custom (interceptor)",[591,2970,2971],{},[594,2972,2975],{"href":2973,"rel":2974},"https:\u002F\u002Fgithub.com\u002Fhugorcd\u002Fevlog\u002Fblob\u002Fmain\u002Fpackages\u002Fevlog\u002Fsrc\u002Fnestjs\u002F",[811],"nestjs\u002F",[573,2977,2978,2980,2983,2989],{},[591,2979,240],{},[591,2981,2982],{},"~90",[591,2984,2985,2986,2988],{},"custom (",[540,2987,631],{}," hook)",[591,2990,2991],{},[594,2992,2995],{"href":2993,"rel":2994},"https:\u002F\u002Fgithub.com\u002Fhugorcd\u002Fevlog\u002Fblob\u002Fmain\u002Fpackages\u002Fevlog\u002Fsrc\u002Fsveltekit\u002F",[811],"sveltekit\u002F",[557,2997,3000,3001,3006],{"color":2998,"icon":2999},"neutral","i-lucide-heart","Built an integration for a framework we don't support? ",[594,3002,3005],{"href":3003,"rel":3004},"https:\u002F\u002Fgithub.com\u002Fhugorcd\u002Fevlog\u002Fpulls",[811],"Open a PR"," — the community will thank you.",[813,3008,3010],{"id":3009},"next-steps","Next steps",[658,3012,3013,3019,3025,3030,3035,3040],{},[661,3014,3015,3018],{},[594,3016,3017],{"href":491},"Custom Drains"," — same toolkit shape for drain destinations",[661,3020,3021,3024],{},[594,3022,3023],{"href":478},"Custom Enrichers"," — same toolkit shape for derived event fields",[661,3026,3027,3029],{},[594,3028,473],{"href":474}," — multi-hook extensions (drain + enrich + keep in one object)",[661,3031,3032,3034],{},[594,3033,46],{"href":47}," — design comprehensive events with context layering",[661,3036,3037,3039],{},[594,3038,61],{"href":62}," — control log volume with head and tail sampling",[661,3041,3042,3044],{},[594,3043,138],{"href":143}," — send logs to Axiom, Sentry, PostHog, and more",[3046,3047,3048],"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 .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sHdIc, html code.shiki .sHdIc{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic}",{"title":827,"searchDepth":1195,"depth":1195,"links":3050},[3051,3052,3053,3057,3058,3059,3060,3061],{"id":815,"depth":1195,"text":816},{"id":890,"depth":1195,"text":891},{"id":1133,"depth":1195,"text":1134,"children":3054},[3055],{"id":1978,"depth":1203,"text":3056},"What defineFrameworkIntegration does",{"id":2051,"depth":1195,"text":2052},{"id":2191,"depth":1195,"text":2192},{"id":2599,"depth":1195,"text":2600},{"id":2867,"depth":1195,"text":2868},{"id":3009,"depth":1195,"text":3010},"Build evlog support for an HTTP framework (or non-HTTP runtime) without a built-in integration. Use defineFrameworkIntegration for the (ctx, next) middleware shape, or createMiddlewareLogger \u002F createRequestLogger for everything else.","md",[3065,3067],{"label":3017,"icon":493,"to":491,"color":2998,"variant":3066},"subtle",{"label":3023,"icon":434,"to":478,"color":2998,"variant":3066},{},{"title":455,"icon":458},{"title":531,"description":3062},"tE0g7MuhC5DtwwxqiGtuCyY-5TQDWiziJyFf9R_bXaA",[3073,3075],{"title":450,"path":451,"stem":452,"description":3074,"icon":453,"children":-1},"Subscribe to wide events flowing through evlog — in-process with createStreamDrain, or over the network with the local SSE stream server.",{"title":460,"path":461,"stem":462,"description":3076,"icon":453,"children":-1},"Publish every wide event on a node:diagnostics_channel so any consumer can subscribe without importing evlog — and so Cloudflare forwards them to a Tail Worker with no drain.",1785969325688]