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