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