[{"data":1,"prerenderedAt":2167},["ShallowReactive",2],{"navigation_docs":3,"-integrate-adapters-self-hosted-fs":520,"-integrate-adapters-self-hosted-fs-surround":2162},[4,30,80,123,303,435,490],{"title":5,"path":6,"stem":7,"children":8,"page":29},"Start","\u002Fstart","1.start",[9,14,19,24],{"title":10,"path":11,"stem":12,"icon":13},"Introduction","\u002Fstart\u002Fintroduction","1.start\u002F1.introduction","i-lucide-info",{"title":15,"path":16,"stem":17,"icon":18},"Why start with evlog","\u002Fstart\u002Fwhy-evlog","1.start\u002F2.why-evlog","i-lucide-rocket",{"title":20,"path":21,"stem":22,"icon":23},"Installation","\u002Fstart\u002Finstallation","1.start\u002F3.installation","i-lucide-download",{"title":25,"path":26,"stem":27,"icon":28},"Quick Start","\u002Fstart\u002Fquick-start","1.start\u002F4.quick-start","i-lucide-zap",false,{"title":31,"path":32,"stem":33,"children":34,"page":29},"Learn","\u002Flearn","2.learn",[35,40,45,50,55,60,65,70,75],{"title":36,"path":37,"stem":38,"icon":39},"Overview","\u002Flearn\u002Foverview","2.learn\u002F0.overview","i-lucide-list",{"title":41,"path":42,"stem":43,"icon":44},"Simple Logging","\u002Flearn\u002Fsimple-logging","2.learn\u002F1.simple-logging","i-lucide-terminal",{"title":46,"path":47,"stem":48,"icon":49},"Wide Events","\u002Flearn\u002Fwide-events","2.learn\u002F2.wide-events","i-lucide-layers",{"title":51,"path":52,"stem":53,"icon":54},"Structured Errors","\u002Flearn\u002Fstructured-errors","2.learn\u002F3.structured-errors","i-lucide-shield-alert",{"title":56,"path":57,"stem":58,"icon":59},"Lifecycle","\u002Flearn\u002Flifecycle","2.learn\u002F4.lifecycle","i-lucide-arrow-right-left",{"title":61,"path":62,"stem":63,"icon":64},"Sampling","\u002Flearn\u002Fsampling","2.learn\u002F5.sampling","i-lucide-filter",{"title":66,"path":67,"stem":68,"icon":69},"Auto-Redaction","\u002Flearn\u002Fredaction","2.learn\u002F6.redaction","i-lucide-eye-off",{"title":71,"path":72,"stem":73,"icon":74},"Typed Fields","\u002Flearn\u002Ftyped-fields","2.learn\u002F7.typed-fields","i-simple-icons-typescript",{"title":76,"path":77,"stem":78,"icon":79},"Catalogs","\u002Flearn\u002Fcatalogs","2.learn\u002F8.catalogs","i-lucide-book-open",{"title":81,"path":82,"stem":83,"children":84,"page":29},"CLI","\u002Fcli","3.cli",[85,88,93,98,103,108,113,118],{"title":36,"path":86,"stem":87,"icon":44},"\u002Fcli\u002Foverview","3.cli\u002F0.overview",{"title":89,"path":90,"stem":91,"icon":92},"init","\u002Fcli\u002Finit","3.cli\u002F1.init","i-lucide-wand-sparkles",{"title":94,"path":95,"stem":96,"icon":97},"map","\u002Fcli\u002Fmap","3.cli\u002F2.map","i-lucide-radar",{"title":99,"path":100,"stem":101,"icon":102},"Rules","\u002Fcli\u002Frules","3.cli\u002F3.rules","i-lucide-list-checks",{"title":104,"path":105,"stem":106,"icon":107},"Scoring","\u002Fcli\u002Fscoring","3.cli\u002F4.scoring","i-lucide-gauge",{"title":109,"path":110,"stem":111,"icon":112},"CI","\u002Fcli\u002Fci","3.cli\u002F5.ci","i-lucide-git-pull-request",{"title":114,"path":115,"stem":116,"icon":117},"doctor","\u002Fcli\u002Fdoctor","3.cli\u002F6.doctor","i-lucide-stethoscope",{"title":119,"path":120,"stem":121,"icon":122},"telemetry","\u002Fcli\u002Ftelemetry","3.cli\u002F7.telemetry","i-lucide-bar-chart-3",{"title":124,"path":125,"stem":126,"children":127,"page":29},"Integrate","\u002Fintegrate","4.integrate",[128,132,215],{"title":36,"path":129,"stem":130,"icon":131},"\u002Fintegrate\u002Foverview","4.integrate\u002F0.overview","i-lucide-plug",{"title":133,"path":134,"stem":135,"children":136,"page":29},"Adapters","\u002Fintegrate\u002Fadapters","4.integrate\u002Fadapters",[137,140,170,195],{"title":36,"path":138,"stem":139,"icon":39},"\u002Fintegrate\u002Fadapters\u002Foverview","4.integrate\u002Fadapters\u002F01.overview",{"title":141,"path":142,"stem":143,"children":144,"page":29},"Cloud","\u002Fintegrate\u002Fadapters\u002Fcloud","4.integrate\u002Fadapters\u002Fcloud",[145,150,155,160,165],{"title":146,"path":147,"stem":148,"icon":149},"Axiom","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Faxiom","4.integrate\u002Fadapters\u002Fcloud\u002F01.axiom","i-custom-axiom",{"title":151,"path":152,"stem":153,"icon":154},"PostHog","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fposthog","4.integrate\u002Fadapters\u002Fcloud\u002F02.posthog","i-simple-icons-posthog",{"title":156,"path":157,"stem":158,"icon":159},"Sentry","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fsentry","4.integrate\u002Fadapters\u002Fcloud\u002F03.sentry","i-simple-icons-sentry",{"title":161,"path":162,"stem":163,"icon":164},"Better Stack","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fbetter-stack","4.integrate\u002Fadapters\u002Fcloud\u002F04.better-stack","i-simple-icons-betterstack",{"title":166,"path":167,"stem":168,"icon":169},"Datadog","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fdatadog","4.integrate\u002Fadapters\u002Fcloud\u002F05.datadog","i-simple-icons-datadog",{"title":171,"path":172,"stem":173,"children":174,"page":29},"Cloud or Self-Hosted","\u002Fintegrate\u002Fadapters\u002Fhybrid","4.integrate\u002Fadapters\u002Fhybrid",[175,180,185,190],{"title":176,"path":177,"stem":178,"icon":179},"Grafana Loki","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Floki","4.integrate\u002Fadapters\u002Fhybrid\u002F01.loki","i-simple-icons-grafana",{"title":181,"path":182,"stem":183,"icon":184},"ClickHouse","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Fclickhouse","4.integrate\u002Fadapters\u002Fhybrid\u002F02.clickhouse","i-simple-icons-clickhouse",{"title":186,"path":187,"stem":188,"icon":189},"OTLP","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Fotlp","4.integrate\u002Fadapters\u002Fhybrid\u002F03.otlp","i-simple-icons-opentelemetry",{"title":191,"path":192,"stem":193,"icon":194},"HyperDX","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Fhyperdx","4.integrate\u002Fadapters\u002Fhybrid\u002F04.hyperdx","i-custom-hyperdx",{"title":196,"path":197,"stem":198,"children":199,"page":29},"Self-Hosted","\u002Fintegrate\u002Fadapters\u002Fself-hosted","4.integrate\u002Fadapters\u002Fself-hosted",[200,205,210],{"title":201,"path":202,"stem":203,"icon":204},"File System","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Ffs","4.integrate\u002Fadapters\u002Fself-hosted\u002F01.fs","i-lucide-hard-drive",{"title":206,"path":207,"stem":208,"icon":209},"NuxtHub","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Fnuxthub","4.integrate\u002Fadapters\u002Fself-hosted\u002F02.nuxthub","i-simple-icons-nuxt",{"title":211,"path":212,"stem":213,"icon":214},"Memory","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Fmemory","4.integrate\u002Fadapters\u002Fself-hosted\u002F03.memory","i-lucide-cpu",{"title":216,"path":217,"stem":218,"children":219,"page":29},"Frameworks","\u002Fintegrate\u002Fframeworks","4.integrate\u002Fframeworks",[220,224,229,234,239,244,249,254,259,264,269,274,279,284,288,293,298],{"title":36,"path":221,"stem":222,"icon":223},"\u002Fintegrate\u002Fframeworks\u002Foverview","4.integrate\u002Fframeworks\u002F00.overview","i-lucide-layout-grid",{"title":225,"path":226,"stem":227,"icon":228},"Nuxt","\u002Fintegrate\u002Fframeworks\u002Fnuxt","4.integrate\u002Fframeworks\u002F01.nuxt","i-simple-icons-nuxtdotjs",{"title":230,"path":231,"stem":232,"icon":233},"Next.js","\u002Fintegrate\u002Fframeworks\u002Fnextjs","4.integrate\u002Fframeworks\u002F02.nextjs","i-simple-icons-nextdotjs",{"title":235,"path":236,"stem":237,"icon":238},"SvelteKit","\u002Fintegrate\u002Fframeworks\u002Fsveltekit","4.integrate\u002Fframeworks\u002F03.sveltekit","i-simple-icons-svelte",{"title":240,"path":241,"stem":242,"icon":243},"Nitro","\u002Fintegrate\u002Fframeworks\u002Fnitro","4.integrate\u002Fframeworks\u002F04.nitro","i-custom-nitro",{"title":245,"path":246,"stem":247,"icon":248},"TanStack Start","\u002Fintegrate\u002Fframeworks\u002Ftanstack-start","4.integrate\u002Fframeworks\u002F05.tanstack-start","i-custom-tanstack",{"title":250,"path":251,"stem":252,"icon":253},"NestJS","\u002Fintegrate\u002Fframeworks\u002Fnestjs","4.integrate\u002Fframeworks\u002F06.nestjs","i-simple-icons-nestjs",{"title":255,"path":256,"stem":257,"icon":258},"Express","\u002Fintegrate\u002Fframeworks\u002Fexpress","4.integrate\u002Fframeworks\u002F07.express","i-simple-icons-express",{"title":260,"path":261,"stem":262,"icon":263},"Hono","\u002Fintegrate\u002Fframeworks\u002Fhono","4.integrate\u002Fframeworks\u002F08.hono","i-simple-icons-hono",{"title":265,"path":266,"stem":267,"icon":268},"Fastify","\u002Fintegrate\u002Fframeworks\u002Ffastify","4.integrate\u002Fframeworks\u002F09.fastify","i-simple-icons-fastify",{"title":270,"path":271,"stem":272,"icon":273},"Elysia","\u002Fintegrate\u002Fframeworks\u002Felysia","4.integrate\u002Fframeworks\u002F10.elysia","i-custom-elysia",{"title":275,"path":276,"stem":277,"icon":278},"React Router","\u002Fintegrate\u002Fframeworks\u002Freact-router","4.integrate\u002Fframeworks\u002F11.react-router","i-custom-reactrouter",{"title":280,"path":281,"stem":282,"icon":283},"Cloudflare Workers","\u002Fintegrate\u002Fframeworks\u002Fcloudflare-workers","4.integrate\u002Fframeworks\u002F12.cloudflare-workers","i-simple-icons-cloudflare",{"title":285,"path":286,"stem":287,"icon":74},"Standalone","\u002Fintegrate\u002Fframeworks\u002Fstandalone","4.integrate\u002Fframeworks\u002F13.standalone",{"title":289,"path":290,"stem":291,"icon":292},"Astro","\u002Fintegrate\u002Fframeworks\u002Fastro","4.integrate\u002Fframeworks\u002F14.astro","i-simple-icons-astro",{"title":294,"path":295,"stem":296,"icon":297},"oRPC","\u002Fintegrate\u002Fframeworks\u002Forpc","4.integrate\u002Fframeworks\u002F15.orpc","i-lucide-network",{"title":299,"path":300,"stem":301,"icon":302},"AWS Lambda","\u002Fintegrate\u002Fframeworks\u002Faws-lambda","4.integrate\u002Fframeworks\u002F16.aws-lambda","i-custom-lambda",{"title":304,"path":305,"stem":306,"children":307,"page":29},"Use Cases","\u002Fuse-cases","5.use-cases",[308,311,316,345,372,404,425,430],{"title":36,"path":309,"stem":310,"icon":102},"\u002Fuse-cases\u002Foverview","5.use-cases\u002F0.overview",{"title":312,"path":313,"stem":314,"icon":315},"Client Logging","\u002Fuse-cases\u002Fclient-logging","5.use-cases\u002F1.client-logging","i-lucide-monitor",{"title":317,"icon":318,"path":319,"stem":320,"children":321,"page":29},"AI SDK","i-simple-icons-vercel","\u002Fuse-cases\u002Fai-sdk","5.use-cases\u002F2.ai-sdk",[322,325,330,335,340],{"title":36,"path":323,"stem":324,"icon":39},"\u002Fuse-cases\u002Fai-sdk\u002Foverview","5.use-cases\u002F2.ai-sdk\u002F01.overview",{"title":326,"path":327,"stem":328,"icon":329},"Usage","\u002Fuse-cases\u002Fai-sdk\u002Fusage","5.use-cases\u002F2.ai-sdk\u002F02.usage","i-lucide-code",{"title":331,"path":332,"stem":333,"icon":334},"Options","\u002Fuse-cases\u002Fai-sdk\u002Foptions","5.use-cases\u002F2.ai-sdk\u002F03.options","i-lucide-sliders",{"title":336,"path":337,"stem":338,"icon":339},"Metadata","\u002Fuse-cases\u002Fai-sdk\u002Fmetadata","5.use-cases\u002F2.ai-sdk\u002F04.metadata","i-lucide-database",{"title":341,"path":342,"stem":343,"icon":344},"Telemetry","\u002Fuse-cases\u002Fai-sdk\u002Ftelemetry","5.use-cases\u002F2.ai-sdk\u002F05.telemetry","i-lucide-activity",{"title":346,"icon":347,"path":348,"stem":349,"children":350,"page":29},"Better Auth","i-simple-icons-betterauth","\u002Fuse-cases\u002Fbetter-auth","5.use-cases\u002F3.better-auth",[351,354,359,364,368],{"title":36,"path":352,"stem":353,"icon":39},"\u002Fuse-cases\u002Fbetter-auth\u002Foverview","5.use-cases\u002F3.better-auth\u002F01.overview",{"title":355,"path":356,"stem":357,"icon":358},"Identify User","\u002Fuse-cases\u002Fbetter-auth\u002Fidentify-user","5.use-cases\u002F3.better-auth\u002F02.identify-user","i-lucide-user-check",{"title":360,"path":361,"stem":362,"icon":363},"Middleware","\u002Fuse-cases\u002Fbetter-auth\u002Fmiddleware","5.use-cases\u002F3.better-auth\u002F03.middleware","i-lucide-shield",{"title":365,"path":366,"stem":367,"icon":315},"Client Sync","\u002Fuse-cases\u002Fbetter-auth\u002Fclient-sync","5.use-cases\u002F3.better-auth\u002F04.client-sync",{"title":369,"path":370,"stem":371,"icon":107},"Performance","\u002Fuse-cases\u002Fbetter-auth\u002Fperformance","5.use-cases\u002F3.better-auth\u002F05.performance",{"title":373,"icon":374,"path":375,"stem":376,"children":377,"page":29},"Audit Logs","i-lucide-shield-check","\u002Fuse-cases\u002Faudit","5.use-cases\u002F4.audit",[378,381,386,391,396,400],{"title":36,"path":379,"stem":380,"icon":39},"\u002Fuse-cases\u002Faudit\u002Foverview","5.use-cases\u002F4.audit\u002F01.overview",{"title":382,"path":383,"stem":384,"icon":385},"Schema","\u002Fuse-cases\u002Faudit\u002Fschema","5.use-cases\u002F4.audit\u002F02.schema","i-lucide-file-text",{"title":387,"path":388,"stem":389,"icon":390},"Recording","\u002Fuse-cases\u002Faudit\u002Frecording","5.use-cases\u002F4.audit\u002F03.recording","i-lucide-pen-line",{"title":392,"path":393,"stem":394,"icon":395},"Drains","\u002Fuse-cases\u002Faudit\u002Fpipeline","5.use-cases\u002F4.audit\u002F04.pipeline","i-lucide-link",{"title":397,"path":398,"stem":399,"icon":374},"Compliance","\u002Fuse-cases\u002Faudit\u002Fcompliance","5.use-cases\u002F4.audit\u002F05.compliance",{"title":401,"path":402,"stem":403,"icon":79},"Recipes","\u002Fuse-cases\u002Faudit\u002Frecipes","5.use-cases\u002F4.audit\u002F06.recipes",{"title":341,"icon":107,"path":405,"stem":406,"children":407,"page":29},"\u002Fuse-cases\u002Ftelemetry","5.use-cases\u002F4.telemetry",[408,411,416,421],{"title":36,"path":409,"stem":410,"icon":39},"\u002Fuse-cases\u002Ftelemetry\u002Foverview","5.use-cases\u002F4.telemetry\u002F01.overview",{"title":412,"path":413,"stem":414,"icon":415},"Setup","\u002Fuse-cases\u002Ftelemetry\u002Fsetup","5.use-cases\u002F4.telemetry\u002F02.setup","i-lucide-wrench",{"title":417,"path":418,"stem":419,"icon":420},"Ingest","\u002Fuse-cases\u002Ftelemetry\u002Fingest","5.use-cases\u002F4.telemetry\u002F03.ingest","i-lucide-server",{"title":422,"path":423,"stem":424,"icon":79},"Reference","\u002Fuse-cases\u002Ftelemetry\u002Freference","5.use-cases\u002F4.telemetry\u002F04.reference",{"title":426,"path":427,"stem":428,"icon":429},"Enrichers","\u002Fuse-cases\u002Fenrichers","5.use-cases\u002F5.enrichers","i-lucide-sparkles",{"title":431,"path":432,"stem":433,"icon":434},"eve","\u002Fuse-cases\u002Feve","5.use-cases\u002F5.eve","i-custom-eve",{"title":436,"path":437,"stem":438,"children":439,"page":29},"Extend","\u002Fextend","6.extend",[440,444,449,454,459,463,467,471,475,480,485],{"title":36,"path":441,"stem":442,"icon":443},"\u002Fextend\u002Foverview","6.extend\u002F0.overview","i-lucide-blocks",{"title":445,"path":446,"stem":447,"icon":448},"Stream","\u002Fextend\u002Fstream","6.extend\u002F1.stream","i-lucide-radio-tower",{"title":450,"path":451,"stem":452,"icon":453},"Custom framework","\u002Fextend\u002Fcustom-framework","6.extend\u002F10.custom-framework","i-lucide-puzzle",{"title":455,"path":456,"stem":457,"icon":458},"FS reader","\u002Fextend\u002Ffs-reader","6.extend\u002F2.fs-reader","i-lucide-folder-search",{"title":401,"path":460,"stem":461,"icon":462},"\u002Fextend\u002Fconsumer-recipes","6.extend\u002F3.consumer-recipes","i-lucide-chef-hat",{"title":464,"path":465,"stem":466,"icon":443},"Plugins","\u002Fextend\u002Fplugins","6.extend\u002F4.plugins",{"title":468,"path":469,"stem":470,"icon":429},"Custom enrichers","\u002Fextend\u002Fcustom-enrichers","6.extend\u002F5.custom-enrichers",{"title":472,"path":473,"stem":474,"icon":64},"Tail sampling","\u002Fextend\u002Ftail-sampling","6.extend\u002F6.tail-sampling",{"title":476,"path":477,"stem":478,"icon":479},"Identity headers","\u002Fextend\u002Fidentity-headers","6.extend\u002F7.identity-headers","i-lucide-fingerprint",{"title":481,"path":482,"stem":483,"icon":484},"Custom drains","\u002Fextend\u002Fcustom-drains","6.extend\u002F8.custom-drains","i-lucide-share-2",{"title":486,"path":487,"stem":488,"icon":489},"Drain pipeline","\u002Fextend\u002Fdrain-pipeline","6.extend\u002F9.drain-pipeline","i-lucide-workflow",{"title":422,"path":491,"stem":492,"children":493,"page":29},"\u002Freference","7.reference",[494,499,502,507,511,516],{"title":495,"path":496,"stem":497,"icon":498},"Configuration","\u002Freference\u002Fconfiguration","7.reference\u002F1.configuration","i-lucide-settings",{"title":369,"path":500,"stem":501,"icon":107},"\u002Freference\u002Fperformance","7.reference\u002F2.performance",{"title":503,"path":504,"stem":505,"icon":506},"Vite Plugin","\u002Freference\u002Fvite-plugin","7.reference\u002F3.vite-plugin","i-custom-vite",{"title":508,"path":509,"stem":510,"icon":374},"Best Practices","\u002Freference\u002Fbest-practices","7.reference\u002F4.best-practices",{"title":512,"path":513,"stem":514,"icon":515},"vs Other Loggers","\u002Freference\u002Fvs-other-loggers","7.reference\u002F5.vs-other-loggers","i-lucide-scale",{"title":517,"path":518,"stem":519,"icon":429},"Agent Skills","\u002Freference\u002Fagent-skills","7.reference\u002F6.agent-skills",{"id":521,"title":522,"body":523,"description":2147,"extension":2148,"links":2149,"meta":2158,"navigation":2159,"path":202,"seo":2160,"stem":203,"__hash__":2161},"docs\u002F4.integrate\u002Fadapters\u002Fself-hosted\u002F01.fs.md","File System Adapter",{"type":524,"value":525,"toc":2127},"minimark",[526,530,562,608,612,615,658,661,664,1259,1265,1269,1278,1285,1302,1305,1309,1412,1416,1575,1579,1589,1596,1600,1609,1613,1616,1775,1779,1783,1802,1806,1889,1893,1946,1950,1953,2080,2084,2094,2098,2123],[527,528,529],"p",{},"The File System adapter writes your wide events to local NDJSON files (one JSON object per line, one file per day). This enables:",[531,532,533,546,556],"ul",{},[534,535,536,540,541,545],"li",{},[537,538,539],"strong",{},"AI agent integration"," - point a skill to ",[542,543,544],"code",{},".evlog\u002Flogs\u002F"," to parse structured logs for debugging and pattern analysis",[534,547,548,551,552,555],{},[537,549,550],{},"Local dev debugging"," - persistent log history without scrolling the terminal (",[542,553,554],{},"tail -f .evlog\u002Flogs\u002F2026-03-14.jsonl",")",[534,557,558,561],{},[537,559,560],{},"Production backup"," - combine with a network drain (Axiom, OTLP) for local fallback",[563,564,567,570,594],"prompt",{":actions":565,"description":566,"icon":204},"[\"copy\",\"cursor\",\"claude\"]","Add the file system drain adapter",[527,568,569],{},"Add the file system drain adapter to write evlog wide events locally as NDJSON files.",[571,572,573,576,579,582,585,588,591],"ol",{},[534,574,575],{},"Identify which framework I'm using and follow its evlog integration pattern",[534,577,578],{},"Install evlog if not already installed",[534,580,581],{},"Import createFsDrain from 'evlog\u002Ffs'",[534,583,584],{},"Wire createFsDrain() into my framework's drain configuration",[534,586,587],{},"Logs are written to .evlog\u002Flogs\u002F by default (one file per day, auto .gitignore)",[534,589,590],{},"Optionally configure dir, maxFiles, maxSizePerFile, or pretty options",[534,592,593],{},"Test by triggering a request and checking .evlog\u002Flogs\u002F*.jsonl",[527,595,596,597,603,604],{},"Adapter docs: ",[598,599,600],"a",{"href":600,"rel":601},"https:\u002F\u002Fwww.evlog.dev\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Ffs",[602],"nofollow","\nFramework setup: ",[598,605,606],{"href":606,"rel":607},"https:\u002F\u002Fwww.evlog.dev\u002Fintegrate\u002Fframeworks\u002Foverview",[602],[609,610,20],"h2",{"id":611},"installation",[527,613,614],{},"The File System adapter comes bundled with evlog:",[616,617,623],"pre",{"className":618,"code":619,"filename":620,"language":621,"meta":622,"style":622},"language-typescript shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import { createFsDrain } from 'evlog\u002Ffs'\n","src\u002Findex.ts","typescript","",[542,624,625],{"__ignoreMap":622},[626,627,630,634,638,642,645,648,651,655],"span",{"class":628,"line":629},"line",1,[626,631,633],{"class":632},"s7zQu","import",[626,635,637],{"class":636},"sMK4o"," {",[626,639,641],{"class":640},"sTEyZ"," createFsDrain",[626,643,644],{"class":636}," }",[626,646,647],{"class":632}," from",[626,649,650],{"class":636}," '",[626,652,654],{"class":653},"sfazB","evlog\u002Ffs",[626,656,657],{"class":636},"'\n",[609,659,25],{"id":660},"quick-start",[527,662,663],{},"No credentials or environment variables needed. Just wire the drain to your framework:",[665,666,667,781,912,929,991,1045,1104,1158,1211],"code-group",{},[616,668,671],{"className":618,"code":669,"filename":670,"language":621,"meta":622,"style":622},"\u002F\u002F server\u002Fplugins\u002Fevlog-drain.ts\nimport { createFsDrain } from 'evlog\u002Ffs'\n\nexport default defineNitroPlugin((nitroApp) => {\n  nitroApp.hooks.hook('evlog:drain', createFsDrain())\n})\n","Nuxt \u002F Nitro",[542,672,673,679,698,705,736,772],{"__ignoreMap":622},[626,674,675],{"class":628,"line":629},[626,676,678],{"class":677},"sHwdD","\u002F\u002F server\u002Fplugins\u002Fevlog-drain.ts\n",[626,680,682,684,686,688,690,692,694,696],{"class":628,"line":681},2,[626,683,633],{"class":632},[626,685,637],{"class":636},[626,687,641],{"class":640},[626,689,644],{"class":636},[626,691,647],{"class":632},[626,693,650],{"class":636},[626,695,654],{"class":653},[626,697,657],{"class":636},[626,699,701],{"class":628,"line":700},3,[626,702,704],{"emptyLinePlaceholder":703},true,"\n",[626,706,708,711,714,718,721,723,727,729,733],{"class":628,"line":707},4,[626,709,710],{"class":632},"export",[626,712,713],{"class":632}," default",[626,715,717],{"class":716},"s2Zo4"," defineNitroPlugin",[626,719,720],{"class":640},"(",[626,722,720],{"class":636},[626,724,726],{"class":725},"sHdIc","nitroApp",[626,728,555],{"class":636},[626,730,732],{"class":731},"spNyl"," =>",[626,734,735],{"class":636}," {\n",[626,737,739,742,745,748,750,753,756,759,762,764,767,769],{"class":628,"line":738},5,[626,740,741],{"class":640},"  nitroApp",[626,743,744],{"class":636},".",[626,746,747],{"class":640},"hooks",[626,749,744],{"class":636},[626,751,752],{"class":716},"hook",[626,754,720],{"class":755},"swJcz",[626,757,758],{"class":636},"'",[626,760,761],{"class":653},"evlog:drain",[626,763,758],{"class":636},[626,765,766],{"class":636},",",[626,768,641],{"class":716},[626,770,771],{"class":755},"())\n",[626,773,775,778],{"class":628,"line":774},6,[626,776,777],{"class":636},"}",[626,779,780],{"class":640},")\n",[616,782,784],{"className":618,"code":783,"filename":230,"language":621,"meta":622,"style":622},"\u002F\u002F lib\u002Fevlog.ts — Node.js routes only; keep evlog\u002Ffs out of root instrumentation.ts\nimport { createEvlog } from 'evlog\u002Fnext'\nimport { createFsDrain } from 'evlog\u002Ffs'\n\nexport const { withEvlog, useLogger, log, createError } = createEvlog({\n  service: 'my-app',\n  drain: createFsDrain(),\n})\n",[542,785,786,791,811,829,833,872,890,905],{"__ignoreMap":622},[626,787,788],{"class":628,"line":629},[626,789,790],{"class":677},"\u002F\u002F lib\u002Fevlog.ts — Node.js routes only; keep evlog\u002Ffs out of root instrumentation.ts\n",[626,792,793,795,797,800,802,804,806,809],{"class":628,"line":681},[626,794,633],{"class":632},[626,796,637],{"class":636},[626,798,799],{"class":640}," createEvlog",[626,801,644],{"class":636},[626,803,647],{"class":632},[626,805,650],{"class":636},[626,807,808],{"class":653},"evlog\u002Fnext",[626,810,657],{"class":636},[626,812,813,815,817,819,821,823,825,827],{"class":628,"line":700},[626,814,633],{"class":632},[626,816,637],{"class":636},[626,818,641],{"class":640},[626,820,644],{"class":636},[626,822,647],{"class":632},[626,824,650],{"class":636},[626,826,654],{"class":653},[626,828,657],{"class":636},[626,830,831],{"class":628,"line":707},[626,832,704],{"emptyLinePlaceholder":703},[626,834,835,837,840,842,845,847,850,852,855,857,860,862,865,867,869],{"class":628,"line":738},[626,836,710],{"class":632},[626,838,839],{"class":731}," const",[626,841,637],{"class":636},[626,843,844],{"class":640}," withEvlog",[626,846,766],{"class":636},[626,848,849],{"class":640}," useLogger",[626,851,766],{"class":636},[626,853,854],{"class":640}," log",[626,856,766],{"class":636},[626,858,859],{"class":640}," createError ",[626,861,777],{"class":636},[626,863,864],{"class":636}," =",[626,866,799],{"class":716},[626,868,720],{"class":640},[626,870,871],{"class":636},"{\n",[626,873,874,877,880,882,885,887],{"class":628,"line":774},[626,875,876],{"class":755},"  service",[626,878,879],{"class":636},":",[626,881,650],{"class":636},[626,883,884],{"class":653},"my-app",[626,886,758],{"class":636},[626,888,889],{"class":636},",\n",[626,891,893,896,898,900,903],{"class":628,"line":892},7,[626,894,895],{"class":755},"  drain",[626,897,879],{"class":636},[626,899,641],{"class":716},[626,901,902],{"class":640},"()",[626,904,889],{"class":636},[626,906,908,910],{"class":628,"line":907},8,[626,909,777],{"class":636},[626,911,780],{"class":640},[913,914,916,917,920,921,924,925,928],"callout",{"color":915,"icon":13},"info","The FS adapter requires Node.js (",[542,918,919],{},"node:fs","). On the Edge runtime it logs a one-time ",[542,922,923],{},"[evlog\u002Ffs]"," warning and skips writes. Use ",[542,926,927],{},"evlog\u002Fmemory"," or an HTTP adapter for Edge routes.",[616,930,932],{"className":618,"code":931,"filename":260,"language":621,"meta":622,"style":622},"import { createFsDrain } from 'evlog\u002Ffs'\n\napp.use(evlog({ drain: createFsDrain() }))\n",[542,933,934,952,956],{"__ignoreMap":622},[626,935,936,938,940,942,944,946,948,950],{"class":628,"line":629},[626,937,633],{"class":632},[626,939,637],{"class":636},[626,941,641],{"class":640},[626,943,644],{"class":636},[626,945,647],{"class":632},[626,947,650],{"class":636},[626,949,654],{"class":653},[626,951,657],{"class":636},[626,953,954],{"class":628,"line":681},[626,955,704],{"emptyLinePlaceholder":703},[626,957,958,961,963,966,968,971,973,976,979,981,983,986,988],{"class":628,"line":700},[626,959,960],{"class":640},"app",[626,962,744],{"class":636},[626,964,965],{"class":716},"use",[626,967,720],{"class":640},[626,969,970],{"class":716},"evlog",[626,972,720],{"class":640},[626,974,975],{"class":636},"{",[626,977,978],{"class":755}," drain",[626,980,879],{"class":636},[626,982,641],{"class":716},[626,984,985],{"class":640},"() ",[626,987,777],{"class":636},[626,989,990],{"class":640},"))\n",[616,992,993],{"className":618,"code":931,"filename":255,"language":621,"meta":622,"style":622},[542,994,995,1013,1017],{"__ignoreMap":622},[626,996,997,999,1001,1003,1005,1007,1009,1011],{"class":628,"line":629},[626,998,633],{"class":632},[626,1000,637],{"class":636},[626,1002,641],{"class":640},[626,1004,644],{"class":636},[626,1006,647],{"class":632},[626,1008,650],{"class":636},[626,1010,654],{"class":653},[626,1012,657],{"class":636},[626,1014,1015],{"class":628,"line":681},[626,1016,704],{"emptyLinePlaceholder":703},[626,1018,1019,1021,1023,1025,1027,1029,1031,1033,1035,1037,1039,1041,1043],{"class":628,"line":700},[626,1020,960],{"class":640},[626,1022,744],{"class":636},[626,1024,965],{"class":716},[626,1026,720],{"class":640},[626,1028,970],{"class":716},[626,1030,720],{"class":640},[626,1032,975],{"class":636},[626,1034,978],{"class":755},[626,1036,879],{"class":636},[626,1038,641],{"class":716},[626,1040,985],{"class":640},[626,1042,777],{"class":636},[626,1044,990],{"class":640},[616,1046,1048],{"className":618,"code":1047,"filename":265,"language":621,"meta":622,"style":622},"import { createFsDrain } from 'evlog\u002Ffs'\n\nawait app.register(evlog, { drain: createFsDrain() })\n",[542,1049,1050,1068,1072],{"__ignoreMap":622},[626,1051,1052,1054,1056,1058,1060,1062,1064,1066],{"class":628,"line":629},[626,1053,633],{"class":632},[626,1055,637],{"class":636},[626,1057,641],{"class":640},[626,1059,644],{"class":636},[626,1061,647],{"class":632},[626,1063,650],{"class":636},[626,1065,654],{"class":653},[626,1067,657],{"class":636},[626,1069,1070],{"class":628,"line":681},[626,1071,704],{"emptyLinePlaceholder":703},[626,1073,1074,1077,1080,1082,1085,1088,1090,1092,1094,1096,1098,1100,1102],{"class":628,"line":700},[626,1075,1076],{"class":632},"await",[626,1078,1079],{"class":640}," app",[626,1081,744],{"class":636},[626,1083,1084],{"class":716},"register",[626,1086,1087],{"class":640},"(evlog",[626,1089,766],{"class":636},[626,1091,637],{"class":636},[626,1093,978],{"class":755},[626,1095,879],{"class":636},[626,1097,641],{"class":716},[626,1099,985],{"class":640},[626,1101,777],{"class":636},[626,1103,780],{"class":640},[616,1105,1106],{"className":618,"code":931,"filename":270,"language":621,"meta":622,"style":622},[542,1107,1108,1126,1130],{"__ignoreMap":622},[626,1109,1110,1112,1114,1116,1118,1120,1122,1124],{"class":628,"line":629},[626,1111,633],{"class":632},[626,1113,637],{"class":636},[626,1115,641],{"class":640},[626,1117,644],{"class":636},[626,1119,647],{"class":632},[626,1121,650],{"class":636},[626,1123,654],{"class":653},[626,1125,657],{"class":636},[626,1127,1128],{"class":628,"line":681},[626,1129,704],{"emptyLinePlaceholder":703},[626,1131,1132,1134,1136,1138,1140,1142,1144,1146,1148,1150,1152,1154,1156],{"class":628,"line":700},[626,1133,960],{"class":640},[626,1135,744],{"class":636},[626,1137,965],{"class":716},[626,1139,720],{"class":640},[626,1141,970],{"class":716},[626,1143,720],{"class":640},[626,1145,975],{"class":636},[626,1147,978],{"class":755},[626,1149,879],{"class":636},[626,1151,641],{"class":716},[626,1153,985],{"class":640},[626,1155,777],{"class":636},[626,1157,990],{"class":640},[616,1159,1161],{"className":618,"code":1160,"filename":250,"language":621,"meta":622,"style":622},"import { createFsDrain } from 'evlog\u002Ffs'\n\nEvlogModule.forRoot({ drain: createFsDrain() })\n",[542,1162,1163,1181,1185],{"__ignoreMap":622},[626,1164,1165,1167,1169,1171,1173,1175,1177,1179],{"class":628,"line":629},[626,1166,633],{"class":632},[626,1168,637],{"class":636},[626,1170,641],{"class":640},[626,1172,644],{"class":636},[626,1174,647],{"class":632},[626,1176,650],{"class":636},[626,1178,654],{"class":653},[626,1180,657],{"class":636},[626,1182,1183],{"class":628,"line":681},[626,1184,704],{"emptyLinePlaceholder":703},[626,1186,1187,1190,1192,1195,1197,1199,1201,1203,1205,1207,1209],{"class":628,"line":700},[626,1188,1189],{"class":640},"EvlogModule",[626,1191,744],{"class":636},[626,1193,1194],{"class":716},"forRoot",[626,1196,720],{"class":640},[626,1198,975],{"class":636},[626,1200,978],{"class":755},[626,1202,879],{"class":636},[626,1204,641],{"class":716},[626,1206,985],{"class":640},[626,1208,777],{"class":636},[626,1210,780],{"class":640},[616,1212,1214],{"className":618,"code":1213,"filename":285,"language":621,"meta":622,"style":622},"import { createFsDrain } from 'evlog\u002Ffs'\n\ninitLogger({ drain: createFsDrain() })\n",[542,1215,1216,1234,1238],{"__ignoreMap":622},[626,1217,1218,1220,1222,1224,1226,1228,1230,1232],{"class":628,"line":629},[626,1219,633],{"class":632},[626,1221,637],{"class":636},[626,1223,641],{"class":640},[626,1225,644],{"class":636},[626,1227,647],{"class":632},[626,1229,650],{"class":636},[626,1231,654],{"class":653},[626,1233,657],{"class":636},[626,1235,1236],{"class":628,"line":681},[626,1237,704],{"emptyLinePlaceholder":703},[626,1239,1240,1243,1245,1247,1249,1251,1253,1255,1257],{"class":628,"line":700},[626,1241,1242],{"class":716},"initLogger",[626,1244,720],{"class":640},[626,1246,975],{"class":636},[626,1248,978],{"class":755},[626,1250,879],{"class":636},[626,1252,641],{"class":716},[626,1254,985],{"class":640},[626,1256,777],{"class":636},[626,1258,780],{"class":640},[527,1260,1261,1262,1264],{},"Logs start appearing in ",[542,1263,544],{}," immediately.",[609,1266,1268],{"id":1267},"file-structure","File Structure",[616,1270,1276],{"className":1271,"code":1273,"filename":1274,"language":1275,"meta":622},[1272],"language-text",".evlog\u002F\n  logs\u002F\n    2026-03-14.jsonl    ← one file per day\n    2026-03-13.jsonl\n    2026-03-12.jsonl\n",".evlog\u002Flogs directory layout","text",[542,1277,1273],{"__ignoreMap":622},[527,1279,1280,1281,1284],{},"Each ",[542,1282,1283],{},".jsonl"," file contains one JSON object per line (NDJSON format), making it easy to parse, grep, and stream.",[913,1286,1289,1290,1293,1294,1297,1298,1301],{"color":1287,"icon":1288},"success","i-lucide-git-branch","A ",[542,1291,1292],{},".gitignore"," is automatically created on first write, inside the ",[542,1295,1296],{},".evlog\u002F"," ancestor directory when present or in the configured ",[542,1299,1300],{},"dir"," otherwise. Log files are never committed to version control.",[609,1303,495],{"id":1304},"configuration",[1306,1307,331],"h3",{"id":1308},"options",[1310,1311,1312,1331],"table",{},[1313,1314,1315],"thead",{},[1316,1317,1318,1322,1325,1328],"tr",{},[1319,1320,1321],"th",{},"Option",[1319,1323,1324],{},"Type",[1319,1326,1327],{},"Default",[1319,1329,1330],{},"Description",[1332,1333,1334,1354,1374,1392],"tbody",{},[1316,1335,1336,1341,1346,1351],{},[1337,1338,1339],"td",{},[542,1340,1300],{},[1337,1342,1343],{},[542,1344,1345],{},"string",[1337,1347,1348],{},[542,1349,1350],{},"'.evlog\u002Flogs'",[1337,1352,1353],{},"Directory for log files",[1316,1355,1356,1361,1366,1371],{},[1337,1357,1358],{},[542,1359,1360],{},"maxFiles",[1337,1362,1363],{},[542,1364,1365],{},"number",[1337,1367,1368],{},[542,1369,1370],{},"undefined",[1337,1372,1373],{},"Max files to keep (auto-deletes oldest)",[1316,1375,1376,1381,1385,1389],{},[1337,1377,1378],{},[542,1379,1380],{},"maxSizePerFile",[1337,1382,1383],{},[542,1384,1365],{},[1337,1386,1387],{},[542,1388,1370],{},[1337,1390,1391],{},"Max bytes per file before rotating",[1316,1393,1394,1399,1404,1409],{},[1337,1395,1396],{},[542,1397,1398],{},"pretty",[1337,1400,1401],{},[542,1402,1403],{},"boolean",[1337,1405,1406],{},[542,1407,1408],{},"false",[1337,1410,1411],{},"Pretty-print JSON (multi-line, readable)",[1306,1413,1415],{"id":1414},"examples","Examples",[616,1417,1420],{"className":618,"code":1418,"filename":1419,"language":621,"meta":622,"style":622},"\u002F\u002F Keep only the last 7 days of logs\ncreateFsDrain({ maxFiles: 7 })\n\n\u002F\u002F Rotate files at 10MB, keep 30 files\ncreateFsDrain({\n  maxSizePerFile: 10 * 1024 * 1024,\n  maxFiles: 30,\n})\n\n\u002F\u002F Pretty-print for human reading\ncreateFsDrain({ pretty: true })\n\n\u002F\u002F Custom directory\ncreateFsDrain({ dir: '\u002Fvar\u002Flog\u002Fmyapp' })\n","server\u002Fplugins\u002Fevlog-drain.ts",[542,1421,1422,1427,1449,1453,1458,1466,1488,1500,1506,1511,1517,1539,1544,1550],{"__ignoreMap":622},[626,1423,1424],{"class":628,"line":629},[626,1425,1426],{"class":677},"\u002F\u002F Keep only the last 7 days of logs\n",[626,1428,1429,1432,1434,1436,1439,1441,1445,1447],{"class":628,"line":681},[626,1430,1431],{"class":716},"createFsDrain",[626,1433,720],{"class":640},[626,1435,975],{"class":636},[626,1437,1438],{"class":755}," maxFiles",[626,1440,879],{"class":636},[626,1442,1444],{"class":1443},"sbssI"," 7",[626,1446,644],{"class":636},[626,1448,780],{"class":640},[626,1450,1451],{"class":628,"line":700},[626,1452,704],{"emptyLinePlaceholder":703},[626,1454,1455],{"class":628,"line":707},[626,1456,1457],{"class":677},"\u002F\u002F Rotate files at 10MB, keep 30 files\n",[626,1459,1460,1462,1464],{"class":628,"line":738},[626,1461,1431],{"class":716},[626,1463,720],{"class":640},[626,1465,871],{"class":636},[626,1467,1468,1471,1473,1476,1479,1482,1484,1486],{"class":628,"line":774},[626,1469,1470],{"class":755},"  maxSizePerFile",[626,1472,879],{"class":636},[626,1474,1475],{"class":1443}," 10",[626,1477,1478],{"class":636}," *",[626,1480,1481],{"class":1443}," 1024",[626,1483,1478],{"class":636},[626,1485,1481],{"class":1443},[626,1487,889],{"class":636},[626,1489,1490,1493,1495,1498],{"class":628,"line":892},[626,1491,1492],{"class":755},"  maxFiles",[626,1494,879],{"class":636},[626,1496,1497],{"class":1443}," 30",[626,1499,889],{"class":636},[626,1501,1502,1504],{"class":628,"line":907},[626,1503,777],{"class":636},[626,1505,780],{"class":640},[626,1507,1509],{"class":628,"line":1508},9,[626,1510,704],{"emptyLinePlaceholder":703},[626,1512,1514],{"class":628,"line":1513},10,[626,1515,1516],{"class":677},"\u002F\u002F Pretty-print for human reading\n",[626,1518,1520,1522,1524,1526,1529,1531,1535,1537],{"class":628,"line":1519},11,[626,1521,1431],{"class":716},[626,1523,720],{"class":640},[626,1525,975],{"class":636},[626,1527,1528],{"class":755}," pretty",[626,1530,879],{"class":636},[626,1532,1534],{"class":1533},"sfNiH"," true",[626,1536,644],{"class":636},[626,1538,780],{"class":640},[626,1540,1542],{"class":628,"line":1541},12,[626,1543,704],{"emptyLinePlaceholder":703},[626,1545,1547],{"class":628,"line":1546},13,[626,1548,1549],{"class":677},"\u002F\u002F Custom directory\n",[626,1551,1553,1555,1557,1559,1562,1564,1566,1569,1571,1573],{"class":628,"line":1552},14,[626,1554,1431],{"class":716},[626,1556,720],{"class":640},[626,1558,975],{"class":636},[626,1560,1561],{"class":755}," dir",[626,1563,879],{"class":636},[626,1565,650],{"class":636},[626,1567,1568],{"class":653},"\u002Fvar\u002Flog\u002Fmyapp",[626,1570,758],{"class":636},[626,1572,644],{"class":636},[626,1574,780],{"class":640},[1306,1576,1578],{"id":1577},"file-rotation","File Rotation",[527,1580,1581,1582,1585,1586,1588],{},"By default, a new file is created each day (",[542,1583,1584],{},"2026-03-14.jsonl","). When ",[542,1587,1380],{}," is set, the adapter creates suffixed files when the current file exceeds the limit:",[616,1590,1594],{"className":1591,"code":1592,"filename":1593,"language":1275,"meta":622},[1272],".evlog\u002Flogs\u002F\n  2026-03-14.jsonl      ← base file (full)\n  2026-03-14.1.jsonl    ← first rotation\n  2026-03-14.2.jsonl    ← second rotation\n","Rotated log files",[542,1595,1592],{"__ignoreMap":622},[1306,1597,1599],{"id":1598},"cleanup","Cleanup",[527,1601,1602,1603,1605,1606,1608],{},"When ",[542,1604,1360],{}," is set, the adapter automatically deletes the oldest ",[542,1607,1283],{}," files after each write, keeping only the most recent files.",[609,1610,1612],{"id":1611},"combining-with-network-drains","Combining with Network Drains",[527,1614,1615],{},"Use the FS adapter alongside a network drain for local backup:",[616,1617,1619],{"className":618,"code":1618,"filename":1419,"language":621,"meta":622,"style":622},"import { createFsDrain } from 'evlog\u002Ffs'\nimport { createAxiomDrain } from 'evlog\u002Faxiom'\n\nconst fs = createFsDrain({ maxFiles: 7 })\nconst axiom = createAxiomDrain()\n\nconst drain = async (ctx) => {\n  await Promise.allSettled([fs(ctx), axiom(ctx)])\n}\n",[542,1620,1621,1639,1659,1663,1690,1704,1708,1732,1770],{"__ignoreMap":622},[626,1622,1623,1625,1627,1629,1631,1633,1635,1637],{"class":628,"line":629},[626,1624,633],{"class":632},[626,1626,637],{"class":636},[626,1628,641],{"class":640},[626,1630,644],{"class":636},[626,1632,647],{"class":632},[626,1634,650],{"class":636},[626,1636,654],{"class":653},[626,1638,657],{"class":636},[626,1640,1641,1643,1645,1648,1650,1652,1654,1657],{"class":628,"line":681},[626,1642,633],{"class":632},[626,1644,637],{"class":636},[626,1646,1647],{"class":640}," createAxiomDrain",[626,1649,644],{"class":636},[626,1651,647],{"class":632},[626,1653,650],{"class":636},[626,1655,1656],{"class":653},"evlog\u002Faxiom",[626,1658,657],{"class":636},[626,1660,1661],{"class":628,"line":700},[626,1662,704],{"emptyLinePlaceholder":703},[626,1664,1665,1668,1671,1674,1676,1678,1680,1682,1684,1686,1688],{"class":628,"line":707},[626,1666,1667],{"class":731},"const",[626,1669,1670],{"class":640}," fs ",[626,1672,1673],{"class":636},"=",[626,1675,641],{"class":716},[626,1677,720],{"class":640},[626,1679,975],{"class":636},[626,1681,1438],{"class":755},[626,1683,879],{"class":636},[626,1685,1444],{"class":1443},[626,1687,644],{"class":636},[626,1689,780],{"class":640},[626,1691,1692,1694,1697,1699,1701],{"class":628,"line":738},[626,1693,1667],{"class":731},[626,1695,1696],{"class":640}," axiom ",[626,1698,1673],{"class":636},[626,1700,1647],{"class":716},[626,1702,1703],{"class":640},"()\n",[626,1705,1706],{"class":628,"line":774},[626,1707,704],{"emptyLinePlaceholder":703},[626,1709,1710,1712,1715,1717,1720,1723,1726,1728,1730],{"class":628,"line":892},[626,1711,1667],{"class":731},[626,1713,1714],{"class":640}," drain ",[626,1716,1673],{"class":636},[626,1718,1719],{"class":731}," async",[626,1721,1722],{"class":636}," (",[626,1724,1725],{"class":725},"ctx",[626,1727,555],{"class":636},[626,1729,732],{"class":731},[626,1731,735],{"class":636},[626,1733,1734,1737,1741,1743,1746,1749,1752,1754,1756,1758,1760,1763,1765,1767],{"class":628,"line":907},[626,1735,1736],{"class":632},"  await",[626,1738,1740],{"class":1739},"sBMFI"," Promise",[626,1742,744],{"class":636},[626,1744,1745],{"class":716},"allSettled",[626,1747,1748],{"class":755},"([",[626,1750,1751],{"class":716},"fs",[626,1753,720],{"class":755},[626,1755,1725],{"class":640},[626,1757,555],{"class":755},[626,1759,766],{"class":636},[626,1761,1762],{"class":716}," axiom",[626,1764,720],{"class":755},[626,1766,1725],{"class":640},[626,1768,1769],{"class":755},")])\n",[626,1771,1772],{"class":628,"line":1508},[626,1773,1774],{"class":636},"}\n",[609,1776,1778],{"id":1777},"querying-logs","Querying Logs",[1306,1780,1782],{"id":1781},"stream-in-real-time","Stream in real-time",[616,1784,1789],{"className":1785,"code":1786,"filename":1787,"language":1788,"meta":622,"style":622},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","tail -f .evlog\u002Flogs\u002F2026-03-14.jsonl\n","Terminal","bash",[542,1790,1791],{"__ignoreMap":622},[626,1792,1793,1796,1799],{"class":628,"line":629},[626,1794,1795],{"class":1739},"tail",[626,1797,1798],{"class":653}," -f",[626,1800,1801],{"class":653}," .evlog\u002Flogs\u002F2026-03-14.jsonl\n",[1306,1803,1805],{"id":1804},"search-with-jq","Search with jq",[616,1807,1809],{"className":1785,"code":1808,"filename":1787,"language":1788,"meta":622,"style":622},"# Find errors\ncat .evlog\u002Flogs\u002F2026-03-14.jsonl | jq 'select(.level == \"error\")'\n\n# Slow requests (duration is a formatted string like \"706ms\" or \"1.23s\")\ncat .evlog\u002Flogs\u002F2026-03-14.jsonl | jq 'select(.duration | test(\"^[0-9.]+s\"))'\n\n# Requests by path\ncat .evlog\u002Flogs\u002F2026-03-14.jsonl | jq 'select(.path == \"\u002Fapi\u002Fcheckout\")'\n",[542,1810,1811,1816,1837,1841,1846,1863,1867,1872],{"__ignoreMap":622},[626,1812,1813],{"class":628,"line":629},[626,1814,1815],{"class":677},"# Find errors\n",[626,1817,1818,1821,1824,1827,1830,1832,1835],{"class":628,"line":681},[626,1819,1820],{"class":1739},"cat",[626,1822,1823],{"class":653}," .evlog\u002Flogs\u002F2026-03-14.jsonl",[626,1825,1826],{"class":636}," |",[626,1828,1829],{"class":1739}," jq",[626,1831,650],{"class":636},[626,1833,1834],{"class":653},"select(.level == \"error\")",[626,1836,657],{"class":636},[626,1838,1839],{"class":628,"line":700},[626,1840,704],{"emptyLinePlaceholder":703},[626,1842,1843],{"class":628,"line":707},[626,1844,1845],{"class":677},"# Slow requests (duration is a formatted string like \"706ms\" or \"1.23s\")\n",[626,1847,1848,1850,1852,1854,1856,1858,1861],{"class":628,"line":738},[626,1849,1820],{"class":1739},[626,1851,1823],{"class":653},[626,1853,1826],{"class":636},[626,1855,1829],{"class":1739},[626,1857,650],{"class":636},[626,1859,1860],{"class":653},"select(.duration | test(\"^[0-9.]+s\"))",[626,1862,657],{"class":636},[626,1864,1865],{"class":628,"line":774},[626,1866,704],{"emptyLinePlaceholder":703},[626,1868,1869],{"class":628,"line":892},[626,1870,1871],{"class":677},"# Requests by path\n",[626,1873,1874,1876,1878,1880,1882,1884,1887],{"class":628,"line":907},[626,1875,1820],{"class":1739},[626,1877,1823],{"class":653},[626,1879,1826],{"class":636},[626,1881,1829],{"class":1739},[626,1883,650],{"class":636},[626,1885,1886],{"class":653},"select(.path == \"\u002Fapi\u002Fcheckout\")",[626,1888,657],{"class":636},[1306,1890,1892],{"id":1891},"search-with-grep","Search with grep",[616,1894,1896],{"className":1785,"code":1895,"filename":1787,"language":1788,"meta":622,"style":622},"# Find all errors\ngrep '\"level\":\"error\"' .evlog\u002Flogs\u002F2026-03-14.jsonl\n\n# Find by request ID\ngrep 'req_abc123' .evlog\u002Flogs\u002F*.jsonl\n",[542,1897,1898,1903,1917,1921,1926],{"__ignoreMap":622},[626,1899,1900],{"class":628,"line":629},[626,1901,1902],{"class":677},"# Find all errors\n",[626,1904,1905,1908,1910,1913,1915],{"class":628,"line":681},[626,1906,1907],{"class":1739},"grep",[626,1909,650],{"class":636},[626,1911,1912],{"class":653},"\"level\":\"error\"",[626,1914,758],{"class":636},[626,1916,1801],{"class":653},[626,1918,1919],{"class":628,"line":700},[626,1920,704],{"emptyLinePlaceholder":703},[626,1922,1923],{"class":628,"line":707},[626,1924,1925],{"class":677},"# Find by request ID\n",[626,1927,1928,1930,1932,1935,1937,1940,1943],{"class":628,"line":738},[626,1929,1907],{"class":1739},[626,1931,650],{"class":636},[626,1933,1934],{"class":653},"req_abc123",[626,1936,758],{"class":636},[626,1938,1939],{"class":653}," .evlog\u002Flogs\u002F",[626,1941,1942],{"class":640},"*",[626,1944,1945],{"class":653},".jsonl\n",[609,1947,1949],{"id":1948},"direct-api-usage","Direct API Usage",[527,1951,1952],{},"For advanced use cases, use the lower-level write functions:",[616,1954,1956],{"className":618,"code":1955,"filename":620,"language":621,"meta":622,"style":622},"import { writeToFs, writeBatchToFs } from 'evlog\u002Ffs'\n\nawait writeToFs(event, {\n  dir: '.evlog\u002Flogs',\n  pretty: false,\n})\n\nawait writeBatchToFs(events, {\n  dir: '.evlog\u002Flogs',\n  pretty: false,\n})\n",[542,1957,1958,1982,1986,1999,2015,2027,2033,2037,2050,2064,2074],{"__ignoreMap":622},[626,1959,1960,1962,1964,1967,1969,1972,1974,1976,1978,1980],{"class":628,"line":629},[626,1961,633],{"class":632},[626,1963,637],{"class":636},[626,1965,1966],{"class":640}," writeToFs",[626,1968,766],{"class":636},[626,1970,1971],{"class":640}," writeBatchToFs",[626,1973,644],{"class":636},[626,1975,647],{"class":632},[626,1977,650],{"class":636},[626,1979,654],{"class":653},[626,1981,657],{"class":636},[626,1983,1984],{"class":628,"line":681},[626,1985,704],{"emptyLinePlaceholder":703},[626,1987,1988,1990,1992,1995,1997],{"class":628,"line":700},[626,1989,1076],{"class":632},[626,1991,1966],{"class":716},[626,1993,1994],{"class":640},"(event",[626,1996,766],{"class":636},[626,1998,735],{"class":636},[626,2000,2001,2004,2006,2008,2011,2013],{"class":628,"line":707},[626,2002,2003],{"class":755},"  dir",[626,2005,879],{"class":636},[626,2007,650],{"class":636},[626,2009,2010],{"class":653},".evlog\u002Flogs",[626,2012,758],{"class":636},[626,2014,889],{"class":636},[626,2016,2017,2020,2022,2025],{"class":628,"line":738},[626,2018,2019],{"class":755},"  pretty",[626,2021,879],{"class":636},[626,2023,2024],{"class":1533}," false",[626,2026,889],{"class":636},[626,2028,2029,2031],{"class":628,"line":774},[626,2030,777],{"class":636},[626,2032,780],{"class":640},[626,2034,2035],{"class":628,"line":892},[626,2036,704],{"emptyLinePlaceholder":703},[626,2038,2039,2041,2043,2046,2048],{"class":628,"line":907},[626,2040,1076],{"class":632},[626,2042,1971],{"class":716},[626,2044,2045],{"class":640},"(events",[626,2047,766],{"class":636},[626,2049,735],{"class":636},[626,2051,2052,2054,2056,2058,2060,2062],{"class":628,"line":1508},[626,2053,2003],{"class":755},[626,2055,879],{"class":636},[626,2057,650],{"class":636},[626,2059,2010],{"class":653},[626,2061,758],{"class":636},[626,2063,889],{"class":636},[626,2065,2066,2068,2070,2072],{"class":628,"line":1513},[626,2067,2019],{"class":755},[626,2069,879],{"class":636},[626,2071,2024],{"class":1533},[626,2073,889],{"class":636},[626,2075,2076,2078],{"class":628,"line":1519},[626,2077,777],{"class":636},[626,2079,780],{"class":640},[609,2081,2083],{"id":2082},"ai-log-analysis","AI Log Analysis",[527,2085,2086,2087,2093],{},"The file system drain pairs with the ",[598,2088,2089,2092],{"href":518},[542,2090,2091],{},"analyze-logs"," agent skill",". When installed, your AI assistant can read the NDJSON logs directly to debug errors, trace requests, and investigate performance without any external tools.",[609,2095,2097],{"id":2096},"next-steps","Next Steps",[531,2099,2100,2105,2111,2117],{},[534,2101,2102,2104],{},[598,2103,517],{"href":518}," - Let AI analyze your logs",[534,2106,2107,2110],{},[598,2108,2109],{"href":147},"Axiom Adapter"," - Send logs to Axiom for querying and dashboards",[534,2112,2113,2116],{},[598,2114,2115],{"href":487},"Pipeline"," - Add batching and retry to any drain",[534,2118,2119,2122],{},[598,2120,2121],{"href":482},"Custom Adapters"," - Build your own adapter",[2124,2125,2126],"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 .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 .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 .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}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 .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}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 pre.shiki code .sfNiH, html code.shiki .sfNiH{--shiki-light:#FF5370;--shiki-default:#FF9CAC;--shiki-dark:#FF9CAC}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}",{"title":622,"searchDepth":681,"depth":681,"links":2128},[2129,2130,2131,2132,2138,2139,2144,2145,2146],{"id":611,"depth":681,"text":20},{"id":660,"depth":681,"text":25},{"id":1267,"depth":681,"text":1268},{"id":1304,"depth":681,"text":495,"children":2133},[2134,2135,2136,2137],{"id":1308,"depth":700,"text":331},{"id":1414,"depth":700,"text":1415},{"id":1577,"depth":700,"text":1578},{"id":1598,"depth":700,"text":1599},{"id":1611,"depth":681,"text":1612},{"id":1777,"depth":681,"text":1778,"children":2140},[2141,2142,2143],{"id":1781,"depth":700,"text":1782},{"id":1804,"depth":700,"text":1805},{"id":1891,"depth":700,"text":1892},{"id":1948,"depth":681,"text":1949},{"id":2082,"depth":681,"text":2083},{"id":2096,"depth":681,"text":2097},"Write wide events to the local file system as NDJSON for local debugging, AI agent integration, and production backup.","md",[2150,2157],{"label":2151,"icon":2152,"to":2153,"target":2154,"color":2155,"variant":2156},"NDJSON Format","i-lucide-external-link","https:\u002F\u002Fgithub.com\u002Fndjson\u002Fndjson-spec","_blank","neutral","subtle",{"label":2109,"icon":149,"to":147,"color":2155,"variant":2156},{},{"title":201,"icon":204},{"title":522,"description":2147},"jB9SyGTKAnAMMiuPqzZm_AQeiBXM27MYE8YpF9tFDXU",[2163,2165],{"title":191,"path":192,"stem":193,"description":2164,"icon":194,"children":-1},"Send wide events to HyperDX via OTLP\u002FHTTP using HyperDX’s documented OpenTelemetry endpoint and authorization header. Zero-config setup with environment variables.",{"title":206,"path":207,"stem":208,"description":2166,"icon":209,"children":-1},"Self-hosted log retention for evlog using NuxtHub database storage. Store, query, and automatically clean up your structured logs with zero external dependencies.",1785666936911]