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