[{"data":1,"prerenderedAt":2466},["ShallowReactive",2],{"navigation_docs":3,"-use-cases-audit-recipes":598,"-use-cases-audit-recipes-surround":2461},[4,35,85,138,318,453,475,534,573],{"title":5,"path":6,"stem":7,"children":8,"page":34},"Start","\u002Fstart","1.start",[9,14,19,24,29],{"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",{"title":30,"path":31,"stem":32,"icon":33},"Choose your logger","\u002Fstart\u002Ftypescript-logging-library","1.start\u002F5.typescript-logging-library","i-lucide-file-code",false,{"title":36,"path":37,"stem":38,"children":39,"page":34},"Learn","\u002Flearn","2.learn",[40,45,50,55,60,65,70,75,80],{"title":41,"path":42,"stem":43,"icon":44},"Overview","\u002Flearn\u002Foverview","2.learn\u002F0.overview","i-lucide-list",{"title":46,"path":47,"stem":48,"icon":49},"Simple Logging","\u002Flearn\u002Fsimple-logging","2.learn\u002F1.simple-logging","i-lucide-terminal",{"title":51,"path":52,"stem":53,"icon":54},"Wide Events","\u002Flearn\u002Fwide-events","2.learn\u002F2.wide-events","i-lucide-layers",{"title":56,"path":57,"stem":58,"icon":59},"Structured Errors","\u002Flearn\u002Fstructured-errors","2.learn\u002F3.structured-errors","i-lucide-shield-alert",{"title":61,"path":62,"stem":63,"icon":64},"Lifecycle","\u002Flearn\u002Flifecycle","2.learn\u002F4.lifecycle","i-lucide-arrow-right-left",{"title":66,"path":67,"stem":68,"icon":69},"Sampling","\u002Flearn\u002Fsampling","2.learn\u002F5.sampling","i-lucide-filter",{"title":71,"path":72,"stem":73,"icon":74},"Auto-Redaction","\u002Flearn\u002Fredaction","2.learn\u002F6.redaction","i-lucide-eye-off",{"title":76,"path":77,"stem":78,"icon":79},"Typed Fields","\u002Flearn\u002Ftyped-fields","2.learn\u002F7.typed-fields","i-simple-icons-typescript",{"title":81,"path":82,"stem":83,"icon":84},"Catalogs","\u002Flearn\u002Fcatalogs","2.learn\u002F8.catalogs","i-lucide-book-open",{"title":86,"path":87,"stem":88,"children":89,"page":34},"CLI","\u002Fcli","3.cli",[90,93,98,103,108,113,118,123,128,133],{"title":41,"path":91,"stem":92,"icon":49},"\u002Fcli\u002Foverview","3.cli\u002F0.overview",{"title":94,"path":95,"stem":96,"icon":97},"init","\u002Fcli\u002Finit","3.cli\u002F1.init","i-lucide-wand-sparkles",{"title":99,"path":100,"stem":101,"icon":102},"map","\u002Fcli\u002Fmap","3.cli\u002F2.map","i-lucide-radar",{"title":104,"path":105,"stem":106,"icon":107},"Rules","\u002Fcli\u002Frules","3.cli\u002F3.rules","i-lucide-list-checks",{"title":109,"path":110,"stem":111,"icon":112},"Scoring","\u002Fcli\u002Fscoring","3.cli\u002F4.scoring","i-lucide-gauge",{"title":114,"path":115,"stem":116,"icon":117},"CI","\u002Fcli\u002Fci","3.cli\u002F5.ci","i-lucide-git-pull-request",{"title":119,"path":120,"stem":121,"icon":122},"doctor","\u002Fcli\u002Fdoctor","3.cli\u002F6.doctor","i-lucide-stethoscope",{"title":124,"path":125,"stem":126,"icon":127},"telemetry","\u002Fcli\u002Ftelemetry","3.cli\u002F7.telemetry","i-lucide-bar-chart-3",{"title":129,"path":130,"stem":131,"icon":132},"agents","\u002Fcli\u002Fagents","3.cli\u002F8.agents","i-lucide-bot",{"title":134,"path":135,"stem":136,"icon":137},"Observability Score","\u002Fcli\u002Fobservability-score","3.cli\u002F9.observability-score","i-lucide-activity",{"title":139,"path":140,"stem":141,"children":142,"page":34},"Integrate","\u002Fintegrate","4.integrate",[143,147,230],{"title":41,"path":144,"stem":145,"icon":146},"\u002Fintegrate\u002Foverview","4.integrate\u002F0.overview","i-lucide-plug",{"title":148,"path":149,"stem":150,"children":151,"page":34},"Adapters","\u002Fintegrate\u002Fadapters","4.integrate\u002Fadapters",[152,155,185,210],{"title":41,"path":153,"stem":154,"icon":44},"\u002Fintegrate\u002Fadapters\u002Foverview","4.integrate\u002Fadapters\u002F01.overview",{"title":156,"path":157,"stem":158,"children":159,"page":34},"Cloud","\u002Fintegrate\u002Fadapters\u002Fcloud","4.integrate\u002Fadapters\u002Fcloud",[160,165,170,175,180],{"title":161,"path":162,"stem":163,"icon":164},"Axiom","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Faxiom","4.integrate\u002Fadapters\u002Fcloud\u002F01.axiom","i-custom-axiom",{"title":166,"path":167,"stem":168,"icon":169},"PostHog","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fposthog","4.integrate\u002Fadapters\u002Fcloud\u002F02.posthog","i-simple-icons-posthog",{"title":171,"path":172,"stem":173,"icon":174},"Sentry","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fsentry","4.integrate\u002Fadapters\u002Fcloud\u002F03.sentry","i-simple-icons-sentry",{"title":176,"path":177,"stem":178,"icon":179},"Better Stack","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fbetter-stack","4.integrate\u002Fadapters\u002Fcloud\u002F04.better-stack","i-simple-icons-betterstack",{"title":181,"path":182,"stem":183,"icon":184},"Datadog","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fdatadog","4.integrate\u002Fadapters\u002Fcloud\u002F05.datadog","i-simple-icons-datadog",{"title":186,"path":187,"stem":188,"children":189,"page":34},"Cloud or Self-Hosted","\u002Fintegrate\u002Fadapters\u002Fhybrid","4.integrate\u002Fadapters\u002Fhybrid",[190,195,200,205],{"title":191,"path":192,"stem":193,"icon":194},"Grafana Loki","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Floki","4.integrate\u002Fadapters\u002Fhybrid\u002F01.loki","i-simple-icons-grafana",{"title":196,"path":197,"stem":198,"icon":199},"ClickHouse","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Fclickhouse","4.integrate\u002Fadapters\u002Fhybrid\u002F02.clickhouse","i-simple-icons-clickhouse",{"title":201,"path":202,"stem":203,"icon":204},"OTLP","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Fotlp","4.integrate\u002Fadapters\u002Fhybrid\u002F03.otlp","i-simple-icons-opentelemetry",{"title":206,"path":207,"stem":208,"icon":209},"HyperDX","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Fhyperdx","4.integrate\u002Fadapters\u002Fhybrid\u002F04.hyperdx","i-custom-hyperdx",{"title":211,"path":212,"stem":213,"children":214,"page":34},"Self-Hosted","\u002Fintegrate\u002Fadapters\u002Fself-hosted","4.integrate\u002Fadapters\u002Fself-hosted",[215,220,225],{"title":216,"path":217,"stem":218,"icon":219},"File System","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Ffs","4.integrate\u002Fadapters\u002Fself-hosted\u002F01.fs","i-lucide-hard-drive",{"title":221,"path":222,"stem":223,"icon":224},"NuxtHub","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Fnuxthub","4.integrate\u002Fadapters\u002Fself-hosted\u002F02.nuxthub","i-simple-icons-nuxt",{"title":226,"path":227,"stem":228,"icon":229},"Memory","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Fmemory","4.integrate\u002Fadapters\u002Fself-hosted\u002F03.memory","i-lucide-cpu",{"title":231,"path":232,"stem":233,"children":234,"page":34},"Frameworks","\u002Fintegrate\u002Fframeworks","4.integrate\u002Fframeworks",[235,239,244,249,254,259,264,269,274,279,284,289,294,299,303,308,313],{"title":41,"path":236,"stem":237,"icon":238},"\u002Fintegrate\u002Fframeworks\u002Foverview","4.integrate\u002Fframeworks\u002F00.overview","i-lucide-layout-grid",{"title":240,"path":241,"stem":242,"icon":243},"Nuxt","\u002Fintegrate\u002Fframeworks\u002Fnuxt","4.integrate\u002Fframeworks\u002F01.nuxt","i-simple-icons-nuxtdotjs",{"title":245,"path":246,"stem":247,"icon":248},"Next.js","\u002Fintegrate\u002Fframeworks\u002Fnextjs","4.integrate\u002Fframeworks\u002F02.nextjs","i-simple-icons-nextdotjs",{"title":250,"path":251,"stem":252,"icon":253},"SvelteKit","\u002Fintegrate\u002Fframeworks\u002Fsveltekit","4.integrate\u002Fframeworks\u002F03.sveltekit","i-simple-icons-svelte",{"title":255,"path":256,"stem":257,"icon":258},"Nitro","\u002Fintegrate\u002Fframeworks\u002Fnitro","4.integrate\u002Fframeworks\u002F04.nitro","i-custom-nitro",{"title":260,"path":261,"stem":262,"icon":263},"TanStack Start","\u002Fintegrate\u002Fframeworks\u002Ftanstack-start","4.integrate\u002Fframeworks\u002F05.tanstack-start","i-custom-tanstack",{"title":265,"path":266,"stem":267,"icon":268},"NestJS","\u002Fintegrate\u002Fframeworks\u002Fnestjs","4.integrate\u002Fframeworks\u002F06.nestjs","i-simple-icons-nestjs",{"title":270,"path":271,"stem":272,"icon":273},"Express","\u002Fintegrate\u002Fframeworks\u002Fexpress","4.integrate\u002Fframeworks\u002F07.express","i-simple-icons-express",{"title":275,"path":276,"stem":277,"icon":278},"Hono","\u002Fintegrate\u002Fframeworks\u002Fhono","4.integrate\u002Fframeworks\u002F08.hono","i-simple-icons-hono",{"title":280,"path":281,"stem":282,"icon":283},"Fastify","\u002Fintegrate\u002Fframeworks\u002Ffastify","4.integrate\u002Fframeworks\u002F09.fastify","i-simple-icons-fastify",{"title":285,"path":286,"stem":287,"icon":288},"Elysia","\u002Fintegrate\u002Fframeworks\u002Felysia","4.integrate\u002Fframeworks\u002F10.elysia","i-custom-elysia",{"title":290,"path":291,"stem":292,"icon":293},"React Router","\u002Fintegrate\u002Fframeworks\u002Freact-router","4.integrate\u002Fframeworks\u002F11.react-router","i-custom-reactrouter",{"title":295,"path":296,"stem":297,"icon":298},"Cloudflare Workers","\u002Fintegrate\u002Fframeworks\u002Fcloudflare-workers","4.integrate\u002Fframeworks\u002F12.cloudflare-workers","i-simple-icons-cloudflare",{"title":300,"path":301,"stem":302,"icon":79},"Standalone","\u002Fintegrate\u002Fframeworks\u002Fstandalone","4.integrate\u002Fframeworks\u002F13.standalone",{"title":304,"path":305,"stem":306,"icon":307},"Astro","\u002Fintegrate\u002Fframeworks\u002Fastro","4.integrate\u002Fframeworks\u002F14.astro","i-simple-icons-astro",{"title":309,"path":310,"stem":311,"icon":312},"oRPC","\u002Fintegrate\u002Fframeworks\u002Forpc","4.integrate\u002Fframeworks\u002F15.orpc","i-lucide-network",{"title":314,"path":315,"stem":316,"icon":317},"AWS Lambda","\u002Fintegrate\u002Fframeworks\u002Faws-lambda","4.integrate\u002Fframeworks\u002F16.aws-lambda","i-custom-lambda",{"title":319,"path":320,"stem":321,"children":322,"page":34},"Use Cases","\u002Fuse-cases","5.use-cases",[323,326,331,359,386,418,439,444,449],{"title":41,"path":324,"stem":325,"icon":107},"\u002Fuse-cases\u002Foverview","5.use-cases\u002F0.overview",{"title":327,"path":328,"stem":329,"icon":330},"Client Logging","\u002Fuse-cases\u002Fclient-logging","5.use-cases\u002F1.client-logging","i-lucide-monitor",{"title":332,"icon":333,"path":334,"stem":335,"children":336,"page":34},"AI SDK","i-simple-icons-vercel","\u002Fuse-cases\u002Fai-sdk","5.use-cases\u002F2.ai-sdk",[337,340,345,350,355],{"title":41,"path":338,"stem":339,"icon":44},"\u002Fuse-cases\u002Fai-sdk\u002Foverview","5.use-cases\u002F2.ai-sdk\u002F01.overview",{"title":341,"path":342,"stem":343,"icon":344},"Usage","\u002Fuse-cases\u002Fai-sdk\u002Fusage","5.use-cases\u002F2.ai-sdk\u002F02.usage","i-lucide-code",{"title":346,"path":347,"stem":348,"icon":349},"Options","\u002Fuse-cases\u002Fai-sdk\u002Foptions","5.use-cases\u002F2.ai-sdk\u002F03.options","i-lucide-sliders",{"title":351,"path":352,"stem":353,"icon":354},"Metadata","\u002Fuse-cases\u002Fai-sdk\u002Fmetadata","5.use-cases\u002F2.ai-sdk\u002F04.metadata","i-lucide-database",{"title":356,"path":357,"stem":358,"icon":137},"Telemetry","\u002Fuse-cases\u002Fai-sdk\u002Ftelemetry","5.use-cases\u002F2.ai-sdk\u002F05.telemetry",{"title":360,"icon":361,"path":362,"stem":363,"children":364,"page":34},"Better Auth","i-simple-icons-betterauth","\u002Fuse-cases\u002Fbetter-auth","5.use-cases\u002F3.better-auth",[365,368,373,378,382],{"title":41,"path":366,"stem":367,"icon":44},"\u002Fuse-cases\u002Fbetter-auth\u002Foverview","5.use-cases\u002F3.better-auth\u002F01.overview",{"title":369,"path":370,"stem":371,"icon":372},"Identify User","\u002Fuse-cases\u002Fbetter-auth\u002Fidentify-user","5.use-cases\u002F3.better-auth\u002F02.identify-user","i-lucide-user-check",{"title":374,"path":375,"stem":376,"icon":377},"Middleware","\u002Fuse-cases\u002Fbetter-auth\u002Fmiddleware","5.use-cases\u002F3.better-auth\u002F03.middleware","i-lucide-shield",{"title":379,"path":380,"stem":381,"icon":330},"Client Sync","\u002Fuse-cases\u002Fbetter-auth\u002Fclient-sync","5.use-cases\u002F3.better-auth\u002F04.client-sync",{"title":383,"path":384,"stem":385,"icon":112},"Performance","\u002Fuse-cases\u002Fbetter-auth\u002Fperformance","5.use-cases\u002F3.better-auth\u002F05.performance",{"title":387,"icon":388,"path":389,"stem":390,"children":391,"page":34},"Audit Logs","i-lucide-shield-check","\u002Fuse-cases\u002Faudit","5.use-cases\u002F4.audit",[392,395,400,405,410,414],{"title":41,"path":393,"stem":394,"icon":44},"\u002Fuse-cases\u002Faudit\u002Foverview","5.use-cases\u002F4.audit\u002F01.overview",{"title":396,"path":397,"stem":398,"icon":399},"Schema","\u002Fuse-cases\u002Faudit\u002Fschema","5.use-cases\u002F4.audit\u002F02.schema","i-lucide-file-text",{"title":401,"path":402,"stem":403,"icon":404},"Recording","\u002Fuse-cases\u002Faudit\u002Frecording","5.use-cases\u002F4.audit\u002F03.recording","i-lucide-pen-line",{"title":406,"path":407,"stem":408,"icon":409},"Drains","\u002Fuse-cases\u002Faudit\u002Fpipeline","5.use-cases\u002F4.audit\u002F04.pipeline","i-lucide-link",{"title":411,"path":412,"stem":413,"icon":388},"Compliance","\u002Fuse-cases\u002Faudit\u002Fcompliance","5.use-cases\u002F4.audit\u002F05.compliance",{"title":415,"path":416,"stem":417,"icon":84},"Recipes","\u002Fuse-cases\u002Faudit\u002Frecipes","5.use-cases\u002F4.audit\u002F06.recipes",{"title":356,"icon":112,"path":419,"stem":420,"children":421,"page":34},"\u002Fuse-cases\u002Ftelemetry","5.use-cases\u002F4.telemetry",[422,425,430,435],{"title":41,"path":423,"stem":424,"icon":44},"\u002Fuse-cases\u002Ftelemetry\u002Foverview","5.use-cases\u002F4.telemetry\u002F01.overview",{"title":426,"path":427,"stem":428,"icon":429},"Setup","\u002Fuse-cases\u002Ftelemetry\u002Fsetup","5.use-cases\u002F4.telemetry\u002F02.setup","i-lucide-wrench",{"title":431,"path":432,"stem":433,"icon":434},"Ingest","\u002Fuse-cases\u002Ftelemetry\u002Fingest","5.use-cases\u002F4.telemetry\u002F03.ingest","i-lucide-server",{"title":436,"path":437,"stem":438,"icon":84},"Reference","\u002Fuse-cases\u002Ftelemetry\u002Freference","5.use-cases\u002F4.telemetry\u002F04.reference",{"title":440,"path":441,"stem":442,"icon":443},"Enrichers","\u002Fuse-cases\u002Fenrichers","5.use-cases\u002F5.enrichers","i-lucide-sparkles",{"title":445,"path":446,"stem":447,"icon":448},"eve","\u002Fuse-cases\u002Feve","5.use-cases\u002F5.eve","i-custom-eve",{"title":450,"path":451,"stem":452,"icon":434},"Node.js request logging","\u002Fuse-cases\u002Fstructured-logging-nodejs","5.use-cases\u002F6.structured-logging-nodejs",{"title":454,"path":455,"stem":456,"children":457,"page":34},"Libraries","\u002Flibraries","6.libraries",[458,462,467,470],{"title":41,"path":459,"stem":460,"icon":461},"\u002Flibraries\u002Foverview","6.libraries\u002F0.overview","i-lucide-package",{"title":463,"path":464,"stem":465,"icon":466},"Emitting Events","\u002Flibraries\u002Femitting","6.libraries\u002F1.emitting","i-lucide-radio",{"title":56,"path":468,"stem":469,"icon":59},"\u002Flibraries\u002Ferrors","6.libraries\u002F2.errors",{"title":471,"path":472,"stem":473,"icon":474},"Testing","\u002Flibraries\u002Ftesting","6.libraries\u002F3.testing","i-lucide-flask-conical",{"title":476,"path":477,"stem":478,"children":479,"page":34},"Extend","\u002Fextend","7.extend",[480,484,489,494,498,503,507,511,515,519,524,529],{"title":41,"path":481,"stem":482,"icon":483},"\u002Fextend\u002Foverview","7.extend\u002F0.overview","i-lucide-blocks",{"title":485,"path":486,"stem":487,"icon":488},"Stream","\u002Fextend\u002Fstream","7.extend\u002F1.stream","i-lucide-radio-tower",{"title":490,"path":491,"stem":492,"icon":493},"Custom framework","\u002Fextend\u002Fcustom-framework","7.extend\u002F10.custom-framework","i-lucide-puzzle",{"title":495,"path":496,"stem":497,"icon":488},"Diagnostics channel","\u002Fextend\u002Fdiagnostics-channel","7.extend\u002F11.diagnostics-channel",{"title":499,"path":500,"stem":501,"icon":502},"FS reader","\u002Fextend\u002Ffs-reader","7.extend\u002F2.fs-reader","i-lucide-folder-search",{"title":415,"path":504,"stem":505,"icon":506},"\u002Fextend\u002Fconsumer-recipes","7.extend\u002F3.consumer-recipes","i-lucide-chef-hat",{"title":508,"path":509,"stem":510,"icon":483},"Plugins","\u002Fextend\u002Fplugins","7.extend\u002F4.plugins",{"title":512,"path":513,"stem":514,"icon":443},"Custom enrichers","\u002Fextend\u002Fcustom-enrichers","7.extend\u002F5.custom-enrichers",{"title":516,"path":517,"stem":518,"icon":69},"Tail sampling","\u002Fextend\u002Ftail-sampling","7.extend\u002F6.tail-sampling",{"title":520,"path":521,"stem":522,"icon":523},"Identity headers","\u002Fextend\u002Fidentity-headers","7.extend\u002F7.identity-headers","i-lucide-fingerprint",{"title":525,"path":526,"stem":527,"icon":528},"Custom drains","\u002Fextend\u002Fcustom-drains","7.extend\u002F8.custom-drains","i-lucide-share-2",{"title":530,"path":531,"stem":532,"icon":533},"Drain pipeline","\u002Fextend\u002Fdrain-pipeline","7.extend\u002F9.drain-pipeline","i-lucide-workflow",{"title":436,"path":535,"stem":536,"children":537,"page":34},"\u002Freference","8.reference",[538,542,547,550,555,559,564,568],{"title":41,"path":539,"stem":540,"icon":541},"\u002Freference\u002Foverview","8.reference\u002F0.overview","i-lucide-book-marked",{"title":543,"path":544,"stem":545,"icon":546},"Configuration","\u002Freference\u002Fconfiguration","8.reference\u002F1.configuration","i-lucide-settings",{"title":383,"path":548,"stem":549,"icon":112},"\u002Freference\u002Fperformance","8.reference\u002F2.performance",{"title":551,"path":552,"stem":553,"icon":554},"Vite Plugin","\u002Freference\u002Fvite-plugin","8.reference\u002F3.vite-plugin","i-custom-vite",{"title":556,"path":557,"stem":558,"icon":388},"Best Practices","\u002Freference\u002Fbest-practices","8.reference\u002F4.best-practices",{"title":560,"path":561,"stem":562,"icon":563},"vs Other Loggers","\u002Freference\u002Fvs-other-loggers","8.reference\u002F5.vs-other-loggers","i-lucide-scale",{"title":565,"path":566,"stem":567,"icon":443},"Agent Skills","\u002Freference\u002Fagent-skills","8.reference\u002F6.agent-skills",{"title":569,"path":570,"stem":571,"icon":572},"Cost","\u002Freference\u002Fcost","8.reference\u002F7.cost","i-lucide-receipt",{"title":574,"path":575,"stem":576,"children":577,"page":34},"Compare","\u002Fcompare","9.compare",[578,582,586,590,594],{"title":579,"path":580,"stem":581,"icon":563},"evlog vs Pino","\u002Fcompare\u002Fpino","9.compare\u002F1.pino",{"title":583,"path":584,"stem":585,"icon":204},"evlog vs OpenTelemetry","\u002Fcompare\u002Fopentelemetry","9.compare\u002F2.opentelemetry",{"title":587,"path":588,"stem":589,"icon":563},"evlog vs LogTape","\u002Fcompare\u002Flogtape","9.compare\u002F3.logtape",{"title":591,"path":592,"stem":593,"icon":563},"evlog vs Winston: formats and request events","\u002Fcompare\u002Fwinston","9.compare\u002F4.winston",{"title":595,"path":596,"stem":597,"icon":563},"evlog vs Consola: reporters and request context","\u002Fcompare\u002Fconsola","9.compare\u002F5.consola",{"id":599,"title":600,"body":601,"description":2450,"extension":2451,"links":2452,"meta":2457,"navigation":2458,"path":416,"seo":2459,"stem":417,"__hash__":2460},"docs\u002F5.use-cases\u002F4.audit\u002F06.recipes.md","Recipes & Reference",{"type":602,"value":603,"toc":2443},"minimark",[604,621,626,1234,1243,1247,1546,1549,1553,1928,1938,1942,1958,2204,2218,2229,2233,2433,2439],[605,606,607,608,612,613,616,617,620],"p",{},"Pick the recipe that matches your drain, drop it in, and you have a tamper-evident audit log. Each recipe composes the same primitives (",[609,610,611],"code",{},"auditOnly",", ",[609,614,615],{},"signed",", optional ",[609,618,619],{},"await: true",") over different drains.",[622,623,625],"h2",{"id":624},"audit-logs-on-disk","Audit logs on disk",[627,628,629,835],"code-group",{},[630,631,637],"pre",{"className":632,"code":633,"filename":634,"language":635,"meta":636,"style":636},"language-typescript shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import { auditOnly, signed } from 'evlog'\nimport { createFsDrain } from 'evlog\u002Ffs'\n\nnitro.hooks.hook('evlog:drain', auditOnly(\n  signed(createFsDrain({ dir: '.audit', maxFiles: 30 }), { strategy: 'hash-chain' }),\n  { await: true },\n))\n","Input — server\u002Fplugins\u002Fevlog.ts","typescript","",[609,638,639,678,699,706,742,811,829],{"__ignoreMap":636},[640,641,644,648,652,656,659,662,665,668,671,675],"span",{"class":642,"line":643},"line",1,[640,645,647],{"class":646},"s7zQu","import",[640,649,651],{"class":650},"sMK4o"," {",[640,653,655],{"class":654},"sTEyZ"," auditOnly",[640,657,658],{"class":650},",",[640,660,661],{"class":654}," signed",[640,663,664],{"class":650}," }",[640,666,667],{"class":646}," from",[640,669,670],{"class":650}," '",[640,672,674],{"class":673},"sfazB","evlog",[640,676,677],{"class":650},"'\n",[640,679,681,683,685,688,690,692,694,697],{"class":642,"line":680},2,[640,682,647],{"class":646},[640,684,651],{"class":650},[640,686,687],{"class":654}," createFsDrain",[640,689,664],{"class":650},[640,691,667],{"class":646},[640,693,670],{"class":650},[640,695,696],{"class":673},"evlog\u002Ffs",[640,698,677],{"class":650},[640,700,702],{"class":642,"line":701},3,[640,703,705],{"emptyLinePlaceholder":704},true,"\n",[640,707,709,712,715,718,720,724,727,730,733,735,737,739],{"class":642,"line":708},4,[640,710,711],{"class":654},"nitro",[640,713,714],{"class":650},".",[640,716,717],{"class":654},"hooks",[640,719,714],{"class":650},[640,721,723],{"class":722},"s2Zo4","hook",[640,725,726],{"class":654},"(",[640,728,729],{"class":650},"'",[640,731,732],{"class":673},"evlog:drain",[640,734,729],{"class":650},[640,736,658],{"class":650},[640,738,655],{"class":722},[640,740,741],{"class":654},"(\n",[640,743,745,748,750,753,755,758,762,765,767,770,772,774,777,779,783,785,788,790,792,795,797,799,802,804,806,808],{"class":642,"line":744},5,[640,746,747],{"class":722},"  signed",[640,749,726],{"class":654},[640,751,752],{"class":722},"createFsDrain",[640,754,726],{"class":654},[640,756,757],{"class":650},"{",[640,759,761],{"class":760},"swJcz"," dir",[640,763,764],{"class":650},":",[640,766,670],{"class":650},[640,768,769],{"class":673},".audit",[640,771,729],{"class":650},[640,773,658],{"class":650},[640,775,776],{"class":760}," maxFiles",[640,778,764],{"class":650},[640,780,782],{"class":781},"sbssI"," 30",[640,784,664],{"class":650},[640,786,787],{"class":654},")",[640,789,658],{"class":650},[640,791,651],{"class":650},[640,793,794],{"class":760}," strategy",[640,796,764],{"class":650},[640,798,670],{"class":650},[640,800,801],{"class":673},"hash-chain",[640,803,729],{"class":650},[640,805,664],{"class":650},[640,807,787],{"class":654},[640,809,810],{"class":650},",\n",[640,812,814,817,820,822,826],{"class":642,"line":813},6,[640,815,816],{"class":650},"  {",[640,818,819],{"class":760}," await",[640,821,764],{"class":650},[640,823,825],{"class":824},"sfNiH"," true",[640,827,828],{"class":650}," },\n",[640,830,832],{"class":642,"line":831},7,[640,833,834],{"class":654},"))\n",[630,836,841],{"className":837,"code":838,"filename":839,"language":840,"meta":636,"style":636},"language-jsonl shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\"audit\":{\"action\":\"invoice.refund\",\"actor\":{\"type\":\"user\",\"id\":\"usr_42\"},\"target\":{\"type\":\"invoice\",\"id\":\"inv_889\"},\"outcome\":\"success\",\"version\":1,\"idempotencyKey\":\"ak_8f3c4b2a1e5d6f7c\",\"prevHash\":null,\"hash\":\"3f2c8e1a...\"}}\n{\"audit\":{\"action\":\"user.update\",\"actor\":{\"type\":\"user\",\"id\":\"usr_42\"},\"target\":{\"type\":\"user\",\"id\":\"usr_99\"},\"outcome\":\"success\",\"version\":1,\"idempotencyKey\":\"ak_5e7d8f9a0b1c2d3e\",\"prevHash\":\"3f2c8e1a...\",\"hash\":\"9a1b4d7c...\"}}\n","Output — .audit\u002F2026-04-24.ndjson","jsonl",[609,842,843,1046],{"__ignoreMap":636},[640,844,845,847,850,854,856,859,861,865,867,869,871,874,876,878,880,883,885,887,889,892,894,896,898,901,903,905,907,910,912,914,916,919,921,924,926,929,931,933,935,937,939,941,943,946,948,950,952,954,956,958,960,963,965,967,969,972,974,976,978,981,983,985,987,990,992,994,997,999,1001,1004,1006,1008,1010,1013,1015,1017,1019,1022,1024,1027,1029,1032,1034,1036,1038,1041,1043],{"class":642,"line":643},[640,846,757],{"class":650},[640,848,849],{"class":650},"\"",[640,851,853],{"class":852},"spNyl","audit",[640,855,849],{"class":650},[640,857,858],{"class":650},":{",[640,860,849],{"class":650},[640,862,864],{"class":863},"sBMFI","action",[640,866,849],{"class":650},[640,868,764],{"class":650},[640,870,849],{"class":650},[640,872,873],{"class":673},"invoice.refund",[640,875,849],{"class":650},[640,877,658],{"class":650},[640,879,849],{"class":650},[640,881,882],{"class":863},"actor",[640,884,849],{"class":650},[640,886,858],{"class":650},[640,888,849],{"class":650},[640,890,891],{"class":781},"type",[640,893,849],{"class":650},[640,895,764],{"class":650},[640,897,849],{"class":650},[640,899,900],{"class":673},"user",[640,902,849],{"class":650},[640,904,658],{"class":650},[640,906,849],{"class":650},[640,908,909],{"class":781},"id",[640,911,849],{"class":650},[640,913,764],{"class":650},[640,915,849],{"class":650},[640,917,918],{"class":673},"usr_42",[640,920,849],{"class":650},[640,922,923],{"class":650},"},",[640,925,849],{"class":650},[640,927,928],{"class":863},"target",[640,930,849],{"class":650},[640,932,858],{"class":650},[640,934,849],{"class":650},[640,936,891],{"class":781},[640,938,849],{"class":650},[640,940,764],{"class":650},[640,942,849],{"class":650},[640,944,945],{"class":673},"invoice",[640,947,849],{"class":650},[640,949,658],{"class":650},[640,951,849],{"class":650},[640,953,909],{"class":781},[640,955,849],{"class":650},[640,957,764],{"class":650},[640,959,849],{"class":650},[640,961,962],{"class":673},"inv_889",[640,964,849],{"class":650},[640,966,923],{"class":650},[640,968,849],{"class":650},[640,970,971],{"class":863},"outcome",[640,973,849],{"class":650},[640,975,764],{"class":650},[640,977,849],{"class":650},[640,979,980],{"class":673},"success",[640,982,849],{"class":650},[640,984,658],{"class":650},[640,986,849],{"class":650},[640,988,989],{"class":863},"version",[640,991,849],{"class":650},[640,993,764],{"class":650},[640,995,996],{"class":781},"1",[640,998,658],{"class":650},[640,1000,849],{"class":650},[640,1002,1003],{"class":863},"idempotencyKey",[640,1005,849],{"class":650},[640,1007,764],{"class":650},[640,1009,849],{"class":650},[640,1011,1012],{"class":673},"ak_8f3c4b2a1e5d6f7c",[640,1014,849],{"class":650},[640,1016,658],{"class":650},[640,1018,849],{"class":650},[640,1020,1021],{"class":863},"prevHash",[640,1023,849],{"class":650},[640,1025,1026],{"class":650},":null,",[640,1028,849],{"class":650},[640,1030,1031],{"class":863},"hash",[640,1033,849],{"class":650},[640,1035,764],{"class":650},[640,1037,849],{"class":650},[640,1039,1040],{"class":673},"3f2c8e1a...",[640,1042,849],{"class":650},[640,1044,1045],{"class":650},"}}\n",[640,1047,1048,1050,1052,1054,1056,1058,1060,1062,1064,1066,1068,1071,1073,1075,1077,1079,1081,1083,1085,1087,1089,1091,1093,1095,1097,1099,1101,1103,1105,1107,1109,1111,1113,1115,1117,1119,1121,1123,1125,1127,1129,1131,1133,1135,1137,1139,1141,1143,1145,1147,1149,1152,1154,1156,1158,1160,1162,1164,1166,1168,1170,1172,1174,1176,1178,1180,1182,1184,1186,1188,1190,1192,1194,1197,1199,1201,1203,1205,1207,1209,1211,1213,1215,1217,1219,1221,1223,1225,1227,1230,1232],{"class":642,"line":680},[640,1049,757],{"class":650},[640,1051,849],{"class":650},[640,1053,853],{"class":852},[640,1055,849],{"class":650},[640,1057,858],{"class":650},[640,1059,849],{"class":650},[640,1061,864],{"class":863},[640,1063,849],{"class":650},[640,1065,764],{"class":650},[640,1067,849],{"class":650},[640,1069,1070],{"class":673},"user.update",[640,1072,849],{"class":650},[640,1074,658],{"class":650},[640,1076,849],{"class":650},[640,1078,882],{"class":863},[640,1080,849],{"class":650},[640,1082,858],{"class":650},[640,1084,849],{"class":650},[640,1086,891],{"class":781},[640,1088,849],{"class":650},[640,1090,764],{"class":650},[640,1092,849],{"class":650},[640,1094,900],{"class":673},[640,1096,849],{"class":650},[640,1098,658],{"class":650},[640,1100,849],{"class":650},[640,1102,909],{"class":781},[640,1104,849],{"class":650},[640,1106,764],{"class":650},[640,1108,849],{"class":650},[640,1110,918],{"class":673},[640,1112,849],{"class":650},[640,1114,923],{"class":650},[640,1116,849],{"class":650},[640,1118,928],{"class":863},[640,1120,849],{"class":650},[640,1122,858],{"class":650},[640,1124,849],{"class":650},[640,1126,891],{"class":781},[640,1128,849],{"class":650},[640,1130,764],{"class":650},[640,1132,849],{"class":650},[640,1134,900],{"class":673},[640,1136,849],{"class":650},[640,1138,658],{"class":650},[640,1140,849],{"class":650},[640,1142,909],{"class":781},[640,1144,849],{"class":650},[640,1146,764],{"class":650},[640,1148,849],{"class":650},[640,1150,1151],{"class":673},"usr_99",[640,1153,849],{"class":650},[640,1155,923],{"class":650},[640,1157,849],{"class":650},[640,1159,971],{"class":863},[640,1161,849],{"class":650},[640,1163,764],{"class":650},[640,1165,849],{"class":650},[640,1167,980],{"class":673},[640,1169,849],{"class":650},[640,1171,658],{"class":650},[640,1173,849],{"class":650},[640,1175,989],{"class":863},[640,1177,849],{"class":650},[640,1179,764],{"class":650},[640,1181,996],{"class":781},[640,1183,658],{"class":650},[640,1185,849],{"class":650},[640,1187,1003],{"class":863},[640,1189,849],{"class":650},[640,1191,764],{"class":650},[640,1193,849],{"class":650},[640,1195,1196],{"class":673},"ak_5e7d8f9a0b1c2d3e",[640,1198,849],{"class":650},[640,1200,658],{"class":650},[640,1202,849],{"class":650},[640,1204,1021],{"class":863},[640,1206,849],{"class":650},[640,1208,764],{"class":650},[640,1210,849],{"class":650},[640,1212,1040],{"class":673},[640,1214,849],{"class":650},[640,1216,658],{"class":650},[640,1218,849],{"class":650},[640,1220,1031],{"class":863},[640,1222,849],{"class":650},[640,1224,764],{"class":650},[640,1226,849],{"class":650},[640,1228,1229],{"class":673},"9a1b4d7c...",[640,1231,849],{"class":650},[640,1233,1045],{"class":650},[605,1235,1236,1237,1239,1240,1242],{},"Each line's ",[609,1238,1021],{}," matches the previous line's ",[609,1241,1031],{},". Tampering with any row breaks the chain forward of that point, and a verifier replays the hashes and reports the first mismatch.",[622,1244,1246],{"id":1245},"audit-logs-to-a-dedicated-axiom-dataset","Audit logs to a dedicated Axiom dataset",[627,1248,1249,1416,1484],{},[630,1250,1252],{"className":632,"code":1251,"filename":634,"language":635,"meta":636,"style":636},"import { auditOnly } from 'evlog'\nimport { createAxiomDrain } from 'evlog\u002Faxiom'\n\nnitro.hooks.hook('evlog:drain', createAxiomDrain({ dataset: 'logs' }))\nnitro.hooks.hook('evlog:drain', auditOnly(\n  createAxiomDrain({ dataset: 'audit', apiKey: process.env.AXIOM_AUDIT_API_KEY }),\n))\n",[609,1253,1254,1272,1292,1296,1340,1366,1412],{"__ignoreMap":636},[640,1255,1256,1258,1260,1262,1264,1266,1268,1270],{"class":642,"line":643},[640,1257,647],{"class":646},[640,1259,651],{"class":650},[640,1261,655],{"class":654},[640,1263,664],{"class":650},[640,1265,667],{"class":646},[640,1267,670],{"class":650},[640,1269,674],{"class":673},[640,1271,677],{"class":650},[640,1273,1274,1276,1278,1281,1283,1285,1287,1290],{"class":642,"line":680},[640,1275,647],{"class":646},[640,1277,651],{"class":650},[640,1279,1280],{"class":654}," createAxiomDrain",[640,1282,664],{"class":650},[640,1284,667],{"class":646},[640,1286,670],{"class":650},[640,1288,1289],{"class":673},"evlog\u002Faxiom",[640,1291,677],{"class":650},[640,1293,1294],{"class":642,"line":701},[640,1295,705],{"emptyLinePlaceholder":704},[640,1297,1298,1300,1302,1304,1306,1308,1310,1312,1314,1316,1318,1320,1322,1324,1327,1329,1331,1334,1336,1338],{"class":642,"line":708},[640,1299,711],{"class":654},[640,1301,714],{"class":650},[640,1303,717],{"class":654},[640,1305,714],{"class":650},[640,1307,723],{"class":722},[640,1309,726],{"class":654},[640,1311,729],{"class":650},[640,1313,732],{"class":673},[640,1315,729],{"class":650},[640,1317,658],{"class":650},[640,1319,1280],{"class":722},[640,1321,726],{"class":654},[640,1323,757],{"class":650},[640,1325,1326],{"class":760}," dataset",[640,1328,764],{"class":650},[640,1330,670],{"class":650},[640,1332,1333],{"class":673},"logs",[640,1335,729],{"class":650},[640,1337,664],{"class":650},[640,1339,834],{"class":654},[640,1341,1342,1344,1346,1348,1350,1352,1354,1356,1358,1360,1362,1364],{"class":642,"line":744},[640,1343,711],{"class":654},[640,1345,714],{"class":650},[640,1347,717],{"class":654},[640,1349,714],{"class":650},[640,1351,723],{"class":722},[640,1353,726],{"class":654},[640,1355,729],{"class":650},[640,1357,732],{"class":673},[640,1359,729],{"class":650},[640,1361,658],{"class":650},[640,1363,655],{"class":722},[640,1365,741],{"class":654},[640,1367,1368,1371,1373,1375,1377,1379,1381,1383,1385,1387,1390,1392,1395,1397,1400,1402,1405,1408,1410],{"class":642,"line":813},[640,1369,1370],{"class":722},"  createAxiomDrain",[640,1372,726],{"class":654},[640,1374,757],{"class":650},[640,1376,1326],{"class":760},[640,1378,764],{"class":650},[640,1380,670],{"class":650},[640,1382,853],{"class":673},[640,1384,729],{"class":650},[640,1386,658],{"class":650},[640,1388,1389],{"class":760}," apiKey",[640,1391,764],{"class":650},[640,1393,1394],{"class":654}," process",[640,1396,714],{"class":650},[640,1398,1399],{"class":654},"env",[640,1401,714],{"class":650},[640,1403,1404],{"class":654},"AXIOM_AUDIT_API_KEY ",[640,1406,1407],{"class":650},"}",[640,1409,787],{"class":654},[640,1411,810],{"class":650},[640,1413,1414],{"class":642,"line":831},[640,1415,834],{"class":654},[630,1417,1422],{"className":1418,"code":1419,"filename":1420,"language":1421,"meta":636,"style":636},"language-kusto shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","['audit']\n| where audit.action == \"invoice.refund\"\n| summarize count() by audit.outcome, bin(_time, 1h)\n","Output — Axiom query","kusto",[609,1423,1424,1438,1456],{"__ignoreMap":636},[640,1425,1426,1429,1431,1433,1435],{"class":642,"line":643},[640,1427,1428],{"class":654},"[",[640,1430,729],{"class":650},[640,1432,853],{"class":673},[640,1434,729],{"class":650},[640,1436,1437],{"class":654},"]\n",[640,1439,1440,1443,1446,1449,1451,1453],{"class":642,"line":680},[640,1441,1442],{"class":654},"| ",[640,1444,1445],{"class":781},"where",[640,1447,1448],{"class":654}," audit.action == ",[640,1450,849],{"class":650},[640,1452,873],{"class":673},[640,1454,1455],{"class":650},"\"\n",[640,1457,1458,1460,1463,1466,1469,1472,1475,1478,1481],{"class":642,"line":701},[640,1459,1442],{"class":654},[640,1461,1462],{"class":781},"summarize",[640,1464,1465],{"class":722}," count()",[640,1467,1468],{"class":781}," by",[640,1470,1471],{"class":654}," audit.outcome, ",[640,1473,1474],{"class":722},"bin",[640,1476,1477],{"class":654},"(_time, ",[640,1479,1480],{"class":781},"1h",[640,1482,1483],{"class":654},")\n",[630,1485,1488],{"className":1418,"code":1486,"filename":1487,"language":1421,"meta":636,"style":636},"['audit']\n| where audit.outcome == \"denied\"\n| summarize count() by audit.actor.id, audit.action\n| order by count_ desc\n","Output — denials by actor",[609,1489,1490,1502,1518,1531],{"__ignoreMap":636},[640,1491,1492,1494,1496,1498,1500],{"class":642,"line":643},[640,1493,1428],{"class":654},[640,1495,729],{"class":650},[640,1497,853],{"class":673},[640,1499,729],{"class":650},[640,1501,1437],{"class":654},[640,1503,1504,1506,1508,1511,1513,1516],{"class":642,"line":680},[640,1505,1442],{"class":654},[640,1507,1445],{"class":781},[640,1509,1510],{"class":654}," audit.outcome == ",[640,1512,849],{"class":650},[640,1514,1515],{"class":673},"denied",[640,1517,1455],{"class":650},[640,1519,1520,1522,1524,1526,1528],{"class":642,"line":701},[640,1521,1442],{"class":654},[640,1523,1462],{"class":781},[640,1525,1465],{"class":722},[640,1527,1468],{"class":781},[640,1529,1530],{"class":654}," audit.actor.id, audit.action\n",[640,1532,1533,1535,1538,1540,1543],{"class":642,"line":708},[640,1534,1442],{"class":654},[640,1536,1537],{"class":781},"order",[640,1539,1468],{"class":781},[640,1541,1542],{"class":654}," count_ ",[640,1544,1545],{"class":781},"desc\n",[605,1547,1548],{},"Splitting datasets means the audit dataset can have a longer retention (7y), tighter access controls, and a separate billing line, without touching the rest of your pipeline.",[622,1550,1552],{"id":1551},"audit-logs-in-postgres","Audit logs in Postgres",[627,1554,1555,1808],{},[630,1556,1558],{"className":632,"code":1557,"filename":634,"language":635,"meta":636,"style":636},"import { auditOnly } from 'evlog'\nimport type { DrainContext } from 'evlog'\n\nconst postgresAudit = async (ctx: DrainContext) => {\n  await db.insert(auditEvents).values({\n    id: ctx.event.audit!.idempotencyKey,\n    timestamp: new Date(ctx.event.timestamp),\n    payload: ctx.event,\n  }).onConflictDoNothing()\n}\n\nnitro.hooks.hook('evlog:drain', auditOnly(postgresAudit, { await: true }))\n",[609,1559,1560,1578,1600,1604,1637,1667,1693,1723,1739,1755,1761,1766],{"__ignoreMap":636},[640,1561,1562,1564,1566,1568,1570,1572,1574,1576],{"class":642,"line":643},[640,1563,647],{"class":646},[640,1565,651],{"class":650},[640,1567,655],{"class":654},[640,1569,664],{"class":650},[640,1571,667],{"class":646},[640,1573,670],{"class":650},[640,1575,674],{"class":673},[640,1577,677],{"class":650},[640,1579,1580,1582,1585,1587,1590,1592,1594,1596,1598],{"class":642,"line":680},[640,1581,647],{"class":646},[640,1583,1584],{"class":646}," type",[640,1586,651],{"class":650},[640,1588,1589],{"class":654}," DrainContext",[640,1591,664],{"class":650},[640,1593,667],{"class":646},[640,1595,670],{"class":650},[640,1597,674],{"class":673},[640,1599,677],{"class":650},[640,1601,1602],{"class":642,"line":701},[640,1603,705],{"emptyLinePlaceholder":704},[640,1605,1606,1609,1612,1615,1618,1621,1625,1627,1629,1631,1634],{"class":642,"line":708},[640,1607,1608],{"class":852},"const",[640,1610,1611],{"class":654}," postgresAudit ",[640,1613,1614],{"class":650},"=",[640,1616,1617],{"class":852}," async",[640,1619,1620],{"class":650}," (",[640,1622,1624],{"class":1623},"sHdIc","ctx",[640,1626,764],{"class":650},[640,1628,1589],{"class":863},[640,1630,787],{"class":650},[640,1632,1633],{"class":852}," =>",[640,1635,1636],{"class":650}," {\n",[640,1638,1639,1642,1645,1647,1650,1652,1655,1657,1659,1662,1664],{"class":642,"line":744},[640,1640,1641],{"class":646},"  await",[640,1643,1644],{"class":654}," db",[640,1646,714],{"class":650},[640,1648,1649],{"class":722},"insert",[640,1651,726],{"class":760},[640,1653,1654],{"class":654},"auditEvents",[640,1656,787],{"class":760},[640,1658,714],{"class":650},[640,1660,1661],{"class":722},"values",[640,1663,726],{"class":760},[640,1665,1666],{"class":650},"{\n",[640,1668,1669,1672,1674,1677,1679,1682,1684,1686,1689,1691],{"class":642,"line":813},[640,1670,1671],{"class":760},"    id",[640,1673,764],{"class":650},[640,1675,1676],{"class":654}," ctx",[640,1678,714],{"class":650},[640,1680,1681],{"class":654},"event",[640,1683,714],{"class":650},[640,1685,853],{"class":654},[640,1687,1688],{"class":650},"!.",[640,1690,1003],{"class":654},[640,1692,810],{"class":650},[640,1694,1695,1698,1700,1703,1706,1708,1710,1712,1714,1716,1719,1721],{"class":642,"line":831},[640,1696,1697],{"class":760},"    timestamp",[640,1699,764],{"class":650},[640,1701,1702],{"class":650}," new",[640,1704,1705],{"class":722}," Date",[640,1707,726],{"class":760},[640,1709,1624],{"class":654},[640,1711,714],{"class":650},[640,1713,1681],{"class":654},[640,1715,714],{"class":650},[640,1717,1718],{"class":654},"timestamp",[640,1720,787],{"class":760},[640,1722,810],{"class":650},[640,1724,1726,1729,1731,1733,1735,1737],{"class":642,"line":1725},8,[640,1727,1728],{"class":760},"    payload",[640,1730,764],{"class":650},[640,1732,1676],{"class":654},[640,1734,714],{"class":650},[640,1736,1681],{"class":654},[640,1738,810],{"class":650},[640,1740,1742,1745,1747,1749,1752],{"class":642,"line":1741},9,[640,1743,1744],{"class":650},"  }",[640,1746,787],{"class":760},[640,1748,714],{"class":650},[640,1750,1751],{"class":722},"onConflictDoNothing",[640,1753,1754],{"class":760},"()\n",[640,1756,1758],{"class":642,"line":1757},10,[640,1759,1760],{"class":650},"}\n",[640,1762,1764],{"class":642,"line":1763},11,[640,1765,705],{"emptyLinePlaceholder":704},[640,1767,1769,1771,1773,1775,1777,1779,1781,1783,1785,1787,1789,1791,1794,1796,1798,1800,1802,1804,1806],{"class":642,"line":1768},12,[640,1770,711],{"class":654},[640,1772,714],{"class":650},[640,1774,717],{"class":654},[640,1776,714],{"class":650},[640,1778,723],{"class":722},[640,1780,726],{"class":654},[640,1782,729],{"class":650},[640,1784,732],{"class":673},[640,1786,729],{"class":650},[640,1788,658],{"class":650},[640,1790,655],{"class":722},[640,1792,1793],{"class":654},"(postgresAudit",[640,1795,658],{"class":650},[640,1797,651],{"class":650},[640,1799,819],{"class":760},[640,1801,764],{"class":650},[640,1803,825],{"class":824},[640,1805,664],{"class":650},[640,1807,834],{"class":654},[630,1809,1814],{"className":1810,"code":1811,"filename":1812,"language":1813,"meta":636,"style":636},"language-sql shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","SELECT id, timestamp, payload->'audit'->>'action' AS action,\n       payload->'audit'->>'outcome' AS outcome\nFROM audit_events\nWHERE id = 'ak_8f3c4b2a1e5d6f7c';\n\n--          id          |       timestamp       |     action      | outcome\n-- ---------------------+-----------------------+-----------------+---------\n--  ak_8f3c4b2a1e5d6f7c | 2026-04-24 10:23:45.6 | invoice.refund  | success\n","Output — audit_events row","sql",[609,1815,1816,1855,1881,1889,1908,1912,1918,1923],{"__ignoreMap":636},[640,1817,1818,1821,1824,1826,1829,1832,1834,1836,1838,1841,1843,1845,1847,1850,1853],{"class":642,"line":643},[640,1819,1820],{"class":781},"SELECT",[640,1822,1823],{"class":654}," id, ",[640,1825,1718],{"class":852},[640,1827,1828],{"class":654},", payload",[640,1830,1831],{"class":650},"->",[640,1833,729],{"class":650},[640,1835,853],{"class":673},[640,1837,729],{"class":650},[640,1839,1840],{"class":650},"->>",[640,1842,729],{"class":650},[640,1844,864],{"class":673},[640,1846,729],{"class":650},[640,1848,1849],{"class":781}," AS",[640,1851,1852],{"class":781}," action",[640,1854,810],{"class":654},[640,1856,1857,1860,1862,1864,1866,1868,1870,1872,1874,1876,1878],{"class":642,"line":680},[640,1858,1859],{"class":654},"       payload",[640,1861,1831],{"class":650},[640,1863,729],{"class":650},[640,1865,853],{"class":673},[640,1867,729],{"class":650},[640,1869,1840],{"class":650},[640,1871,729],{"class":650},[640,1873,971],{"class":673},[640,1875,729],{"class":650},[640,1877,1849],{"class":781},[640,1879,1880],{"class":654}," outcome\n",[640,1882,1883,1886],{"class":642,"line":701},[640,1884,1885],{"class":781},"FROM",[640,1887,1888],{"class":654}," audit_events\n",[640,1890,1891,1894,1897,1899,1901,1903,1905],{"class":642,"line":708},[640,1892,1893],{"class":781},"WHERE",[640,1895,1896],{"class":654}," id ",[640,1898,1614],{"class":650},[640,1900,670],{"class":650},[640,1902,1012],{"class":673},[640,1904,729],{"class":650},[640,1906,1907],{"class":654},";\n",[640,1909,1910],{"class":642,"line":744},[640,1911,705],{"emptyLinePlaceholder":704},[640,1913,1914],{"class":642,"line":813},[640,1915,1917],{"class":1916},"sHwdD","--          id          |       timestamp       |     action      | outcome\n",[640,1919,1920],{"class":642,"line":831},[640,1921,1922],{"class":1916},"-- ---------------------+-----------------------+-----------------+---------\n",[640,1924,1925],{"class":642,"line":1725},[640,1926,1927],{"class":1916},"--  ak_8f3c4b2a1e5d6f7c | 2026-04-24 10:23:45.6 | invoice.refund  | success\n",[605,1929,1930,1931,1933,1934,1937],{},"The deterministic ",[609,1932,1003],{}," makes retries safe: duplicate inserts collapse via ",[609,1935,1936],{},"ON CONFLICT DO NOTHING",". Without it, a transient network blip during a retry would create a duplicate audit row, which is exactly what you don't want.",[622,1939,1941],{"id":1940},"test-what-you-recorded","Test what you recorded",[605,1943,1944,1947,1948,612,1951,1954,1955,764],{},[609,1945,1946],{},"mockAudit()"," captures every audit event on emit, from standalone ",[609,1949,1950],{},"audit()",[609,1952,1953],{},"log.audit()",", and ",[609,1956,1957],{},"log.set({ audit })",[630,1959,1961],{"className":632,"code":1960,"language":635,"meta":636,"style":636},"import { mockAudit } from 'evlog'\n\nit('refunds the invoice and records an audit', async () => {\n  const captured = mockAudit()\n\n  await refundInvoice({ id: 'inv_889' }, { actor: { type: 'user', id: 'u1' } })\n\n  captured.assertAudit({\n    action: 'invoice.refund',\n    target: { type: 'invoice', id: 'inv_889' },\n    outcome: 'success',\n  })\n\n  captured.restore()\n})\n",[609,1962,1963,1982,1986,2011,2026,2030,2093,2097,2111,2126,2159,2174,2180,2185,2197],{"__ignoreMap":636},[640,1964,1965,1967,1969,1972,1974,1976,1978,1980],{"class":642,"line":643},[640,1966,647],{"class":646},[640,1968,651],{"class":650},[640,1970,1971],{"class":654}," mockAudit",[640,1973,664],{"class":650},[640,1975,667],{"class":646},[640,1977,670],{"class":650},[640,1979,674],{"class":673},[640,1981,677],{"class":650},[640,1983,1984],{"class":642,"line":680},[640,1985,705],{"emptyLinePlaceholder":704},[640,1987,1988,1991,1993,1995,1998,2000,2002,2004,2007,2009],{"class":642,"line":701},[640,1989,1990],{"class":722},"it",[640,1992,726],{"class":654},[640,1994,729],{"class":650},[640,1996,1997],{"class":673},"refunds the invoice and records an audit",[640,1999,729],{"class":650},[640,2001,658],{"class":650},[640,2003,1617],{"class":852},[640,2005,2006],{"class":650}," ()",[640,2008,1633],{"class":852},[640,2010,1636],{"class":650},[640,2012,2013,2016,2019,2022,2024],{"class":642,"line":708},[640,2014,2015],{"class":852},"  const",[640,2017,2018],{"class":654}," captured",[640,2020,2021],{"class":650}," =",[640,2023,1971],{"class":722},[640,2025,1754],{"class":760},[640,2027,2028],{"class":642,"line":744},[640,2029,705],{"emptyLinePlaceholder":704},[640,2031,2032,2034,2037,2039,2041,2044,2046,2048,2050,2052,2055,2057,2060,2062,2064,2066,2068,2070,2072,2074,2076,2078,2080,2082,2085,2087,2089,2091],{"class":642,"line":813},[640,2033,1641],{"class":646},[640,2035,2036],{"class":722}," refundInvoice",[640,2038,726],{"class":760},[640,2040,757],{"class":650},[640,2042,2043],{"class":760}," id",[640,2045,764],{"class":650},[640,2047,670],{"class":650},[640,2049,962],{"class":673},[640,2051,729],{"class":650},[640,2053,2054],{"class":650}," },",[640,2056,651],{"class":650},[640,2058,2059],{"class":760}," actor",[640,2061,764],{"class":650},[640,2063,651],{"class":650},[640,2065,1584],{"class":760},[640,2067,764],{"class":650},[640,2069,670],{"class":650},[640,2071,900],{"class":673},[640,2073,729],{"class":650},[640,2075,658],{"class":650},[640,2077,2043],{"class":760},[640,2079,764],{"class":650},[640,2081,670],{"class":650},[640,2083,2084],{"class":673},"u1",[640,2086,729],{"class":650},[640,2088,664],{"class":650},[640,2090,664],{"class":650},[640,2092,1483],{"class":760},[640,2094,2095],{"class":642,"line":831},[640,2096,705],{"emptyLinePlaceholder":704},[640,2098,2099,2102,2104,2107,2109],{"class":642,"line":1725},[640,2100,2101],{"class":654},"  captured",[640,2103,714],{"class":650},[640,2105,2106],{"class":722},"assertAudit",[640,2108,726],{"class":760},[640,2110,1666],{"class":650},[640,2112,2113,2116,2118,2120,2122,2124],{"class":642,"line":1741},[640,2114,2115],{"class":760},"    action",[640,2117,764],{"class":650},[640,2119,670],{"class":650},[640,2121,873],{"class":673},[640,2123,729],{"class":650},[640,2125,810],{"class":650},[640,2127,2128,2131,2133,2135,2137,2139,2141,2143,2145,2147,2149,2151,2153,2155,2157],{"class":642,"line":1757},[640,2129,2130],{"class":760},"    target",[640,2132,764],{"class":650},[640,2134,651],{"class":650},[640,2136,1584],{"class":760},[640,2138,764],{"class":650},[640,2140,670],{"class":650},[640,2142,945],{"class":673},[640,2144,729],{"class":650},[640,2146,658],{"class":650},[640,2148,2043],{"class":760},[640,2150,764],{"class":650},[640,2152,670],{"class":650},[640,2154,962],{"class":673},[640,2156,729],{"class":650},[640,2158,828],{"class":650},[640,2160,2161,2164,2166,2168,2170,2172],{"class":642,"line":1763},[640,2162,2163],{"class":760},"    outcome",[640,2165,764],{"class":650},[640,2167,670],{"class":650},[640,2169,980],{"class":673},[640,2171,729],{"class":650},[640,2173,810],{"class":650},[640,2175,2176,2178],{"class":642,"line":1768},[640,2177,1744],{"class":650},[640,2179,1483],{"class":760},[640,2181,2183],{"class":642,"line":2182},13,[640,2184,705],{"emptyLinePlaceholder":704},[640,2186,2188,2190,2192,2195],{"class":642,"line":2187},14,[640,2189,2101],{"class":654},[640,2191,714],{"class":650},[640,2193,2194],{"class":722},"restore",[640,2196,1754],{"class":760},[640,2198,2200,2202],{"class":642,"line":2199},15,[640,2201,1407],{"class":650},[640,2203,1483],{"class":654},[605,2205,2206,2207,2210,2211,2214,2215,714],{},"Prefer ",[609,2208,2209],{},"assertAudit()"," when a missing audit should fail the test with a readable message. Use ",[609,2212,2213],{},"toIncludeAuditOf()"," when you need a boolean inside ",[609,2216,2217],{},"expect(...)",[605,2219,2220,2221,2224,2225,2228],{},"Always call ",[609,2222,2223],{},"captured.restore()"," in an ",[609,2226,2227],{},"afterEach"," (or wrap with a fixture) so a failing assertion never leaks into the next test.",[622,2230,2232],{"id":2231},"every-audit-export","Every audit export",[2234,2235,2236,2252],"table",{},[2237,2238,2239],"thead",{},[2240,2241,2242,2246,2249],"tr",{},[2243,2244,2245],"th",{},"Symbol",[2243,2247,2248],{},"Kind",[2243,2250,2251],{},"Notes",[2253,2254,2255,2268,2281,2293,2309,2321,2334,2347,2363,2380,2393,2408,2420],"tbody",{},[2240,2256,2257,2263,2265],{},[2258,2259,2260],"td",{},[609,2261,2262],{},"AuditFields",[2258,2264,891],{},[2258,2266,2267],{},"Reserved field on the wide event",[2240,2269,2270,2275,2278],{},[2258,2271,2272],{},[609,2273,2274],{},"defineAuditAction(name, opts?)",[2258,2276,2277],{},"factory",[2258,2279,2280],{},"Typed action registry, infers target shape",[2240,2282,2283,2288,2290],{},[2258,2284,2285],{},[609,2286,2287],{},"defineAuditCatalog(prefix, map)",[2258,2289,2277],{},[2258,2291,2292],{},"Bundle of typed audit actions sharing a prefix",[2240,2294,2295,2300,2303],{},[2258,2296,2297],{},[609,2298,2299],{},"log.audit(fields)",[2258,2301,2302],{},"method",[2258,2304,2305,2306,2308],{},"Sugar over ",[609,2307,1957],{}," + force-keep",[2240,2310,2311,2316,2318],{},[2258,2312,2313],{},[609,2314,2315],{},"log.audit.deny(reason, fields)",[2258,2317,2302],{},[2258,2319,2320],{},"Records a denied action",[2240,2322,2323,2328,2331],{},[2258,2324,2325],{},[609,2326,2327],{},"audit(fields)",[2258,2329,2330],{},"function",[2258,2332,2333],{},"Standalone for scripts \u002F jobs",[2240,2335,2336,2341,2344],{},[2258,2337,2338],{},[609,2339,2340],{},"withAudit({ action, target })(fn)",[2258,2342,2343],{},"wrapper",[2258,2345,2346],{},"Auto-emit success \u002F failure \u002F denied",[2240,2348,2349,2354,2357],{},[2258,2350,2351],{},[609,2352,2353],{},"auditDiff(before, after)",[2258,2355,2356],{},"helper",[2258,2358,2359,2360],{},"Redact-aware JSON Patch for ",[609,2361,2362],{},"changes",[2240,2364,2365,2369,2372],{},[2258,2366,2367],{},[609,2368,1946],{},[2258,2370,2371],{},"test util",[2258,2373,2374,2375,2377,2378],{},"Capture audits on emit; ",[609,2376,2209],{}," or ",[609,2379,2213],{},[2240,2381,2382,2387,2390],{},[2258,2383,2384],{},[609,2385,2386],{},"auditEnricher(opts?)",[2258,2388,2389],{},"enricher",[2258,2391,2392],{},"Auto-fill request \u002F runtime \u002F tenant context",[2240,2394,2395,2400,2402],{},[2258,2396,2397],{},[609,2398,2399],{},"auditOnly(drain, { await? })",[2258,2401,2343],{},[2258,2403,2404,2405,2407],{},"Routes only events with an ",[609,2406,853],{}," field",[2240,2409,2410,2415,2417],{},[2258,2411,2412],{},[609,2413,2414],{},"signed(drain, opts)",[2258,2416,2343],{},[2258,2418,2419],{},"Generic integrity wrapper (hmac \u002F hash-chain)",[2240,2421,2422,2427,2430],{},[2258,2423,2424],{},[609,2425,2426],{},"auditRedactPreset",[2258,2428,2429],{},"config",[2258,2431,2432],{},"Strict PII for audit events",[605,2434,2435,2436,2438],{},"Everything ships from the main ",[609,2437,674],{}," entrypoint.",[2440,2441,2442],"style",{},"html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .sfNiH, html code.shiki .sfNiH{--shiki-light:#FF5370;--shiki-default:#FF9CAC;--shiki-dark:#FF9CAC}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sHdIc, html code.shiki .sHdIc{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}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}",{"title":636,"searchDepth":680,"depth":680,"links":2444},[2445,2446,2447,2448,2449],{"id":624,"depth":680,"text":625},{"id":1245,"depth":680,"text":1246},{"id":1551,"depth":680,"text":1552},{"id":1940,"depth":680,"text":1941},{"id":2231,"depth":680,"text":2232},"File system, Axiom, and Postgres recipes for audit logs, plus mockAudit for tests and the full API reference.","md",[2453,2456],{"label":411,"icon":388,"to":412,"color":2454,"variant":2455},"neutral","subtle",{"label":148,"icon":146,"to":153,"color":2454,"variant":2455},{},{"title":415,"icon":84},{"title":600,"description":2450},"_5RK4jKMdGZrkk5XjLN6rkbGLur3OTXTtCRkWokVX7w",[2462,2464],{"title":411,"path":412,"stem":413,"description":2463,"icon":388,"children":-1},"Integrity, redact presets, GDPR vs append-only, retention windows, and the most common pitfalls when shipping audit logs to production.",{"title":41,"path":423,"stem":424,"description":2465,"icon":44,"children":-1},"One event per run for CLIs and automation, with privacy-safe flags, consent, an outbox, and disclosure generated from the same config.",1789076909061]