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