[{"data":1,"prerenderedAt":3668},["ShallowReactive",2],{"navigation_docs":3,"-extend-custom-drains":525,"-extend-custom-drains-surround":3663},[4,30,80,128,308,440,495],{"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,464,468,472,476,480,485,490],{"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":463},"FS reader","\u002Fextend\u002Ffs-reader","6.extend\u002F2.fs-reader","i-lucide-folder-search",{"title":406,"path":465,"stem":466,"icon":467},"\u002Fextend\u002Fconsumer-recipes","6.extend\u002F3.consumer-recipes","i-lucide-chef-hat",{"title":469,"path":470,"stem":471,"icon":448},"Plugins","\u002Fextend\u002Fplugins","6.extend\u002F4.plugins",{"title":473,"path":474,"stem":475,"icon":434},"Custom enrichers","\u002Fextend\u002Fcustom-enrichers","6.extend\u002F5.custom-enrichers",{"title":477,"path":478,"stem":479,"icon":64},"Tail sampling","\u002Fextend\u002Ftail-sampling","6.extend\u002F6.tail-sampling",{"title":481,"path":482,"stem":483,"icon":484},"Identity headers","\u002Fextend\u002Fidentity-headers","6.extend\u002F7.identity-headers","i-lucide-fingerprint",{"title":486,"path":487,"stem":488,"icon":489},"Custom drains","\u002Fextend\u002Fcustom-drains","6.extend\u002F8.custom-drains","i-lucide-share-2",{"title":491,"path":492,"stem":493,"icon":494},"Drain pipeline","\u002Fextend\u002Fdrain-pipeline","6.extend\u002F9.drain-pipeline","i-lucide-workflow",{"title":427,"path":496,"stem":497,"children":498,"page":29},"\u002Freference","7.reference",[499,504,507,512,516,521],{"title":500,"path":501,"stem":502,"icon":503},"Configuration","\u002Freference\u002Fconfiguration","7.reference\u002F1.configuration","i-lucide-settings",{"title":374,"path":505,"stem":506,"icon":107},"\u002Freference\u002Fperformance","7.reference\u002F2.performance",{"title":508,"path":509,"stem":510,"icon":511},"Vite Plugin","\u002Freference\u002Fvite-plugin","7.reference\u002F3.vite-plugin","i-custom-vite",{"title":513,"path":514,"stem":515,"icon":379},"Best Practices","\u002Freference\u002Fbest-practices","7.reference\u002F4.best-practices",{"title":517,"path":518,"stem":519,"icon":520},"vs Other Loggers","\u002Freference\u002Fvs-other-loggers","7.reference\u002F5.vs-other-loggers","i-lucide-scale",{"title":522,"path":523,"stem":524,"icon":434},"Agent Skills","\u002Freference\u002Fagent-skills","7.reference\u002F6.agent-skills",{"id":526,"title":527,"body":528,"description":3651,"extension":3652,"links":3653,"meta":3659,"navigation":3660,"path":487,"seo":3661,"stem":488,"__hash__":3662},"docs\u002F6.extend\u002F8.custom-drains.md","Custom Drains",{"type":529,"value":530,"toc":3634},"minimark",[531,545,548,599,606,727,734,747,1414,1428,1433,1436,1911,1915,1920,1961,1991,1995,2002,2437,2445,2449,2461,2817,2823,2829,3015,3032,3036,3046,3305,3322,3326,3331,3437,3440,3445,3486,3495,3499,3504,3546,3552,3556,3559,3567,3581,3593,3597,3630],[532,533,534,535,539,540,544],"p",{},"A ",[536,537,538],"strong",{},"drain"," is the terminal step of evlog's pipeline: a function that receives wide events and ships them somewhere — an HTTP API, a message queue, a database, a webhook, a local file. evlog ships built-in drains for popular providers (",[541,542,543],"a",{"href":143},"Adapters overview","). When you need a destination that isn't covered, you write your own.",[532,546,547],{},"Two factories cover every case:",[549,550,551,564],"table",{},[552,553,554],"thead",{},[555,556,557,561],"tr",{},[558,559,560],"th",{},"You have…",[558,562,563],{},"Use",[565,566,567,586],"tbody",{},[555,568,569,578],{},[570,571,572,573,577],"td",{},"An HTTP backend (REST, JSON ingest, vendor ",[574,575,576],"code",{},"\u002Fv1\u002Flogs"," endpoint)",[570,579,580],{},[541,581,583],{"href":582},"#definehttpdrain-the-http-recipe",[574,584,585],{},"defineHttpDrain",[555,587,588,591],{},[570,589,590],{},"A non-HTTP transport (gRPC, WebSocket, vendor SDK, queue, raw socket)",[570,592,593],{},[541,594,596],{"href":595},"#definedrain-non-http-transports",[574,597,598],{},"defineDrain",[532,600,601,602,605],{},"Both come from ",[574,603,604],{},"evlog\u002Ftoolkit"," and are the exact factories every built-in adapter uses.",[607,608,612,615,714],"prompt",{":actions":609,"description":610,"icon":611},"[\"copy\",\"cursor\",\"claude\"]","Build a custom evlog drain","i-lucide-code-2",[532,613,614],{},"Build a custom evlog drain that ships wide events to a backend without a built-in adapter.",[616,617,618,633,644,659,677,692,697,707],"ul",{},[619,620,621,622,625,626,628,629,632],"li",{},"For HTTP backends, use ",[574,623,624],{},"defineHttpDrain({ name, resolve, encode })"," from ",[574,627,604],{}," — never call ",[574,630,631],{},"fetch"," directly",[619,634,635,636,639,640,643],{},"For non-HTTP transports (queue, DB, native SDK, raw socket), use ",[574,637,638],{},"defineDrain({ name, send })"," and implement ",[574,641,642],{},"send(events)"," myself",[619,645,646,647,650,651,654,655,658],{},"Resolve config lazily inside ",[574,648,649],{},"resolve()"," via ",[574,652,653],{},"resolveAdapterConfig(namespace, fields, overrides)"," so users get the standard precedence (overrides → ",[574,656,657],{},"runtimeConfig.evlog.\u003Cns>"," → env)",[619,660,661,662,665,666,669,670,673,674],{},"Use the standardized field names: ",[574,663,664],{},"apiKey"," for bearer secrets, ",[574,667,668],{},"endpoint"," for the base URL, ",[574,671,672],{},"serviceName",", ",[574,675,676],{},"timeout",[619,678,679,680,683,684,687,688,691],{},"Encode batched events into the destination's wire format inside ",[574,681,682],{},"encode(events, config)"," — return ",[574,685,686],{},"{ url, headers, body }"," (or ",[574,689,690],{},"null"," to opt out of the batch)",[619,693,694,696],{},[574,695,585],{}," handles retries, timeouts, error isolation, batching, and identity headers — don't reimplement them",[619,698,699,700,703,704,706],{},"Wire the drain via ",[574,701,702],{},"defineEvlog({ drain: createMyDrain() })"," or my framework's middleware ",[574,705,538],{}," option",[619,708,709,710,713],{},"For production, wrap the result in ",[574,711,712],{},"createDrainPipeline"," for batching + retries",[532,715,716,717,722,723],{},"Docs: ",[541,718,719],{"href":719,"rel":720},"https:\u002F\u002Fwww.evlog.dev\u002Fextend\u002Fcustom-drains",[721],"nofollow","\nPipeline: ",[541,724,725],{"href":725,"rel":726},"https:\u002F\u002Fwww.evlog.dev\u002Fextend\u002Fdrain-pipeline",[721],[728,729,731,733],"h2",{"id":730},"definehttpdrain-the-http-recipe",[574,732,585],{}," (the HTTP recipe)",[532,735,736,737,739,740,742,743,746],{},"The recipe every built-in adapter follows. Two pure functions: ",[574,738,649],{}," returns the config (or ",[574,741,690],{}," to skip), ",[574,744,745],{},"encode()"," returns the HTTP request payload.",[748,749,750],"code-collapse",{},[751,752,758],"pre",{"className":753,"code":754,"filename":755,"language":756,"meta":757,"style":757},"language-typescript shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import {\n  defineHttpDrain,\n  resolveAdapterConfig,\n  type ConfigField,\n} from 'evlog\u002Ftoolkit'\n\ninterface MyServiceConfig {\n  apiKey: string\n  endpoint?: string\n  timeout?: number\n}\n\nconst FIELDS: ConfigField\u003CMyServiceConfig>[] = [\n  { key: 'apiKey', env: ['MYSERVICE_API_KEY'] },\n  { key: 'endpoint', env: ['MYSERVICE_ENDPOINT'] },\n  { key: 'timeout' },\n]\n\nexport function createMyServiceDrain(overrides?: Partial\u003CMyServiceConfig>) {\n  return defineHttpDrain\u003CMyServiceConfig>({\n    name: 'myservice',\n    resolve: async () => {\n      const cfg = await resolveAdapterConfig\u003CMyServiceConfig>('myservice', FIELDS, overrides)\n      if (!cfg.apiKey) {\n        console.error('[evlog\u002Fmyservice] Missing apiKey')\n        return null\n      }\n      return cfg as MyServiceConfig\n    },\n    encode: (events, cfg) => ({\n      url: `${cfg.endpoint ?? 'https:\u002F\u002Fapi.myservice.com'}\u002Fv1\u002Fingest`,\n      headers: {\n        'Content-Type': 'application\u002Fjson',\n        Authorization: `Bearer ${cfg.apiKey}`,\n      },\n      body: JSON.stringify(events),\n    }),\n  })\n}\n","lib\u002Fmy-drain.ts","typescript","",[574,759,760,773,783,791,802,820,827,840,853,864,875,881,886,917,959,993,1011,1017,1022,1056,1076,1093,1112,1156,1181,1203,1212,1218,1232,1238,1264,1301,1311,1333,1361,1367,1391,1401,1409],{"__ignoreMap":757},[761,762,765,769],"span",{"class":763,"line":764},"line",1,[761,766,768],{"class":767},"s7zQu","import",[761,770,772],{"class":771},"sMK4o"," {\n",[761,774,776,780],{"class":763,"line":775},2,[761,777,779],{"class":778},"sTEyZ","  defineHttpDrain",[761,781,782],{"class":771},",\n",[761,784,786,789],{"class":763,"line":785},3,[761,787,788],{"class":778},"  resolveAdapterConfig",[761,790,782],{"class":771},[761,792,794,797,800],{"class":763,"line":793},4,[761,795,796],{"class":767},"  type",[761,798,799],{"class":778}," ConfigField",[761,801,782],{"class":771},[761,803,805,808,811,814,817],{"class":763,"line":804},5,[761,806,807],{"class":771},"}",[761,809,810],{"class":767}," from",[761,812,813],{"class":771}," '",[761,815,604],{"class":816},"sfazB",[761,818,819],{"class":771},"'\n",[761,821,823],{"class":763,"line":822},6,[761,824,826],{"emptyLinePlaceholder":825},true,"\n",[761,828,830,834,838],{"class":763,"line":829},7,[761,831,833],{"class":832},"spNyl","interface",[761,835,837],{"class":836},"sBMFI"," MyServiceConfig",[761,839,772],{"class":771},[761,841,843,847,850],{"class":763,"line":842},8,[761,844,846],{"class":845},"swJcz","  apiKey",[761,848,849],{"class":771},":",[761,851,852],{"class":836}," string\n",[761,854,856,859,862],{"class":763,"line":855},9,[761,857,858],{"class":845},"  endpoint",[761,860,861],{"class":771},"?:",[761,863,852],{"class":836},[761,865,867,870,872],{"class":763,"line":866},10,[761,868,869],{"class":845},"  timeout",[761,871,861],{"class":771},[761,873,874],{"class":836}," number\n",[761,876,878],{"class":763,"line":877},11,[761,879,880],{"class":771},"}\n",[761,882,884],{"class":763,"line":883},12,[761,885,826],{"emptyLinePlaceholder":825},[761,887,889,892,895,897,899,902,905,908,911,914],{"class":763,"line":888},13,[761,890,891],{"class":832},"const",[761,893,894],{"class":778}," FIELDS",[761,896,849],{"class":771},[761,898,799],{"class":836},[761,900,901],{"class":771},"\u003C",[761,903,904],{"class":836},"MyServiceConfig",[761,906,907],{"class":771},">",[761,909,910],{"class":778},"[] ",[761,912,913],{"class":771},"=",[761,915,916],{"class":778}," [\n",[761,918,920,923,926,928,930,932,935,938,941,943,946,948,951,953,956],{"class":763,"line":919},14,[761,921,922],{"class":771},"  {",[761,924,925],{"class":845}," key",[761,927,849],{"class":771},[761,929,813],{"class":771},[761,931,664],{"class":816},[761,933,934],{"class":771},"'",[761,936,937],{"class":771},",",[761,939,940],{"class":845}," env",[761,942,849],{"class":771},[761,944,945],{"class":778}," [",[761,947,934],{"class":771},[761,949,950],{"class":816},"MYSERVICE_API_KEY",[761,952,934],{"class":771},[761,954,955],{"class":778},"] ",[761,957,958],{"class":771},"},\n",[761,960,962,964,966,968,970,972,974,976,978,980,982,984,987,989,991],{"class":763,"line":961},15,[761,963,922],{"class":771},[761,965,925],{"class":845},[761,967,849],{"class":771},[761,969,813],{"class":771},[761,971,668],{"class":816},[761,973,934],{"class":771},[761,975,937],{"class":771},[761,977,940],{"class":845},[761,979,849],{"class":771},[761,981,945],{"class":778},[761,983,934],{"class":771},[761,985,986],{"class":816},"MYSERVICE_ENDPOINT",[761,988,934],{"class":771},[761,990,955],{"class":778},[761,992,958],{"class":771},[761,994,996,998,1000,1002,1004,1006,1008],{"class":763,"line":995},16,[761,997,922],{"class":771},[761,999,925],{"class":845},[761,1001,849],{"class":771},[761,1003,813],{"class":771},[761,1005,676],{"class":816},[761,1007,934],{"class":771},[761,1009,1010],{"class":771}," },\n",[761,1012,1014],{"class":763,"line":1013},17,[761,1015,1016],{"class":778},"]\n",[761,1018,1020],{"class":763,"line":1019},18,[761,1021,826],{"emptyLinePlaceholder":825},[761,1023,1025,1028,1031,1035,1038,1042,1044,1047,1049,1051,1054],{"class":763,"line":1024},19,[761,1026,1027],{"class":767},"export",[761,1029,1030],{"class":832}," function",[761,1032,1034],{"class":1033},"s2Zo4"," createMyServiceDrain",[761,1036,1037],{"class":771},"(",[761,1039,1041],{"class":1040},"sHdIc","overrides",[761,1043,861],{"class":771},[761,1045,1046],{"class":836}," Partial",[761,1048,901],{"class":771},[761,1050,904],{"class":836},[761,1052,1053],{"class":771},">)",[761,1055,772],{"class":771},[761,1057,1059,1062,1065,1067,1069,1071,1073],{"class":763,"line":1058},20,[761,1060,1061],{"class":767},"  return",[761,1063,1064],{"class":1033}," defineHttpDrain",[761,1066,901],{"class":771},[761,1068,904],{"class":836},[761,1070,907],{"class":771},[761,1072,1037],{"class":845},[761,1074,1075],{"class":771},"{\n",[761,1077,1079,1082,1084,1086,1089,1091],{"class":763,"line":1078},21,[761,1080,1081],{"class":845},"    name",[761,1083,849],{"class":771},[761,1085,813],{"class":771},[761,1087,1088],{"class":816},"myservice",[761,1090,934],{"class":771},[761,1092,782],{"class":771},[761,1094,1096,1099,1101,1104,1107,1110],{"class":763,"line":1095},22,[761,1097,1098],{"class":1033},"    resolve",[761,1100,849],{"class":771},[761,1102,1103],{"class":832}," async",[761,1105,1106],{"class":771}," ()",[761,1108,1109],{"class":832}," =>",[761,1111,772],{"class":771},[761,1113,1115,1118,1121,1124,1127,1130,1132,1134,1136,1138,1140,1142,1144,1146,1148,1150,1153],{"class":763,"line":1114},23,[761,1116,1117],{"class":832},"      const",[761,1119,1120],{"class":778}," cfg",[761,1122,1123],{"class":771}," =",[761,1125,1126],{"class":767}," await",[761,1128,1129],{"class":1033}," resolveAdapterConfig",[761,1131,901],{"class":771},[761,1133,904],{"class":836},[761,1135,907],{"class":771},[761,1137,1037],{"class":845},[761,1139,934],{"class":771},[761,1141,1088],{"class":816},[761,1143,934],{"class":771},[761,1145,937],{"class":771},[761,1147,894],{"class":778},[761,1149,937],{"class":771},[761,1151,1152],{"class":778}," overrides",[761,1154,1155],{"class":845},")\n",[761,1157,1159,1162,1165,1168,1171,1174,1176,1179],{"class":763,"line":1158},24,[761,1160,1161],{"class":767},"      if",[761,1163,1164],{"class":845}," (",[761,1166,1167],{"class":771},"!",[761,1169,1170],{"class":778},"cfg",[761,1172,1173],{"class":771},".",[761,1175,664],{"class":778},[761,1177,1178],{"class":845},") ",[761,1180,1075],{"class":771},[761,1182,1184,1187,1189,1192,1194,1196,1199,1201],{"class":763,"line":1183},25,[761,1185,1186],{"class":778},"        console",[761,1188,1173],{"class":771},[761,1190,1191],{"class":1033},"error",[761,1193,1037],{"class":845},[761,1195,934],{"class":771},[761,1197,1198],{"class":816},"[evlog\u002Fmyservice] Missing apiKey",[761,1200,934],{"class":771},[761,1202,1155],{"class":845},[761,1204,1206,1209],{"class":763,"line":1205},26,[761,1207,1208],{"class":767},"        return",[761,1210,1211],{"class":771}," null\n",[761,1213,1215],{"class":763,"line":1214},27,[761,1216,1217],{"class":771},"      }\n",[761,1219,1221,1224,1226,1229],{"class":763,"line":1220},28,[761,1222,1223],{"class":767},"      return",[761,1225,1120],{"class":778},[761,1227,1228],{"class":767}," as",[761,1230,1231],{"class":836}," MyServiceConfig\n",[761,1233,1235],{"class":763,"line":1234},29,[761,1236,1237],{"class":771},"    },\n",[761,1239,1241,1244,1246,1248,1251,1253,1255,1258,1260,1262],{"class":763,"line":1240},30,[761,1242,1243],{"class":1033},"    encode",[761,1245,849],{"class":771},[761,1247,1164],{"class":771},[761,1249,1250],{"class":1040},"events",[761,1252,937],{"class":771},[761,1254,1120],{"class":1040},[761,1256,1257],{"class":771},")",[761,1259,1109],{"class":832},[761,1261,1164],{"class":845},[761,1263,1075],{"class":771},[761,1265,1267,1270,1272,1275,1277,1279,1282,1285,1287,1290,1293,1296,1299],{"class":763,"line":1266},31,[761,1268,1269],{"class":845},"      url",[761,1271,849],{"class":771},[761,1273,1274],{"class":771}," `${",[761,1276,1170],{"class":778},[761,1278,1173],{"class":771},[761,1280,1281],{"class":778},"endpoint ",[761,1283,1284],{"class":771},"??",[761,1286,813],{"class":771},[761,1288,1289],{"class":816},"https:\u002F\u002Fapi.myservice.com",[761,1291,1292],{"class":771},"'}",[761,1294,1295],{"class":816},"\u002Fv1\u002Fingest",[761,1297,1298],{"class":771},"`",[761,1300,782],{"class":771},[761,1302,1304,1307,1309],{"class":763,"line":1303},32,[761,1305,1306],{"class":845},"      headers",[761,1308,849],{"class":771},[761,1310,772],{"class":771},[761,1312,1314,1317,1320,1322,1324,1326,1329,1331],{"class":763,"line":1313},33,[761,1315,1316],{"class":771},"        '",[761,1318,1319],{"class":845},"Content-Type",[761,1321,934],{"class":771},[761,1323,849],{"class":771},[761,1325,813],{"class":771},[761,1327,1328],{"class":816},"application\u002Fjson",[761,1330,934],{"class":771},[761,1332,782],{"class":771},[761,1334,1336,1339,1341,1344,1347,1350,1352,1354,1356,1359],{"class":763,"line":1335},34,[761,1337,1338],{"class":845},"        Authorization",[761,1340,849],{"class":771},[761,1342,1343],{"class":771}," `",[761,1345,1346],{"class":816},"Bearer ",[761,1348,1349],{"class":771},"${",[761,1351,1170],{"class":778},[761,1353,1173],{"class":771},[761,1355,664],{"class":778},[761,1357,1358],{"class":771},"}`",[761,1360,782],{"class":771},[761,1362,1364],{"class":763,"line":1363},35,[761,1365,1366],{"class":771},"      },\n",[761,1368,1370,1373,1375,1378,1380,1383,1385,1387,1389],{"class":763,"line":1369},36,[761,1371,1372],{"class":845},"      body",[761,1374,849],{"class":771},[761,1376,1377],{"class":778}," JSON",[761,1379,1173],{"class":771},[761,1381,1382],{"class":1033},"stringify",[761,1384,1037],{"class":845},[761,1386,1250],{"class":778},[761,1388,1257],{"class":845},[761,1390,782],{"class":771},[761,1392,1394,1397,1399],{"class":763,"line":1393},37,[761,1395,1396],{"class":771},"    }",[761,1398,1257],{"class":845},[761,1400,782],{"class":771},[761,1402,1404,1407],{"class":763,"line":1403},38,[761,1405,1406],{"class":771},"  }",[761,1408,1155],{"class":845},[761,1410,1412],{"class":763,"line":1411},39,[761,1413,880],{"class":771},[532,1415,1416,1417,1419,1420,1423,1424,1427],{},"That's it. ",[574,1418,585],{}," handles batching, retries (default 2), timeouts (default 5000ms), error isolation, and the identity headers (",[574,1421,1422],{},"User-Agent: evlog\u002F\u003Cversion>"," + ",[574,1425,1426],{},"X-Evlog-Source: \u003Cname>","). Your app pipeline keeps running even if your destination is down.",[1429,1430,1432],"h3",{"id":1431},"a-5-minute-example-internal-loki-drain","A 5-minute example — internal Loki drain",[532,1434,1435],{},"A complete working drain in 25 lines, with no external config helper:",[751,1437,1442],{"className":1438,"code":1439,"filename":1440,"language":1441,"meta":757,"style":757},"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","lib\u002Floki-drain.ts","ts",[574,1443,1444,1464,1468,1507,1537,1552,1566,1599,1628,1636,1659,1683,1691,1709,1731,1735,1751,1776,1814,1874,1884,1893,1901,1907],{"__ignoreMap":757},[761,1445,1446,1448,1451,1453,1456,1458,1460,1462],{"class":763,"line":764},[761,1447,768],{"class":767},[761,1449,1450],{"class":771}," {",[761,1452,1064],{"class":778},[761,1454,1455],{"class":771}," }",[761,1457,810],{"class":767},[761,1459,813],{"class":771},[761,1461,604],{"class":816},[761,1463,819],{"class":771},[761,1465,1466],{"class":763,"line":775},[761,1467,826],{"emptyLinePlaceholder":825},[761,1469,1470,1472,1474,1477,1479,1481,1483,1485,1488,1490,1493,1495,1498,1500,1502,1505],{"class":763,"line":785},[761,1471,1027],{"class":767},[761,1473,1030],{"class":832},[761,1475,1476],{"class":1033}," createLokiDrain",[761,1478,1037],{"class":771},[761,1480,1041],{"class":1040},[761,1482,861],{"class":771},[761,1484,1450],{"class":771},[761,1486,1487],{"class":845}," url",[761,1489,861],{"class":771},[761,1491,1492],{"class":836}," string",[761,1494,937],{"class":771},[761,1496,1497],{"class":845}," token",[761,1499,861],{"class":771},[761,1501,1492],{"class":836},[761,1503,1504],{"class":771}," })",[761,1506,772],{"class":771},[761,1508,1509,1511,1513,1516,1518,1520,1522,1524,1526,1528,1530,1533,1535],{"class":763,"line":793},[761,1510,1061],{"class":767},[761,1512,1064],{"class":1033},[761,1514,1515],{"class":771},"\u003C{",[761,1517,1487],{"class":845},[761,1519,849],{"class":771},[761,1521,1492],{"class":836},[761,1523,937],{"class":771},[761,1525,1497],{"class":845},[761,1527,849],{"class":771},[761,1529,1492],{"class":836},[761,1531,1532],{"class":771}," }>",[761,1534,1037],{"class":845},[761,1536,1075],{"class":771},[761,1538,1539,1541,1543,1545,1548,1550],{"class":763,"line":804},[761,1540,1081],{"class":845},[761,1542,849],{"class":771},[761,1544,813],{"class":771},[761,1546,1547],{"class":816},"loki",[761,1549,934],{"class":771},[761,1551,782],{"class":771},[761,1553,1554,1556,1558,1560,1562,1564],{"class":763,"line":822},[761,1555,1098],{"class":1033},[761,1557,849],{"class":771},[761,1559,1106],{"class":771},[761,1561,1109],{"class":832},[761,1563,1164],{"class":845},[761,1565,1075],{"class":771},[761,1567,1568,1570,1572,1574,1577,1580,1583,1586,1588,1591,1593,1596],{"class":763,"line":829},[761,1569,1269],{"class":845},[761,1571,849],{"class":771},[761,1573,1152],{"class":778},[761,1575,1576],{"class":771},"?.",[761,1578,1579],{"class":778},"url",[761,1581,1582],{"class":771}," ??",[761,1584,1585],{"class":778}," process",[761,1587,1173],{"class":771},[761,1589,1590],{"class":778},"env",[761,1592,1173],{"class":771},[761,1594,1595],{"class":778},"LOKI_URL",[761,1597,1598],{"class":771},"!,\n",[761,1600,1601,1604,1606,1608,1610,1613,1615,1617,1619,1621,1623,1626],{"class":763,"line":842},[761,1602,1603],{"class":845},"      token",[761,1605,849],{"class":771},[761,1607,1152],{"class":778},[761,1609,1576],{"class":771},[761,1611,1612],{"class":778},"token",[761,1614,1582],{"class":771},[761,1616,1585],{"class":778},[761,1618,1173],{"class":771},[761,1620,1590],{"class":778},[761,1622,1173],{"class":771},[761,1624,1625],{"class":778},"LOKI_TOKEN",[761,1627,1598],{"class":771},[761,1629,1630,1632,1634],{"class":763,"line":855},[761,1631,1396],{"class":771},[761,1633,1257],{"class":845},[761,1635,782],{"class":771},[761,1637,1638,1640,1642,1644,1646,1648,1651,1653,1655,1657],{"class":763,"line":866},[761,1639,1243],{"class":1033},[761,1641,849],{"class":771},[761,1643,1164],{"class":771},[761,1645,1250],{"class":1040},[761,1647,937],{"class":771},[761,1649,1650],{"class":1040}," config",[761,1652,1257],{"class":771},[761,1654,1109],{"class":832},[761,1656,1164],{"class":845},[761,1658,1075],{"class":771},[761,1660,1661,1663,1665,1667,1670,1672,1674,1676,1679,1681],{"class":763,"line":877},[761,1662,1269],{"class":845},[761,1664,849],{"class":771},[761,1666,1274],{"class":771},[761,1668,1669],{"class":778},"config",[761,1671,1173],{"class":771},[761,1673,1579],{"class":778},[761,1675,807],{"class":771},[761,1677,1678],{"class":816},"\u002Floki\u002Fapi\u002Fv1\u002Fpush",[761,1680,1298],{"class":771},[761,1682,782],{"class":771},[761,1684,1685,1687,1689],{"class":763,"line":883},[761,1686,1306],{"class":845},[761,1688,849],{"class":771},[761,1690,772],{"class":771},[761,1692,1693,1695,1697,1699,1701,1703,1705,1707],{"class":763,"line":888},[761,1694,1316],{"class":771},[761,1696,1319],{"class":845},[761,1698,934],{"class":771},[761,1700,849],{"class":771},[761,1702,813],{"class":771},[761,1704,1328],{"class":816},[761,1706,934],{"class":771},[761,1708,782],{"class":771},[761,1710,1711,1713,1715,1717,1719,1721,1723,1725,1727,1729],{"class":763,"line":919},[761,1712,1338],{"class":845},[761,1714,849],{"class":771},[761,1716,1343],{"class":771},[761,1718,1346],{"class":816},[761,1720,1349],{"class":771},[761,1722,1669],{"class":778},[761,1724,1173],{"class":771},[761,1726,1612],{"class":778},[761,1728,1358],{"class":771},[761,1730,782],{"class":771},[761,1732,1733],{"class":763,"line":961},[761,1734,1366],{"class":771},[761,1736,1737,1739,1741,1743,1745,1747,1749],{"class":763,"line":995},[761,1738,1372],{"class":845},[761,1740,849],{"class":771},[761,1742,1377],{"class":778},[761,1744,1173],{"class":771},[761,1746,1382],{"class":1033},[761,1748,1037],{"class":845},[761,1750,1075],{"class":771},[761,1752,1753,1756,1758,1761,1763,1765,1767,1770,1772,1774],{"class":763,"line":1013},[761,1754,1755],{"class":845},"        streams",[761,1757,849],{"class":771},[761,1759,1760],{"class":778}," events",[761,1762,1173],{"class":771},[761,1764,94],{"class":1033},[761,1766,1037],{"class":845},[761,1768,1769],{"class":1040},"e",[761,1771,1109],{"class":832},[761,1773,1164],{"class":845},[761,1775,1075],{"class":771},[761,1777,1778,1781,1783,1785,1788,1790,1793,1795,1798,1800,1803,1805,1807,1809,1812],{"class":763,"line":1019},[761,1779,1780],{"class":845},"          stream",[761,1782,849],{"class":771},[761,1784,1450],{"class":771},[761,1786,1787],{"class":845}," service",[761,1789,849],{"class":771},[761,1791,1792],{"class":778}," e",[761,1794,1173],{"class":771},[761,1796,1797],{"class":778},"service",[761,1799,937],{"class":771},[761,1801,1802],{"class":845}," level",[761,1804,849],{"class":771},[761,1806,1792],{"class":778},[761,1808,1173],{"class":771},[761,1810,1811],{"class":778},"level",[761,1813,1010],{"class":771},[761,1815,1816,1819,1821,1824,1827,1829,1832,1834,1837,1839,1841,1843,1846,1848,1851,1855,1857,1859,1861,1863,1865,1867,1869,1872],{"class":763,"line":1024},[761,1817,1818],{"class":845},"          values",[761,1820,849],{"class":771},[761,1822,1823],{"class":845}," [[",[761,1825,1826],{"class":1033},"String",[761,1828,1037],{"class":845},[761,1830,1831],{"class":778},"Date",[761,1833,1173],{"class":771},[761,1835,1836],{"class":1033},"parse",[761,1838,1037],{"class":845},[761,1840,1769],{"class":778},[761,1842,1173],{"class":771},[761,1844,1845],{"class":778},"timestamp",[761,1847,1178],{"class":845},[761,1849,1850],{"class":771},"*",[761,1852,1854],{"class":1853},"sbssI"," 1e6",[761,1856,1257],{"class":845},[761,1858,937],{"class":771},[761,1860,1377],{"class":778},[761,1862,1173],{"class":771},[761,1864,1382],{"class":1033},[761,1866,1037],{"class":845},[761,1868,1769],{"class":778},[761,1870,1871],{"class":845},")]]",[761,1873,782],{"class":771},[761,1875,1876,1879,1882],{"class":763,"line":1058},[761,1877,1878],{"class":771},"        }",[761,1880,1881],{"class":845},"))",[761,1883,782],{"class":771},[761,1885,1886,1889,1891],{"class":763,"line":1078},[761,1887,1888],{"class":771},"      }",[761,1890,1257],{"class":845},[761,1892,782],{"class":771},[761,1894,1895,1897,1899],{"class":763,"line":1095},[761,1896,1396],{"class":771},[761,1898,1257],{"class":845},[761,1900,782],{"class":771},[761,1902,1903,1905],{"class":763,"line":1114},[761,1904,1406],{"class":771},[761,1906,1155],{"class":845},[761,1908,1909],{"class":763,"line":1158},[761,1910,880],{"class":771},[728,1912,1914],{"id":1913},"standardized-config-priority","Standardized config priority",[532,1916,1917,1919],{},[574,1918,653],{}," walks the standard chain so users get the same configuration UX as built-in adapters:",[1921,1922,1923,1929,1935,1941],"ol",{},[619,1924,1925,1926,1928],{},"Explicit ",[574,1927,1041],{}," passed to your factory",[619,1930,1931,1934],{},[574,1932,1933],{},"runtimeConfig.evlog.\u003Cnamespace>"," (Nuxt\u002FNitro)",[619,1936,1937,1940],{},[574,1938,1939],{},"runtimeConfig.\u003Cnamespace>"," (legacy Nuxt\u002FNitro)",[619,1942,1943,1946,1947,1950,1951,1954,1955,1957,1958,1257],{},[574,1944,1945],{},"\u003CNS>_\u003CFIELD>"," env vars (list ",[574,1948,1949],{},"NUXT_\u003CNS>_\u003CFIELD>"," in ",[574,1952,1953],{},"ConfigField.env"," for silent Nuxt compat; show only ",[574,1956,1945],{}," in error messages via ",[574,1959,1960],{},"formatPublicEnvKeys",[532,1962,1963,1964,673,1966,673,1968,673,1970,1972,1973,1975,1976,1978,1979,1982,1983,1986,1987,1990],{},"Field names should follow the project conventions: ",[574,1965,664],{},[574,1967,668],{},[574,1969,672],{},[574,1971,676],{},". If you're renaming an existing field (e.g. ",[574,1974,1612],{}," → ",[574,1977,664],{},"), keep both as ",[574,1980,1981],{},"ConfigField"," entries for one major version — see ",[574,1984,1985],{},"axiom.ts"," and ",[574,1988,1989],{},"better-stack.ts"," for the deprecation pattern.",[728,1992,1994],{"id":1993},"wiring-the-drain-into-your-framework","Wiring the drain into your framework",[532,1996,1997,1998,2001],{},"Once ",[574,1999,2000],{},"createMyServiceDrain()"," returns the drain, wire it like any other:",[2003,2004,2005,2118,2244,2302,2339,2370],"code-group",{},[751,2006,2009],{"className":753,"code":2007,"filename":2008,"language":756,"meta":757,"style":757},"\u002F\u002F server\u002Fplugins\u002Fevlog-drain.ts\nimport { createMyServiceDrain } from '~\u002Fserver\u002Futils\u002Fmy-drain'\n\nconst drain = createMyServiceDrain()\n\nexport default defineNitroPlugin((nitroApp) => {\n  nitroApp.hooks.hook('evlog:drain', drain)\n})\n","Nuxt \u002F Nitro",[574,2010,2011,2017,2036,2040,2054,2058,2081,2112],{"__ignoreMap":757},[761,2012,2013],{"class":763,"line":764},[761,2014,2016],{"class":2015},"sHwdD","\u002F\u002F server\u002Fplugins\u002Fevlog-drain.ts\n",[761,2018,2019,2021,2023,2025,2027,2029,2031,2034],{"class":763,"line":775},[761,2020,768],{"class":767},[761,2022,1450],{"class":771},[761,2024,1034],{"class":778},[761,2026,1455],{"class":771},[761,2028,810],{"class":767},[761,2030,813],{"class":771},[761,2032,2033],{"class":816},"~\u002Fserver\u002Futils\u002Fmy-drain",[761,2035,819],{"class":771},[761,2037,2038],{"class":763,"line":785},[761,2039,826],{"emptyLinePlaceholder":825},[761,2041,2042,2044,2047,2049,2051],{"class":763,"line":793},[761,2043,891],{"class":832},[761,2045,2046],{"class":778}," drain ",[761,2048,913],{"class":771},[761,2050,1034],{"class":1033},[761,2052,2053],{"class":778},"()\n",[761,2055,2056],{"class":763,"line":804},[761,2057,826],{"emptyLinePlaceholder":825},[761,2059,2060,2062,2065,2068,2070,2072,2075,2077,2079],{"class":763,"line":822},[761,2061,1027],{"class":767},[761,2063,2064],{"class":767}," default",[761,2066,2067],{"class":1033}," defineNitroPlugin",[761,2069,1037],{"class":778},[761,2071,1037],{"class":771},[761,2073,2074],{"class":1040},"nitroApp",[761,2076,1257],{"class":771},[761,2078,1109],{"class":832},[761,2080,772],{"class":771},[761,2082,2083,2086,2088,2091,2093,2096,2098,2100,2103,2105,2107,2110],{"class":763,"line":829},[761,2084,2085],{"class":778},"  nitroApp",[761,2087,1173],{"class":771},[761,2089,2090],{"class":778},"hooks",[761,2092,1173],{"class":771},[761,2094,2095],{"class":1033},"hook",[761,2097,1037],{"class":845},[761,2099,934],{"class":771},[761,2101,2102],{"class":816},"evlog:drain",[761,2104,934],{"class":771},[761,2106,937],{"class":771},[761,2108,2109],{"class":778}," drain",[761,2111,1155],{"class":845},[761,2113,2114,2116],{"class":763,"line":842},[761,2115,807],{"class":771},[761,2117,1155],{"class":778},[751,2119,2121],{"className":753,"code":2120,"filename":235,"language":756,"meta":757,"style":757},"\u002F\u002F lib\u002Fevlog.ts\nimport { createEvlog } from 'evlog\u002Fnext'\nimport { createMyServiceDrain } from '.\u002Fmy-drain'\n\nexport const { withEvlog, useLogger, log, createError } = createEvlog({\n  service: 'my-app',\n  drain: createMyServiceDrain(),\n})\n",[574,2122,2123,2128,2148,2167,2171,2208,2224,2238],{"__ignoreMap":757},[761,2124,2125],{"class":763,"line":764},[761,2126,2127],{"class":2015},"\u002F\u002F lib\u002Fevlog.ts\n",[761,2129,2130,2132,2134,2137,2139,2141,2143,2146],{"class":763,"line":775},[761,2131,768],{"class":767},[761,2133,1450],{"class":771},[761,2135,2136],{"class":778}," createEvlog",[761,2138,1455],{"class":771},[761,2140,810],{"class":767},[761,2142,813],{"class":771},[761,2144,2145],{"class":816},"evlog\u002Fnext",[761,2147,819],{"class":771},[761,2149,2150,2152,2154,2156,2158,2160,2162,2165],{"class":763,"line":785},[761,2151,768],{"class":767},[761,2153,1450],{"class":771},[761,2155,1034],{"class":778},[761,2157,1455],{"class":771},[761,2159,810],{"class":767},[761,2161,813],{"class":771},[761,2163,2164],{"class":816},".\u002Fmy-drain",[761,2166,819],{"class":771},[761,2168,2169],{"class":763,"line":793},[761,2170,826],{"emptyLinePlaceholder":825},[761,2172,2173,2175,2178,2180,2183,2185,2188,2190,2193,2195,2198,2200,2202,2204,2206],{"class":763,"line":804},[761,2174,1027],{"class":767},[761,2176,2177],{"class":832}," const",[761,2179,1450],{"class":771},[761,2181,2182],{"class":778}," withEvlog",[761,2184,937],{"class":771},[761,2186,2187],{"class":778}," useLogger",[761,2189,937],{"class":771},[761,2191,2192],{"class":778}," log",[761,2194,937],{"class":771},[761,2196,2197],{"class":778}," createError ",[761,2199,807],{"class":771},[761,2201,1123],{"class":771},[761,2203,2136],{"class":1033},[761,2205,1037],{"class":778},[761,2207,1075],{"class":771},[761,2209,2210,2213,2215,2217,2220,2222],{"class":763,"line":822},[761,2211,2212],{"class":845},"  service",[761,2214,849],{"class":771},[761,2216,813],{"class":771},[761,2218,2219],{"class":816},"my-app",[761,2221,934],{"class":771},[761,2223,782],{"class":771},[761,2225,2226,2229,2231,2233,2236],{"class":763,"line":829},[761,2227,2228],{"class":845},"  drain",[761,2230,849],{"class":771},[761,2232,1034],{"class":1033},[761,2234,2235],{"class":778},"()",[761,2237,782],{"class":771},[761,2239,2240,2242],{"class":763,"line":842},[761,2241,807],{"class":771},[761,2243,1155],{"class":778},[751,2245,2248],{"className":753,"code":2246,"filename":2247,"language":756,"meta":757,"style":757},"import { createMyServiceDrain } from '.\u002Fmy-drain'\napp.use(evlog({ drain: createMyServiceDrain() }))\n","Hono \u002F Express \u002F Elysia",[574,2249,2250,2268],{"__ignoreMap":757},[761,2251,2252,2254,2256,2258,2260,2262,2264,2266],{"class":763,"line":764},[761,2253,768],{"class":767},[761,2255,1450],{"class":771},[761,2257,1034],{"class":778},[761,2259,1455],{"class":771},[761,2261,810],{"class":767},[761,2263,813],{"class":771},[761,2265,2164],{"class":816},[761,2267,819],{"class":771},[761,2269,2270,2273,2275,2278,2280,2283,2285,2288,2290,2292,2294,2297,2299],{"class":763,"line":775},[761,2271,2272],{"class":778},"app",[761,2274,1173],{"class":771},[761,2276,2277],{"class":1033},"use",[761,2279,1037],{"class":778},[761,2281,2282],{"class":1033},"evlog",[761,2284,1037],{"class":778},[761,2286,2287],{"class":771},"{",[761,2289,2109],{"class":845},[761,2291,849],{"class":771},[761,2293,1034],{"class":1033},[761,2295,2296],{"class":778},"() ",[761,2298,807],{"class":771},[761,2300,2301],{"class":778},"))\n",[751,2303,2305],{"className":753,"code":2304,"filename":270,"language":756,"meta":757,"style":757},"await app.register(evlog, { drain: createMyServiceDrain() })\n",[574,2306,2307],{"__ignoreMap":757},[761,2308,2309,2312,2315,2317,2320,2323,2325,2327,2329,2331,2333,2335,2337],{"class":763,"line":764},[761,2310,2311],{"class":767},"await",[761,2313,2314],{"class":778}," app",[761,2316,1173],{"class":771},[761,2318,2319],{"class":1033},"register",[761,2321,2322],{"class":778},"(evlog",[761,2324,937],{"class":771},[761,2326,1450],{"class":771},[761,2328,2109],{"class":845},[761,2330,849],{"class":771},[761,2332,1034],{"class":1033},[761,2334,2296],{"class":778},[761,2336,807],{"class":771},[761,2338,1155],{"class":778},[751,2340,2342],{"className":753,"code":2341,"filename":255,"language":756,"meta":757,"style":757},"EvlogModule.forRoot({ drain: createMyServiceDrain() })\n",[574,2343,2344],{"__ignoreMap":757},[761,2345,2346,2349,2351,2354,2356,2358,2360,2362,2364,2366,2368],{"class":763,"line":764},[761,2347,2348],{"class":778},"EvlogModule",[761,2350,1173],{"class":771},[761,2352,2353],{"class":1033},"forRoot",[761,2355,1037],{"class":778},[761,2357,2287],{"class":771},[761,2359,2109],{"class":845},[761,2361,849],{"class":771},[761,2363,1034],{"class":1033},[761,2365,2296],{"class":778},[761,2367,807],{"class":771},[761,2369,1155],{"class":778},[751,2371,2373],{"className":753,"code":2372,"filename":290,"language":756,"meta":757,"style":757},"import { initLogger } from 'evlog'\nimport { createMyServiceDrain } from '.\u002Fmy-drain'\n\ninitLogger({ drain: createMyServiceDrain() })\n",[574,2374,2375,2394,2412,2416],{"__ignoreMap":757},[761,2376,2377,2379,2381,2384,2386,2388,2390,2392],{"class":763,"line":764},[761,2378,768],{"class":767},[761,2380,1450],{"class":771},[761,2382,2383],{"class":778}," initLogger",[761,2385,1455],{"class":771},[761,2387,810],{"class":767},[761,2389,813],{"class":771},[761,2391,2282],{"class":816},[761,2393,819],{"class":771},[761,2395,2396,2398,2400,2402,2404,2406,2408,2410],{"class":763,"line":775},[761,2397,768],{"class":767},[761,2399,1450],{"class":771},[761,2401,1034],{"class":778},[761,2403,1455],{"class":771},[761,2405,810],{"class":767},[761,2407,813],{"class":771},[761,2409,2164],{"class":816},[761,2411,819],{"class":771},[761,2413,2414],{"class":763,"line":785},[761,2415,826],{"emptyLinePlaceholder":825},[761,2417,2418,2421,2423,2425,2427,2429,2431,2433,2435],{"class":763,"line":793},[761,2419,2420],{"class":1033},"initLogger",[761,2422,1037],{"class":778},[761,2424,2287],{"class":771},[761,2426,2109],{"class":845},[761,2428,849],{"class":771},[761,2430,1034],{"class":1033},[761,2432,2296],{"class":778},[761,2434,807],{"class":771},[761,2436,1155],{"class":778},[532,2438,2439,2440,2444],{},"For production, wrap it once in ",[541,2441,2442],{"href":492},[574,2443,712],{}," so events are batched and retried.",[728,2446,2448],{"id":2447},"filtering-and-transforming-events","Filtering and transforming events",[532,2450,2451,2453,2454,2457,2458,2460],{},[574,2452,745],{}," receives the full batch of ",[574,2455,2456],{},"WideEvent[]"," plus the resolved config. Filter or transform inline — returning ",[574,2459,690],{}," is a clean opt-out for that batch:",[751,2462,2464],{"className":753,"code":2463,"language":756,"meta":757,"style":757},"encode: (events, cfg) => {\n  const filtered = events.filter(e => e.level === 'error' && e.path !== '\u002Fhealth')\n  if (filtered.length === 0) return null\n\n  const payload = filtered.map(e => ({\n    ts: new Date(e.timestamp).getTime(),\n    severity: e.level.toUpperCase(),\n    attributes: { method: e.method, path: e.path, status: e.status, duration: e.duration },\n  }))\n\n  return {\n    url: `${cfg.endpoint}\u002Fv1\u002Fpush`,\n    headers: { 'Content-Type': 'application\u002Fjson' },\n    body: JSON.stringify(payload),\n  }\n}\n",[574,2465,2466,2487,2547,2574,2578,2603,2635,2657,2721,2727,2731,2737,2761,2786,2808,2813],{"__ignoreMap":757},[761,2467,2468,2471,2473,2475,2477,2479,2481,2483,2485],{"class":763,"line":764},[761,2469,2470],{"class":836},"encode",[761,2472,849],{"class":771},[761,2474,1164],{"class":771},[761,2476,1250],{"class":1040},[761,2478,937],{"class":771},[761,2480,1120],{"class":1040},[761,2482,1257],{"class":771},[761,2484,1109],{"class":832},[761,2486,772],{"class":771},[761,2488,2489,2492,2495,2497,2499,2501,2504,2506,2508,2510,2512,2514,2516,2519,2521,2523,2525,2528,2530,2532,2535,2538,2540,2543,2545],{"class":763,"line":775},[761,2490,2491],{"class":832},"  const",[761,2493,2494],{"class":778}," filtered",[761,2496,1123],{"class":771},[761,2498,1760],{"class":778},[761,2500,1173],{"class":771},[761,2502,2503],{"class":1033},"filter",[761,2505,1037],{"class":845},[761,2507,1769],{"class":1040},[761,2509,1109],{"class":832},[761,2511,1792],{"class":778},[761,2513,1173],{"class":771},[761,2515,1811],{"class":778},[761,2517,2518],{"class":771}," ===",[761,2520,813],{"class":771},[761,2522,1191],{"class":816},[761,2524,934],{"class":771},[761,2526,2527],{"class":771}," &&",[761,2529,1792],{"class":778},[761,2531,1173],{"class":771},[761,2533,2534],{"class":778},"path",[761,2536,2537],{"class":771}," !==",[761,2539,813],{"class":771},[761,2541,2542],{"class":816},"\u002Fhealth",[761,2544,934],{"class":771},[761,2546,1155],{"class":845},[761,2548,2549,2552,2554,2557,2559,2562,2564,2567,2569,2572],{"class":763,"line":785},[761,2550,2551],{"class":767},"  if",[761,2553,1164],{"class":845},[761,2555,2556],{"class":778},"filtered",[761,2558,1173],{"class":771},[761,2560,2561],{"class":778},"length",[761,2563,2518],{"class":771},[761,2565,2566],{"class":1853}," 0",[761,2568,1178],{"class":845},[761,2570,2571],{"class":767},"return",[761,2573,1211],{"class":771},[761,2575,2576],{"class":763,"line":793},[761,2577,826],{"emptyLinePlaceholder":825},[761,2579,2580,2582,2585,2587,2589,2591,2593,2595,2597,2599,2601],{"class":763,"line":804},[761,2581,2491],{"class":832},[761,2583,2584],{"class":778}," payload",[761,2586,1123],{"class":771},[761,2588,2494],{"class":778},[761,2590,1173],{"class":771},[761,2592,94],{"class":1033},[761,2594,1037],{"class":845},[761,2596,1769],{"class":1040},[761,2598,1109],{"class":832},[761,2600,1164],{"class":845},[761,2602,1075],{"class":771},[761,2604,2605,2608,2610,2613,2616,2618,2620,2622,2624,2626,2628,2631,2633],{"class":763,"line":822},[761,2606,2607],{"class":845},"    ts",[761,2609,849],{"class":771},[761,2611,2612],{"class":771}," new",[761,2614,2615],{"class":1033}," Date",[761,2617,1037],{"class":845},[761,2619,1769],{"class":778},[761,2621,1173],{"class":771},[761,2623,1845],{"class":778},[761,2625,1257],{"class":845},[761,2627,1173],{"class":771},[761,2629,2630],{"class":1033},"getTime",[761,2632,2235],{"class":845},[761,2634,782],{"class":771},[761,2636,2637,2640,2642,2644,2646,2648,2650,2653,2655],{"class":763,"line":829},[761,2638,2639],{"class":845},"    severity",[761,2641,849],{"class":771},[761,2643,1792],{"class":778},[761,2645,1173],{"class":771},[761,2647,1811],{"class":778},[761,2649,1173],{"class":771},[761,2651,2652],{"class":1033},"toUpperCase",[761,2654,2235],{"class":845},[761,2656,782],{"class":771},[761,2658,2659,2662,2664,2666,2669,2671,2673,2675,2678,2680,2683,2685,2687,2689,2691,2693,2696,2698,2700,2702,2705,2707,2710,2712,2714,2716,2719],{"class":763,"line":842},[761,2660,2661],{"class":845},"    attributes",[761,2663,849],{"class":771},[761,2665,1450],{"class":771},[761,2667,2668],{"class":845}," method",[761,2670,849],{"class":771},[761,2672,1792],{"class":778},[761,2674,1173],{"class":771},[761,2676,2677],{"class":778},"method",[761,2679,937],{"class":771},[761,2681,2682],{"class":845}," path",[761,2684,849],{"class":771},[761,2686,1792],{"class":778},[761,2688,1173],{"class":771},[761,2690,2534],{"class":778},[761,2692,937],{"class":771},[761,2694,2695],{"class":845}," status",[761,2697,849],{"class":771},[761,2699,1792],{"class":778},[761,2701,1173],{"class":771},[761,2703,2704],{"class":778},"status",[761,2706,937],{"class":771},[761,2708,2709],{"class":845}," duration",[761,2711,849],{"class":771},[761,2713,1792],{"class":778},[761,2715,1173],{"class":771},[761,2717,2718],{"class":778},"duration",[761,2720,1010],{"class":771},[761,2722,2723,2725],{"class":763,"line":855},[761,2724,1406],{"class":771},[761,2726,2301],{"class":845},[761,2728,2729],{"class":763,"line":866},[761,2730,826],{"emptyLinePlaceholder":825},[761,2732,2733,2735],{"class":763,"line":877},[761,2734,1061],{"class":767},[761,2736,772],{"class":771},[761,2738,2739,2742,2744,2746,2748,2750,2752,2754,2757,2759],{"class":763,"line":883},[761,2740,2741],{"class":845},"    url",[761,2743,849],{"class":771},[761,2745,1274],{"class":771},[761,2747,1170],{"class":778},[761,2749,1173],{"class":771},[761,2751,668],{"class":778},[761,2753,807],{"class":771},[761,2755,2756],{"class":816},"\u002Fv1\u002Fpush",[761,2758,1298],{"class":771},[761,2760,782],{"class":771},[761,2762,2763,2766,2768,2770,2772,2774,2776,2778,2780,2782,2784],{"class":763,"line":888},[761,2764,2765],{"class":845},"    headers",[761,2767,849],{"class":771},[761,2769,1450],{"class":771},[761,2771,813],{"class":771},[761,2773,1319],{"class":845},[761,2775,934],{"class":771},[761,2777,849],{"class":771},[761,2779,813],{"class":771},[761,2781,1328],{"class":816},[761,2783,934],{"class":771},[761,2785,1010],{"class":771},[761,2787,2788,2791,2793,2795,2797,2799,2801,2804,2806],{"class":763,"line":919},[761,2789,2790],{"class":845},"    body",[761,2792,849],{"class":771},[761,2794,1377],{"class":778},[761,2796,1173],{"class":771},[761,2798,1382],{"class":1033},[761,2800,1037],{"class":845},[761,2802,2803],{"class":778},"payload",[761,2805,1257],{"class":845},[761,2807,782],{"class":771},[761,2809,2810],{"class":763,"line":961},[761,2811,2812],{"class":771},"  }\n",[761,2814,2815],{"class":763,"line":995},[761,2816,880],{"class":771},[728,2818,2820,2822],{"id":2819},"definedrain-non-http-transports",[574,2821,598],{}," (non-HTTP transports)",[532,2824,2825,2826,2828],{},"If your destination requires gRPC, a vendor SDK, a queue client, a WebSocket, or a raw socket, drop one level lower with ",[574,2827,598],{},". You own the transport; the toolkit still gives you config resolution, error isolation, and a consistent shape.",[751,2830,2832],{"className":753,"code":2831,"language":756,"meta":757,"style":757},"import { defineDrain } from 'evlog\u002Ftoolkit'\n\nexport const createCustomTransportDrain = () =>\n  defineDrain\u003C{ apiKey: string }>({\n    name: 'custom',\n    resolve: async () => ({ apiKey: process.env.MY_KEY! }),\n    send: async (events, cfg) => {\n      await myVendorSdk.publish(events, { token: cfg.apiKey })\n    },\n  })\n",[574,2833,2834,2853,2857,2873,2893,2908,2947,2970,3005,3009],{"__ignoreMap":757},[761,2835,2836,2838,2840,2843,2845,2847,2849,2851],{"class":763,"line":764},[761,2837,768],{"class":767},[761,2839,1450],{"class":771},[761,2841,2842],{"class":778}," defineDrain",[761,2844,1455],{"class":771},[761,2846,810],{"class":767},[761,2848,813],{"class":771},[761,2850,604],{"class":816},[761,2852,819],{"class":771},[761,2854,2855],{"class":763,"line":775},[761,2856,826],{"emptyLinePlaceholder":825},[761,2858,2859,2861,2863,2866,2868,2870],{"class":763,"line":785},[761,2860,1027],{"class":767},[761,2862,2177],{"class":832},[761,2864,2865],{"class":778}," createCustomTransportDrain ",[761,2867,913],{"class":771},[761,2869,1106],{"class":771},[761,2871,2872],{"class":832}," =>\n",[761,2874,2875,2878,2880,2883,2885,2887,2889,2891],{"class":763,"line":793},[761,2876,2877],{"class":1033},"  defineDrain",[761,2879,1515],{"class":771},[761,2881,2882],{"class":845}," apiKey",[761,2884,849],{"class":771},[761,2886,1492],{"class":836},[761,2888,1532],{"class":771},[761,2890,1037],{"class":778},[761,2892,1075],{"class":771},[761,2894,2895,2897,2899,2901,2904,2906],{"class":763,"line":804},[761,2896,1081],{"class":845},[761,2898,849],{"class":771},[761,2900,813],{"class":771},[761,2902,2903],{"class":816},"custom",[761,2905,934],{"class":771},[761,2907,782],{"class":771},[761,2909,2910,2912,2914,2916,2918,2920,2922,2924,2926,2928,2930,2932,2934,2936,2939,2941,2943,2945],{"class":763,"line":822},[761,2911,1098],{"class":1033},[761,2913,849],{"class":771},[761,2915,1103],{"class":832},[761,2917,1106],{"class":771},[761,2919,1109],{"class":832},[761,2921,1164],{"class":778},[761,2923,2287],{"class":771},[761,2925,2882],{"class":845},[761,2927,849],{"class":771},[761,2929,1585],{"class":778},[761,2931,1173],{"class":771},[761,2933,1590],{"class":778},[761,2935,1173],{"class":771},[761,2937,2938],{"class":778},"MY_KEY",[761,2940,1167],{"class":771},[761,2942,1455],{"class":771},[761,2944,1257],{"class":778},[761,2946,782],{"class":771},[761,2948,2949,2952,2954,2956,2958,2960,2962,2964,2966,2968],{"class":763,"line":829},[761,2950,2951],{"class":1033},"    send",[761,2953,849],{"class":771},[761,2955,1103],{"class":832},[761,2957,1164],{"class":771},[761,2959,1250],{"class":1040},[761,2961,937],{"class":771},[761,2963,1120],{"class":1040},[761,2965,1257],{"class":771},[761,2967,1109],{"class":832},[761,2969,772],{"class":771},[761,2971,2972,2975,2978,2980,2983,2985,2987,2989,2991,2993,2995,2997,2999,3001,3003],{"class":763,"line":842},[761,2973,2974],{"class":767},"      await",[761,2976,2977],{"class":778}," myVendorSdk",[761,2979,1173],{"class":771},[761,2981,2982],{"class":1033},"publish",[761,2984,1037],{"class":845},[761,2986,1250],{"class":778},[761,2988,937],{"class":771},[761,2990,1450],{"class":771},[761,2992,1497],{"class":845},[761,2994,849],{"class":771},[761,2996,1120],{"class":778},[761,2998,1173],{"class":771},[761,3000,664],{"class":778},[761,3002,1455],{"class":771},[761,3004,1155],{"class":845},[761,3006,3007],{"class":763,"line":855},[761,3008,1237],{"class":771},[761,3010,3011,3013],{"class":763,"line":866},[761,3012,1406],{"class":771},[761,3014,1155],{"class":778},[532,3016,3017,3018,3020,3021,3023,3024,3027,3028,3031],{},"When you fall back to ",[574,3019,598],{},", follow the same rules manually that ",[574,3022,585],{}," enforces: wrap the transport in ",[574,3025,3026],{},"try\u002Fcatch",", log with ",[574,3029,3030],{},"console.error('[evlog\u002F\u003Cname>] …')",", and never re-throw.",[728,3033,3035],{"id":3034},"draincontext-reference","DrainContext reference",[532,3037,3038,3039,3041,3042,3045],{},"When evlog calls your drain through ",[574,3040,2102],{},", it passes a ",[574,3043,3044],{},"DrainContext"," per event:",[751,3047,3050],{"className":753,"code":3048,"filename":3049,"language":756,"meta":757,"style":757},"interface DrainContext {\n  \u002F** The complete wide event with all accumulated context *\u002F\n  event: WideEvent\n\n  \u002F** Request metadata *\u002F\n  request?: {\n    method: string\n    path: string\n    requestId: string\n  }\n\n  \u002F** Safe HTTP headers (sensitive headers filtered) *\u002F\n  headers?: Record\u003Cstring, string>\n}\n\ninterface WideEvent {\n  timestamp: string\n  level: 'debug' | 'info' | 'warn' | 'error'\n  service: string\n  environment?: string\n  version?: string\n  region?: string\n  commitHash?: string\n  requestId?: string\n  \u002F\u002F ... plus all fields added via log.set()\n  [key: string]: unknown\n}\n","types.ts",[574,3051,3052,3061,3066,3076,3080,3085,3094,3103,3112,3121,3125,3129,3134,3156,3160,3164,3173,3182,3223,3231,3240,3249,3258,3267,3276,3281,3301],{"__ignoreMap":757},[761,3053,3054,3056,3059],{"class":763,"line":764},[761,3055,833],{"class":832},[761,3057,3058],{"class":836}," DrainContext",[761,3060,772],{"class":771},[761,3062,3063],{"class":763,"line":775},[761,3064,3065],{"class":2015},"  \u002F** The complete wide event with all accumulated context *\u002F\n",[761,3067,3068,3071,3073],{"class":763,"line":785},[761,3069,3070],{"class":845},"  event",[761,3072,849],{"class":771},[761,3074,3075],{"class":836}," WideEvent\n",[761,3077,3078],{"class":763,"line":793},[761,3079,826],{"emptyLinePlaceholder":825},[761,3081,3082],{"class":763,"line":804},[761,3083,3084],{"class":2015},"  \u002F** Request metadata *\u002F\n",[761,3086,3087,3090,3092],{"class":763,"line":822},[761,3088,3089],{"class":845},"  request",[761,3091,861],{"class":771},[761,3093,772],{"class":771},[761,3095,3096,3099,3101],{"class":763,"line":829},[761,3097,3098],{"class":845},"    method",[761,3100,849],{"class":771},[761,3102,852],{"class":836},[761,3104,3105,3108,3110],{"class":763,"line":842},[761,3106,3107],{"class":845},"    path",[761,3109,849],{"class":771},[761,3111,852],{"class":836},[761,3113,3114,3117,3119],{"class":763,"line":855},[761,3115,3116],{"class":845},"    requestId",[761,3118,849],{"class":771},[761,3120,852],{"class":836},[761,3122,3123],{"class":763,"line":866},[761,3124,2812],{"class":771},[761,3126,3127],{"class":763,"line":877},[761,3128,826],{"emptyLinePlaceholder":825},[761,3130,3131],{"class":763,"line":883},[761,3132,3133],{"class":2015},"  \u002F** Safe HTTP headers (sensitive headers filtered) *\u002F\n",[761,3135,3136,3139,3141,3144,3146,3149,3151,3153],{"class":763,"line":888},[761,3137,3138],{"class":845},"  headers",[761,3140,861],{"class":771},[761,3142,3143],{"class":836}," Record",[761,3145,901],{"class":771},[761,3147,3148],{"class":836},"string",[761,3150,937],{"class":771},[761,3152,1492],{"class":836},[761,3154,3155],{"class":771},">\n",[761,3157,3158],{"class":763,"line":919},[761,3159,880],{"class":771},[761,3161,3162],{"class":763,"line":961},[761,3163,826],{"emptyLinePlaceholder":825},[761,3165,3166,3168,3171],{"class":763,"line":995},[761,3167,833],{"class":832},[761,3169,3170],{"class":836}," WideEvent",[761,3172,772],{"class":771},[761,3174,3175,3178,3180],{"class":763,"line":1013},[761,3176,3177],{"class":845},"  timestamp",[761,3179,849],{"class":771},[761,3181,852],{"class":836},[761,3183,3184,3187,3189,3191,3194,3196,3199,3201,3204,3206,3208,3210,3213,3215,3217,3219,3221],{"class":763,"line":1019},[761,3185,3186],{"class":845},"  level",[761,3188,849],{"class":771},[761,3190,813],{"class":771},[761,3192,3193],{"class":816},"debug",[761,3195,934],{"class":771},[761,3197,3198],{"class":771}," |",[761,3200,813],{"class":771},[761,3202,3203],{"class":816},"info",[761,3205,934],{"class":771},[761,3207,3198],{"class":771},[761,3209,813],{"class":771},[761,3211,3212],{"class":816},"warn",[761,3214,934],{"class":771},[761,3216,3198],{"class":771},[761,3218,813],{"class":771},[761,3220,1191],{"class":816},[761,3222,819],{"class":771},[761,3224,3225,3227,3229],{"class":763,"line":1024},[761,3226,2212],{"class":845},[761,3228,849],{"class":771},[761,3230,852],{"class":836},[761,3232,3233,3236,3238],{"class":763,"line":1058},[761,3234,3235],{"class":845},"  environment",[761,3237,861],{"class":771},[761,3239,852],{"class":836},[761,3241,3242,3245,3247],{"class":763,"line":1078},[761,3243,3244],{"class":845},"  version",[761,3246,861],{"class":771},[761,3248,852],{"class":836},[761,3250,3251,3254,3256],{"class":763,"line":1095},[761,3252,3253],{"class":845},"  region",[761,3255,861],{"class":771},[761,3257,852],{"class":836},[761,3259,3260,3263,3265],{"class":763,"line":1114},[761,3261,3262],{"class":845},"  commitHash",[761,3264,861],{"class":771},[761,3266,852],{"class":836},[761,3268,3269,3272,3274],{"class":763,"line":1158},[761,3270,3271],{"class":845},"  requestId",[761,3273,861],{"class":771},[761,3275,852],{"class":836},[761,3277,3278],{"class":763,"line":1183},[761,3279,3280],{"class":2015},"  \u002F\u002F ... plus all fields added via log.set()\n",[761,3282,3283,3286,3289,3291,3293,3296,3298],{"class":763,"line":1205},[761,3284,3285],{"class":778},"  [",[761,3287,3288],{"class":1040},"key",[761,3290,849],{"class":771},[761,3292,1492],{"class":836},[761,3294,3295],{"class":778},"]",[761,3297,849],{"class":771},[761,3299,3300],{"class":836}," unknown\n",[761,3302,3303],{"class":763,"line":1214},[761,3304,880],{"class":771},[532,3306,3307,3308,3310,3311,3314,3315,3317,3318,3321],{},"In the batched form your ",[574,3309,745],{}," \u002F ",[574,3312,3313],{},"send()"," receives, you get ",[574,3316,2456],{}," directly (the toolkit unwraps ",[574,3319,3320],{},"event"," from each context).",[728,3323,3325],{"id":3324},"toolkit-helpers","Toolkit helpers",[532,3327,3328,3330],{},[574,3329,604],{}," exposes the same helpers every built-in adapter uses. The ones relevant to drains:",[549,3332,3333,3343],{},[552,3334,3335],{},[555,3336,3337,3340],{},[558,3338,3339],{},"Export",[558,3341,3342],{},"Purpose",[565,3344,3345,3355,3365,3377,3387,3400,3410,3424],{},[555,3346,3347,3352],{},[570,3348,3349],{},[574,3350,3351],{},"defineHttpDrain(spec)",[570,3353,3354],{},"The HTTP recipe — auto retries, timeouts, identity headers, error isolation",[555,3356,3357,3362],{},[570,3358,3359],{},[574,3360,3361],{},"defineDrain(spec)",[570,3363,3364],{},"Same contract for non-HTTP transports",[555,3366,3367,3372],{},[570,3368,3369],{},[574,3370,3371],{},"resolveAdapterConfig(ns, fields, overrides)",[570,3373,3374,3375,658],{},"Standard config priority chain (overrides → ",[574,3376,657],{},[555,3378,3379,3384],{},[570,3380,3381],{},[574,3382,3383],{},"httpPost(opts)",[570,3385,3386],{},"The retried POST helper used by every built-in HTTP adapter — handles timeout, retries, redacted error messages",[555,3388,3389,3394],{},[570,3390,3391],{},[574,3392,3393],{},"composeDrains(drains)",[570,3395,3396,3397,1257],{},"Combine multiple drains into one (errors isolated, runs concurrently with ",[574,3398,3399],{},"Promise.allSettled",[555,3401,3402,3407],{},[570,3403,3404],{},[574,3405,3406],{},"toTypedAttributeValue(value)",[570,3408,3409],{},"Convert any value to the typed attribute shape used by Axiom \u002F Sentry",[555,3411,3412,3417],{},[570,3413,3414],{},[574,3415,3416],{},"toOtlpAttributeValue(value)",[570,3418,3419,3420,3423],{},"Convert any value to the OTLP ",[574,3421,3422],{},"AnyValue"," shape (used by OTLP \u002F HyperDX \u002F PostHog logs)",[555,3425,3426,3434],{},[570,3427,3428,673,3431],{},[574,3429,3430],{},"OTEL_SEVERITY_NUMBER",[574,3432,3433],{},"OTEL_SEVERITY_TEXT",[570,3435,3436],{},"OTEL log severity tables",[728,3438,481],{"id":3439},"identity-headers",[532,3441,3442,3444],{},[574,3443,585],{}," automatically tags every request with two headers so receivers can identify the traffic:",[549,3446,3447,3457],{},[552,3448,3449],{},[555,3450,3451,3454],{},[558,3452,3453],{},"Header",[558,3455,3456],{},"Value",[565,3458,3459,3472],{},[555,3460,3461,3466],{},[570,3462,3463],{},[574,3464,3465],{},"User-Agent",[570,3467,3468,3471],{},[574,3469,3470],{},"evlog\u002F\u003Cversion>"," (Node \u002F server runtimes only — browsers strip this header)",[555,3473,3474,3479],{},[570,3475,3476],{},[574,3477,3478],{},"X-Evlog-Source",[570,3480,3481,3482,3485],{},"The drain ",[574,3483,3484],{},"name"," you provided",[532,3487,3488,3489,3492,3493,1173],{},"If you build a drain on top of ",[574,3490,3491],{},"httpPost"," directly, you can override or suppress them — see ",[541,3494,481],{"href":482},[728,3496,3498],{"id":3497},"error-handling-already-done-for-you","Error handling — already done for you",[532,3500,3501,3503],{},[574,3502,585],{}," enforces every best practice automatically:",[1921,3505,3506,3516,3526,3534],{},[619,3507,3508,3511,3512,3515],{},[536,3509,3510],{},"Never throws"," — failures are caught and logged with the ",[574,3513,3514],{},"[evlog\u002F\u003Cname>]"," prefix.",[619,3517,3518,3521,3522,3525],{},[536,3519,3520],{},"Retries"," — defaults to 2 attempts on transient errors (configurable via ",[574,3523,3524],{},"retries",").",[619,3527,3528,3531,3532,3525],{},[536,3529,3530],{},"Timeouts"," — defaults to 5000ms (configurable via ",[574,3533,676],{},[619,3535,3536,3539,3540,3542,3543,3545],{},[536,3537,3538],{},"Graceful degradation"," — ",[574,3541,649],{}," returning ",[574,3544,690],{}," makes the drain a no-op.",[532,3547,3548,3549,3551],{},"If you fall back to ",[574,3550,598],{},", follow the same rules manually.",[728,3553,3555],{"id":3554},"publishing-as-a-community-package","Publishing as a community package",[532,3557,3558],{},"Recommended structure for a community drain:",[751,3560,3565],{"className":3561,"code":3563,"language":3564,"meta":757},[3562],"language-text","my-evlog-drain\u002F\n├─ src\u002F\n│  ├─ drain.ts        # createMyDrain via defineHttpDrain\n│  └─ index.ts        # re-exports\n├─ test\u002F              # vitest, mock fetch\n├─ package.json       # peerDependency: \"evlog\"\n└─ README.md\n","text",[574,3566,3563],{"__ignoreMap":757},[532,3568,3569,3570,3572,3573,3576,3577,3580],{},"Add ",[574,3571,2282],{}," as a ",[574,3574,3575],{},"peerDependency"," (not a ",[574,3578,3579],{},"dependency",") — your package shouldn't pull in a copy of evlog at install time.",[3582,3583,3586,3587,3592],"callout",{"color":3584,"icon":3585},"neutral","i-lucide-heart","Built something great? ",[541,3588,3591],{"href":3589,"rel":3590},"https:\u002F\u002Fgithub.com\u002Fhugorcd\u002Fevlog\u002Fpulls",[721],"Open a PR"," to add a row to the Adapters table — the community will thank you.",[728,3594,3596],{"id":3595},"next-steps","Next steps",[616,3598,3599,3605,3613,3619,3625],{},[619,3600,3601,3604],{},[541,3602,3603],{"href":492},"Drain Pipeline"," — wrap your drain in batch + retry + fanout for production",[619,3606,3607,3610,3611],{},[541,3608,3609],{"href":143},"Adapters Overview"," — see how the built-in adapters use ",[574,3612,585],{},[619,3614,3615,3618],{},[541,3616,3617],{"href":474},"Custom Enrichers"," — same toolkit shape for derived event fields",[619,3620,3621,3624],{},[541,3622,3623],{"href":456},"Custom Framework Integration"," — same toolkit shape for HTTP frameworks",[619,3626,3627,3629],{},[541,3628,513],{"href":514}," — security and production tips",[3631,3632,3633],"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 .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}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 .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 .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}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":757,"searchDepth":775,"depth":775,"links":3635},[3636,3640,3641,3642,3643,3645,3646,3647,3648,3649,3650],{"id":730,"depth":775,"text":3637,"children":3638},"defineHttpDrain (the HTTP recipe)",[3639],{"id":1431,"depth":785,"text":1432},{"id":1913,"depth":775,"text":1914},{"id":1993,"depth":775,"text":1994},{"id":2447,"depth":775,"text":2448},{"id":2819,"depth":775,"text":3644},"defineDrain (non-HTTP transports)",{"id":3034,"depth":775,"text":3035},{"id":3324,"depth":775,"text":3325},{"id":3439,"depth":775,"text":481},{"id":3497,"depth":775,"text":3498},{"id":3554,"depth":775,"text":3555},{"id":3595,"depth":775,"text":3596},"Build a drain for any backend without a built-in adapter — defineHttpDrain for HTTP destinations, defineDrain for any other transport. Standardized config resolution, retries, timeouts, and identity headers handled for you.","md",[3654,3656,3658],{"label":3603,"icon":494,"to":492,"color":3584,"variant":3655},"subtle",{"label":3609,"icon":3657,"to":143,"color":3584,"variant":3655},"i-custom-plug",{"label":513,"icon":379,"to":514,"color":3584,"variant":3655},{},{"title":486,"icon":489},{"title":527,"description":3651},"uCmp0ogWAKmIRL4AQNUhlp9bvOT-kc-JJsFP-mZ-pns",[3664,3666],{"title":481,"path":482,"stem":483,"description":3665,"icon":484,"children":-1},"Every drain request sent by evlog is tagged with User-Agent and X-Evlog-Source headers so receivers can identify and triage the traffic. Override or suppress them when your custom drain needs different identity.",{"title":491,"path":492,"stem":493,"description":3667,"icon":494,"children":-1},"Batch events, retry on failure, fan out to multiple destinations, and ship browser logs to your server. The shared pipeline that wraps every drain in production.",1785673281901]