[{"data":1,"prerenderedAt":1236},["ShallowReactive",2],{"navigation_docs":3,"-build-on-top-sinks-custom-drains":547,"-build-on-top-sinks-custom-drains-surround":1231},[4,35,159,201,289,446,531],{"title":5,"path":6,"stem":7,"children":8,"page":34},"Getting Started","\u002Fgetting-started","1.getting-started",[9,14,19,24,29],{"title":10,"path":11,"stem":12,"icon":13},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F1.introduction","i-lucide-info",{"title":15,"path":16,"stem":17,"icon":18},"Installation","\u002Fgetting-started\u002Finstallation","1.getting-started\u002F2.installation","i-lucide-download",{"title":20,"path":21,"stem":22,"icon":23},"Quick Start","\u002Fgetting-started\u002Fquick-start","1.getting-started\u002F3.quick-start","i-lucide-zap",{"title":25,"path":26,"stem":27,"icon":28},"Agent Skills","\u002Fgetting-started\u002Fagent-skills","1.getting-started\u002F4.agent-skills","i-lucide-sparkles",{"title":30,"path":31,"stem":32,"icon":33},"vs Other Loggers","\u002Fgetting-started\u002Fvs-other-loggers","1.getting-started\u002F5.vs-other-loggers","i-lucide-scale",false,{"title":36,"path":37,"stem":38,"children":39,"page":34},"Logging","\u002Flogging","2.logging",[40,45,50,55,60,65,70,99,127],{"title":41,"path":42,"stem":43,"icon":44},"Overview","\u002Flogging\u002Foverview","2.logging\u002F0.overview","i-lucide-list",{"title":46,"path":47,"stem":48,"icon":49},"Simple Logging","\u002Flogging\u002Fsimple-logging","2.logging\u002F1.simple-logging","i-lucide-terminal",{"title":51,"path":52,"stem":53,"icon":54},"Wide Events","\u002Flogging\u002Fwide-events","2.logging\u002F2.wide-events","i-lucide-layers",{"title":56,"path":57,"stem":58,"icon":59},"Structured Errors","\u002Flogging\u002Fstructured-errors","2.logging\u002F3.structured-errors","i-lucide-shield-alert",{"title":61,"path":62,"stem":63,"icon":64},"Catalogs","\u002Flogging\u002Fcatalogs","2.logging\u002F4.catalogs","i-lucide-book-open",{"title":66,"path":67,"stem":68,"icon":69},"Client Logging","\u002Flogging\u002Fclient-logging","2.logging\u002F5.client-logging","i-lucide-monitor",{"title":71,"icon":72,"path":73,"stem":74,"children":75,"page":34},"AI SDK","i-simple-icons-vercel","\u002Flogging\u002Fai-sdk","2.logging\u002F6.ai-sdk",[76,79,84,89,94],{"title":41,"path":77,"stem":78,"icon":44},"\u002Flogging\u002Fai-sdk\u002Foverview","2.logging\u002F6.ai-sdk\u002F01.overview",{"title":80,"path":81,"stem":82,"icon":83},"Usage","\u002Flogging\u002Fai-sdk\u002Fusage","2.logging\u002F6.ai-sdk\u002F02.usage","i-lucide-code",{"title":85,"path":86,"stem":87,"icon":88},"Options","\u002Flogging\u002Fai-sdk\u002Foptions","2.logging\u002F6.ai-sdk\u002F03.options","i-lucide-sliders",{"title":90,"path":91,"stem":92,"icon":93},"Metadata","\u002Flogging\u002Fai-sdk\u002Fmetadata","2.logging\u002F6.ai-sdk\u002F04.metadata","i-lucide-database",{"title":95,"path":96,"stem":97,"icon":98},"Telemetry","\u002Flogging\u002Fai-sdk\u002Ftelemetry","2.logging\u002F6.ai-sdk\u002F05.telemetry","i-lucide-activity",{"title":100,"icon":101,"path":102,"stem":103,"children":104,"page":34},"Better Auth","i-simple-icons-betterauth","\u002Flogging\u002Fbetter-auth","2.logging\u002F7.better-auth",[105,108,113,118,122],{"title":41,"path":106,"stem":107,"icon":44},"\u002Flogging\u002Fbetter-auth\u002Foverview","2.logging\u002F7.better-auth\u002F01.overview",{"title":109,"path":110,"stem":111,"icon":112},"Identify User","\u002Flogging\u002Fbetter-auth\u002Fidentify-user","2.logging\u002F7.better-auth\u002F02.identify-user","i-lucide-user-check",{"title":114,"path":115,"stem":116,"icon":117},"Middleware","\u002Flogging\u002Fbetter-auth\u002Fmiddleware","2.logging\u002F7.better-auth\u002F03.middleware","i-lucide-shield",{"title":119,"path":120,"stem":121,"icon":69},"Client Sync","\u002Flogging\u002Fbetter-auth\u002Fclient-sync","2.logging\u002F7.better-auth\u002F04.client-sync",{"title":123,"path":124,"stem":125,"icon":126},"Performance","\u002Flogging\u002Fbetter-auth\u002Fperformance","2.logging\u002F7.better-auth\u002F05.performance","i-lucide-gauge",{"title":128,"icon":129,"path":130,"stem":131,"children":132,"page":34},"Audit Logs","i-lucide-shield-check","\u002Flogging\u002Faudit","2.logging\u002F8.audit",[133,136,141,146,151,155],{"title":41,"path":134,"stem":135,"icon":44},"\u002Flogging\u002Faudit\u002Foverview","2.logging\u002F8.audit\u002F01.overview",{"title":137,"path":138,"stem":139,"icon":140},"Schema","\u002Flogging\u002Faudit\u002Fschema","2.logging\u002F8.audit\u002F02.schema","i-lucide-file-text",{"title":142,"path":143,"stem":144,"icon":145},"Recording","\u002Flogging\u002Faudit\u002Frecording","2.logging\u002F8.audit\u002F03.recording","i-lucide-pen-line",{"title":147,"path":148,"stem":149,"icon":150},"Drains","\u002Flogging\u002Faudit\u002Fpipeline","2.logging\u002F8.audit\u002F04.pipeline","i-lucide-link",{"title":152,"path":153,"stem":154,"icon":129},"Compliance","\u002Flogging\u002Faudit\u002Fcompliance","2.logging\u002F8.audit\u002F05.compliance",{"title":156,"path":157,"stem":158,"icon":64},"Recipes","\u002Flogging\u002Faudit\u002Frecipes","2.logging\u002F8.audit\u002F06.recipes",{"title":160,"path":161,"stem":162,"children":163,"page":34},"Core Concepts","\u002Fcore-concepts","3.core-concepts",[164,169,174,179,184,188,191,196],{"title":165,"path":166,"stem":167,"icon":168},"Lifecycle","\u002Fcore-concepts\u002Flifecycle","3.core-concepts\u002F0.lifecycle","i-lucide-arrow-right-left",{"title":170,"path":171,"stem":172,"icon":173},"Configuration","\u002Fcore-concepts\u002Fconfiguration","3.core-concepts\u002F1.configuration","i-lucide-settings",{"title":175,"path":176,"stem":177,"icon":178},"Sampling","\u002Fcore-concepts\u002Fsampling","3.core-concepts\u002F2.sampling","i-lucide-filter",{"title":180,"path":181,"stem":182,"icon":183},"Typed Fields","\u002Fcore-concepts\u002Ftyped-fields","3.core-concepts\u002F3.typed-fields","i-simple-icons-typescript",{"title":185,"path":186,"stem":187,"icon":129},"Best Practices","\u002Fcore-concepts\u002Fbest-practices","3.core-concepts\u002F4.best-practices",{"title":123,"path":189,"stem":190,"icon":126},"\u002Fcore-concepts\u002Fperformance","3.core-concepts\u002F5.performance",{"title":192,"path":193,"stem":194,"icon":195},"Vite Plugin","\u002Fcore-concepts\u002Fvite-plugin","3.core-concepts\u002F6.vite-plugin","i-custom-vite",{"title":197,"path":198,"stem":199,"icon":200},"Auto-Redaction","\u002Fcore-concepts\u002Fredaction","3.core-concepts\u002F7.redaction","i-lucide-eye-off",{"title":202,"path":203,"stem":204,"children":205,"page":34},"Frameworks","\u002Fframeworks","4.frameworks",[206,210,215,220,225,230,235,240,245,250,255,260,265,270,274,279,284],{"title":41,"path":207,"stem":208,"icon":209},"\u002Fframeworks\u002Foverview","4.frameworks\u002F00.overview","i-lucide-layout-grid",{"title":211,"path":212,"stem":213,"icon":214},"Nuxt","\u002Fframeworks\u002Fnuxt","4.frameworks\u002F01.nuxt","i-simple-icons-nuxtdotjs",{"title":216,"path":217,"stem":218,"icon":219},"Next.js","\u002Fframeworks\u002Fnextjs","4.frameworks\u002F02.nextjs","i-simple-icons-nextdotjs",{"title":221,"path":222,"stem":223,"icon":224},"SvelteKit","\u002Fframeworks\u002Fsveltekit","4.frameworks\u002F03.sveltekit","i-simple-icons-svelte",{"title":226,"path":227,"stem":228,"icon":229},"Nitro","\u002Fframeworks\u002Fnitro","4.frameworks\u002F04.nitro","i-custom-nitro",{"title":231,"path":232,"stem":233,"icon":234},"TanStack Start","\u002Fframeworks\u002Ftanstack-start","4.frameworks\u002F05.tanstack-start","i-custom-tanstack",{"title":236,"path":237,"stem":238,"icon":239},"NestJS","\u002Fframeworks\u002Fnestjs","4.frameworks\u002F06.nestjs","i-simple-icons-nestjs",{"title":241,"path":242,"stem":243,"icon":244},"Express","\u002Fframeworks\u002Fexpress","4.frameworks\u002F07.express","i-simple-icons-express",{"title":246,"path":247,"stem":248,"icon":249},"Hono","\u002Fframeworks\u002Fhono","4.frameworks\u002F08.hono","i-simple-icons-hono",{"title":251,"path":252,"stem":253,"icon":254},"Fastify","\u002Fframeworks\u002Ffastify","4.frameworks\u002F09.fastify","i-simple-icons-fastify",{"title":256,"path":257,"stem":258,"icon":259},"Elysia","\u002Fframeworks\u002Felysia","4.frameworks\u002F10.elysia","i-custom-elysia",{"title":261,"path":262,"stem":263,"icon":264},"React Router","\u002Fframeworks\u002Freact-router","4.frameworks\u002F11.react-router","i-custom-reactrouter",{"title":266,"path":267,"stem":268,"icon":269},"Cloudflare Workers","\u002Fframeworks\u002Fcloudflare-workers","4.frameworks\u002F12.cloudflare-workers","i-simple-icons-cloudflare",{"title":271,"path":272,"stem":273,"icon":183},"Standalone","\u002Fframeworks\u002Fstandalone","4.frameworks\u002F13.standalone",{"title":275,"path":276,"stem":277,"icon":278},"Astro","\u002Fframeworks\u002Fastro","4.frameworks\u002F14.astro","i-simple-icons-astro",{"title":280,"path":281,"stem":282,"icon":283},"AWS Lambda","\u002Fframeworks\u002Faws-lambda","4.frameworks\u002F16.aws-lambda","i-custom-lambda",{"title":285,"path":286,"stem":287,"icon":288},"Custom Integration","\u002Fframeworks\u002Fcustom-integration","4.frameworks\u002F17.custom-integration","i-lucide-puzzle",{"title":290,"path":291,"stem":292,"children":293,"page":34},"Build on top","\u002Fbuild-on-top","5.build-on-top",[294,297,325,346,373,400,428],{"title":41,"path":295,"stem":296,"icon":54},"\u002Fbuild-on-top\u002Foverview","5.build-on-top\u002F0.overview",{"title":298,"path":299,"stem":300,"children":301,"page":34},"Observers","\u002Fbuild-on-top\u002Fobservers","5.build-on-top\u002Fobservers",[302,306,311,316,321],{"title":41,"path":303,"stem":304,"icon":305},"\u002Fbuild-on-top\u002Fobservers\u002Foverview","5.build-on-top\u002Fobservers\u002F1.overview","i-lucide-eye",{"title":307,"path":308,"stem":309,"icon":310},"Stream API","\u002Fbuild-on-top\u002Fobservers\u002Fin-process-stream","5.build-on-top\u002Fobservers\u002F2.in-process-stream","i-lucide-radio-tower",{"title":312,"path":313,"stem":314,"icon":315},"Stream server","\u002Fbuild-on-top\u002Fobservers\u002Fstream-server","5.build-on-top\u002Fobservers\u002F3.stream-server","i-lucide-radio",{"title":317,"path":318,"stem":319,"icon":320},"FS reader","\u002Fbuild-on-top\u002Fobservers\u002Ffs-reader","5.build-on-top\u002Fobservers\u002F4.fs-reader","i-lucide-folder-search",{"title":156,"path":322,"stem":323,"icon":324},"\u002Fbuild-on-top\u002Fobservers\u002Fconsumer-recipes","5.build-on-top\u002Fobservers\u002F5.consumer-recipes","i-lucide-chef-hat",{"title":326,"path":327,"stem":328,"children":329,"page":34},"Pipeline","\u002Fbuild-on-top\u002Fpipeline","5.build-on-top\u002Fpipeline",[330,334,338,342],{"title":41,"path":331,"stem":332,"icon":333},"\u002Fbuild-on-top\u002Fpipeline\u002Foverview","5.build-on-top\u002Fpipeline\u002F1.overview","i-lucide-workflow",{"title":335,"path":336,"stem":337,"icon":288},"Plugins","\u002Fbuild-on-top\u002Fpipeline\u002Fplugins","5.build-on-top\u002Fpipeline\u002F2.plugins",{"title":339,"path":340,"stem":341,"icon":28},"Custom enrichers","\u002Fbuild-on-top\u002Fpipeline\u002Fcustom-enrichers","5.build-on-top\u002Fpipeline\u002F3.custom-enrichers",{"title":343,"path":344,"stem":345,"icon":178},"Tail sampling","\u002Fbuild-on-top\u002Fpipeline\u002Ftail-sampling","5.build-on-top\u002Fpipeline\u002F4.tail-sampling",{"title":347,"path":348,"stem":349,"children":350,"page":34},"Scenarios","\u002Fbuild-on-top\u002Fscenarios","5.build-on-top\u002Fscenarios",[351,355,359,364,368],{"title":41,"path":352,"stem":353,"icon":354},"\u002Fbuild-on-top\u002Fscenarios\u002Foverview","5.build-on-top\u002Fscenarios\u002F0.overview","i-lucide-clipboard-list",{"title":356,"path":357,"stem":358,"icon":49},"Local debugging toolkit","\u002Fbuild-on-top\u002Fscenarios\u002Flocal-debugging-toolkit","5.build-on-top\u002Fscenarios\u002F1.local-debugging-toolkit",{"title":360,"path":361,"stem":362,"icon":363},"Tenant-aware logging","\u002Fbuild-on-top\u002Fscenarios\u002Ftenant-aware-logging","5.build-on-top\u002Fscenarios\u002F2.tenant-aware-logging","i-lucide-users",{"title":365,"path":366,"stem":367,"icon":129},"Compliance audit","\u002Fbuild-on-top\u002Fscenarios\u002Fcompliance-audit","5.build-on-top\u002Fscenarios\u002F3.compliance-audit",{"title":369,"path":370,"stem":371,"icon":372},"Cross-app error vocab","\u002Fbuild-on-top\u002Fscenarios\u002Fcross-app-error-vocab","5.build-on-top\u002Fscenarios\u002F4.cross-app-error-vocab","i-lucide-book",{"title":374,"path":375,"stem":376,"children":377,"page":34},"Shared packages","\u002Fbuild-on-top\u002Fshared","5.build-on-top\u002Fshared",[378,382,386,391,395],{"title":41,"path":379,"stem":380,"icon":381},"\u002Fbuild-on-top\u002Fshared\u002Foverview","5.build-on-top\u002Fshared\u002F1.overview","i-lucide-package",{"title":383,"path":384,"stem":385,"icon":381},"Catalogs as packages","\u002Fbuild-on-top\u002Fshared\u002Fcatalogs-as-packages","5.build-on-top\u002Fshared\u002F2.catalogs-as-packages",{"title":387,"path":388,"stem":389,"icon":390},"Drains as packages","\u002Fbuild-on-top\u002Fshared\u002Fdrains-as-packages","5.build-on-top\u002Fshared\u002F3.drains-as-packages","i-lucide-package-2",{"title":392,"path":393,"stem":394,"icon":28},"Enrichers as packages","\u002Fbuild-on-top\u002Fshared\u002Fenrichers-as-packages","5.build-on-top\u002Fshared\u002F4.enrichers-as-packages",{"title":396,"path":397,"stem":398,"icon":399},"Integration as package","\u002Fbuild-on-top\u002Fshared\u002Fintegration-as-package","5.build-on-top\u002Fshared\u002F5.integration-as-package","i-lucide-package-check",{"title":401,"path":402,"stem":403,"children":404,"page":34},"Sinks","\u002Fbuild-on-top\u002Fsinks","5.build-on-top\u002Fsinks",[405,409,414,418,423],{"title":41,"path":406,"stem":407,"icon":408},"\u002Fbuild-on-top\u002Fsinks\u002Foverview","5.build-on-top\u002Fsinks\u002F1.overview","i-lucide-arrow-up-from-line",{"title":410,"path":411,"stem":412,"icon":413},"Custom drains","\u002Fbuild-on-top\u002Fsinks\u002Fcustom-drains","5.build-on-top\u002Fsinks\u002F2.custom-drains","i-lucide-code-2",{"title":415,"path":416,"stem":417,"icon":333},"Drain pipeline","\u002Fbuild-on-top\u002Fsinks\u002Fdrain-pipeline","5.build-on-top\u002Fsinks\u002F3.drain-pipeline",{"title":419,"path":420,"stem":421,"icon":422},"Identity headers","\u002Fbuild-on-top\u002Fsinks\u002Fidentity-headers","5.build-on-top\u002Fsinks\u002F4.identity-headers","i-lucide-fingerprint",{"title":424,"path":425,"stem":426,"icon":427},"Fanout","\u002Fbuild-on-top\u002Fsinks\u002Ffanout-and-multi-drain","5.build-on-top\u002Fsinks\u002F5.fanout-and-multi-drain","i-lucide-share-2",{"title":429,"path":430,"stem":431,"children":432,"page":34},"Sources","\u002Fbuild-on-top\u002Fsources","5.build-on-top\u002Fsources",[433,437,441],{"title":41,"path":434,"stem":435,"icon":436},"\u002Fbuild-on-top\u002Fsources\u002Foverview","5.build-on-top\u002Fsources\u002F1.overview","i-lucide-arrow-down-to-line",{"title":438,"path":439,"stem":440,"icon":288},"Custom framework","\u002Fbuild-on-top\u002Fsources\u002Fcustom-framework","5.build-on-top\u002Fsources\u002F2.custom-framework",{"title":442,"path":443,"stem":444,"icon":445},"Middleware toolkit","\u002Fbuild-on-top\u002Fsources\u002Fmiddleware-toolkit","5.build-on-top\u002Fsources\u002F3.middleware-toolkit","i-lucide-wrench",{"title":447,"path":448,"stem":449,"children":450,"page":34},"Adapters","\u002Fadapters","6.adapters",[451,454,494,509],{"title":41,"path":452,"stem":453,"icon":44},"\u002Fadapters\u002Foverview","6.adapters\u002F01.overview",{"title":455,"path":456,"stem":457,"children":458,"page":34},"Cloud destinations","\u002Fadapters\u002Fcloud","6.adapters\u002F02.cloud",[459,464,469,474,479,484,489],{"title":460,"path":461,"stem":462,"icon":463},"Axiom","\u002Fadapters\u002Fcloud\u002Faxiom","6.adapters\u002F02.cloud\u002F01.axiom","i-custom-axiom",{"title":465,"path":466,"stem":467,"icon":468},"OTLP","\u002Fadapters\u002Fcloud\u002Fotlp","6.adapters\u002F02.cloud\u002F02.otlp","i-simple-icons-opentelemetry",{"title":470,"path":471,"stem":472,"icon":473},"PostHog","\u002Fadapters\u002Fcloud\u002Fposthog","6.adapters\u002F02.cloud\u002F03.posthog","i-simple-icons-posthog",{"title":475,"path":476,"stem":477,"icon":478},"Sentry","\u002Fadapters\u002Fcloud\u002Fsentry","6.adapters\u002F02.cloud\u002F04.sentry","i-simple-icons-sentry",{"title":480,"path":481,"stem":482,"icon":483},"Better Stack","\u002Fadapters\u002Fcloud\u002Fbetter-stack","6.adapters\u002F02.cloud\u002F05.better-stack","i-simple-icons-betterstack",{"title":485,"path":486,"stem":487,"icon":488},"Datadog","\u002Fadapters\u002Fcloud\u002Fdatadog","6.adapters\u002F02.cloud\u002F06.datadog","i-simple-icons-datadog",{"title":490,"path":491,"stem":492,"icon":493},"HyperDX","\u002Fadapters\u002Fcloud\u002Fhyperdx","6.adapters\u002F02.cloud\u002F07.hyperdx","i-custom-hyperdx",{"title":495,"path":496,"stem":497,"children":498,"page":34},"Self-hosted","\u002Fadapters\u002Fself-hosted","6.adapters\u002F03.self-hosted",[499,504],{"title":500,"path":501,"stem":502,"icon":503},"File System","\u002Fadapters\u002Fself-hosted\u002Ffs","6.adapters\u002F03.self-hosted\u002F01.fs","i-lucide-hard-drive",{"title":505,"path":506,"stem":507,"icon":508},"NuxtHub","\u002Fadapters\u002Fself-hosted\u002Fnuxthub","6.adapters\u002F03.self-hosted\u002F02.nuxthub","i-simple-icons-nuxt",{"title":510,"path":511,"stem":512,"children":513,"page":34},"Building blocks","\u002Fadapters\u002Fbuilding-blocks","6.adapters\u002F04.building-blocks",[514,517,522,526],{"title":326,"path":515,"stem":516,"icon":333},"\u002Fadapters\u002Fbuilding-blocks\u002Fpipeline","6.adapters\u002F04.building-blocks\u002F01.pipeline",{"title":518,"path":519,"stem":520,"icon":521},"HTTP","\u002Fadapters\u002Fbuilding-blocks\u002Fhttp","6.adapters\u002F04.building-blocks\u002F02.http","i-lucide-globe",{"title":523,"path":524,"stem":525,"icon":83},"Custom Adapters","\u002Fadapters\u002Fbuilding-blocks\u002Fcustom","6.adapters\u002F04.building-blocks\u002F03.custom",{"title":527,"path":528,"stem":529,"icon":530},"Toolkit","\u002Fadapters\u002Fbuilding-blocks\u002Ftoolkit","6.adapters\u002F04.building-blocks\u002F04.toolkit","i-lucide-blocks",{"title":532,"path":533,"stem":534,"children":535,"page":34},"Enrichers","\u002Fenrichers","7.enrichers",[536,539,543],{"title":41,"path":537,"stem":538,"icon":28},"\u002Fenrichers\u002Foverview","7.enrichers\u002F1.overview",{"title":540,"path":541,"stem":542,"icon":288},"Built-in","\u002Fenrichers\u002Fbuilt-in","7.enrichers\u002F2.built-in",{"title":544,"path":545,"stem":546,"icon":83},"Custom","\u002Fenrichers\u002Fcustom","7.enrichers\u002F3.custom",{"id":548,"title":410,"body":549,"description":1224,"extension":1225,"links":1226,"meta":1227,"navigation":1228,"path":411,"seo":1229,"stem":412,"__hash__":1230},"docs\u002F5.build-on-top\u002Fsinks\u002F2.custom-drains.md",{"type":550,"value":551,"toc":1219},"minimark",[552,566,571,578,605,612,616,1181,1191,1195,1215],[553,554,555,556,560,561,565],"p",{},"A ",[557,558,559],"strong",{},"drain"," is a function that receives wide events and ships them somewhere terminal: an HTTP API, a message queue, a database, a webhook. evlog ships built-in drains for popular providers (",[562,563,564],"a",{"href":452},"Adapters overview","). When you need a destination that isn't covered, write your own.",[567,568,570],"h2",{"id":569},"canonical-guide","Canonical guide",[553,572,573,574,577],{},"Full reference at ",[562,575,576],{"href":524},"Custom adapters",":",[579,580,581,589,595,602],"ul",{},[582,583,584,588],"li",{},[585,586,587],"code",{},"defineDrain()"," for arbitrary transports (queue, DB, native SDK)",[582,590,591,594],{},[585,592,593],{},"defineHttpDrain()"," for HTTP-based backends (auto timeouts + retries + identity headers)",[582,596,597,598,601],{},"Configuration resolution patterns (",[585,599,600],{},"runtimeConfig",", env vars, overrides)",[582,603,604],{},"Error handling and retries",[553,606,607,608,611],{},"This page exists in the ",[557,609,610],{},"build-on-top"," section as a pointer — same content, classified by axis.",[567,613,615],{"id":614},"a-5-minute-example-internal-loki-drain","A 5-minute example — internal Loki drain",[617,618,623],"pre",{"className":619,"code":620,"language":621,"meta":622,"style":622},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import { defineHttpDrain } from 'evlog\u002Ftoolkit'\n\nexport function createLokiDrain(overrides?: { url?: string; token?: string }) {\n  return defineHttpDrain\u003C{ url: string; token: string }>({\n    name: 'loki',\n    resolve: () => ({\n      url: overrides?.url ?? process.env.LOKI_URL!,\n      token: overrides?.token ?? process.env.LOKI_TOKEN!,\n    }),\n    encode: (events, config) => ({\n      url: `${config.url}\u002Floki\u002Fapi\u002Fv1\u002Fpush`,\n      headers: {\n        'Content-Type': 'application\u002Fjson',\n        Authorization: `Bearer ${config.token}`,\n      },\n      body: JSON.stringify({\n        streams: events.map(e => ({\n          stream: { service: e.service, level: e.level },\n          values: [[String(Date.parse(e.timestamp) * 1e6), JSON.stringify(e)]],\n        })),\n      }),\n    }),\n  })\n}\n","ts","",[585,624,625,658,665,717,750,769,788,825,855,866,893,921,931,953,981,987,1007,1034,1074,1136,1147,1157,1166,1175],{"__ignoreMap":622},[626,627,630,634,638,642,645,648,651,655],"span",{"class":628,"line":629},"line",1,[626,631,633],{"class":632},"s7zQu","import",[626,635,637],{"class":636},"sMK4o"," {",[626,639,641],{"class":640},"sTEyZ"," defineHttpDrain",[626,643,644],{"class":636}," }",[626,646,647],{"class":632}," from",[626,649,650],{"class":636}," '",[626,652,654],{"class":653},"sfazB","evlog\u002Ftoolkit",[626,656,657],{"class":636},"'\n",[626,659,661],{"class":628,"line":660},2,[626,662,664],{"emptyLinePlaceholder":663},true,"\n",[626,666,668,671,675,679,682,686,689,691,695,697,701,704,707,709,711,714],{"class":628,"line":667},3,[626,669,670],{"class":632},"export",[626,672,674],{"class":673},"spNyl"," function",[626,676,678],{"class":677},"s2Zo4"," createLokiDrain",[626,680,681],{"class":636},"(",[626,683,685],{"class":684},"sHdIc","overrides",[626,687,688],{"class":636},"?:",[626,690,637],{"class":636},[626,692,694],{"class":693},"swJcz"," url",[626,696,688],{"class":636},[626,698,700],{"class":699},"sBMFI"," string",[626,702,703],{"class":636},";",[626,705,706],{"class":693}," token",[626,708,688],{"class":636},[626,710,700],{"class":699},[626,712,713],{"class":636}," })",[626,715,716],{"class":636}," {\n",[626,718,720,723,725,728,730,732,734,736,738,740,742,745,747],{"class":628,"line":719},4,[626,721,722],{"class":632},"  return",[626,724,641],{"class":677},[626,726,727],{"class":636},"\u003C{",[626,729,694],{"class":693},[626,731,577],{"class":636},[626,733,700],{"class":699},[626,735,703],{"class":636},[626,737,706],{"class":693},[626,739,577],{"class":636},[626,741,700],{"class":699},[626,743,744],{"class":636}," }>",[626,746,681],{"class":693},[626,748,749],{"class":636},"{\n",[626,751,753,756,758,760,763,766],{"class":628,"line":752},5,[626,754,755],{"class":693},"    name",[626,757,577],{"class":636},[626,759,650],{"class":636},[626,761,762],{"class":653},"loki",[626,764,765],{"class":636},"'",[626,767,768],{"class":636},",\n",[626,770,772,775,777,780,783,786],{"class":628,"line":771},6,[626,773,774],{"class":677},"    resolve",[626,776,577],{"class":636},[626,778,779],{"class":636}," ()",[626,781,782],{"class":673}," =>",[626,784,785],{"class":693}," (",[626,787,749],{"class":636},[626,789,791,794,796,799,802,805,808,811,814,817,819,822],{"class":628,"line":790},7,[626,792,793],{"class":693},"      url",[626,795,577],{"class":636},[626,797,798],{"class":640}," overrides",[626,800,801],{"class":636},"?.",[626,803,804],{"class":640},"url",[626,806,807],{"class":636}," ??",[626,809,810],{"class":640}," process",[626,812,813],{"class":636},".",[626,815,816],{"class":640},"env",[626,818,813],{"class":636},[626,820,821],{"class":640},"LOKI_URL",[626,823,824],{"class":636},"!,\n",[626,826,828,831,833,835,837,840,842,844,846,848,850,853],{"class":628,"line":827},8,[626,829,830],{"class":693},"      token",[626,832,577],{"class":636},[626,834,798],{"class":640},[626,836,801],{"class":636},[626,838,839],{"class":640},"token",[626,841,807],{"class":636},[626,843,810],{"class":640},[626,845,813],{"class":636},[626,847,816],{"class":640},[626,849,813],{"class":636},[626,851,852],{"class":640},"LOKI_TOKEN",[626,854,824],{"class":636},[626,856,858,861,864],{"class":628,"line":857},9,[626,859,860],{"class":636},"    }",[626,862,863],{"class":693},")",[626,865,768],{"class":636},[626,867,869,872,874,876,879,882,885,887,889,891],{"class":628,"line":868},10,[626,870,871],{"class":677},"    encode",[626,873,577],{"class":636},[626,875,785],{"class":636},[626,877,878],{"class":684},"events",[626,880,881],{"class":636},",",[626,883,884],{"class":684}," config",[626,886,863],{"class":636},[626,888,782],{"class":673},[626,890,785],{"class":693},[626,892,749],{"class":636},[626,894,896,898,900,903,906,908,910,913,916,919],{"class":628,"line":895},11,[626,897,793],{"class":693},[626,899,577],{"class":636},[626,901,902],{"class":636}," `${",[626,904,905],{"class":640},"config",[626,907,813],{"class":636},[626,909,804],{"class":640},[626,911,912],{"class":636},"}",[626,914,915],{"class":653},"\u002Floki\u002Fapi\u002Fv1\u002Fpush",[626,917,918],{"class":636},"`",[626,920,768],{"class":636},[626,922,924,927,929],{"class":628,"line":923},12,[626,925,926],{"class":693},"      headers",[626,928,577],{"class":636},[626,930,716],{"class":636},[626,932,934,937,940,942,944,946,949,951],{"class":628,"line":933},13,[626,935,936],{"class":636},"        '",[626,938,939],{"class":693},"Content-Type",[626,941,765],{"class":636},[626,943,577],{"class":636},[626,945,650],{"class":636},[626,947,948],{"class":653},"application\u002Fjson",[626,950,765],{"class":636},[626,952,768],{"class":636},[626,954,956,959,961,964,967,970,972,974,976,979],{"class":628,"line":955},14,[626,957,958],{"class":693},"        Authorization",[626,960,577],{"class":636},[626,962,963],{"class":636}," `",[626,965,966],{"class":653},"Bearer ",[626,968,969],{"class":636},"${",[626,971,905],{"class":640},[626,973,813],{"class":636},[626,975,839],{"class":640},[626,977,978],{"class":636},"}`",[626,980,768],{"class":636},[626,982,984],{"class":628,"line":983},15,[626,985,986],{"class":636},"      },\n",[626,988,990,993,995,998,1000,1003,1005],{"class":628,"line":989},16,[626,991,992],{"class":693},"      body",[626,994,577],{"class":636},[626,996,997],{"class":640}," JSON",[626,999,813],{"class":636},[626,1001,1002],{"class":677},"stringify",[626,1004,681],{"class":693},[626,1006,749],{"class":636},[626,1008,1010,1013,1015,1018,1020,1023,1025,1028,1030,1032],{"class":628,"line":1009},17,[626,1011,1012],{"class":693},"        streams",[626,1014,577],{"class":636},[626,1016,1017],{"class":640}," events",[626,1019,813],{"class":636},[626,1021,1022],{"class":677},"map",[626,1024,681],{"class":693},[626,1026,1027],{"class":684},"e",[626,1029,782],{"class":673},[626,1031,785],{"class":693},[626,1033,749],{"class":636},[626,1035,1037,1040,1042,1044,1047,1049,1052,1054,1057,1059,1062,1064,1066,1068,1071],{"class":628,"line":1036},18,[626,1038,1039],{"class":693},"          stream",[626,1041,577],{"class":636},[626,1043,637],{"class":636},[626,1045,1046],{"class":693}," service",[626,1048,577],{"class":636},[626,1050,1051],{"class":640}," e",[626,1053,813],{"class":636},[626,1055,1056],{"class":640},"service",[626,1058,881],{"class":636},[626,1060,1061],{"class":693}," level",[626,1063,577],{"class":636},[626,1065,1051],{"class":640},[626,1067,813],{"class":636},[626,1069,1070],{"class":640},"level",[626,1072,1073],{"class":636}," },\n",[626,1075,1077,1080,1082,1085,1088,1090,1093,1095,1098,1100,1102,1104,1107,1110,1113,1117,1119,1121,1123,1125,1127,1129,1131,1134],{"class":628,"line":1076},19,[626,1078,1079],{"class":693},"          values",[626,1081,577],{"class":636},[626,1083,1084],{"class":693}," [[",[626,1086,1087],{"class":677},"String",[626,1089,681],{"class":693},[626,1091,1092],{"class":640},"Date",[626,1094,813],{"class":636},[626,1096,1097],{"class":677},"parse",[626,1099,681],{"class":693},[626,1101,1027],{"class":640},[626,1103,813],{"class":636},[626,1105,1106],{"class":640},"timestamp",[626,1108,1109],{"class":693},") ",[626,1111,1112],{"class":636},"*",[626,1114,1116],{"class":1115},"sbssI"," 1e6",[626,1118,863],{"class":693},[626,1120,881],{"class":636},[626,1122,997],{"class":640},[626,1124,813],{"class":636},[626,1126,1002],{"class":677},[626,1128,681],{"class":693},[626,1130,1027],{"class":640},[626,1132,1133],{"class":693},")]]",[626,1135,768],{"class":636},[626,1137,1139,1142,1145],{"class":628,"line":1138},20,[626,1140,1141],{"class":636},"        }",[626,1143,1144],{"class":693},"))",[626,1146,768],{"class":636},[626,1148,1150,1153,1155],{"class":628,"line":1149},21,[626,1151,1152],{"class":636},"      }",[626,1154,863],{"class":693},[626,1156,768],{"class":636},[626,1158,1160,1162,1164],{"class":628,"line":1159},22,[626,1161,860],{"class":636},[626,1163,863],{"class":693},[626,1165,768],{"class":636},[626,1167,1169,1172],{"class":628,"line":1168},23,[626,1170,1171],{"class":636},"  }",[626,1173,1174],{"class":693},")\n",[626,1176,1178],{"class":628,"line":1177},24,[626,1179,1180],{"class":636},"}\n",[553,1182,1183,1186,1187,1190],{},[585,1184,1185],{},"defineHttpDrain"," handles abort timeouts, exponential backoff on ",[585,1188,1189],{},"5xx"," \u002F network errors, and automatic identity headers — you only describe how to encode events into the request.",[567,1192,1194],{"id":1193},"going-further","Going further",[579,1196,1197,1202,1207],{},[582,1198,1199,1201],{},[562,1200,415],{"href":416}," — wrap your drain in batch + retry + buffer overflow protection",[582,1203,1204,1206],{},[562,1205,419],{"href":420}," — what your drain advertises on every request",[582,1208,1209,1211,1212],{},[562,1210,387],{"href":388}," — publish your drain as ",[585,1213,1214],{},"@my-org\u002Fevlog-loki",[1216,1217,1218],"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 .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}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 .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":622,"searchDepth":660,"depth":660,"links":1220},[1221,1222,1223],{"id":569,"depth":660,"text":570},{"id":614,"depth":660,"text":615},{"id":1193,"depth":660,"text":1194},"defineDrain and defineHttpDrain — write your own drain to ship wide events to any backend without a built-in adapter.","md",null,{},{"title":410,"icon":413},{"title":410,"description":1224},"svoktrOg-Erc9gvW8rvA9Oud_ygR9pCazyMcjsuWFBM",[1232,1234],{"title":41,"path":406,"stem":407,"description":1233,"icon":408,"children":-1},"Sinks are where events leave evlog — built-in drain adapters, custom drains, the drain pipeline (batch + retry + fanout), and identity headers.",{"title":415,"path":416,"stem":417,"description":1235,"icon":333,"children":-1},"createDrainPipeline wraps any drain in batch + retry + buffer overflow protection. Required for non-trivial production volume; supports fanout to multiple drains in parallel.",1778338251274]