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