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