[{"data":1,"prerenderedAt":3499},["ShallowReactive",2],{"navigation_docs":3,"-integrate-adapters-hybrid-clickhouse":602,"-integrate-adapters-hybrid-clickhouse-surround":3494},[4,35,85,138,318,479,538,577],{"title":5,"path":6,"stem":7,"children":8,"page":34},"Start","\u002Fstart","1.start",[9,14,19,24,29],{"title":10,"path":11,"stem":12,"icon":13},"Introduction","\u002Fstart\u002Fintroduction","1.start\u002F1.introduction","i-lucide-info",{"title":15,"path":16,"stem":17,"icon":18},"Why start with evlog","\u002Fstart\u002Fwhy-evlog","1.start\u002F2.why-evlog","i-lucide-rocket",{"title":20,"path":21,"stem":22,"icon":23},"Installation","\u002Fstart\u002Finstallation","1.start\u002F3.installation","i-lucide-download",{"title":25,"path":26,"stem":27,"icon":28},"Quick Start","\u002Fstart\u002Fquick-start","1.start\u002F4.quick-start","i-lucide-zap",{"title":30,"path":31,"stem":32,"icon":33},"Choose your logger","\u002Fstart\u002Ftypescript-logging-library","1.start\u002F5.typescript-logging-library","i-lucide-file-code",false,{"title":36,"path":37,"stem":38,"children":39,"page":34},"Learn","\u002Flearn","2.learn",[40,45,50,55,60,65,70,75,80],{"title":41,"path":42,"stem":43,"icon":44},"Overview","\u002Flearn\u002Foverview","2.learn\u002F0.overview","i-lucide-list",{"title":46,"path":47,"stem":48,"icon":49},"Simple Logging","\u002Flearn\u002Fsimple-logging","2.learn\u002F1.simple-logging","i-lucide-terminal",{"title":51,"path":52,"stem":53,"icon":54},"Wide Events","\u002Flearn\u002Fwide-events","2.learn\u002F2.wide-events","i-lucide-layers",{"title":56,"path":57,"stem":58,"icon":59},"Structured Errors","\u002Flearn\u002Fstructured-errors","2.learn\u002F3.structured-errors","i-lucide-shield-alert",{"title":61,"path":62,"stem":63,"icon":64},"Lifecycle","\u002Flearn\u002Flifecycle","2.learn\u002F4.lifecycle","i-lucide-arrow-right-left",{"title":66,"path":67,"stem":68,"icon":69},"Sampling","\u002Flearn\u002Fsampling","2.learn\u002F5.sampling","i-lucide-filter",{"title":71,"path":72,"stem":73,"icon":74},"Auto-Redaction","\u002Flearn\u002Fredaction","2.learn\u002F6.redaction","i-lucide-eye-off",{"title":76,"path":77,"stem":78,"icon":79},"Typed Fields","\u002Flearn\u002Ftyped-fields","2.learn\u002F7.typed-fields","i-simple-icons-typescript",{"title":81,"path":82,"stem":83,"icon":84},"Catalogs","\u002Flearn\u002Fcatalogs","2.learn\u002F8.catalogs","i-lucide-book-open",{"title":86,"path":87,"stem":88,"children":89,"page":34},"CLI","\u002Fcli","3.cli",[90,93,98,103,108,113,118,123,128,133],{"title":41,"path":91,"stem":92,"icon":49},"\u002Fcli\u002Foverview","3.cli\u002F0.overview",{"title":94,"path":95,"stem":96,"icon":97},"init","\u002Fcli\u002Finit","3.cli\u002F1.init","i-lucide-wand-sparkles",{"title":99,"path":100,"stem":101,"icon":102},"map","\u002Fcli\u002Fmap","3.cli\u002F2.map","i-lucide-radar",{"title":104,"path":105,"stem":106,"icon":107},"Rules","\u002Fcli\u002Frules","3.cli\u002F3.rules","i-lucide-list-checks",{"title":109,"path":110,"stem":111,"icon":112},"Scoring","\u002Fcli\u002Fscoring","3.cli\u002F4.scoring","i-lucide-gauge",{"title":114,"path":115,"stem":116,"icon":117},"CI","\u002Fcli\u002Fci","3.cli\u002F5.ci","i-lucide-git-pull-request",{"title":119,"path":120,"stem":121,"icon":122},"doctor","\u002Fcli\u002Fdoctor","3.cli\u002F6.doctor","i-lucide-stethoscope",{"title":124,"path":125,"stem":126,"icon":127},"telemetry","\u002Fcli\u002Ftelemetry","3.cli\u002F7.telemetry","i-lucide-bar-chart-3",{"title":129,"path":130,"stem":131,"icon":132},"agents","\u002Fcli\u002Fagents","3.cli\u002F8.agents","i-lucide-bot",{"title":134,"path":135,"stem":136,"icon":137},"Observability Score","\u002Fcli\u002Fobservability-score","3.cli\u002F9.observability-score","i-lucide-activity",{"title":139,"path":140,"stem":141,"children":142,"page":34},"Integrate","\u002Fintegrate","4.integrate",[143,147,230],{"title":41,"path":144,"stem":145,"icon":146},"\u002Fintegrate\u002Foverview","4.integrate\u002F0.overview","i-lucide-plug",{"title":148,"path":149,"stem":150,"children":151,"page":34},"Adapters","\u002Fintegrate\u002Fadapters","4.integrate\u002Fadapters",[152,155,185,210],{"title":41,"path":153,"stem":154,"icon":44},"\u002Fintegrate\u002Fadapters\u002Foverview","4.integrate\u002Fadapters\u002F01.overview",{"title":156,"path":157,"stem":158,"children":159,"page":34},"Cloud","\u002Fintegrate\u002Fadapters\u002Fcloud","4.integrate\u002Fadapters\u002Fcloud",[160,165,170,175,180],{"title":161,"path":162,"stem":163,"icon":164},"Axiom","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Faxiom","4.integrate\u002Fadapters\u002Fcloud\u002F01.axiom","i-custom-axiom",{"title":166,"path":167,"stem":168,"icon":169},"PostHog","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fposthog","4.integrate\u002Fadapters\u002Fcloud\u002F02.posthog","i-simple-icons-posthog",{"title":171,"path":172,"stem":173,"icon":174},"Sentry","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fsentry","4.integrate\u002Fadapters\u002Fcloud\u002F03.sentry","i-simple-icons-sentry",{"title":176,"path":177,"stem":178,"icon":179},"Better Stack","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fbetter-stack","4.integrate\u002Fadapters\u002Fcloud\u002F04.better-stack","i-simple-icons-betterstack",{"title":181,"path":182,"stem":183,"icon":184},"Datadog","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fdatadog","4.integrate\u002Fadapters\u002Fcloud\u002F05.datadog","i-simple-icons-datadog",{"title":186,"path":187,"stem":188,"children":189,"page":34},"Cloud or Self-Hosted","\u002Fintegrate\u002Fadapters\u002Fhybrid","4.integrate\u002Fadapters\u002Fhybrid",[190,195,200,205],{"title":191,"path":192,"stem":193,"icon":194},"Grafana Loki","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Floki","4.integrate\u002Fadapters\u002Fhybrid\u002F01.loki","i-simple-icons-grafana",{"title":196,"path":197,"stem":198,"icon":199},"ClickHouse","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Fclickhouse","4.integrate\u002Fadapters\u002Fhybrid\u002F02.clickhouse","i-simple-icons-clickhouse",{"title":201,"path":202,"stem":203,"icon":204},"OTLP","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Fotlp","4.integrate\u002Fadapters\u002Fhybrid\u002F03.otlp","i-simple-icons-opentelemetry",{"title":206,"path":207,"stem":208,"icon":209},"HyperDX","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Fhyperdx","4.integrate\u002Fadapters\u002Fhybrid\u002F04.hyperdx","i-custom-hyperdx",{"title":211,"path":212,"stem":213,"children":214,"page":34},"Self-Hosted","\u002Fintegrate\u002Fadapters\u002Fself-hosted","4.integrate\u002Fadapters\u002Fself-hosted",[215,220,225],{"title":216,"path":217,"stem":218,"icon":219},"File System","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Ffs","4.integrate\u002Fadapters\u002Fself-hosted\u002F01.fs","i-lucide-hard-drive",{"title":221,"path":222,"stem":223,"icon":224},"NuxtHub","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Fnuxthub","4.integrate\u002Fadapters\u002Fself-hosted\u002F02.nuxthub","i-simple-icons-nuxt",{"title":226,"path":227,"stem":228,"icon":229},"Memory","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Fmemory","4.integrate\u002Fadapters\u002Fself-hosted\u002F03.memory","i-lucide-cpu",{"title":231,"path":232,"stem":233,"children":234,"page":34},"Frameworks","\u002Fintegrate\u002Fframeworks","4.integrate\u002Fframeworks",[235,239,244,249,254,259,264,269,274,279,284,289,294,299,303,308,313],{"title":41,"path":236,"stem":237,"icon":238},"\u002Fintegrate\u002Fframeworks\u002Foverview","4.integrate\u002Fframeworks\u002F00.overview","i-lucide-layout-grid",{"title":240,"path":241,"stem":242,"icon":243},"Nuxt","\u002Fintegrate\u002Fframeworks\u002Fnuxt","4.integrate\u002Fframeworks\u002F01.nuxt","i-simple-icons-nuxtdotjs",{"title":245,"path":246,"stem":247,"icon":248},"Next.js","\u002Fintegrate\u002Fframeworks\u002Fnextjs","4.integrate\u002Fframeworks\u002F02.nextjs","i-simple-icons-nextdotjs",{"title":250,"path":251,"stem":252,"icon":253},"SvelteKit","\u002Fintegrate\u002Fframeworks\u002Fsveltekit","4.integrate\u002Fframeworks\u002F03.sveltekit","i-simple-icons-svelte",{"title":255,"path":256,"stem":257,"icon":258},"Nitro","\u002Fintegrate\u002Fframeworks\u002Fnitro","4.integrate\u002Fframeworks\u002F04.nitro","i-custom-nitro",{"title":260,"path":261,"stem":262,"icon":263},"TanStack Start","\u002Fintegrate\u002Fframeworks\u002Ftanstack-start","4.integrate\u002Fframeworks\u002F05.tanstack-start","i-custom-tanstack",{"title":265,"path":266,"stem":267,"icon":268},"NestJS","\u002Fintegrate\u002Fframeworks\u002Fnestjs","4.integrate\u002Fframeworks\u002F06.nestjs","i-simple-icons-nestjs",{"title":270,"path":271,"stem":272,"icon":273},"Express","\u002Fintegrate\u002Fframeworks\u002Fexpress","4.integrate\u002Fframeworks\u002F07.express","i-simple-icons-express",{"title":275,"path":276,"stem":277,"icon":278},"Hono","\u002Fintegrate\u002Fframeworks\u002Fhono","4.integrate\u002Fframeworks\u002F08.hono","i-simple-icons-hono",{"title":280,"path":281,"stem":282,"icon":283},"Fastify","\u002Fintegrate\u002Fframeworks\u002Ffastify","4.integrate\u002Fframeworks\u002F09.fastify","i-simple-icons-fastify",{"title":285,"path":286,"stem":287,"icon":288},"Elysia","\u002Fintegrate\u002Fframeworks\u002Felysia","4.integrate\u002Fframeworks\u002F10.elysia","i-custom-elysia",{"title":290,"path":291,"stem":292,"icon":293},"React Router","\u002Fintegrate\u002Fframeworks\u002Freact-router","4.integrate\u002Fframeworks\u002F11.react-router","i-custom-reactrouter",{"title":295,"path":296,"stem":297,"icon":298},"Cloudflare Workers","\u002Fintegrate\u002Fframeworks\u002Fcloudflare-workers","4.integrate\u002Fframeworks\u002F12.cloudflare-workers","i-simple-icons-cloudflare",{"title":300,"path":301,"stem":302,"icon":79},"Standalone","\u002Fintegrate\u002Fframeworks\u002Fstandalone","4.integrate\u002Fframeworks\u002F13.standalone",{"title":304,"path":305,"stem":306,"icon":307},"Astro","\u002Fintegrate\u002Fframeworks\u002Fastro","4.integrate\u002Fframeworks\u002F14.astro","i-simple-icons-astro",{"title":309,"path":310,"stem":311,"icon":312},"oRPC","\u002Fintegrate\u002Fframeworks\u002Forpc","4.integrate\u002Fframeworks\u002F15.orpc","i-lucide-network",{"title":314,"path":315,"stem":316,"icon":317},"AWS Lambda","\u002Fintegrate\u002Fframeworks\u002Faws-lambda","4.integrate\u002Fframeworks\u002F16.aws-lambda","i-custom-lambda",{"title":319,"path":320,"stem":321,"children":322,"page":34},"Use Cases","\u002Fuse-cases","5.use-cases",[323,326,331,359,386,418,439,444,449,453],{"title":41,"path":324,"stem":325,"icon":107},"\u002Fuse-cases\u002Foverview","5.use-cases\u002F0.overview",{"title":327,"path":328,"stem":329,"icon":330},"Client Logging","\u002Fuse-cases\u002Fclient-logging","5.use-cases\u002F1.client-logging","i-lucide-monitor",{"title":332,"icon":333,"path":334,"stem":335,"children":336,"page":34},"AI SDK","i-simple-icons-vercel","\u002Fuse-cases\u002Fai-sdk","5.use-cases\u002F2.ai-sdk",[337,340,345,350,355],{"title":41,"path":338,"stem":339,"icon":44},"\u002Fuse-cases\u002Fai-sdk\u002Foverview","5.use-cases\u002F2.ai-sdk\u002F01.overview",{"title":341,"path":342,"stem":343,"icon":344},"Usage","\u002Fuse-cases\u002Fai-sdk\u002Fusage","5.use-cases\u002F2.ai-sdk\u002F02.usage","i-lucide-code",{"title":346,"path":347,"stem":348,"icon":349},"Options","\u002Fuse-cases\u002Fai-sdk\u002Foptions","5.use-cases\u002F2.ai-sdk\u002F03.options","i-lucide-sliders",{"title":351,"path":352,"stem":353,"icon":354},"Metadata","\u002Fuse-cases\u002Fai-sdk\u002Fmetadata","5.use-cases\u002F2.ai-sdk\u002F04.metadata","i-lucide-database",{"title":356,"path":357,"stem":358,"icon":137},"Telemetry","\u002Fuse-cases\u002Fai-sdk\u002Ftelemetry","5.use-cases\u002F2.ai-sdk\u002F05.telemetry",{"title":360,"icon":361,"path":362,"stem":363,"children":364,"page":34},"Better Auth","i-simple-icons-betterauth","\u002Fuse-cases\u002Fbetter-auth","5.use-cases\u002F3.better-auth",[365,368,373,378,382],{"title":41,"path":366,"stem":367,"icon":44},"\u002Fuse-cases\u002Fbetter-auth\u002Foverview","5.use-cases\u002F3.better-auth\u002F01.overview",{"title":369,"path":370,"stem":371,"icon":372},"Identify User","\u002Fuse-cases\u002Fbetter-auth\u002Fidentify-user","5.use-cases\u002F3.better-auth\u002F02.identify-user","i-lucide-user-check",{"title":374,"path":375,"stem":376,"icon":377},"Middleware","\u002Fuse-cases\u002Fbetter-auth\u002Fmiddleware","5.use-cases\u002F3.better-auth\u002F03.middleware","i-lucide-shield",{"title":379,"path":380,"stem":381,"icon":330},"Client Sync","\u002Fuse-cases\u002Fbetter-auth\u002Fclient-sync","5.use-cases\u002F3.better-auth\u002F04.client-sync",{"title":383,"path":384,"stem":385,"icon":112},"Performance","\u002Fuse-cases\u002Fbetter-auth\u002Fperformance","5.use-cases\u002F3.better-auth\u002F05.performance",{"title":387,"icon":388,"path":389,"stem":390,"children":391,"page":34},"Audit Logs","i-lucide-shield-check","\u002Fuse-cases\u002Faudit","5.use-cases\u002F4.audit",[392,395,400,405,410,414],{"title":41,"path":393,"stem":394,"icon":44},"\u002Fuse-cases\u002Faudit\u002Foverview","5.use-cases\u002F4.audit\u002F01.overview",{"title":396,"path":397,"stem":398,"icon":399},"Schema","\u002Fuse-cases\u002Faudit\u002Fschema","5.use-cases\u002F4.audit\u002F02.schema","i-lucide-file-text",{"title":401,"path":402,"stem":403,"icon":404},"Recording","\u002Fuse-cases\u002Faudit\u002Frecording","5.use-cases\u002F4.audit\u002F03.recording","i-lucide-pen-line",{"title":406,"path":407,"stem":408,"icon":409},"Drains","\u002Fuse-cases\u002Faudit\u002Fpipeline","5.use-cases\u002F4.audit\u002F04.pipeline","i-lucide-link",{"title":411,"path":412,"stem":413,"icon":388},"Compliance","\u002Fuse-cases\u002Faudit\u002Fcompliance","5.use-cases\u002F4.audit\u002F05.compliance",{"title":415,"path":416,"stem":417,"icon":84},"Recipes","\u002Fuse-cases\u002Faudit\u002Frecipes","5.use-cases\u002F4.audit\u002F06.recipes",{"title":356,"icon":112,"path":419,"stem":420,"children":421,"page":34},"\u002Fuse-cases\u002Ftelemetry","5.use-cases\u002F4.telemetry",[422,425,430,435],{"title":41,"path":423,"stem":424,"icon":44},"\u002Fuse-cases\u002Ftelemetry\u002Foverview","5.use-cases\u002F4.telemetry\u002F01.overview",{"title":426,"path":427,"stem":428,"icon":429},"Setup","\u002Fuse-cases\u002Ftelemetry\u002Fsetup","5.use-cases\u002F4.telemetry\u002F02.setup","i-lucide-wrench",{"title":431,"path":432,"stem":433,"icon":434},"Ingest","\u002Fuse-cases\u002Ftelemetry\u002Fingest","5.use-cases\u002F4.telemetry\u002F03.ingest","i-lucide-server",{"title":436,"path":437,"stem":438,"icon":84},"Reference","\u002Fuse-cases\u002Ftelemetry\u002Freference","5.use-cases\u002F4.telemetry\u002F04.reference",{"title":440,"path":441,"stem":442,"icon":443},"Enrichers","\u002Fuse-cases\u002Fenrichers","5.use-cases\u002F5.enrichers","i-lucide-sparkles",{"title":445,"path":446,"stem":447,"icon":448},"eve","\u002Fuse-cases\u002Feve","5.use-cases\u002F5.eve","i-custom-eve",{"title":450,"path":451,"stem":452,"icon":434},"Node.js request logging","\u002Fuse-cases\u002Fstructured-logging-nodejs","5.use-cases\u002F6.structured-logging-nodejs",{"title":454,"icon":455,"path":456,"stem":457,"children":458,"page":34},"Signals","i-lucide-scan-search","\u002Fuse-cases\u002Fsignals","5.use-cases\u002F7.signals",[459,462,467,472,475],{"title":41,"path":460,"stem":461,"icon":44},"\u002Fuse-cases\u002Fsignals\u002Foverview","5.use-cases\u002F7.signals\u002F01.overview",{"title":463,"path":464,"stem":465,"icon":466},"What You Can Ask","\u002Fuse-cases\u002Fsignals\u002Fask","5.use-cases\u002F7.signals\u002F02.ask","i-lucide-message-circle-question",{"title":468,"path":469,"stem":470,"icon":471},"What It Costs","\u002Fuse-cases\u002Fsignals\u002Fcost","5.use-cases\u002F7.signals\u002F03.cost","i-lucide-coins",{"title":436,"path":473,"stem":474,"icon":84},"\u002Fuse-cases\u002Fsignals\u002Freference","5.use-cases\u002F7.signals\u002F04.reference",{"title":415,"path":476,"stem":477,"icon":478},"\u002Fuse-cases\u002Fsignals\u002Frecipes","5.use-cases\u002F7.signals\u002F05.recipes","i-lucide-lightbulb",{"title":480,"path":481,"stem":482,"children":483,"page":34},"Extend","\u002Fextend","6.extend",[484,488,493,498,502,507,511,515,519,523,528,533],{"title":41,"path":485,"stem":486,"icon":487},"\u002Fextend\u002Foverview","6.extend\u002F0.overview","i-lucide-blocks",{"title":489,"path":490,"stem":491,"icon":492},"Stream","\u002Fextend\u002Fstream","6.extend\u002F1.stream","i-lucide-radio-tower",{"title":494,"path":495,"stem":496,"icon":497},"Custom framework","\u002Fextend\u002Fcustom-framework","6.extend\u002F10.custom-framework","i-lucide-puzzle",{"title":499,"path":500,"stem":501,"icon":492},"Diagnostics channel","\u002Fextend\u002Fdiagnostics-channel","6.extend\u002F11.diagnostics-channel",{"title":503,"path":504,"stem":505,"icon":506},"FS reader","\u002Fextend\u002Ffs-reader","6.extend\u002F2.fs-reader","i-lucide-folder-search",{"title":415,"path":508,"stem":509,"icon":510},"\u002Fextend\u002Fconsumer-recipes","6.extend\u002F3.consumer-recipes","i-lucide-chef-hat",{"title":512,"path":513,"stem":514,"icon":487},"Plugins","\u002Fextend\u002Fplugins","6.extend\u002F4.plugins",{"title":516,"path":517,"stem":518,"icon":443},"Custom enrichers","\u002Fextend\u002Fcustom-enrichers","6.extend\u002F5.custom-enrichers",{"title":520,"path":521,"stem":522,"icon":69},"Tail sampling","\u002Fextend\u002Ftail-sampling","6.extend\u002F6.tail-sampling",{"title":524,"path":525,"stem":526,"icon":527},"Identity headers","\u002Fextend\u002Fidentity-headers","6.extend\u002F7.identity-headers","i-lucide-fingerprint",{"title":529,"path":530,"stem":531,"icon":532},"Custom drains","\u002Fextend\u002Fcustom-drains","6.extend\u002F8.custom-drains","i-lucide-share-2",{"title":534,"path":535,"stem":536,"icon":537},"Drain pipeline","\u002Fextend\u002Fdrain-pipeline","6.extend\u002F9.drain-pipeline","i-lucide-workflow",{"title":436,"path":539,"stem":540,"children":541,"page":34},"\u002Freference","7.reference",[542,546,551,554,559,563,568,572],{"title":41,"path":543,"stem":544,"icon":545},"\u002Freference\u002Foverview","7.reference\u002F0.overview","i-lucide-book-marked",{"title":547,"path":548,"stem":549,"icon":550},"Configuration","\u002Freference\u002Fconfiguration","7.reference\u002F1.configuration","i-lucide-settings",{"title":383,"path":552,"stem":553,"icon":112},"\u002Freference\u002Fperformance","7.reference\u002F2.performance",{"title":555,"path":556,"stem":557,"icon":558},"Vite Plugin","\u002Freference\u002Fvite-plugin","7.reference\u002F3.vite-plugin","i-custom-vite",{"title":560,"path":561,"stem":562,"icon":388},"Best Practices","\u002Freference\u002Fbest-practices","7.reference\u002F4.best-practices",{"title":564,"path":565,"stem":566,"icon":567},"vs Other Loggers","\u002Freference\u002Fvs-other-loggers","7.reference\u002F5.vs-other-loggers","i-lucide-scale",{"title":569,"path":570,"stem":571,"icon":443},"Agent Skills","\u002Freference\u002Fagent-skills","7.reference\u002F6.agent-skills",{"title":573,"path":574,"stem":575,"icon":576},"Cost","\u002Freference\u002Fcost","7.reference\u002F7.cost","i-lucide-receipt",{"title":578,"path":579,"stem":580,"children":581,"page":34},"Compare","\u002Fcompare","8.compare",[582,586,590,594,598],{"title":583,"path":584,"stem":585,"icon":567},"evlog vs Pino","\u002Fcompare\u002Fpino","8.compare\u002F1.pino",{"title":587,"path":588,"stem":589,"icon":204},"evlog vs OpenTelemetry","\u002Fcompare\u002Fopentelemetry","8.compare\u002F2.opentelemetry",{"title":591,"path":592,"stem":593,"icon":567},"evlog vs LogTape","\u002Fcompare\u002Flogtape","8.compare\u002F3.logtape",{"title":595,"path":596,"stem":597,"icon":567},"evlog vs Winston: formats and request events","\u002Fcompare\u002Fwinston","8.compare\u002F4.winston",{"title":599,"path":600,"stem":601,"icon":567},"evlog vs Consola: reporters and request context","\u002Fcompare\u002Fconsola","8.compare\u002F5.consola",{"id":603,"title":604,"body":605,"description":3479,"extension":3480,"links":3481,"meta":3490,"navigation":3491,"path":197,"seo":3492,"stem":198,"__hash__":3493},"docs\u002F4.integrate\u002Fadapters\u002Fhybrid\u002F02.clickhouse.md","ClickHouse Adapter",{"type":606,"value":607,"toc":3458},"minimark",[608,625,637,687,691,694,737,741,744,986,998,1001,1780,1783,1788,1885,1888,2092,2096,2099,2103,2106,2136,2176,2191,2195,2198,2270,2302,2317,2337,2341,2344,2403,2423,2430,2459,2470,2474,2487,2495,2498,2512,2516,2522,2613,2745,2810,2893,2897,2903,3050,3056,3060,3063,3252,3256,3273,3293,3305,3320,3324,3412,3425,3429,3454],[609,610,611,612,619,620,624],"p",{},"The ClickHouse adapter inserts wide events over the ",[613,614,618],"a",{"href":615,"rel":616},"https:\u002F\u002Fclickhouse.com\u002Fdocs\u002Fen\u002Finterfaces\u002Fhttp",[617],"nofollow","HTTP interface"," in ",[621,622,623],"code",{},"JSONEachRow"," format. It works with a local instance, a self-managed cluster, and ClickHouse Cloud.",[609,626,627,628,632,633,636],{},"The default schema gives you ",[629,630,631],"strong",{},"typed columns"," for the fields you filter and aggregate on, plus the complete wide event as JSON in ",[621,634,635],{},"data",", so no field is ever lost, and adding a field to your events never requires a migration.",[638,639,642,645,675],"prompt",{":actions":640,"description":641,"icon":199},"[\"copy\",\"cursor\",\"claude\"]","Add the ClickHouse drain adapter",[609,643,644],{},"Add the ClickHouse drain adapter to store evlog wide events in ClickHouse.",[646,647,648,652,655,658,661,664,672],"ol",{},[649,650,651],"li",{},"Identify which framework I'm using and follow its evlog integration pattern",[649,653,654],{},"Install evlog if not already installed",[649,656,657],{},"Create the evlog_events table using the CREATE TABLE from the adapter docs",[649,659,660],{},"Import createClickHouseDrain from 'evlog\u002Fclickhouse'",[649,662,663],{},"Wire createClickHouseDrain() into my framework's drain configuration",[649,665,666,667,671],{},"Set CLICKHOUSE_ENDPOINT (e.g. ",[613,668,669],{"href":669,"rel":670},"http:\u002F\u002Flocalhost:8123",[617],"), plus CLICKHOUSE_USER \u002F CLICKHOUSE_PASSWORD if authenticated",[649,673,674],{},"Test by triggering a request and running SELECT * FROM evlog_events ORDER BY timestamp DESC LIMIT 10",[609,676,677,678,682,683],{},"Adapter docs: ",[613,679,680],{"href":680,"rel":681},"https:\u002F\u002Fwww.evlog.dev\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Fclickhouse",[617],"\nFramework setup: ",[613,684,685],{"href":685,"rel":686},"https:\u002F\u002Fwww.evlog.dev\u002Fintegrate\u002Fframeworks\u002Foverview",[617],[688,689,20],"h2",{"id":690},"installation",[609,692,693],{},"The ClickHouse adapter comes bundled with evlog:",[695,696,702],"pre",{"className":697,"code":698,"filename":699,"language":700,"meta":701,"style":701},"language-typescript shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import { createClickHouseDrain } from 'evlog\u002Fclickhouse'\n","src\u002Findex.ts","typescript","",[621,703,704],{"__ignoreMap":701},[705,706,709,713,717,721,724,727,730,734],"span",{"class":707,"line":708},"line",1,[705,710,712],{"class":711},"s7zQu","import",[705,714,716],{"class":715},"sMK4o"," {",[705,718,720],{"class":719},"sTEyZ"," createClickHouseDrain",[705,722,723],{"class":715}," }",[705,725,726],{"class":711}," from",[705,728,729],{"class":715}," '",[705,731,733],{"class":732},"sfazB","evlog\u002Fclickhouse",[705,735,736],{"class":715},"'\n",[688,738,740],{"id":739},"create-the-table","Create the table",[609,742,743],{},"Run this once before wiring the drain:",[695,745,750],{"className":746,"code":747,"filename":748,"language":749,"meta":701,"style":701},"language-sql shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","CREATE TABLE IF NOT EXISTS evlog_events\n(\n  timestamp     DateTime64(3, 'UTC'),\n  level         LowCardinality(String),\n  service       LowCardinality(String),\n  environment   LowCardinality(String),\n  request_id    String,\n  trace_id      String,\n  span_id       String,\n  method        LowCardinality(String),\n  path          String,\n  status        Nullable(UInt16),\n  duration      String,\n  duration_ms   Nullable(UInt32),\n  error_name    String,\n  error_message String,\n  data          String\n)\nENGINE = MergeTree\nPARTITION BY toYYYYMM(timestamp)\nORDER BY (service, environment, timestamp)\nTTL toDateTime(timestamp) + INTERVAL 30 DAY;\n","schema.sql","sql",[621,751,752,774,780,807,816,825,831,837,843,849,855,864,873,879,885,891,897,906,912,924,941,960],{"__ignoreMap":701},[705,753,754,758,761,765,768,771],{"class":707,"line":708},[705,755,757],{"class":756},"sbssI","CREATE",[705,759,760],{"class":756}," TABLE",[705,762,764],{"class":763},"s2Zo4"," IF",[705,766,767],{"class":756}," NOT",[705,769,770],{"class":756}," EXISTS",[705,772,773],{"class":719}," evlog_events\n",[705,775,777],{"class":707,"line":776},2,[705,778,779],{"class":719},"(\n",[705,781,783,787,790,793,796,799,802,804],{"class":707,"line":782},3,[705,784,786],{"class":785},"spNyl","  timestamp",[705,788,789],{"class":719},"     DateTime64(",[705,791,792],{"class":756},"3",[705,794,795],{"class":719},", ",[705,797,798],{"class":715},"'",[705,800,801],{"class":732},"UTC",[705,803,798],{"class":715},[705,805,806],{"class":719},"),\n",[705,808,810,813],{"class":707,"line":809},4,[705,811,812],{"class":756},"  level",[705,814,815],{"class":719},"         LowCardinality(String),\n",[705,817,819,822],{"class":707,"line":818},5,[705,820,821],{"class":756},"  service",[705,823,824],{"class":719},"       LowCardinality(String),\n",[705,826,828],{"class":707,"line":827},6,[705,829,830],{"class":719},"  environment   LowCardinality(String),\n",[705,832,834],{"class":707,"line":833},7,[705,835,836],{"class":719},"  request_id    String,\n",[705,838,840],{"class":707,"line":839},8,[705,841,842],{"class":719},"  trace_id      String,\n",[705,844,846],{"class":707,"line":845},9,[705,847,848],{"class":719},"  span_id       String,\n",[705,850,852],{"class":707,"line":851},10,[705,853,854],{"class":719},"  method        LowCardinality(String),\n",[705,856,858,861],{"class":707,"line":857},11,[705,859,860],{"class":785},"  path",[705,862,863],{"class":719},"          String,\n",[705,865,867,870],{"class":707,"line":866},12,[705,868,869],{"class":756},"  status",[705,871,872],{"class":719},"        Nullable(UInt16),\n",[705,874,876],{"class":707,"line":875},13,[705,877,878],{"class":719},"  duration      String,\n",[705,880,882],{"class":707,"line":881},14,[705,883,884],{"class":719},"  duration_ms   Nullable(UInt32),\n",[705,886,888],{"class":707,"line":887},15,[705,889,890],{"class":719},"  error_name    String,\n",[705,892,894],{"class":707,"line":893},16,[705,895,896],{"class":719},"  error_message String,\n",[705,898,900,903],{"class":707,"line":899},17,[705,901,902],{"class":756},"  data",[705,904,905],{"class":719},"          String\n",[705,907,909],{"class":707,"line":908},18,[705,910,911],{"class":719},")\n",[705,913,915,918,921],{"class":707,"line":914},19,[705,916,917],{"class":719},"ENGINE ",[705,919,920],{"class":715},"=",[705,922,923],{"class":719}," MergeTree\n",[705,925,927,930,933,936,939],{"class":707,"line":926},20,[705,928,929],{"class":756},"PARTITION",[705,931,932],{"class":756}," BY",[705,934,935],{"class":719}," toYYYYMM(",[705,937,938],{"class":785},"timestamp",[705,940,911],{"class":719},[705,942,944,947,950,953,956,958],{"class":707,"line":943},21,[705,945,946],{"class":756},"ORDER BY",[705,948,949],{"class":719}," (",[705,951,952],{"class":756},"service",[705,954,955],{"class":719},", environment, ",[705,957,938],{"class":785},[705,959,911],{"class":719},[705,961,963,966,968,971,974,977,980,983],{"class":707,"line":962},22,[705,964,965],{"class":719},"TTL toDateTime(",[705,967,938],{"class":785},[705,969,970],{"class":719},") ",[705,972,973],{"class":715},"+",[705,975,976],{"class":719}," INTERVAL ",[705,978,979],{"class":756},"30",[705,981,982],{"class":756}," DAY",[705,984,985],{"class":719},";\n",[987,988,990,993,994,997],"callout",{"color":989,"icon":13},"info",[621,991,992],{},"ORDER BY (service, environment, timestamp)"," matches how you'll filter most often. Adjust the ",[621,995,996],{},"TTL"," to your retention policy, and drop the clause entirely to keep events forever.",[688,999,25],{"id":1000},"quick-start",[1002,1003,1004,1110,1231,1335,1442,1547,1682],"code-group",{},[695,1005,1008],{"className":697,"code":1006,"filename":1007,"language":700,"meta":701,"style":701},"\u002F\u002F server\u002Fplugins\u002Fevlog.ts\nimport { createClickHouseDrain } from 'evlog\u002Fclickhouse'\n\nexport default defineNitroPlugin((nitroApp) => {\n  nitroApp.hooks.hook('evlog:drain', createClickHouseDrain())\n})\n","Nuxt \u002F Nitro",[621,1009,1010,1016,1034,1040,1069,1103],{"__ignoreMap":701},[705,1011,1012],{"class":707,"line":708},[705,1013,1015],{"class":1014},"sHwdD","\u002F\u002F server\u002Fplugins\u002Fevlog.ts\n",[705,1017,1018,1020,1022,1024,1026,1028,1030,1032],{"class":707,"line":776},[705,1019,712],{"class":711},[705,1021,716],{"class":715},[705,1023,720],{"class":719},[705,1025,723],{"class":715},[705,1027,726],{"class":711},[705,1029,729],{"class":715},[705,1031,733],{"class":732},[705,1033,736],{"class":715},[705,1035,1036],{"class":707,"line":782},[705,1037,1039],{"emptyLinePlaceholder":1038},true,"\n",[705,1041,1042,1045,1048,1051,1054,1056,1060,1063,1066],{"class":707,"line":809},[705,1043,1044],{"class":711},"export",[705,1046,1047],{"class":711}," default",[705,1049,1050],{"class":763}," defineNitroPlugin",[705,1052,1053],{"class":719},"(",[705,1055,1053],{"class":715},[705,1057,1059],{"class":1058},"sHdIc","nitroApp",[705,1061,1062],{"class":715},")",[705,1064,1065],{"class":785}," =>",[705,1067,1068],{"class":715}," {\n",[705,1070,1071,1074,1077,1080,1082,1085,1088,1090,1093,1095,1098,1100],{"class":707,"line":818},[705,1072,1073],{"class":719},"  nitroApp",[705,1075,1076],{"class":715},".",[705,1078,1079],{"class":719},"hooks",[705,1081,1076],{"class":715},[705,1083,1084],{"class":763},"hook",[705,1086,1053],{"class":1087},"swJcz",[705,1089,798],{"class":715},[705,1091,1092],{"class":732},"evlog:drain",[705,1094,798],{"class":715},[705,1096,1097],{"class":715},",",[705,1099,720],{"class":763},[705,1101,1102],{"class":1087},"())\n",[705,1104,1105,1108],{"class":707,"line":827},[705,1106,1107],{"class":715},"}",[705,1109,911],{"class":719},[695,1111,1113],{"className":697,"code":1112,"filename":275,"language":700,"meta":701,"style":701},"import { Hono } from 'hono'\nimport { evlog } from 'evlog\u002Fhono'\nimport { createClickHouseDrain } from 'evlog\u002Fclickhouse'\n\nconst app = new Hono()\napp.use(evlog({ drain: createClickHouseDrain() }))\n",[621,1114,1115,1135,1155,1173,1177,1195],{"__ignoreMap":701},[705,1116,1117,1119,1121,1124,1126,1128,1130,1133],{"class":707,"line":708},[705,1118,712],{"class":711},[705,1120,716],{"class":715},[705,1122,1123],{"class":719}," Hono",[705,1125,723],{"class":715},[705,1127,726],{"class":711},[705,1129,729],{"class":715},[705,1131,1132],{"class":732},"hono",[705,1134,736],{"class":715},[705,1136,1137,1139,1141,1144,1146,1148,1150,1153],{"class":707,"line":776},[705,1138,712],{"class":711},[705,1140,716],{"class":715},[705,1142,1143],{"class":719}," evlog",[705,1145,723],{"class":715},[705,1147,726],{"class":711},[705,1149,729],{"class":715},[705,1151,1152],{"class":732},"evlog\u002Fhono",[705,1154,736],{"class":715},[705,1156,1157,1159,1161,1163,1165,1167,1169,1171],{"class":707,"line":782},[705,1158,712],{"class":711},[705,1160,716],{"class":715},[705,1162,720],{"class":719},[705,1164,723],{"class":715},[705,1166,726],{"class":711},[705,1168,729],{"class":715},[705,1170,733],{"class":732},[705,1172,736],{"class":715},[705,1174,1175],{"class":707,"line":809},[705,1176,1039],{"emptyLinePlaceholder":1038},[705,1178,1179,1182,1185,1187,1190,1192],{"class":707,"line":818},[705,1180,1181],{"class":785},"const",[705,1183,1184],{"class":719}," app ",[705,1186,920],{"class":715},[705,1188,1189],{"class":715}," new",[705,1191,1123],{"class":763},[705,1193,1194],{"class":719},"()\n",[705,1196,1197,1200,1202,1205,1207,1210,1212,1215,1218,1221,1223,1226,1228],{"class":707,"line":827},[705,1198,1199],{"class":719},"app",[705,1201,1076],{"class":715},[705,1203,1204],{"class":763},"use",[705,1206,1053],{"class":719},[705,1208,1209],{"class":763},"evlog",[705,1211,1053],{"class":719},[705,1213,1214],{"class":715},"{",[705,1216,1217],{"class":1087}," drain",[705,1219,1220],{"class":715},":",[705,1222,720],{"class":763},[705,1224,1225],{"class":719},"() ",[705,1227,1107],{"class":715},[705,1229,1230],{"class":719},"))\n",[695,1232,1234],{"className":697,"code":1233,"filename":270,"language":700,"meta":701,"style":701},"import express from 'express'\nimport { evlog } from 'evlog\u002Fexpress'\nimport { createClickHouseDrain } from 'evlog\u002Fclickhouse'\n\nconst app = express()\napp.use(evlog({ drain: createClickHouseDrain() }))\n",[621,1235,1236,1253,1272,1290,1294,1307],{"__ignoreMap":701},[705,1237,1238,1240,1243,1246,1248,1251],{"class":707,"line":708},[705,1239,712],{"class":711},[705,1241,1242],{"class":719}," express ",[705,1244,1245],{"class":711},"from",[705,1247,729],{"class":715},[705,1249,1250],{"class":732},"express",[705,1252,736],{"class":715},[705,1254,1255,1257,1259,1261,1263,1265,1267,1270],{"class":707,"line":776},[705,1256,712],{"class":711},[705,1258,716],{"class":715},[705,1260,1143],{"class":719},[705,1262,723],{"class":715},[705,1264,726],{"class":711},[705,1266,729],{"class":715},[705,1268,1269],{"class":732},"evlog\u002Fexpress",[705,1271,736],{"class":715},[705,1273,1274,1276,1278,1280,1282,1284,1286,1288],{"class":707,"line":782},[705,1275,712],{"class":711},[705,1277,716],{"class":715},[705,1279,720],{"class":719},[705,1281,723],{"class":715},[705,1283,726],{"class":711},[705,1285,729],{"class":715},[705,1287,733],{"class":732},[705,1289,736],{"class":715},[705,1291,1292],{"class":707,"line":809},[705,1293,1039],{"emptyLinePlaceholder":1038},[705,1295,1296,1298,1300,1302,1305],{"class":707,"line":818},[705,1297,1181],{"class":785},[705,1299,1184],{"class":719},[705,1301,920],{"class":715},[705,1303,1304],{"class":763}," express",[705,1306,1194],{"class":719},[705,1308,1309,1311,1313,1315,1317,1319,1321,1323,1325,1327,1329,1331,1333],{"class":707,"line":827},[705,1310,1199],{"class":719},[705,1312,1076],{"class":715},[705,1314,1204],{"class":763},[705,1316,1053],{"class":719},[705,1318,1209],{"class":763},[705,1320,1053],{"class":719},[705,1322,1214],{"class":715},[705,1324,1217],{"class":1087},[705,1326,1220],{"class":715},[705,1328,720],{"class":763},[705,1330,1225],{"class":719},[705,1332,1107],{"class":715},[705,1334,1230],{"class":719},[695,1336,1338],{"className":697,"code":1337,"filename":280,"language":700,"meta":701,"style":701},"import Fastify from 'fastify'\nimport { evlog } from 'evlog\u002Ffastify'\nimport { createClickHouseDrain } from 'evlog\u002Fclickhouse'\n\nconst app = Fastify()\nawait app.register(evlog, { drain: createClickHouseDrain() })\n",[621,1339,1340,1356,1375,1393,1397,1410],{"__ignoreMap":701},[705,1341,1342,1344,1347,1349,1351,1354],{"class":707,"line":708},[705,1343,712],{"class":711},[705,1345,1346],{"class":719}," Fastify ",[705,1348,1245],{"class":711},[705,1350,729],{"class":715},[705,1352,1353],{"class":732},"fastify",[705,1355,736],{"class":715},[705,1357,1358,1360,1362,1364,1366,1368,1370,1373],{"class":707,"line":776},[705,1359,712],{"class":711},[705,1361,716],{"class":715},[705,1363,1143],{"class":719},[705,1365,723],{"class":715},[705,1367,726],{"class":711},[705,1369,729],{"class":715},[705,1371,1372],{"class":732},"evlog\u002Ffastify",[705,1374,736],{"class":715},[705,1376,1377,1379,1381,1383,1385,1387,1389,1391],{"class":707,"line":782},[705,1378,712],{"class":711},[705,1380,716],{"class":715},[705,1382,720],{"class":719},[705,1384,723],{"class":715},[705,1386,726],{"class":711},[705,1388,729],{"class":715},[705,1390,733],{"class":732},[705,1392,736],{"class":715},[705,1394,1395],{"class":707,"line":809},[705,1396,1039],{"emptyLinePlaceholder":1038},[705,1398,1399,1401,1403,1405,1408],{"class":707,"line":818},[705,1400,1181],{"class":785},[705,1402,1184],{"class":719},[705,1404,920],{"class":715},[705,1406,1407],{"class":763}," Fastify",[705,1409,1194],{"class":719},[705,1411,1412,1415,1418,1420,1423,1426,1428,1430,1432,1434,1436,1438,1440],{"class":707,"line":827},[705,1413,1414],{"class":711},"await",[705,1416,1417],{"class":719}," app",[705,1419,1076],{"class":715},[705,1421,1422],{"class":763},"register",[705,1424,1425],{"class":719},"(evlog",[705,1427,1097],{"class":715},[705,1429,716],{"class":715},[705,1431,1217],{"class":1087},[705,1433,1220],{"class":715},[705,1435,720],{"class":763},[705,1437,1225],{"class":719},[705,1439,1107],{"class":715},[705,1441,911],{"class":719},[695,1443,1445],{"className":697,"code":1444,"filename":285,"language":700,"meta":701,"style":701},"import { Elysia } from 'elysia'\nimport { evlog } from 'evlog\u002Felysia'\nimport { createClickHouseDrain } from 'evlog\u002Fclickhouse'\n\nconst app = new Elysia().use(evlog({ drain: createClickHouseDrain() }))\n",[621,1446,1447,1467,1486,1504,1508],{"__ignoreMap":701},[705,1448,1449,1451,1453,1456,1458,1460,1462,1465],{"class":707,"line":708},[705,1450,712],{"class":711},[705,1452,716],{"class":715},[705,1454,1455],{"class":719}," Elysia",[705,1457,723],{"class":715},[705,1459,726],{"class":711},[705,1461,729],{"class":715},[705,1463,1464],{"class":732},"elysia",[705,1466,736],{"class":715},[705,1468,1469,1471,1473,1475,1477,1479,1481,1484],{"class":707,"line":776},[705,1470,712],{"class":711},[705,1472,716],{"class":715},[705,1474,1143],{"class":719},[705,1476,723],{"class":715},[705,1478,726],{"class":711},[705,1480,729],{"class":715},[705,1482,1483],{"class":732},"evlog\u002Felysia",[705,1485,736],{"class":715},[705,1487,1488,1490,1492,1494,1496,1498,1500,1502],{"class":707,"line":782},[705,1489,712],{"class":711},[705,1491,716],{"class":715},[705,1493,720],{"class":719},[705,1495,723],{"class":715},[705,1497,726],{"class":711},[705,1499,729],{"class":715},[705,1501,733],{"class":732},[705,1503,736],{"class":715},[705,1505,1506],{"class":707,"line":809},[705,1507,1039],{"emptyLinePlaceholder":1038},[705,1509,1510,1512,1514,1516,1518,1520,1523,1525,1527,1529,1531,1533,1535,1537,1539,1541,1543,1545],{"class":707,"line":818},[705,1511,1181],{"class":785},[705,1513,1184],{"class":719},[705,1515,920],{"class":715},[705,1517,1189],{"class":715},[705,1519,1455],{"class":763},[705,1521,1522],{"class":719},"()",[705,1524,1076],{"class":715},[705,1526,1204],{"class":763},[705,1528,1053],{"class":719},[705,1530,1209],{"class":763},[705,1532,1053],{"class":719},[705,1534,1214],{"class":715},[705,1536,1217],{"class":1087},[705,1538,1220],{"class":715},[705,1540,720],{"class":763},[705,1542,1225],{"class":719},[705,1544,1107],{"class":715},[705,1546,1230],{"class":719},[695,1548,1550],{"className":697,"code":1549,"filename":265,"language":700,"meta":701,"style":701},"import { Module } from '@nestjs\u002Fcommon'\nimport { EvlogModule } from 'evlog\u002Fnestjs'\nimport { createClickHouseDrain } from 'evlog\u002Fclickhouse'\n\n@Module({\n  imports: [EvlogModule.forRoot({ drain: createClickHouseDrain() })],\n})\nexport class AppModule {}\n",[621,1551,1552,1572,1592,1610,1614,1627,1662,1668],{"__ignoreMap":701},[705,1553,1554,1556,1558,1561,1563,1565,1567,1570],{"class":707,"line":708},[705,1555,712],{"class":711},[705,1557,716],{"class":715},[705,1559,1560],{"class":719}," Module",[705,1562,723],{"class":715},[705,1564,726],{"class":711},[705,1566,729],{"class":715},[705,1568,1569],{"class":732},"@nestjs\u002Fcommon",[705,1571,736],{"class":715},[705,1573,1574,1576,1578,1581,1583,1585,1587,1590],{"class":707,"line":776},[705,1575,712],{"class":711},[705,1577,716],{"class":715},[705,1579,1580],{"class":719}," EvlogModule",[705,1582,723],{"class":715},[705,1584,726],{"class":711},[705,1586,729],{"class":715},[705,1588,1589],{"class":732},"evlog\u002Fnestjs",[705,1591,736],{"class":715},[705,1593,1594,1596,1598,1600,1602,1604,1606,1608],{"class":707,"line":782},[705,1595,712],{"class":711},[705,1597,716],{"class":715},[705,1599,720],{"class":719},[705,1601,723],{"class":715},[705,1603,726],{"class":711},[705,1605,729],{"class":715},[705,1607,733],{"class":732},[705,1609,736],{"class":715},[705,1611,1612],{"class":707,"line":809},[705,1613,1039],{"emptyLinePlaceholder":1038},[705,1615,1616,1619,1622,1624],{"class":707,"line":818},[705,1617,1618],{"class":715},"@",[705,1620,1621],{"class":763},"Module",[705,1623,1053],{"class":719},[705,1625,1626],{"class":715},"{\n",[705,1628,1629,1632,1634,1637,1639,1642,1644,1646,1648,1650,1652,1654,1656,1659],{"class":707,"line":827},[705,1630,1631],{"class":1087},"  imports",[705,1633,1220],{"class":715},[705,1635,1636],{"class":719}," [EvlogModule",[705,1638,1076],{"class":715},[705,1640,1641],{"class":763},"forRoot",[705,1643,1053],{"class":719},[705,1645,1214],{"class":715},[705,1647,1217],{"class":1087},[705,1649,1220],{"class":715},[705,1651,720],{"class":763},[705,1653,1225],{"class":719},[705,1655,1107],{"class":715},[705,1657,1658],{"class":719},")]",[705,1660,1661],{"class":715},",\n",[705,1663,1664,1666],{"class":707,"line":833},[705,1665,1107],{"class":715},[705,1667,911],{"class":719},[705,1669,1670,1672,1675,1679],{"class":707,"line":839},[705,1671,1044],{"class":711},[705,1673,1674],{"class":785}," class",[705,1676,1678],{"class":1677},"sBMFI"," AppModule",[705,1680,1681],{"class":715}," {}\n",[695,1683,1685],{"className":697,"code":1684,"filename":300,"language":700,"meta":701,"style":701},"import { initLogger } from 'evlog'\nimport { createClickHouseDrain } from 'evlog\u002Fclickhouse'\n\ninitLogger({\n  env: { service: 'my-app' },\n  drain: createClickHouseDrain(),\n})\n",[621,1686,1687,1706,1724,1728,1737,1761,1774],{"__ignoreMap":701},[705,1688,1689,1691,1693,1696,1698,1700,1702,1704],{"class":707,"line":708},[705,1690,712],{"class":711},[705,1692,716],{"class":715},[705,1694,1695],{"class":719}," initLogger",[705,1697,723],{"class":715},[705,1699,726],{"class":711},[705,1701,729],{"class":715},[705,1703,1209],{"class":732},[705,1705,736],{"class":715},[705,1707,1708,1710,1712,1714,1716,1718,1720,1722],{"class":707,"line":776},[705,1709,712],{"class":711},[705,1711,716],{"class":715},[705,1713,720],{"class":719},[705,1715,723],{"class":715},[705,1717,726],{"class":711},[705,1719,729],{"class":715},[705,1721,733],{"class":732},[705,1723,736],{"class":715},[705,1725,1726],{"class":707,"line":782},[705,1727,1039],{"emptyLinePlaceholder":1038},[705,1729,1730,1733,1735],{"class":707,"line":809},[705,1731,1732],{"class":763},"initLogger",[705,1734,1053],{"class":719},[705,1736,1626],{"class":715},[705,1738,1739,1742,1744,1746,1749,1751,1753,1756,1758],{"class":707,"line":818},[705,1740,1741],{"class":1087},"  env",[705,1743,1220],{"class":715},[705,1745,716],{"class":715},[705,1747,1748],{"class":1087}," service",[705,1750,1220],{"class":715},[705,1752,729],{"class":715},[705,1754,1755],{"class":732},"my-app",[705,1757,798],{"class":715},[705,1759,1760],{"class":715}," },\n",[705,1762,1763,1766,1768,1770,1772],{"class":707,"line":827},[705,1764,1765],{"class":1087},"  drain",[705,1767,1220],{"class":715},[705,1769,720],{"class":763},[705,1771,1522],{"class":719},[705,1773,1661],{"class":715},[705,1775,1776,1778],{"class":707,"line":833},[705,1777,1107],{"class":715},[705,1779,911],{"class":719},[688,1781,547],{"id":1782},"configuration",[1784,1785,1787],"h3",{"id":1786},"environment-variables","Environment variables",[1789,1790,1791,1807],"table",{},[1792,1793,1794],"thead",{},[1795,1796,1797,1801,1804],"tr",{},[1798,1799,1800],"th",{},"Variable",[1798,1802,1803],{},"Required",[1798,1805,1806],{},"Description",[1808,1809,1810,1828,1844,1856,1870],"tbody",{},[1795,1811,1812,1818,1821],{},[1813,1814,1815],"td",{},[621,1816,1817],{},"CLICKHOUSE_ENDPOINT",[1813,1819,1820],{},"Yes",[1813,1822,1823,1824,1827],{},"HTTP interface URL (",[621,1825,1826],{},"CLICKHOUSE_URL"," also accepted)",[1795,1829,1830,1835,1838],{},[1813,1831,1832],{},[621,1833,1834],{},"CLICKHOUSE_USER",[1813,1836,1837],{},"No",[1813,1839,1840,1841],{},"Username. Default ",[621,1842,1843],{},"default",[1795,1845,1846,1851,1853],{},[1813,1847,1848],{},[621,1849,1850],{},"CLICKHOUSE_PASSWORD",[1813,1852,1837],{},[1813,1854,1855],{},"Password. Omit for an unauthenticated local instance",[1795,1857,1858,1863,1865],{},[1813,1859,1860],{},[621,1861,1862],{},"CLICKHOUSE_DATABASE",[1813,1864,1837],{},[1813,1866,1867,1868],{},"Database. Default ",[621,1869,1843],{},[1795,1871,1872,1877,1879],{},[1813,1873,1874],{},[621,1875,1876],{},"CLICKHOUSE_TABLE",[1813,1878,1837],{},[1813,1880,1881,1882],{},"Table. Default ",[621,1883,1884],{},"evlog_events",[1784,1886,346],{"id":1887},"options",[1789,1889,1890,1905],{},[1792,1891,1892],{},[1795,1893,1894,1897,1900,1903],{},[1798,1895,1896],{},"Option",[1798,1898,1899],{},"Type",[1798,1901,1902],{},"Default",[1798,1904,1806],{},[1808,1906,1907,1925,1943,1960,1978,1994,2014,2033,2053,2073],{},[1795,1908,1909,1914,1919,1922],{},[1813,1910,1911],{},[621,1912,1913],{},"endpoint",[1813,1915,1916],{},[621,1917,1918],{},"string",[1813,1920,1921],{},"—",[1813,1923,1924],{},"HTTP interface URL",[1795,1926,1927,1932,1936,1940],{},[1813,1928,1929],{},[621,1930,1931],{},"database",[1813,1933,1934],{},[621,1935,1918],{},[1813,1937,1938],{},[621,1939,1843],{},[1813,1941,1942],{},"Target database",[1795,1944,1945,1949,1953,1957],{},[1813,1946,1947],{},[621,1948,1789],{},[1813,1950,1951],{},[621,1952,1918],{},[1813,1954,1955],{},[621,1956,1884],{},[1813,1958,1959],{},"Target table",[1795,1961,1962,1967,1971,1975],{},[1813,1963,1964],{},[621,1965,1966],{},"username",[1813,1968,1969],{},[621,1970,1918],{},[1813,1972,1973],{},[621,1974,1843],{},[1813,1976,1977],{},"Username",[1795,1979,1980,1985,1989,1991],{},[1813,1981,1982],{},[621,1983,1984],{},"password",[1813,1986,1987],{},[621,1988,1918],{},[1813,1990,1921],{},[1813,1992,1993],{},"Password",[1795,1995,1996,2001,2006,2011],{},[1813,1997,1998],{},[621,1999,2000],{},"asyncInsert",[1813,2002,2003],{},[621,2004,2005],{},"boolean",[1813,2007,2008],{},[621,2009,2010],{},"true",[1813,2012,2013],{},"Batch inserts server-side",[1795,2015,2016,2021,2025,2030],{},[1813,2017,2018],{},[621,2019,2020],{},"waitForAsyncInsert",[1813,2022,2023],{},[621,2024,2005],{},[1813,2026,2027],{},[621,2028,2029],{},"false",[1813,2031,2032],{},"Wait for the flush before responding",[1795,2034,2035,2040,2045,2050],{},[1813,2036,2037],{},[621,2038,2039],{},"transform",[1813,2041,2042],{},[621,2043,2044],{},"(event) => Record\u003Cstring, unknown>",[1813,2046,2047],{},[621,2048,2049],{},"toClickHouseRow",[1813,2051,2052],{},"Map an event to a row",[1795,2054,2055,2060,2065,2070],{},[1813,2056,2057],{},[621,2058,2059],{},"timeout",[1813,2061,2062],{},[621,2063,2064],{},"number",[1813,2066,2067],{},[621,2068,2069],{},"5000",[1813,2071,2072],{},"Request timeout in ms",[1795,2074,2075,2080,2084,2089],{},[1813,2076,2077],{},[621,2078,2079],{},"retries",[1813,2081,2082],{},[621,2083,2064],{},[1813,2085,2086],{},[621,2087,2088],{},"2",[1813,2090,2091],{},"Retry attempts",[688,2093,2095],{"id":2094},"deployment","Deployment",[609,2097,2098],{},"The adapter is identical either way. Only the endpoint and credentials change.",[1784,2100,2102],{"id":2101},"self-hosted","Self-hosted",[609,2104,2105],{},"A local or self-managed instance, with or without auth:",[695,2107,2110],{"className":697,"code":2108,"filename":2109,"language":700,"meta":701,"style":701},"createClickHouseDrain({ endpoint: 'http:\u002F\u002Flocalhost:8123' })\n","server\u002Fplugins\u002Fevlog.ts",[621,2111,2112],{"__ignoreMap":701},[705,2113,2114,2117,2119,2121,2124,2126,2128,2130,2132,2134],{"class":707,"line":708},[705,2115,2116],{"class":763},"createClickHouseDrain",[705,2118,1053],{"class":719},[705,2120,1214],{"class":715},[705,2122,2123],{"class":1087}," endpoint",[705,2125,1220],{"class":715},[705,2127,729],{"class":715},[705,2129,669],{"class":732},[705,2131,798],{"class":715},[705,2133,723],{"class":715},[705,2135,911],{"class":719},[695,2137,2142],{"className":2138,"code":2139,"filename":2140,"language":2141,"meta":701,"style":701},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","CLICKHOUSE_ENDPOINT=http:\u002F\u002Flocalhost:8123\n# Only if your instance requires auth:\nCLICKHOUSE_USER=evlog\nCLICKHOUSE_PASSWORD=your-password\n",".env","bash",[621,2143,2144,2153,2158,2167],{"__ignoreMap":701},[705,2145,2146,2148,2150],{"class":707,"line":708},[705,2147,1817],{"class":719},[705,2149,920],{"class":715},[705,2151,2152],{"class":732},"http:\u002F\u002Flocalhost:8123\n",[705,2154,2155],{"class":707,"line":776},[705,2156,2157],{"class":1014},"# Only if your instance requires auth:\n",[705,2159,2160,2162,2164],{"class":707,"line":782},[705,2161,1834],{"class":719},[705,2163,920],{"class":715},[705,2165,2166],{"class":732},"evlog\n",[705,2168,2169,2171,2173],{"class":707,"line":809},[705,2170,1850],{"class":719},[705,2172,920],{"class":715},[705,2174,2175],{"class":732},"your-password\n",[609,2177,2178,2179,2181,2182,2184,2185,2187,2188,2190],{},"A fresh container runs as ",[621,2180,1843],{}," with no password, which is why ",[621,2183,1966],{},"\ndefaults to ",[621,2186,1843],{}," and ",[621,2189,1984],{}," is optional.",[1784,2192,2194],{"id":2193},"clickhouse-cloud","ClickHouse Cloud",[609,2196,2197],{},"Cloud services always require credentials and speak HTTPS on port 8443:",[695,2199,2201],{"className":697,"code":2200,"filename":2109,"language":700,"meta":701,"style":701},"createClickHouseDrain({\n  endpoint: 'https:\u002F\u002Fabc123.eu-west-1.aws.clickhouse.cloud:8443',\n  password: process.env.CLICKHOUSE_PASSWORD,\n  database: 'logs',\n})\n",[621,2202,2203,2211,2227,2248,2264],{"__ignoreMap":701},[705,2204,2205,2207,2209],{"class":707,"line":708},[705,2206,2116],{"class":763},[705,2208,1053],{"class":719},[705,2210,1626],{"class":715},[705,2212,2213,2216,2218,2220,2223,2225],{"class":707,"line":776},[705,2214,2215],{"class":1087},"  endpoint",[705,2217,1220],{"class":715},[705,2219,729],{"class":715},[705,2221,2222],{"class":732},"https:\u002F\u002Fabc123.eu-west-1.aws.clickhouse.cloud:8443",[705,2224,798],{"class":715},[705,2226,1661],{"class":715},[705,2228,2229,2232,2234,2237,2239,2242,2244,2246],{"class":707,"line":782},[705,2230,2231],{"class":1087},"  password",[705,2233,1220],{"class":715},[705,2235,2236],{"class":719}," process",[705,2238,1076],{"class":715},[705,2240,2241],{"class":719},"env",[705,2243,1076],{"class":715},[705,2245,1850],{"class":719},[705,2247,1661],{"class":715},[705,2249,2250,2253,2255,2257,2260,2262],{"class":707,"line":809},[705,2251,2252],{"class":1087},"  database",[705,2254,1220],{"class":715},[705,2256,729],{"class":715},[705,2258,2259],{"class":732},"logs",[705,2261,798],{"class":715},[705,2263,1661],{"class":715},[705,2265,2266,2268],{"class":707,"line":818},[705,2267,1107],{"class":715},[705,2269,911],{"class":719},[695,2271,2273],{"className":2138,"code":2272,"filename":2140,"language":2141,"meta":701,"style":701},"CLICKHOUSE_ENDPOINT=https:\u002F\u002Fabc123.eu-west-1.aws.clickhouse.cloud:8443\nCLICKHOUSE_PASSWORD=your-service-password\nCLICKHOUSE_DATABASE=logs\n",[621,2274,2275,2284,2293],{"__ignoreMap":701},[705,2276,2277,2279,2281],{"class":707,"line":708},[705,2278,1817],{"class":719},[705,2280,920],{"class":715},[705,2282,2283],{"class":732},"https:\u002F\u002Fabc123.eu-west-1.aws.clickhouse.cloud:8443\n",[705,2285,2286,2288,2290],{"class":707,"line":776},[705,2287,1850],{"class":719},[705,2289,920],{"class":715},[705,2291,2292],{"class":732},"your-service-password\n",[705,2294,2295,2297,2299],{"class":707,"line":782},[705,2296,1862],{"class":719},[705,2298,920],{"class":715},[705,2300,2301],{"class":732},"logs\n",[987,2303,2304,2305,2309,2310,2313,2314,2316],{"color":989,"icon":13},"Copy the endpoint from ",[2306,2307,2308],"em",{},"Connect → HTTPS"," in the ClickHouse Cloud console,\nincluding the ",[621,2311,2312],{},":8443"," port. Cloud services idle-suspend, so the first insert\nafter a pause can take a few seconds; raise ",[621,2315,2059],{}," if you see aborts.",[987,2318,2320,2321,2324,2325,2328,2329,2332,2333,2336],{"color":2319,"icon":388},"success","Credentials are sent as ",[621,2322,2323],{},"X-ClickHouse-User"," \u002F ",[621,2326,2327],{},"X-ClickHouse-Key"," ",[629,2330,2331],{},"headers",",\nnever as query parameters, so they never reach ",[621,2334,2335],{},"system.query_log"," or an\nintermediate proxy's access log.",[688,2338,2340],{"id":2339},"verify-it-locally","Verify it locally",[609,2342,2343],{},"Spin up ClickHouse in Docker, create the table and push a real event:",[695,2345,2348],{"className":2138,"code":2346,"filename":2347,"language":2141,"meta":701,"style":701},"docker compose -f packages\u002Fevlog\u002Ftest\u002Fe2e\u002Fdocker-compose.yml up -d\nCLICKHOUSE_ENDPOINT=http:\u002F\u002Flocalhost:8123 pnpm run test:e2e\ndocker compose -f packages\u002Fevlog\u002Ftest\u002Fe2e\u002Fdocker-compose.yml down -v\n","Terminal",[621,2349,2350,2370,2387],{"__ignoreMap":701},[705,2351,2352,2355,2358,2361,2364,2367],{"class":707,"line":708},[705,2353,2354],{"class":1677},"docker",[705,2356,2357],{"class":732}," compose",[705,2359,2360],{"class":732}," -f",[705,2362,2363],{"class":732}," packages\u002Fevlog\u002Ftest\u002Fe2e\u002Fdocker-compose.yml",[705,2365,2366],{"class":732}," up",[705,2368,2369],{"class":732}," -d\n",[705,2371,2372,2374,2376,2378,2381,2384],{"class":707,"line":776},[705,2373,1817],{"class":719},[705,2375,920],{"class":715},[705,2377,669],{"class":732},[705,2379,2380],{"class":1677}," pnpm",[705,2382,2383],{"class":732}," run",[705,2385,2386],{"class":732}," test:e2e\n",[705,2388,2389,2391,2393,2395,2397,2400],{"class":707,"line":782},[705,2390,2354],{"class":1677},[705,2392,2357],{"class":732},[705,2394,2360],{"class":732},[705,2396,2363],{"class":732},[705,2398,2399],{"class":732}," down",[705,2401,2402],{"class":732}," -v\n",[609,2404,2405,2406,2409,2410,2413,2414,2416,2417,2419,2420,2422],{},"The suite is a ",[629,2407,2408],{},"round-trip",": it inserts events, reads them back with\n",[621,2411,2412],{},"SELECT",", and asserts the typed columns and the ",[621,2415,635],{}," JSON survived. The\ncompose file creates ",[621,2418,1884],{}," from the schema above on first boot.\nWithout ",[621,2421,1817],{}," it skips itself with a visible label.",[609,2424,2425,2426,2429],{},"To ",[2306,2427,2428],{},"see"," the events rather than assert on them, seed the sandbox and open the\nprovisioned dashboard. The stack ships a Grafana with the ClickHouse\ndatasource already wired up:",[695,2431,2433],{"className":2138,"code":2432,"filename":2347,"language":2141,"meta":701,"style":701},"pnpm run sandbox:up\npnpm run sandbox:seed\n# → http:\u002F\u002Flocalhost:3001\u002Fd\u002Fevlog-wide-events\n",[621,2434,2435,2445,2454],{"__ignoreMap":701},[705,2436,2437,2440,2442],{"class":707,"line":708},[705,2438,2439],{"class":1677},"pnpm",[705,2441,2383],{"class":732},[705,2443,2444],{"class":732}," sandbox:up\n",[705,2446,2447,2449,2451],{"class":707,"line":776},[705,2448,2439],{"class":1677},[705,2450,2383],{"class":732},[705,2452,2453],{"class":732}," sandbox:seed\n",[705,2455,2456],{"class":707,"line":782},[705,2457,2458],{"class":1014},"# → http:\u002F\u002Flocalhost:3001\u002Fd\u002Fevlog-wide-events\n",[609,2460,2461,2462,2465,2466,2469],{},"ClickHouse's built-in ",[621,2463,2464],{},"\u002Fplay"," page at ",[621,2467,2468],{},"http:\u002F\u002Flocalhost:8123\u002Fplay"," also works\nfor raw SQL, but it is deliberately minimal, and the dashboard is the better\nstarting point.",[688,2471,2473],{"id":2472},"async-inserts","Async inserts",[609,2475,2476,2477,2482,2483,2486],{},"Log ingestion means many small inserts, and one MergeTree part per request would quickly degrade a table. The adapter therefore enables ",[613,2478,2481],{"href":2479,"rel":2480},"https:\u002F\u002Fclickhouse.com\u002Fdocs\u002Fen\u002Foptimize\u002Fasynchronous-inserts",[617],"asynchronous inserts"," by default, and does ",[629,2484,2485],{},"not"," wait for the flush:",[695,2488,2493],{"className":2489,"code":2491,"language":2492},[2490],"language-text","async_insert=1&wait_for_async_insert=0\n","text",[621,2494,2491],{"__ignoreMap":701},[609,2496,2497],{},"ClickHouse buffers rows server-side and writes them in batches. Draining never blocks a request on disk writes.",[609,2499,2500,2501,2504,2505,2508,2509,1076],{},"Set ",[621,2502,2503],{},"waitForAsyncInsert: true"," if you need the insert acknowledged as durable before the drain resolves, at the cost of latency. Set ",[621,2506,2507],{},"asyncInsert: false"," to insert synchronously, which only makes sense when you already batch client-side with ",[621,2510,2511],{},"evlog\u002Fpipeline",[688,2513,2515],{"id":2514},"querying","Querying",[609,2517,2518,2519,2521],{},"Typed columns are indexed by the sort key; everything else lives in ",[621,2520,635],{}," and is reachable with ClickHouse's JSON functions:",[695,2523,2525],{"className":746,"code":2524,"language":749,"meta":701,"style":701},"-- Error rate per service over the last hour\nSELECT service, countIf(level = 'error') \u002F count() AS error_rate\nFROM evlog_events\nWHERE timestamp > now() - INTERVAL 1 HOUR\nGROUP BY service;\n",[621,2526,2527,2532,2570,2577,2604],{"__ignoreMap":701},[705,2528,2529],{"class":707,"line":708},[705,2530,2531],{"class":1014},"-- Error rate per service over the last hour\n",[705,2533,2534,2536,2538,2541,2544,2547,2549,2552,2554,2556,2559,2562,2564,2567],{"class":707,"line":776},[705,2535,2412],{"class":756},[705,2537,1748],{"class":756},[705,2539,2540],{"class":719},", countIf(",[705,2542,2543],{"class":756},"level",[705,2545,2546],{"class":715}," =",[705,2548,729],{"class":715},[705,2550,2551],{"class":732},"error",[705,2553,798],{"class":715},[705,2555,970],{"class":719},[705,2557,2558],{"class":715},"\u002F",[705,2560,2561],{"class":763}," count",[705,2563,1225],{"class":719},[705,2565,2566],{"class":756},"AS",[705,2568,2569],{"class":719}," error_rate\n",[705,2571,2572,2575],{"class":707,"line":782},[705,2573,2574],{"class":756},"FROM",[705,2576,773],{"class":719},[705,2578,2579,2582,2585,2588,2591,2593,2596,2598,2601],{"class":707,"line":809},[705,2580,2581],{"class":756},"WHERE",[705,2583,2584],{"class":785}," timestamp",[705,2586,2587],{"class":715}," >",[705,2589,2590],{"class":756}," now",[705,2592,1522],{"class":715},[705,2594,2595],{"class":715}," -",[705,2597,976],{"class":719},[705,2599,2600],{"class":756},"1",[705,2602,2603],{"class":756}," HOUR\n",[705,2605,2606,2609,2611],{"class":707,"line":818},[705,2607,2608],{"class":756},"GROUP BY",[705,2610,1748],{"class":756},[705,2612,985],{"class":719},[695,2614,2616],{"className":746,"code":2615,"language":749,"meta":701,"style":701},"-- Slowest routes\nSELECT path, count() AS hits, avg(duration_ms) AS avg_ms, quantile(0.95)(duration_ms) AS p95_ms\nFROM evlog_events\nWHERE timestamp > now() - INTERVAL 1 DAY AND method = 'GET' AND duration_ms IS NOT NULL\nGROUP BY path\nORDER BY avg_ms DESC\nLIMIT 20;\n",[621,2617,2618,2623,2669,2675,2718,2725,2735],{"__ignoreMap":701},[705,2619,2620],{"class":707,"line":708},[705,2621,2622],{"class":1014},"-- Slowest routes\n",[705,2624,2625,2627,2630,2632,2635,2637,2639,2642,2645,2648,2650,2653,2656,2658,2661,2664,2666],{"class":707,"line":776},[705,2626,2412],{"class":756},[705,2628,2629],{"class":785}," path",[705,2631,795],{"class":719},[705,2633,2634],{"class":763},"count",[705,2636,1225],{"class":719},[705,2638,2566],{"class":756},[705,2640,2641],{"class":719}," hits, ",[705,2643,2644],{"class":763},"avg",[705,2646,2647],{"class":719},"(duration_ms) ",[705,2649,2566],{"class":756},[705,2651,2652],{"class":719}," avg_ms, quantile(",[705,2654,2655],{"class":756},"0",[705,2657,1076],{"class":719},[705,2659,2660],{"class":756},"95",[705,2662,2663],{"class":719},")(duration_ms) ",[705,2665,2566],{"class":756},[705,2667,2668],{"class":719}," p95_ms\n",[705,2670,2671,2673],{"class":707,"line":782},[705,2672,2574],{"class":756},[705,2674,773],{"class":719},[705,2676,2677,2679,2681,2683,2685,2687,2689,2691,2693,2695,2698,2701,2703,2705,2708,2710,2712,2715],{"class":707,"line":809},[705,2678,2581],{"class":756},[705,2680,2584],{"class":785},[705,2682,2587],{"class":715},[705,2684,2590],{"class":756},[705,2686,1522],{"class":715},[705,2688,2595],{"class":715},[705,2690,976],{"class":719},[705,2692,2600],{"class":756},[705,2694,982],{"class":756},[705,2696,2697],{"class":756}," AND",[705,2699,2700],{"class":719}," method ",[705,2702,920],{"class":715},[705,2704,729],{"class":715},[705,2706,2707],{"class":732},"GET",[705,2709,798],{"class":715},[705,2711,2697],{"class":756},[705,2713,2714],{"class":719}," duration_ms ",[705,2716,2717],{"class":756},"IS NOT NULL\n",[705,2719,2720,2722],{"class":707,"line":818},[705,2721,2608],{"class":756},[705,2723,2724],{"class":785}," path\n",[705,2726,2727,2729,2732],{"class":707,"line":827},[705,2728,946],{"class":756},[705,2730,2731],{"class":719}," avg_ms ",[705,2733,2734],{"class":756},"DESC\n",[705,2736,2737,2740,2743],{"class":707,"line":833},[705,2738,2739],{"class":756},"LIMIT",[705,2741,2742],{"class":756}," 20",[705,2744,985],{"class":719},[695,2746,2748],{"className":746,"code":2747,"language":749,"meta":701,"style":701},"-- One request end to end\nSELECT timestamp, level, path, status, data\nFROM evlog_events\nWHERE request_id = '4a8ff3a8-...'\nORDER BY timestamp;\n",[621,2749,2750,2755,2780,2786,2802],{"__ignoreMap":701},[705,2751,2752],{"class":707,"line":708},[705,2753,2754],{"class":1014},"-- One request end to end\n",[705,2756,2757,2759,2761,2763,2765,2767,2770,2772,2775,2777],{"class":707,"line":776},[705,2758,2412],{"class":756},[705,2760,2584],{"class":785},[705,2762,795],{"class":719},[705,2764,2543],{"class":756},[705,2766,795],{"class":719},[705,2768,2769],{"class":785},"path",[705,2771,795],{"class":719},[705,2773,2774],{"class":756},"status",[705,2776,795],{"class":719},[705,2778,2779],{"class":756},"data\n",[705,2781,2782,2784],{"class":707,"line":782},[705,2783,2574],{"class":756},[705,2785,773],{"class":719},[705,2787,2788,2790,2793,2795,2797,2800],{"class":707,"line":809},[705,2789,2581],{"class":756},[705,2791,2792],{"class":719}," request_id ",[705,2794,920],{"class":715},[705,2796,729],{"class":715},[705,2798,2799],{"class":732},"4a8ff3a8-...",[705,2801,736],{"class":715},[705,2803,2804,2806,2808],{"class":707,"line":818},[705,2805,946],{"class":756},[705,2807,2584],{"class":785},[705,2809,985],{"class":719},[695,2811,2813],{"className":746,"code":2812,"language":749,"meta":701,"style":701},"-- Reach into a custom field kept only in data\nSELECT JSONExtractString(data, 'user', 'plan') AS plan, count()\nFROM evlog_events\nWHERE timestamp > now() - INTERVAL 7 DAY\nGROUP BY plan;\n",[621,2814,2815,2820,2858,2864,2886],{"__ignoreMap":701},[705,2816,2817],{"class":707,"line":708},[705,2818,2819],{"class":1014},"-- Reach into a custom field kept only in data\n",[705,2821,2822,2824,2827,2829,2831,2833,2836,2838,2840,2842,2845,2847,2849,2851,2854,2856],{"class":707,"line":776},[705,2823,2412],{"class":756},[705,2825,2826],{"class":719}," JSONExtractString(",[705,2828,635],{"class":756},[705,2830,795],{"class":719},[705,2832,798],{"class":715},[705,2834,2835],{"class":732},"user",[705,2837,798],{"class":715},[705,2839,795],{"class":719},[705,2841,798],{"class":715},[705,2843,2844],{"class":732},"plan",[705,2846,798],{"class":715},[705,2848,970],{"class":719},[705,2850,2566],{"class":756},[705,2852,2853],{"class":719}," plan, ",[705,2855,2634],{"class":763},[705,2857,1194],{"class":719},[705,2859,2860,2862],{"class":707,"line":782},[705,2861,2574],{"class":756},[705,2863,773],{"class":719},[705,2865,2866,2868,2870,2872,2874,2876,2878,2880,2883],{"class":707,"line":809},[705,2867,2581],{"class":756},[705,2869,2584],{"class":785},[705,2871,2587],{"class":715},[705,2873,2590],{"class":756},[705,2875,1522],{"class":715},[705,2877,2595],{"class":715},[705,2879,976],{"class":719},[705,2881,2882],{"class":756},"7",[705,2884,2885],{"class":756}," DAY\n",[705,2887,2888,2890],{"class":707,"line":818},[705,2889,2608],{"class":756},[705,2891,2892],{"class":719}," plan;\n",[688,2894,2896],{"id":2895},"custom-schema","Custom schema",[609,2898,2899,2900,2902],{},"Pass ",[621,2901,2039],{}," to target a table of your own shape:",[695,2904,2906],{"className":697,"code":2905,"filename":2109,"language":700,"meta":701,"style":701},"import { createClickHouseDrain } from 'evlog\u002Fclickhouse'\n\ncreateClickHouseDrain({\n  table: 'app_logs',\n  transform: event => ({\n    ts: event.timestamp,\n    lvl: event.level,\n    svc: event.service,\n    payload: JSON.stringify(event),\n  }),\n})\n",[621,2907,2908,2926,2930,2938,2954,2970,2985,3000,3015,3035,3044],{"__ignoreMap":701},[705,2909,2910,2912,2914,2916,2918,2920,2922,2924],{"class":707,"line":708},[705,2911,712],{"class":711},[705,2913,716],{"class":715},[705,2915,720],{"class":719},[705,2917,723],{"class":715},[705,2919,726],{"class":711},[705,2921,729],{"class":715},[705,2923,733],{"class":732},[705,2925,736],{"class":715},[705,2927,2928],{"class":707,"line":776},[705,2929,1039],{"emptyLinePlaceholder":1038},[705,2931,2932,2934,2936],{"class":707,"line":782},[705,2933,2116],{"class":763},[705,2935,1053],{"class":719},[705,2937,1626],{"class":715},[705,2939,2940,2943,2945,2947,2950,2952],{"class":707,"line":809},[705,2941,2942],{"class":1087},"  table",[705,2944,1220],{"class":715},[705,2946,729],{"class":715},[705,2948,2949],{"class":732},"app_logs",[705,2951,798],{"class":715},[705,2953,1661],{"class":715},[705,2955,2956,2959,2961,2964,2966,2968],{"class":707,"line":818},[705,2957,2958],{"class":763},"  transform",[705,2960,1220],{"class":715},[705,2962,2963],{"class":1058}," event",[705,2965,1065],{"class":785},[705,2967,949],{"class":719},[705,2969,1626],{"class":715},[705,2971,2972,2975,2977,2979,2981,2983],{"class":707,"line":827},[705,2973,2974],{"class":1087},"    ts",[705,2976,1220],{"class":715},[705,2978,2963],{"class":719},[705,2980,1076],{"class":715},[705,2982,938],{"class":719},[705,2984,1661],{"class":715},[705,2986,2987,2990,2992,2994,2996,2998],{"class":707,"line":833},[705,2988,2989],{"class":1087},"    lvl",[705,2991,1220],{"class":715},[705,2993,2963],{"class":719},[705,2995,1076],{"class":715},[705,2997,2543],{"class":719},[705,2999,1661],{"class":715},[705,3001,3002,3005,3007,3009,3011,3013],{"class":707,"line":839},[705,3003,3004],{"class":1087},"    svc",[705,3006,1220],{"class":715},[705,3008,2963],{"class":719},[705,3010,1076],{"class":715},[705,3012,952],{"class":719},[705,3014,1661],{"class":715},[705,3016,3017,3020,3022,3025,3027,3030,3033],{"class":707,"line":845},[705,3018,3019],{"class":1087},"    payload",[705,3021,1220],{"class":715},[705,3023,3024],{"class":719}," JSON",[705,3026,1076],{"class":715},[705,3028,3029],{"class":763},"stringify",[705,3031,3032],{"class":719},"(event)",[705,3034,1661],{"class":715},[705,3036,3037,3040,3042],{"class":707,"line":851},[705,3038,3039],{"class":715},"  }",[705,3041,1062],{"class":719},[705,3043,1661],{"class":715},[705,3045,3046,3048],{"class":707,"line":857},[705,3047,1107],{"class":715},[705,3049,911],{"class":719},[609,3051,3052,3053,3055],{},"Keys must match your column names, because ClickHouse rejects a ",[621,3054,623],{}," insert containing unknown columns.",[688,3057,3059],{"id":3058},"batching","Batching",[609,3061,3062],{},"Pair with a pipeline to insert in larger batches:",[695,3064,3066],{"className":697,"code":3065,"filename":2109,"language":700,"meta":701,"style":701},"import { createDrainPipeline } from 'evlog\u002Fpipeline'\nimport { createClickHouseDrain } from 'evlog\u002Fclickhouse'\nimport type { DrainContext } from 'evlog'\n\nconst pipeline = createDrainPipeline\u003CDrainContext>({\n  batch: { size: 500, intervalMs: 5000 },\n})\n\nexport default defineNitroPlugin((nitroApp) => {\n  nitroApp.hooks.hook('evlog:drain', pipeline(createClickHouseDrain()))\n})\n",[621,3067,3068,3087,3105,3127,3131,3155,3184,3190,3194,3214,3246],{"__ignoreMap":701},[705,3069,3070,3072,3074,3077,3079,3081,3083,3085],{"class":707,"line":708},[705,3071,712],{"class":711},[705,3073,716],{"class":715},[705,3075,3076],{"class":719}," createDrainPipeline",[705,3078,723],{"class":715},[705,3080,726],{"class":711},[705,3082,729],{"class":715},[705,3084,2511],{"class":732},[705,3086,736],{"class":715},[705,3088,3089,3091,3093,3095,3097,3099,3101,3103],{"class":707,"line":776},[705,3090,712],{"class":711},[705,3092,716],{"class":715},[705,3094,720],{"class":719},[705,3096,723],{"class":715},[705,3098,726],{"class":711},[705,3100,729],{"class":715},[705,3102,733],{"class":732},[705,3104,736],{"class":715},[705,3106,3107,3109,3112,3114,3117,3119,3121,3123,3125],{"class":707,"line":782},[705,3108,712],{"class":711},[705,3110,3111],{"class":711}," type",[705,3113,716],{"class":715},[705,3115,3116],{"class":719}," DrainContext",[705,3118,723],{"class":715},[705,3120,726],{"class":711},[705,3122,729],{"class":715},[705,3124,1209],{"class":732},[705,3126,736],{"class":715},[705,3128,3129],{"class":707,"line":809},[705,3130,1039],{"emptyLinePlaceholder":1038},[705,3132,3133,3135,3138,3140,3142,3145,3148,3151,3153],{"class":707,"line":818},[705,3134,1181],{"class":785},[705,3136,3137],{"class":719}," pipeline ",[705,3139,920],{"class":715},[705,3141,3076],{"class":763},[705,3143,3144],{"class":715},"\u003C",[705,3146,3147],{"class":1677},"DrainContext",[705,3149,3150],{"class":715},">",[705,3152,1053],{"class":719},[705,3154,1626],{"class":715},[705,3156,3157,3160,3162,3164,3167,3169,3172,3174,3177,3179,3182],{"class":707,"line":827},[705,3158,3159],{"class":1087},"  batch",[705,3161,1220],{"class":715},[705,3163,716],{"class":715},[705,3165,3166],{"class":1087}," size",[705,3168,1220],{"class":715},[705,3170,3171],{"class":756}," 500",[705,3173,1097],{"class":715},[705,3175,3176],{"class":1087}," intervalMs",[705,3178,1220],{"class":715},[705,3180,3181],{"class":756}," 5000",[705,3183,1760],{"class":715},[705,3185,3186,3188],{"class":707,"line":833},[705,3187,1107],{"class":715},[705,3189,911],{"class":719},[705,3191,3192],{"class":707,"line":839},[705,3193,1039],{"emptyLinePlaceholder":1038},[705,3195,3196,3198,3200,3202,3204,3206,3208,3210,3212],{"class":707,"line":845},[705,3197,1044],{"class":711},[705,3199,1047],{"class":711},[705,3201,1050],{"class":763},[705,3203,1053],{"class":719},[705,3205,1053],{"class":715},[705,3207,1059],{"class":1058},[705,3209,1062],{"class":715},[705,3211,1065],{"class":785},[705,3213,1068],{"class":715},[705,3215,3216,3218,3220,3222,3224,3226,3228,3230,3232,3234,3236,3239,3241,3243],{"class":707,"line":851},[705,3217,1073],{"class":719},[705,3219,1076],{"class":715},[705,3221,1079],{"class":719},[705,3223,1076],{"class":715},[705,3225,1084],{"class":763},[705,3227,1053],{"class":1087},[705,3229,798],{"class":715},[705,3231,1092],{"class":732},[705,3233,798],{"class":715},[705,3235,1097],{"class":715},[705,3237,3238],{"class":763}," pipeline",[705,3240,1053],{"class":1087},[705,3242,2116],{"class":763},[705,3244,3245],{"class":1087},"()))\n",[705,3247,3248,3250],{"class":707,"line":857},[705,3249,1107],{"class":715},[705,3251,911],{"class":719},[688,3253,3255],{"id":3254},"troubleshooting","Troubleshooting",[609,3257,3258,2328,3263,3265,3266,3268,3269,3272],{},[629,3259,3260,1076],{},[621,3261,3262],{},"Missing endpoint",[621,3264,1817],{}," is unset and no ",[621,3267,1913],{}," was passed. The drain logs ",[621,3270,3271],{},"[evlog\u002Fclickhouse] Missing endpoint"," once and then does nothing, so requests are never blocked or failed.",[609,3274,3275,3280,3281,2324,3283,3285,3286,2324,3288,3290,3291,1076],{},[629,3276,3277,1076],{},[621,3278,3279],{},"ClickHouse API error: 401"," Check ",[621,3282,1834],{},[621,3284,1850],{},". Credentials are sent as ",[621,3287,2323],{},[621,3289,2327],{}," headers, never in the query string, so they never reach ",[621,3292,2335],{},[609,3294,3295,3301,3302,3304],{},[629,3296,3297,3300],{},[621,3298,3299],{},"ClickHouse API error: 400"," mentioning unknown column."," Your table does not match the row shape. Either create the table from the DDL above, or supply a ",[621,3303,2039],{}," matching your columns.",[609,3306,3307,3312,3313,3315,3316,3319],{},[629,3308,3309,1076],{},[621,3310,3311],{},"Cannot parse input"," The table exists but a column type disagrees. ",[621,3314,2774],{}," is ",[621,3317,3318],{},"Nullable(UInt16)"," because it is absent on non-HTTP events.",[688,3321,3323],{"id":3322},"direct-api-usage","Direct API usage",[695,3325,3328],{"className":697,"code":3326,"filename":3327,"language":700,"meta":701,"style":701},"import { sendBatchToClickHouse, sendToClickHouse } from 'evlog\u002Fclickhouse'\n\nawait sendToClickHouse(event, { endpoint: 'http:\u002F\u002Flocalhost:8123' })\nawait sendBatchToClickHouse(events, { endpoint: 'http:\u002F\u002Flocalhost:8123' })\n","scripts\u002Fbackfill.ts",[621,3329,3330,3354,3358,3385],{"__ignoreMap":701},[705,3331,3332,3334,3336,3339,3341,3344,3346,3348,3350,3352],{"class":707,"line":708},[705,3333,712],{"class":711},[705,3335,716],{"class":715},[705,3337,3338],{"class":719}," sendBatchToClickHouse",[705,3340,1097],{"class":715},[705,3342,3343],{"class":719}," sendToClickHouse",[705,3345,723],{"class":715},[705,3347,726],{"class":711},[705,3349,729],{"class":715},[705,3351,733],{"class":732},[705,3353,736],{"class":715},[705,3355,3356],{"class":707,"line":776},[705,3357,1039],{"emptyLinePlaceholder":1038},[705,3359,3360,3362,3364,3367,3369,3371,3373,3375,3377,3379,3381,3383],{"class":707,"line":782},[705,3361,1414],{"class":711},[705,3363,3343],{"class":763},[705,3365,3366],{"class":719},"(event",[705,3368,1097],{"class":715},[705,3370,716],{"class":715},[705,3372,2123],{"class":1087},[705,3374,1220],{"class":715},[705,3376,729],{"class":715},[705,3378,669],{"class":732},[705,3380,798],{"class":715},[705,3382,723],{"class":715},[705,3384,911],{"class":719},[705,3386,3387,3389,3391,3394,3396,3398,3400,3402,3404,3406,3408,3410],{"class":707,"line":809},[705,3388,1414],{"class":711},[705,3390,3338],{"class":763},[705,3392,3393],{"class":719},"(events",[705,3395,1097],{"class":715},[705,3397,716],{"class":715},[705,3399,2123],{"class":1087},[705,3401,1220],{"class":715},[705,3403,729],{"class":715},[705,3405,669],{"class":732},[705,3407,798],{"class":715},[705,3409,723],{"class":715},[705,3411,911],{"class":719},[609,3413,3414,795,3417,3420,3421,3424],{},[621,3415,3416],{},"toClickHouseRow()",[621,3418,3419],{},"toJSONEachRow()",", and ",[621,3422,3423],{},"resolveClickHouseUrl()"," are also exported.",[688,3426,3428],{"id":3427},"next-steps","Next steps",[3430,3431,3432,3437,3442,3448],"ul",{},[649,3433,3434,3436],{},[613,3435,66],{"href":67},": control volume before it reaches ClickHouse",[649,3438,3439,3441],{},[613,3440,440],{"href":441},": add derived fields to every event",[649,3443,3444,3447],{},[613,3445,3446],{"href":535},"Pipeline",": batching, retries, and fan-out",[649,3449,3450,3453],{},[613,3451,3452],{"href":153},"Adapters Overview",": all available destinations",[3455,3456,3457],"style",{},"html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .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}",{"title":701,"searchDepth":776,"depth":776,"links":3459},[3460,3461,3462,3463,3467,3471,3472,3473,3474,3475,3476,3477,3478],{"id":690,"depth":776,"text":20},{"id":739,"depth":776,"text":740},{"id":1000,"depth":776,"text":25},{"id":1782,"depth":776,"text":547,"children":3464},[3465,3466],{"id":1786,"depth":782,"text":1787},{"id":1887,"depth":782,"text":346},{"id":2094,"depth":776,"text":2095,"children":3468},[3469,3470],{"id":2101,"depth":782,"text":2102},{"id":2193,"depth":782,"text":2194},{"id":2339,"depth":776,"text":2340},{"id":2472,"depth":776,"text":2473},{"id":2514,"depth":776,"text":2515},{"id":2895,"depth":776,"text":2896},{"id":3058,"depth":776,"text":3059},{"id":3254,"depth":776,"text":3255},{"id":3322,"depth":776,"text":3323},{"id":3427,"depth":776,"text":3428},"Insert wide events into ClickHouse over the HTTP interface — typed columns for what you aggregate, full JSON for everything else.","md",[3482,3488],{"label":3483,"icon":3484,"to":615,"target":3485,"color":3486,"variant":3487},"HTTP Interface","i-lucide-external-link","_blank","neutral","subtle",{"label":3489,"icon":3484,"to":2479,"target":3485,"color":3486,"variant":3487},"Async Inserts",{},{"title":196,"icon":199},{"title":604,"description":3479},"2tkkGzm_QM70LI_vpY_UpJWCHtZzf2R9tvxSFL45XwM",[3495,3497],{"title":191,"path":192,"stem":193,"description":3496,"icon":194,"children":-1},"Push wide events to Grafana Loki — self-hosted, multi-tenant, or Grafana Cloud — with low-cardinality labels and full JSON querying.",{"title":201,"path":202,"stem":203,"description":3498,"icon":204,"children":-1},"Send logs via OpenTelemetry Protocol (OTLP) to Grafana, Datadog, Honeycomb, and any compatible backend. Supports gRPC and HTTP transports.",1791049466393]