[{"data":1,"prerenderedAt":1569},["ShallowReactive",2],{"navigation_docs":3,"-start-introduction":434,"-start-introduction-surround":1565},[4,30,80,240,348,403],{"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},"Integrate","\u002Fintegrate","3.integrate",[85,89,152],{"title":36,"path":86,"stem":87,"icon":88},"\u002Fintegrate\u002Foverview","3.integrate\u002F0.overview","i-lucide-plug",{"title":90,"path":91,"stem":92,"children":93,"page":29},"Adapters","\u002Fintegrate\u002Fadapters","3.integrate\u002Fadapters",[94,97,137],{"title":36,"path":95,"stem":96,"icon":39},"\u002Fintegrate\u002Fadapters\u002Foverview","3.integrate\u002Fadapters\u002F01.overview",{"title":98,"path":99,"stem":100,"children":101,"page":29},"Cloud","\u002Fintegrate\u002Fadapters\u002Fcloud","3.integrate\u002Fadapters\u002Fcloud",[102,107,112,117,122,127,132],{"title":103,"path":104,"stem":105,"icon":106},"Axiom","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Faxiom","3.integrate\u002Fadapters\u002Fcloud\u002F01.axiom","i-custom-axiom",{"title":108,"path":109,"stem":110,"icon":111},"OTLP","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fotlp","3.integrate\u002Fadapters\u002Fcloud\u002F02.otlp","i-simple-icons-opentelemetry",{"title":113,"path":114,"stem":115,"icon":116},"PostHog","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fposthog","3.integrate\u002Fadapters\u002Fcloud\u002F03.posthog","i-simple-icons-posthog",{"title":118,"path":119,"stem":120,"icon":121},"Sentry","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fsentry","3.integrate\u002Fadapters\u002Fcloud\u002F04.sentry","i-simple-icons-sentry",{"title":123,"path":124,"stem":125,"icon":126},"Better Stack","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fbetter-stack","3.integrate\u002Fadapters\u002Fcloud\u002F05.better-stack","i-simple-icons-betterstack",{"title":128,"path":129,"stem":130,"icon":131},"Datadog","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fdatadog","3.integrate\u002Fadapters\u002Fcloud\u002F06.datadog","i-simple-icons-datadog",{"title":133,"path":134,"stem":135,"icon":136},"HyperDX","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fhyperdx","3.integrate\u002Fadapters\u002Fcloud\u002F07.hyperdx","i-custom-hyperdx",{"title":138,"path":139,"stem":140,"children":141,"page":29},"Self-Hosted","\u002Fintegrate\u002Fadapters\u002Fself-hosted","3.integrate\u002Fadapters\u002Fself-hosted",[142,147],{"title":143,"path":144,"stem":145,"icon":146},"File System","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Ffs","3.integrate\u002Fadapters\u002Fself-hosted\u002F01.fs","i-lucide-hard-drive",{"title":148,"path":149,"stem":150,"icon":151},"NuxtHub","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Fnuxthub","3.integrate\u002Fadapters\u002Fself-hosted\u002F02.nuxthub","i-simple-icons-nuxt",{"title":153,"path":154,"stem":155,"children":156,"page":29},"Frameworks","\u002Fintegrate\u002Fframeworks","3.integrate\u002Fframeworks",[157,161,166,171,176,181,186,191,196,201,206,211,216,221,225,230,235],{"title":36,"path":158,"stem":159,"icon":160},"\u002Fintegrate\u002Fframeworks\u002Foverview","3.integrate\u002Fframeworks\u002F00.overview","i-lucide-layout-grid",{"title":162,"path":163,"stem":164,"icon":165},"Nuxt","\u002Fintegrate\u002Fframeworks\u002Fnuxt","3.integrate\u002Fframeworks\u002F01.nuxt","i-simple-icons-nuxtdotjs",{"title":167,"path":168,"stem":169,"icon":170},"Next.js","\u002Fintegrate\u002Fframeworks\u002Fnextjs","3.integrate\u002Fframeworks\u002F02.nextjs","i-simple-icons-nextdotjs",{"title":172,"path":173,"stem":174,"icon":175},"SvelteKit","\u002Fintegrate\u002Fframeworks\u002Fsveltekit","3.integrate\u002Fframeworks\u002F03.sveltekit","i-simple-icons-svelte",{"title":177,"path":178,"stem":179,"icon":180},"Nitro","\u002Fintegrate\u002Fframeworks\u002Fnitro","3.integrate\u002Fframeworks\u002F04.nitro","i-custom-nitro",{"title":182,"path":183,"stem":184,"icon":185},"TanStack Start","\u002Fintegrate\u002Fframeworks\u002Ftanstack-start","3.integrate\u002Fframeworks\u002F05.tanstack-start","i-custom-tanstack",{"title":187,"path":188,"stem":189,"icon":190},"NestJS","\u002Fintegrate\u002Fframeworks\u002Fnestjs","3.integrate\u002Fframeworks\u002F06.nestjs","i-simple-icons-nestjs",{"title":192,"path":193,"stem":194,"icon":195},"Express","\u002Fintegrate\u002Fframeworks\u002Fexpress","3.integrate\u002Fframeworks\u002F07.express","i-simple-icons-express",{"title":197,"path":198,"stem":199,"icon":200},"Hono","\u002Fintegrate\u002Fframeworks\u002Fhono","3.integrate\u002Fframeworks\u002F08.hono","i-simple-icons-hono",{"title":202,"path":203,"stem":204,"icon":205},"Fastify","\u002Fintegrate\u002Fframeworks\u002Ffastify","3.integrate\u002Fframeworks\u002F09.fastify","i-simple-icons-fastify",{"title":207,"path":208,"stem":209,"icon":210},"Elysia","\u002Fintegrate\u002Fframeworks\u002Felysia","3.integrate\u002Fframeworks\u002F10.elysia","i-custom-elysia",{"title":212,"path":213,"stem":214,"icon":215},"React Router","\u002Fintegrate\u002Fframeworks\u002Freact-router","3.integrate\u002Fframeworks\u002F11.react-router","i-custom-reactrouter",{"title":217,"path":218,"stem":219,"icon":220},"Cloudflare Workers","\u002Fintegrate\u002Fframeworks\u002Fcloudflare-workers","3.integrate\u002Fframeworks\u002F12.cloudflare-workers","i-simple-icons-cloudflare",{"title":222,"path":223,"stem":224,"icon":74},"Standalone","\u002Fintegrate\u002Fframeworks\u002Fstandalone","3.integrate\u002Fframeworks\u002F13.standalone",{"title":226,"path":227,"stem":228,"icon":229},"Astro","\u002Fintegrate\u002Fframeworks\u002Fastro","3.integrate\u002Fframeworks\u002F14.astro","i-simple-icons-astro",{"title":231,"path":232,"stem":233,"icon":234},"oRPC","\u002Fintegrate\u002Fframeworks\u002Forpc","3.integrate\u002Fframeworks\u002F15.orpc","i-lucide-network",{"title":236,"path":237,"stem":238,"icon":239},"AWS Lambda","\u002Fintegrate\u002Fframeworks\u002Faws-lambda","3.integrate\u002Fframeworks\u002F16.aws-lambda","i-custom-lambda",{"title":241,"path":242,"stem":243,"children":244,"page":29},"Use Cases","\u002Fuse-cases","4.use-cases",[245,249,254,283,311,343],{"title":36,"path":246,"stem":247,"icon":248},"\u002Fuse-cases\u002Foverview","4.use-cases\u002F0.overview","i-lucide-list-checks",{"title":250,"path":251,"stem":252,"icon":253},"Client Logging","\u002Fuse-cases\u002Fclient-logging","4.use-cases\u002F1.client-logging","i-lucide-monitor",{"title":255,"icon":256,"path":257,"stem":258,"children":259,"page":29},"AI SDK","i-simple-icons-vercel","\u002Fuse-cases\u002Fai-sdk","4.use-cases\u002F2.ai-sdk",[260,263,268,273,278],{"title":36,"path":261,"stem":262,"icon":39},"\u002Fuse-cases\u002Fai-sdk\u002Foverview","4.use-cases\u002F2.ai-sdk\u002F01.overview",{"title":264,"path":265,"stem":266,"icon":267},"Usage","\u002Fuse-cases\u002Fai-sdk\u002Fusage","4.use-cases\u002F2.ai-sdk\u002F02.usage","i-lucide-code",{"title":269,"path":270,"stem":271,"icon":272},"Options","\u002Fuse-cases\u002Fai-sdk\u002Foptions","4.use-cases\u002F2.ai-sdk\u002F03.options","i-lucide-sliders",{"title":274,"path":275,"stem":276,"icon":277},"Metadata","\u002Fuse-cases\u002Fai-sdk\u002Fmetadata","4.use-cases\u002F2.ai-sdk\u002F04.metadata","i-lucide-database",{"title":279,"path":280,"stem":281,"icon":282},"Telemetry","\u002Fuse-cases\u002Fai-sdk\u002Ftelemetry","4.use-cases\u002F2.ai-sdk\u002F05.telemetry","i-lucide-activity",{"title":284,"icon":285,"path":286,"stem":287,"children":288,"page":29},"Better Auth","i-simple-icons-betterauth","\u002Fuse-cases\u002Fbetter-auth","4.use-cases\u002F3.better-auth",[289,292,297,302,306],{"title":36,"path":290,"stem":291,"icon":39},"\u002Fuse-cases\u002Fbetter-auth\u002Foverview","4.use-cases\u002F3.better-auth\u002F01.overview",{"title":293,"path":294,"stem":295,"icon":296},"Identify User","\u002Fuse-cases\u002Fbetter-auth\u002Fidentify-user","4.use-cases\u002F3.better-auth\u002F02.identify-user","i-lucide-user-check",{"title":298,"path":299,"stem":300,"icon":301},"Middleware","\u002Fuse-cases\u002Fbetter-auth\u002Fmiddleware","4.use-cases\u002F3.better-auth\u002F03.middleware","i-lucide-shield",{"title":303,"path":304,"stem":305,"icon":253},"Client Sync","\u002Fuse-cases\u002Fbetter-auth\u002Fclient-sync","4.use-cases\u002F3.better-auth\u002F04.client-sync",{"title":307,"path":308,"stem":309,"icon":310},"Performance","\u002Fuse-cases\u002Fbetter-auth\u002Fperformance","4.use-cases\u002F3.better-auth\u002F05.performance","i-lucide-gauge",{"title":312,"icon":313,"path":314,"stem":315,"children":316,"page":29},"Audit Logs","i-lucide-shield-check","\u002Fuse-cases\u002Faudit","4.use-cases\u002F4.audit",[317,320,325,330,335,339],{"title":36,"path":318,"stem":319,"icon":39},"\u002Fuse-cases\u002Faudit\u002Foverview","4.use-cases\u002F4.audit\u002F01.overview",{"title":321,"path":322,"stem":323,"icon":324},"Schema","\u002Fuse-cases\u002Faudit\u002Fschema","4.use-cases\u002F4.audit\u002F02.schema","i-lucide-file-text",{"title":326,"path":327,"stem":328,"icon":329},"Recording","\u002Fuse-cases\u002Faudit\u002Frecording","4.use-cases\u002F4.audit\u002F03.recording","i-lucide-pen-line",{"title":331,"path":332,"stem":333,"icon":334},"Drains","\u002Fuse-cases\u002Faudit\u002Fpipeline","4.use-cases\u002F4.audit\u002F04.pipeline","i-lucide-link",{"title":336,"path":337,"stem":338,"icon":313},"Compliance","\u002Fuse-cases\u002Faudit\u002Fcompliance","4.use-cases\u002F4.audit\u002F05.compliance",{"title":340,"path":341,"stem":342,"icon":79},"Recipes","\u002Fuse-cases\u002Faudit\u002Frecipes","4.use-cases\u002F4.audit\u002F06.recipes",{"title":344,"path":345,"stem":346,"icon":347},"Enrichers","\u002Fuse-cases\u002Fenrichers","4.use-cases\u002F5.enrichers","i-lucide-sparkles",{"title":349,"path":350,"stem":351,"children":352,"page":29},"Extend","\u002Fextend","5.extend",[353,357,362,367,372,376,380,384,388,393,398],{"title":36,"path":354,"stem":355,"icon":356},"\u002Fextend\u002Foverview","5.extend\u002F0.overview","i-lucide-blocks",{"title":358,"path":359,"stem":360,"icon":361},"Stream","\u002Fextend\u002Fstream","5.extend\u002F1.stream","i-lucide-radio-tower",{"title":363,"path":364,"stem":365,"icon":366},"Custom framework","\u002Fextend\u002Fcustom-framework","5.extend\u002F10.custom-framework","i-lucide-puzzle",{"title":368,"path":369,"stem":370,"icon":371},"FS reader","\u002Fextend\u002Ffs-reader","5.extend\u002F2.fs-reader","i-lucide-folder-search",{"title":340,"path":373,"stem":374,"icon":375},"\u002Fextend\u002Fconsumer-recipes","5.extend\u002F3.consumer-recipes","i-lucide-chef-hat",{"title":377,"path":378,"stem":379,"icon":356},"Plugins","\u002Fextend\u002Fplugins","5.extend\u002F4.plugins",{"title":381,"path":382,"stem":383,"icon":347},"Custom enrichers","\u002Fextend\u002Fcustom-enrichers","5.extend\u002F5.custom-enrichers",{"title":385,"path":386,"stem":387,"icon":64},"Tail sampling","\u002Fextend\u002Ftail-sampling","5.extend\u002F6.tail-sampling",{"title":389,"path":390,"stem":391,"icon":392},"Identity headers","\u002Fextend\u002Fidentity-headers","5.extend\u002F7.identity-headers","i-lucide-fingerprint",{"title":394,"path":395,"stem":396,"icon":397},"Custom drains","\u002Fextend\u002Fcustom-drains","5.extend\u002F8.custom-drains","i-lucide-share-2",{"title":399,"path":400,"stem":401,"icon":402},"Drain pipeline","\u002Fextend\u002Fdrain-pipeline","5.extend\u002F9.drain-pipeline","i-lucide-workflow",{"title":404,"path":405,"stem":406,"children":407,"page":29},"Reference","\u002Freference","6.reference",[408,413,416,421,425,430],{"title":409,"path":410,"stem":411,"icon":412},"Configuration","\u002Freference\u002Fconfiguration","6.reference\u002F1.configuration","i-lucide-settings",{"title":307,"path":414,"stem":415,"icon":310},"\u002Freference\u002Fperformance","6.reference\u002F2.performance",{"title":417,"path":418,"stem":419,"icon":420},"Vite Plugin","\u002Freference\u002Fvite-plugin","6.reference\u002F3.vite-plugin","i-custom-vite",{"title":422,"path":423,"stem":424,"icon":313},"Best Practices","\u002Freference\u002Fbest-practices","6.reference\u002F4.best-practices",{"title":426,"path":427,"stem":428,"icon":429},"vs Other Loggers","\u002Freference\u002Fvs-other-loggers","6.reference\u002F5.vs-other-loggers","i-lucide-scale",{"title":431,"path":432,"stem":433,"icon":347},"Agent Skills","\u002Freference\u002Fagent-skills","6.reference\u002F6.agent-skills",{"id":435,"title":10,"body":436,"description":1550,"extension":1551,"links":1552,"meta":1561,"navigation":1562,"path":11,"seo":1563,"stem":12,"__hash__":1564},"docs\u002F1.start\u002F1.introduction.md",{"type":437,"value":438,"toc":1539},"minimark",[439,452,469,474,477,482,504,517,521,524,587,594,598,601,605,611,753,756,759,1182,1185,1188,1200,1453,1457,1464,1487,1497,1501,1535],[440,441,442,446,447,451],"p",{},[443,444,445],"strong",{},"evlog"," is a modern TypeScript logger built for everything you ship. It gives you simple structured logs (a drop-in for ",[448,449,450],"code",{},"console.log",", pino, or consola), wide events that accumulate context across an operation, and structured errors that explain why they happened — all in one API, all behind the same drain pipeline. Use it in CLIs, libraries, background jobs, edge workers, and HTTP handlers without switching loggers.",[440,453,454,455,462,463,468],{},"Inspired by ",[456,457,461],"a",{"href":458,"rel":459},"https:\u002F\u002Floggingsucks.com\u002F",[460],"nofollow","Logging Sucks"," by ",[456,464,467],{"href":465,"rel":466},"https:\u002F\u002Fx.com\u002Fboristane",[460],"Boris Tane",".",[470,471,473],"h2",{"id":472},"philosophy","Philosophy",[440,475,476],{},"Traditional logging is broken. Your logs are scattered across dozens of files. Each request generates 10+ log lines. When something goes wrong, you're left grep-ing through noise hoping to find signal.",[440,478,479,481],{},[443,480,445],{}," takes a different approach:",[483,484,485,493,496,499],"card-group",{},[486,487,489,490,492],"card",{"icon":44,"title":488},"Structured Logging","Replace ",[448,491,450],{}," with typed, structured events that flow through a drain pipeline. Same level filtering, redaction, and pretty\u002FJSON output as pino or consola.",[486,494,495],{"icon":49,"title":46},"Accumulate context over any unit of work (a request, script, or job) and emit once. The two modes coexist — neither is an upgrade of the other.",[486,497,498],{"icon":54,"title":51},"Errors that explain why they occurred and how to fix them.",[486,500,503],{"icon":501,"title":502},"i-lucide-palette","Pretty for Dev","Human-readable in development, machine-parseable JSON in production.",[505,506,509,510,513,514,516],"callout",{"color":507,"icon":508},"info","i-lucide-globe","Not running an HTTP framework? See ",[456,511,512],{"href":223},"Standalone TypeScript"," for scripts, workers, and CLIs, and ",[456,515,217],{"href":218}," for the edge runtime.",[470,518,520],{"id":519},"why-evlog-over-pino-winston-or-consola","Why evlog over pino, winston, or consola",[440,522,523],{},"evlog is a fully-featured general-purpose logger that happens to also do wide events. Concretely:",[525,526,527,538,556,573],"ul",{},[528,529,530,533,534,537],"li",{},[443,531,532],{},"Zero transitive dependencies"," and ~6 kB gzip — nothing to audit, nothing that breaks on the next Node LTS. Benchmarked at ",[456,535,536],{"href":414},"~3 µs\u002Frequest",", 7.7x faster than pino in the wide event pattern (1 event vs 4 log lines) and competitive on every other path.",[528,539,540,543,544,547,548,551,552,555],{},[443,541,542],{},"Same API in every context"," — scripts, frameworks, edge runtimes, browser, library code. No ",[448,545,546],{},"pino-http"," vs ",[448,549,550],{},"pino"," split, no separate ",[448,553,554],{},"consola"," reporters per environment.",[528,557,558,572],{},[443,559,560,561,564,565,564,568,571],{},"Structured errors with ",[448,562,563],{},"why"," \u002F ",[448,566,567],{},"fix",[448,569,570],{},"link"," built in"," — your error toast finally tells users what went wrong and what to do, your on-call stops reverse-engineering stack traces.",[528,574,575,578,579,582,583,586],{},[443,576,577],{},"Wide events as a free upgrade path"," — when you need to correlate context across an operation, the same logger gives you ",[448,580,581],{},"log.set"," + ",[448,584,585],{},"log.emit"," instead of stitching log lines together later.",[440,588,589,590,593],{},"See the full ",[456,591,592],{"href":427},"feature comparison"," (parity matrix, honest gaps, and migration snippets) for a side-by-side with pino, winston, and consola.",[470,595,597],{"id":596},"three-ways-to-log","Three Ways to Log",[440,599,600],{},"evlog provides three APIs for different contexts. You can use all three in the same project.",[602,603,41],"h3",{"id":604},"simple-logging",[440,606,607,608,610],{},"Fire-and-forget structured logs. Replace ",[448,609,450],{},", consola, or pino:",[612,613,619],"pre",{"className":614,"code":615,"filename":616,"language":617,"meta":618,"style":618},"language-typescript shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import { log } from 'evlog'\n\nlog.info('auth', 'User logged in')\nlog.error({ action: 'payment', error: 'card_declined', userId: 42 })\n","src\u002Findex.ts","typescript","",[448,620,621,653,660,695],{"__ignoreMap":618},[622,623,626,630,634,638,641,644,647,650],"span",{"class":624,"line":625},"line",1,[622,627,629],{"class":628},"s7zQu","import",[622,631,633],{"class":632},"sMK4o"," {",[622,635,637],{"class":636},"sTEyZ"," log",[622,639,640],{"class":632}," }",[622,642,643],{"class":628}," from",[622,645,646],{"class":632}," '",[622,648,445],{"class":649},"sfazB",[622,651,652],{"class":632},"'\n",[622,654,656],{"class":624,"line":655},2,[622,657,659],{"emptyLinePlaceholder":658},true,"\n",[622,661,663,666,668,671,674,677,680,682,685,687,690,692],{"class":624,"line":662},3,[622,664,665],{"class":636},"log",[622,667,468],{"class":632},[622,669,507],{"class":670},"s2Zo4",[622,672,673],{"class":636},"(",[622,675,676],{"class":632},"'",[622,678,679],{"class":649},"auth",[622,681,676],{"class":632},[622,683,684],{"class":632},",",[622,686,646],{"class":632},[622,688,689],{"class":649},"User logged in",[622,691,676],{"class":632},[622,693,694],{"class":636},")\n",[622,696,698,700,702,705,707,710,714,717,719,722,724,726,729,731,733,736,738,740,743,745,749,751],{"class":624,"line":697},4,[622,699,665],{"class":636},[622,701,468],{"class":632},[622,703,704],{"class":670},"error",[622,706,673],{"class":636},[622,708,709],{"class":632},"{",[622,711,713],{"class":712},"swJcz"," action",[622,715,716],{"class":632},":",[622,718,646],{"class":632},[622,720,721],{"class":649},"payment",[622,723,676],{"class":632},[622,725,684],{"class":632},[622,727,728],{"class":712}," error",[622,730,716],{"class":632},[622,732,646],{"class":632},[622,734,735],{"class":649},"card_declined",[622,737,676],{"class":632},[622,739,684],{"class":632},[622,741,742],{"class":712}," userId",[622,744,716],{"class":632},[622,746,748],{"class":747},"sbssI"," 42",[622,750,640],{"class":632},[622,752,694],{"class":636},[602,754,46],{"id":755},"wide-events",[440,757,758],{},"Accumulate context progressively over any operation, then emit a single comprehensive event:",[760,761,762,895,1025],"code-group",{},[612,763,766],{"className":614,"code":764,"filename":765,"language":617,"meta":618,"style":618},"import { createLogger } from 'evlog'\n\nconst log = createLogger({ jobId: 'sync-001', queue: 'emails' })\nlog.set({ batch: { size: 50, processed: 50 } })\nlog.emit()\n","scripts\u002Fsync-job.ts",[448,767,768,787,791,839,882],{"__ignoreMap":618},[622,769,770,772,774,777,779,781,783,785],{"class":624,"line":625},[622,771,629],{"class":628},[622,773,633],{"class":632},[622,775,776],{"class":636}," createLogger",[622,778,640],{"class":632},[622,780,643],{"class":628},[622,782,646],{"class":632},[622,784,445],{"class":649},[622,786,652],{"class":632},[622,788,789],{"class":624,"line":655},[622,790,659],{"emptyLinePlaceholder":658},[622,792,793,797,800,803,805,807,809,812,814,816,819,821,823,826,828,830,833,835,837],{"class":624,"line":662},[622,794,796],{"class":795},"spNyl","const",[622,798,799],{"class":636}," log ",[622,801,802],{"class":632},"=",[622,804,776],{"class":670},[622,806,673],{"class":636},[622,808,709],{"class":632},[622,810,811],{"class":712}," jobId",[622,813,716],{"class":632},[622,815,646],{"class":632},[622,817,818],{"class":649},"sync-001",[622,820,676],{"class":632},[622,822,684],{"class":632},[622,824,825],{"class":712}," queue",[622,827,716],{"class":632},[622,829,646],{"class":632},[622,831,832],{"class":649},"emails",[622,834,676],{"class":632},[622,836,640],{"class":632},[622,838,694],{"class":636},[622,840,841,843,845,848,850,852,855,857,859,862,864,867,869,872,874,876,878,880],{"class":624,"line":697},[622,842,665],{"class":636},[622,844,468],{"class":632},[622,846,847],{"class":670},"set",[622,849,673],{"class":636},[622,851,709],{"class":632},[622,853,854],{"class":712}," batch",[622,856,716],{"class":632},[622,858,633],{"class":632},[622,860,861],{"class":712}," size",[622,863,716],{"class":632},[622,865,866],{"class":747}," 50",[622,868,684],{"class":632},[622,870,871],{"class":712}," processed",[622,873,716],{"class":632},[622,875,866],{"class":747},[622,877,640],{"class":632},[622,879,640],{"class":632},[622,881,694],{"class":636},[622,883,885,887,889,892],{"class":624,"line":884},5,[622,886,665],{"class":636},[622,888,468],{"class":632},[622,890,891],{"class":670},"emit",[622,893,894],{"class":636},"()\n",[612,896,899],{"className":614,"code":897,"filename":898,"language":617,"meta":618,"style":618},"import { createRequestLogger } from 'evlog'\n\nconst log = createRequestLogger({ method: 'POST', path: '\u002Fapi\u002Fcheckout' })\nlog.set({ user: { id: 1, plan: 'pro' } })\nlog.emit()\n","src\u002Fworker.ts",[448,900,901,920,924,968,1015],{"__ignoreMap":618},[622,902,903,905,907,910,912,914,916,918],{"class":624,"line":625},[622,904,629],{"class":628},[622,906,633],{"class":632},[622,908,909],{"class":636}," createRequestLogger",[622,911,640],{"class":632},[622,913,643],{"class":628},[622,915,646],{"class":632},[622,917,445],{"class":649},[622,919,652],{"class":632},[622,921,922],{"class":624,"line":655},[622,923,659],{"emptyLinePlaceholder":658},[622,925,926,928,930,932,934,936,938,941,943,945,948,950,952,955,957,959,962,964,966],{"class":624,"line":662},[622,927,796],{"class":795},[622,929,799],{"class":636},[622,931,802],{"class":632},[622,933,909],{"class":670},[622,935,673],{"class":636},[622,937,709],{"class":632},[622,939,940],{"class":712}," method",[622,942,716],{"class":632},[622,944,646],{"class":632},[622,946,947],{"class":649},"POST",[622,949,676],{"class":632},[622,951,684],{"class":632},[622,953,954],{"class":712}," path",[622,956,716],{"class":632},[622,958,646],{"class":632},[622,960,961],{"class":649},"\u002Fapi\u002Fcheckout",[622,963,676],{"class":632},[622,965,640],{"class":632},[622,967,694],{"class":636},[622,969,970,972,974,976,978,980,983,985,987,990,992,995,997,1000,1002,1004,1007,1009,1011,1013],{"class":624,"line":697},[622,971,665],{"class":636},[622,973,468],{"class":632},[622,975,847],{"class":670},[622,977,673],{"class":636},[622,979,709],{"class":632},[622,981,982],{"class":712}," user",[622,984,716],{"class":632},[622,986,633],{"class":632},[622,988,989],{"class":712}," id",[622,991,716],{"class":632},[622,993,994],{"class":747}," 1",[622,996,684],{"class":632},[622,998,999],{"class":712}," plan",[622,1001,716],{"class":632},[622,1003,646],{"class":632},[622,1005,1006],{"class":649},"pro",[622,1008,676],{"class":632},[622,1010,640],{"class":632},[622,1012,640],{"class":632},[622,1014,694],{"class":636},[622,1016,1017,1019,1021,1023],{"class":624,"line":884},[622,1018,665],{"class":636},[622,1020,468],{"class":632},[622,1022,891],{"class":670},[622,1024,894],{"class":636},[612,1026,1029],{"className":614,"code":1027,"filename":1028,"language":617,"meta":618,"style":618},"import { useLogger } from 'evlog'\n\nexport default defineEventHandler(async (event) => {\n  const log = useLogger(event)\n  log.set({ user: { id: 1, plan: 'pro' } })\n  return { success: true }\n  \u002F\u002F auto-emitted on response end\n})\n","server\u002Fapi\u002Fcheckout.post.ts",[448,1030,1031,1050,1054,1086,1104,1147,1167,1174],{"__ignoreMap":618},[622,1032,1033,1035,1037,1040,1042,1044,1046,1048],{"class":624,"line":625},[622,1034,629],{"class":628},[622,1036,633],{"class":632},[622,1038,1039],{"class":636}," useLogger",[622,1041,640],{"class":632},[622,1043,643],{"class":628},[622,1045,646],{"class":632},[622,1047,445],{"class":649},[622,1049,652],{"class":632},[622,1051,1052],{"class":624,"line":655},[622,1053,659],{"emptyLinePlaceholder":658},[622,1055,1056,1059,1062,1065,1067,1070,1073,1077,1080,1083],{"class":624,"line":662},[622,1057,1058],{"class":628},"export",[622,1060,1061],{"class":628}," default",[622,1063,1064],{"class":670}," defineEventHandler",[622,1066,673],{"class":636},[622,1068,1069],{"class":795},"async",[622,1071,1072],{"class":632}," (",[622,1074,1076],{"class":1075},"sHdIc","event",[622,1078,1079],{"class":632},")",[622,1081,1082],{"class":795}," =>",[622,1084,1085],{"class":632}," {\n",[622,1087,1088,1091,1093,1096,1098,1100,1102],{"class":624,"line":697},[622,1089,1090],{"class":795},"  const",[622,1092,637],{"class":636},[622,1094,1095],{"class":632}," =",[622,1097,1039],{"class":670},[622,1099,673],{"class":712},[622,1101,1076],{"class":636},[622,1103,694],{"class":712},[622,1105,1106,1109,1111,1113,1115,1117,1119,1121,1123,1125,1127,1129,1131,1133,1135,1137,1139,1141,1143,1145],{"class":624,"line":884},[622,1107,1108],{"class":636},"  log",[622,1110,468],{"class":632},[622,1112,847],{"class":670},[622,1114,673],{"class":712},[622,1116,709],{"class":632},[622,1118,982],{"class":712},[622,1120,716],{"class":632},[622,1122,633],{"class":632},[622,1124,989],{"class":712},[622,1126,716],{"class":632},[622,1128,994],{"class":747},[622,1130,684],{"class":632},[622,1132,999],{"class":712},[622,1134,716],{"class":632},[622,1136,646],{"class":632},[622,1138,1006],{"class":649},[622,1140,676],{"class":632},[622,1142,640],{"class":632},[622,1144,640],{"class":632},[622,1146,694],{"class":712},[622,1148,1150,1153,1155,1158,1160,1164],{"class":624,"line":1149},6,[622,1151,1152],{"class":628},"  return",[622,1154,633],{"class":632},[622,1156,1157],{"class":712}," success",[622,1159,716],{"class":632},[622,1161,1163],{"class":1162},"sfNiH"," true",[622,1165,1166],{"class":632}," }\n",[622,1168,1170],{"class":624,"line":1169},7,[622,1171,1173],{"class":1172},"sHwdD","  \u002F\u002F auto-emitted on response end\n",[622,1175,1177,1180],{"class":624,"line":1176},8,[622,1178,1179],{"class":632},"}",[622,1181,694],{"class":636},[440,1183,1184],{},"One log, all context. Everything you need to understand what happened.",[602,1186,51],{"id":1187},"structured-errors",[440,1189,1190,1191,1193,1194,1196,1197,1199],{},"Errors with actionable context: ",[448,1192,563],{}," it happened, how to ",[448,1195,567],{}," it, and a ",[448,1198,570],{}," to docs:",[760,1201,1202,1326],{},[612,1203,1205],{"className":614,"code":1204,"filename":1028,"language":617,"meta":618,"style":618},"import { createError } from 'evlog'\n\nthrow createError({\n  message: 'Payment failed',\n  status: 402,\n  why: 'Card declined by issuer (insufficient funds)',\n  fix: 'Try a different payment method or contact your bank',\n  link: 'https:\u002F\u002Fdocs.example.com\u002Fpayments\u002Fdeclined',\n})\n",[448,1206,1207,1226,1230,1242,1259,1271,1287,1303,1319],{"__ignoreMap":618},[622,1208,1209,1211,1213,1216,1218,1220,1222,1224],{"class":624,"line":625},[622,1210,629],{"class":628},[622,1212,633],{"class":632},[622,1214,1215],{"class":636}," createError",[622,1217,640],{"class":632},[622,1219,643],{"class":628},[622,1221,646],{"class":632},[622,1223,445],{"class":649},[622,1225,652],{"class":632},[622,1227,1228],{"class":624,"line":655},[622,1229,659],{"emptyLinePlaceholder":658},[622,1231,1232,1235,1237,1239],{"class":624,"line":662},[622,1233,1234],{"class":628},"throw",[622,1236,1215],{"class":670},[622,1238,673],{"class":636},[622,1240,1241],{"class":632},"{\n",[622,1243,1244,1247,1249,1251,1254,1256],{"class":624,"line":697},[622,1245,1246],{"class":712},"  message",[622,1248,716],{"class":632},[622,1250,646],{"class":632},[622,1252,1253],{"class":649},"Payment failed",[622,1255,676],{"class":632},[622,1257,1258],{"class":632},",\n",[622,1260,1261,1264,1266,1269],{"class":624,"line":884},[622,1262,1263],{"class":712},"  status",[622,1265,716],{"class":632},[622,1267,1268],{"class":747}," 402",[622,1270,1258],{"class":632},[622,1272,1273,1276,1278,1280,1283,1285],{"class":624,"line":1149},[622,1274,1275],{"class":712},"  why",[622,1277,716],{"class":632},[622,1279,646],{"class":632},[622,1281,1282],{"class":649},"Card declined by issuer (insufficient funds)",[622,1284,676],{"class":632},[622,1286,1258],{"class":632},[622,1288,1289,1292,1294,1296,1299,1301],{"class":624,"line":1169},[622,1290,1291],{"class":712},"  fix",[622,1293,716],{"class":632},[622,1295,646],{"class":632},[622,1297,1298],{"class":649},"Try a different payment method or contact your bank",[622,1300,676],{"class":632},[622,1302,1258],{"class":632},[622,1304,1305,1308,1310,1312,1315,1317],{"class":624,"line":1176},[622,1306,1307],{"class":712},"  link",[622,1309,716],{"class":632},[622,1311,646],{"class":632},[622,1313,1314],{"class":649},"https:\u002F\u002Fdocs.example.com\u002Fpayments\u002Fdeclined",[622,1316,676],{"class":632},[622,1318,1258],{"class":632},[622,1320,1322,1324],{"class":624,"line":1321},9,[622,1323,1179],{"class":632},[622,1325,694],{"class":636},[612,1327,1332],{"className":1328,"code":1329,"filename":1330,"language":1331,"meta":618,"style":618},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"statusCode\": 402,\n  \"message\": \"Payment failed\",\n  \"data\": {\n    \"why\": \"Card declined by issuer (insufficient funds)\",\n    \"fix\": \"Try a different payment method or contact your bank\",\n    \"link\": \"https:\u002F\u002Fdocs.example.com\u002Fpayments\u002Fdeclined\"\n  }\n}\n","Response","json",[448,1333,1334,1338,1355,1375,1388,1408,1426,1443,1448],{"__ignoreMap":618},[622,1335,1336],{"class":624,"line":625},[622,1337,1241],{"class":632},[622,1339,1340,1343,1346,1349,1351,1353],{"class":624,"line":655},[622,1341,1342],{"class":632},"  \"",[622,1344,1345],{"class":795},"statusCode",[622,1347,1348],{"class":632},"\"",[622,1350,716],{"class":632},[622,1352,1268],{"class":747},[622,1354,1258],{"class":632},[622,1356,1357,1359,1362,1364,1366,1369,1371,1373],{"class":624,"line":662},[622,1358,1342],{"class":632},[622,1360,1361],{"class":795},"message",[622,1363,1348],{"class":632},[622,1365,716],{"class":632},[622,1367,1368],{"class":632}," \"",[622,1370,1253],{"class":649},[622,1372,1348],{"class":632},[622,1374,1258],{"class":632},[622,1376,1377,1379,1382,1384,1386],{"class":624,"line":697},[622,1378,1342],{"class":632},[622,1380,1381],{"class":795},"data",[622,1383,1348],{"class":632},[622,1385,716],{"class":632},[622,1387,1085],{"class":632},[622,1389,1390,1393,1396,1398,1400,1402,1404,1406],{"class":624,"line":884},[622,1391,1392],{"class":632},"    \"",[622,1394,563],{"class":1395},"sBMFI",[622,1397,1348],{"class":632},[622,1399,716],{"class":632},[622,1401,1368],{"class":632},[622,1403,1282],{"class":649},[622,1405,1348],{"class":632},[622,1407,1258],{"class":632},[622,1409,1410,1412,1414,1416,1418,1420,1422,1424],{"class":624,"line":1149},[622,1411,1392],{"class":632},[622,1413,567],{"class":1395},[622,1415,1348],{"class":632},[622,1417,716],{"class":632},[622,1419,1368],{"class":632},[622,1421,1298],{"class":649},[622,1423,1348],{"class":632},[622,1425,1258],{"class":632},[622,1427,1428,1430,1432,1434,1436,1438,1440],{"class":624,"line":1169},[622,1429,1392],{"class":632},[622,1431,570],{"class":1395},[622,1433,1348],{"class":632},[622,1435,716],{"class":632},[622,1437,1368],{"class":632},[622,1439,1314],{"class":649},[622,1441,1442],{"class":632},"\"\n",[622,1444,1445],{"class":624,"line":1176},[622,1446,1447],{"class":632},"  }\n",[622,1449,1450],{"class":624,"line":1321},[622,1451,1452],{"class":632},"}\n",[470,1454,1456],{"id":1455},"why-context-matters","Why Context Matters",[440,1458,1459,1460,1463],{},"We're entering an era where AI agents build, debug, and maintain applications. These agents need ",[443,1461,1462],{},"structured context"," to work effectively:",[525,1465,1466,1473,1480],{},[528,1467,1468,1472],{},[443,1469,1470],{},[448,1471,563],{},": The root cause, so the agent understands what went wrong",[528,1474,1475,1479],{},[443,1476,1477],{},[448,1478,567],{},": An actionable solution the agent can suggest or apply",[528,1481,1482,1486],{},[443,1483,1484],{},[448,1485,570],{},": Documentation for complex issues",[440,1488,1489,1490,1492,1493,1496],{},"Traditional ",[448,1491,450],{}," and generic ",[448,1494,1495],{},"throw new Error()"," provide no actionable context. evlog's structured output is designed for both humans and AI to parse and act on.",[470,1498,1500],{"id":1499},"next-steps","Next Steps",[525,1502,1503,1508,1513,1518,1524,1530],{},[528,1504,1505,1507],{},[456,1506,15],{"href":16}," - The case for adopting evlog on day zero",[528,1509,1510,1512],{},[456,1511,20],{"href":21}," - Install evlog in your project",[528,1514,1515,1517],{},[456,1516,25],{"href":26}," - Get up and running in minutes",[528,1519,1520,1523],{},[456,1521,1522],{"href":37},"Logging Overview"," - Understand the three logging modes in depth",[528,1525,1526,1529],{},[456,1527,1528],{"href":427},"evlog vs pino, winston, consola"," - Feature parity, honest gaps, and migration snippets",[528,1531,1532,1534],{},[456,1533,512],{"href":223}," — scripts, workers, libraries without a web framework",[1536,1537,1538],"style",{},"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 .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}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 .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}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 .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sHdIc, html code.shiki .sHdIc{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic}html pre.shiki code .sfNiH, html code.shiki .sfNiH{--shiki-light:#FF5370;--shiki-default:#FF9CAC;--shiki-dark:#FF9CAC}html pre.shiki code .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 .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}",{"title":618,"searchDepth":655,"depth":655,"links":1540},[1541,1542,1543,1548,1549],{"id":472,"depth":655,"text":473},{"id":519,"depth":655,"text":520},{"id":596,"depth":655,"text":597,"children":1544},[1545,1546,1547],{"id":604,"depth":662,"text":41},{"id":755,"depth":662,"text":46},{"id":1187,"depth":662,"text":51},{"id":1455,"depth":655,"text":1456},{"id":1499,"depth":655,"text":1500},"A modern TypeScript logger built for everything you ship. Simple structured logs, wide events, and structured errors in one API — drop-in for console.log, pino, or consola.","md",[1553,1556],{"label":25,"icon":28,"to":26,"color":1554,"variant":1555},"neutral","subtle",{"label":1557,"icon":1558,"to":1559,"target":1560,"color":1554,"variant":1555},"GitHub","i-simple-icons-github","https:\u002F\u002Fgithub.com\u002Fhugorcd\u002Fevlog","_blank",{},{"icon":13},{"title":10,"description":1550},"mVhx71oKgHyTzLn-ydrK0KNoL7AriAU8krm9m2N2H60",[1566,1567],null,{"title":15,"path":16,"stem":17,"description":1568,"icon":18,"children":-1},"The cheapest moment to add structured logging is before the first request. Pick evlog on day zero and your application inherits a structured surface, typed catalogs, an audit trail, AI SDK telemetry, and a drain pipeline you don't have to build later.",1778444994694]