[{"data":1,"prerenderedAt":2393},["ShallowReactive",2],{"navigation_docs":3,"-use-cases-telemetry-ingest":602,"-use-cases-telemetry-ingest-surround":2388},[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":2376,"extension":2377,"links":2378,"meta":2384,"navigation":2385,"path":432,"seo":2386,"stem":433,"__hash__":2387},"docs\u002F5.use-cases\u002F4.telemetry\u002F03.ingest.md","Telemetry Ingest",{"type":606,"value":607,"toc":2368},"minimark",[608,622,630,635,642,647,658,663,674,769,775,789,795,807,1036,1055,1059,1066,2023,2027,2033,2341,2345,2354,2364],[609,610,611,612,616,617,621],"p",{},"You ship a CLI. Users run it on their machines. You want to know ",[613,614,615],"em",{},"which commands run, how often they fail, and which versions are out there",", without building a separate analytics SDK or reading raw ",[618,619,620],"code",{},"argv",".",[609,623,624,625,629],{},"That means a ",[626,627,628],"strong",{},"server endpoint"," your CLI POSTs to. The local outbox is only there so short CI jobs and offline runs do not lose data before the POST succeeds.",[631,632,634],"h2",{"id":633},"the-security-question-read-this-first","The security question (read this first)",[636,637,638,641],"tip",{},[626,639,640],{},"CLI telemetry is not a vault."," You are collecting anonymous usage counters (command name, duration, outcome, a few numbers), not passwords, not file paths, not tokens. Design for that threat model and you do not need impossible client-side secrets.",[609,643,644],{},[626,645,646],{},"\"I put the ingest URL in my CLI. Isn't that a secret?\"",[609,648,649,650,653,654,657],{},"No. The URL lives in your npm package or binary. Anyone can read it with ",[618,651,652],{},"strings",", by installing the package, or by watching network traffic. The same applies to an API key or ",[618,655,656],{},"Authorization"," header baked into the CLI is extractable, not a real barrier.",[609,659,660],{},[626,661,662],{},"\"So can't anyone send fake events?\"",[609,664,665,666,669,670,673],{},"In theory, yes: someone could ",[618,667,668],{},"curl"," your endpoint with forged JSON. That is why you treat the endpoint as ",[626,671,672],{},"semi-public"," (like a browser analytics key) and defend on the server:",[675,676,677,690],"table",{},[678,679,680],"thead",{},[681,682,683,687],"tr",{},[684,685,686],"th",{},"What you might worry about",[684,688,689],{},"Practical answer",[691,692,693,705,716,727,742,754],"tbody",{},[681,694,695,699],{},[696,697,698],"td",{},"Random internet bots",[696,700,701,702],{},"Validate the payload shape; reject garbage with ",[618,703,704],{},"400",[681,706,707,713],{},[696,708,709,710,712],{},"Someone spamming fake ",[618,711,119],{}," runs",[696,714,715],{},"Rate-limit by IP; data is low-value counters, not money",[681,717,718,724],{},[696,719,720,721],{},"Forged ",[618,722,723],{},"tool.name",[696,725,726],{},"Allowlist only your published tool names server-side",[681,728,729,735],{},[696,730,731,732],{},"Unexpected fields in ",[618,733,734],{},"custom",[696,736,737,738,741],{},"Filter to the keys you declared — same list as ",[618,739,740],{},"collect"," on the CLI",[681,743,744,747],{},[696,745,746],{},"Double-counting on retry",[696,748,749,750,753],{},"Dedupe on ",[618,751,752],{},"idempotencyKey"," when storing",[681,755,756,759],{},[696,757,758],{},"Leaking user secrets",[696,760,761,762,764,765,768],{},"CLI never reads raw ",[618,763,620],{},"; you only allowlisted flags and ",[618,766,767],{},"telemetry.set()"," counters",[609,770,771,774],{},[626,772,773],{},"What \"good enough\" looks like:"," validate every POST, store idempotently, rate-limit at the edge (CDN, API gateway, or middleware), and keep the payload boring (no PII by design). That is the same playbook as client-side analytics: not banking-grade auth, but reliable product insight.",[776,777,779,782,783,788],"callout",{"color":778,"icon":388},"info",[618,780,781],{},"@evlog\u002Ftelemetry"," ships ",[626,784,785],{},[618,786,787],{},"parseIngestBody()"," for your server, with the same validation rules documented here, so you do not copy-paste a validator from the docs. Pair it with your framework route and your database or evlog drain.",[631,790,792,793],{"id":791},"step-1-validate-with-parseingestbody","Step 1: Validate with ",[618,794,787],{},[609,796,797,798,801,802,804,805,621],{},"Mirror the CLI config on the server: same ",[618,799,800],{},"name",", same custom keys you allow via ",[618,803,740],{}," \u002F ",[618,806,767],{},[808,809,815],"pre",{"className":810,"code":811,"filename":812,"language":813,"meta":814,"style":814},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import { parseIngestBody } from '@evlog\u002Ftelemetry\u002Fingest'\n\nexport const ingestOptions = {\n  allowedTools: ['my-tool'],\n  allowedCustomKeys: {\n    'my-tool': ['checksFailed', 'checksWarn', 'itemsSynced'],\n  },\n} as const\n\nexport function parseTelemetryBody(raw: string) {\n  return parseIngestBody(raw, ingestOptions)\n}\n","lib\u002Ftelemetry-ingest.ts","ts","",[618,816,817,850,857,876,903,913,957,963,975,980,1010,1030],{"__ignoreMap":814},[818,819,822,826,830,834,837,840,843,847],"span",{"class":820,"line":821},"line",1,[818,823,825],{"class":824},"s7zQu","import",[818,827,829],{"class":828},"sMK4o"," {",[818,831,833],{"class":832},"sTEyZ"," parseIngestBody",[818,835,836],{"class":828}," }",[818,838,839],{"class":824}," from",[818,841,842],{"class":828}," '",[818,844,846],{"class":845},"sfazB","@evlog\u002Ftelemetry\u002Fingest",[818,848,849],{"class":828},"'\n",[818,851,853],{"class":820,"line":852},2,[818,854,856],{"emptyLinePlaceholder":855},true,"\n",[818,858,860,863,867,870,873],{"class":820,"line":859},3,[818,861,862],{"class":824},"export",[818,864,866],{"class":865},"spNyl"," const",[818,868,869],{"class":832}," ingestOptions ",[818,871,872],{"class":828},"=",[818,874,875],{"class":828}," {\n",[818,877,879,883,886,889,892,895,897,900],{"class":820,"line":878},4,[818,880,882],{"class":881},"swJcz","  allowedTools",[818,884,885],{"class":828},":",[818,887,888],{"class":832}," [",[818,890,891],{"class":828},"'",[818,893,894],{"class":845},"my-tool",[818,896,891],{"class":828},[818,898,899],{"class":832},"]",[818,901,902],{"class":828},",\n",[818,904,906,909,911],{"class":820,"line":905},5,[818,907,908],{"class":881},"  allowedCustomKeys",[818,910,885],{"class":828},[818,912,875],{"class":828},[818,914,916,919,921,923,925,927,929,932,934,937,939,942,944,946,948,951,953,955],{"class":820,"line":915},6,[818,917,918],{"class":828},"    '",[818,920,894],{"class":881},[818,922,891],{"class":828},[818,924,885],{"class":828},[818,926,888],{"class":832},[818,928,891],{"class":828},[818,930,931],{"class":845},"checksFailed",[818,933,891],{"class":828},[818,935,936],{"class":828},",",[818,938,842],{"class":828},[818,940,941],{"class":845},"checksWarn",[818,943,891],{"class":828},[818,945,936],{"class":828},[818,947,842],{"class":828},[818,949,950],{"class":845},"itemsSynced",[818,952,891],{"class":828},[818,954,899],{"class":832},[818,956,902],{"class":828},[818,958,960],{"class":820,"line":959},7,[818,961,962],{"class":828},"  },\n",[818,964,966,969,972],{"class":820,"line":965},8,[818,967,968],{"class":828},"}",[818,970,971],{"class":824}," as",[818,973,974],{"class":865}," const\n",[818,976,978],{"class":820,"line":977},9,[818,979,856],{"emptyLinePlaceholder":855},[818,981,983,985,988,992,995,999,1001,1005,1008],{"class":820,"line":982},10,[818,984,862],{"class":824},[818,986,987],{"class":865}," function",[818,989,991],{"class":990},"s2Zo4"," parseTelemetryBody",[818,993,994],{"class":828},"(",[818,996,998],{"class":997},"sHdIc","raw",[818,1000,885],{"class":828},[818,1002,1004],{"class":1003},"sBMFI"," string",[818,1006,1007],{"class":828},")",[818,1009,875],{"class":828},[818,1011,1013,1016,1018,1020,1022,1024,1027],{"class":820,"line":1012},11,[818,1014,1015],{"class":824},"  return",[818,1017,833],{"class":990},[818,1019,994],{"class":881},[818,1021,998],{"class":832},[818,1023,936],{"class":828},[818,1025,1026],{"class":832}," ingestOptions",[818,1028,1029],{"class":881},")\n",[818,1031,1033],{"class":820,"line":1032},12,[818,1034,1035],{"class":828},"}\n",[609,1037,1038,1040,1041,1044,1045,1047,1048,1051,1052,1054],{},[618,1039,787],{}," checks batch size, JSON shape, ",[618,1042,1043],{},"event: 'run'",", tool allowlist, envelope types, ISO timestamp, and strips ",[618,1046,734],{}," keys you did not declare. Throws ",[618,1049,1050],{},"IngestValidationError"," on failure, so return ",[618,1053,704],{}," from your route.",[631,1056,1058],{"id":1057},"step-2-wire-your-route","Step 2: Wire your route",[609,1060,1061,1062,1065],{},"Same contract for any framework: read the raw body, validate, store, return ",[626,1063,1064],{},"204"," so the CLI clears its outbox:",[1067,1068,1069,1459,1717],"framework-tabs",{},[808,1070,1073],{"className":810,"code":1071,"filename":255,"language":813,"meta":1072,"style":814},"import { defineHandler } from 'nitro\u002Fh3'\nimport { defineHandler, readRawBody, setResponseStatus } from 'h3'\nimport { IngestValidationError } from '@evlog\u002Ftelemetry\u002Fingest'\nimport { parseTelemetryBody } from '~\u002Flib\u002Ftelemetry-ingest'\nimport { storeRunEvents } from '~\u002Flib\u002Ftelemetry-store'\n\nexport default defineHandler(async (event) => {\n  const raw = await readRawBody(event, 'utf8')\n  if (!raw) {\n    setResponseStatus(event, 400)\n    return { error: 'empty body' }\n  }\n\n  try {\n    const events = parseTelemetryBody(raw)\n    await storeRunEvents(events)\n    setResponseStatus(event, 204)\n    return null\n  } catch (err) {\n    setResponseStatus(event, err instanceof IngestValidationError ? 400 : 500)\n    return { error: 'invalid payload' }\n  }\n})\n","server\u002Fapi\u002Ftelemetry\u002Fingest.post.ts",[618,1074,1075,1095,1124,1143,1162,1182,1186,1213,1244,1262,1279,1301,1306,1311,1319,1338,1353,1369,1377,1395,1427,1447,1452],{"__ignoreMap":814},[818,1076,1077,1079,1081,1084,1086,1088,1090,1093],{"class":820,"line":821},[818,1078,825],{"class":824},[818,1080,829],{"class":828},[818,1082,1083],{"class":832}," defineHandler",[818,1085,836],{"class":828},[818,1087,839],{"class":824},[818,1089,842],{"class":828},[818,1091,1092],{"class":845},"nitro\u002Fh3",[818,1094,849],{"class":828},[818,1096,1097,1099,1101,1103,1105,1108,1110,1113,1115,1117,1119,1122],{"class":820,"line":852},[818,1098,825],{"class":824},[818,1100,829],{"class":828},[818,1102,1083],{"class":832},[818,1104,936],{"class":828},[818,1106,1107],{"class":832}," readRawBody",[818,1109,936],{"class":828},[818,1111,1112],{"class":832}," setResponseStatus",[818,1114,836],{"class":828},[818,1116,839],{"class":824},[818,1118,842],{"class":828},[818,1120,1121],{"class":845},"h3",[818,1123,849],{"class":828},[818,1125,1126,1128,1130,1133,1135,1137,1139,1141],{"class":820,"line":859},[818,1127,825],{"class":824},[818,1129,829],{"class":828},[818,1131,1132],{"class":832}," IngestValidationError",[818,1134,836],{"class":828},[818,1136,839],{"class":824},[818,1138,842],{"class":828},[818,1140,846],{"class":845},[818,1142,849],{"class":828},[818,1144,1145,1147,1149,1151,1153,1155,1157,1160],{"class":820,"line":878},[818,1146,825],{"class":824},[818,1148,829],{"class":828},[818,1150,991],{"class":832},[818,1152,836],{"class":828},[818,1154,839],{"class":824},[818,1156,842],{"class":828},[818,1158,1159],{"class":845},"~\u002Flib\u002Ftelemetry-ingest",[818,1161,849],{"class":828},[818,1163,1164,1166,1168,1171,1173,1175,1177,1180],{"class":820,"line":905},[818,1165,825],{"class":824},[818,1167,829],{"class":828},[818,1169,1170],{"class":832}," storeRunEvents",[818,1172,836],{"class":828},[818,1174,839],{"class":824},[818,1176,842],{"class":828},[818,1178,1179],{"class":845},"~\u002Flib\u002Ftelemetry-store",[818,1181,849],{"class":828},[818,1183,1184],{"class":820,"line":915},[818,1185,856],{"emptyLinePlaceholder":855},[818,1187,1188,1190,1193,1195,1197,1200,1203,1206,1208,1211],{"class":820,"line":959},[818,1189,862],{"class":824},[818,1191,1192],{"class":824}," default",[818,1194,1083],{"class":990},[818,1196,994],{"class":832},[818,1198,1199],{"class":865},"async",[818,1201,1202],{"class":828}," (",[818,1204,1205],{"class":997},"event",[818,1207,1007],{"class":828},[818,1209,1210],{"class":865}," =>",[818,1212,875],{"class":828},[818,1214,1215,1218,1221,1224,1227,1229,1231,1233,1235,1237,1240,1242],{"class":820,"line":965},[818,1216,1217],{"class":865},"  const",[818,1219,1220],{"class":832}," raw",[818,1222,1223],{"class":828}," =",[818,1225,1226],{"class":824}," await",[818,1228,1107],{"class":990},[818,1230,994],{"class":881},[818,1232,1205],{"class":832},[818,1234,936],{"class":828},[818,1236,842],{"class":828},[818,1238,1239],{"class":845},"utf8",[818,1241,891],{"class":828},[818,1243,1029],{"class":881},[818,1245,1246,1249,1251,1254,1256,1259],{"class":820,"line":977},[818,1247,1248],{"class":824},"  if",[818,1250,1202],{"class":881},[818,1252,1253],{"class":828},"!",[818,1255,998],{"class":832},[818,1257,1258],{"class":881},") ",[818,1260,1261],{"class":828},"{\n",[818,1263,1264,1267,1269,1271,1273,1277],{"class":820,"line":982},[818,1265,1266],{"class":990},"    setResponseStatus",[818,1268,994],{"class":881},[818,1270,1205],{"class":832},[818,1272,936],{"class":828},[818,1274,1276],{"class":1275},"sbssI"," 400",[818,1278,1029],{"class":881},[818,1280,1281,1284,1286,1289,1291,1293,1296,1298],{"class":820,"line":1012},[818,1282,1283],{"class":824},"    return",[818,1285,829],{"class":828},[818,1287,1288],{"class":881}," error",[818,1290,885],{"class":828},[818,1292,842],{"class":828},[818,1294,1295],{"class":845},"empty body",[818,1297,891],{"class":828},[818,1299,1300],{"class":828}," }\n",[818,1302,1303],{"class":820,"line":1032},[818,1304,1305],{"class":828},"  }\n",[818,1307,1309],{"class":820,"line":1308},13,[818,1310,856],{"emptyLinePlaceholder":855},[818,1312,1314,1317],{"class":820,"line":1313},14,[818,1315,1316],{"class":824},"  try",[818,1318,875],{"class":828},[818,1320,1322,1325,1328,1330,1332,1334,1336],{"class":820,"line":1321},15,[818,1323,1324],{"class":865},"    const",[818,1326,1327],{"class":832}," events",[818,1329,1223],{"class":828},[818,1331,991],{"class":990},[818,1333,994],{"class":881},[818,1335,998],{"class":832},[818,1337,1029],{"class":881},[818,1339,1341,1344,1346,1348,1351],{"class":820,"line":1340},16,[818,1342,1343],{"class":824},"    await",[818,1345,1170],{"class":990},[818,1347,994],{"class":881},[818,1349,1350],{"class":832},"events",[818,1352,1029],{"class":881},[818,1354,1356,1358,1360,1362,1364,1367],{"class":820,"line":1355},17,[818,1357,1266],{"class":990},[818,1359,994],{"class":881},[818,1361,1205],{"class":832},[818,1363,936],{"class":828},[818,1365,1366],{"class":1275}," 204",[818,1368,1029],{"class":881},[818,1370,1372,1374],{"class":820,"line":1371},18,[818,1373,1283],{"class":824},[818,1375,1376],{"class":828}," null\n",[818,1378,1380,1383,1386,1388,1391,1393],{"class":820,"line":1379},19,[818,1381,1382],{"class":828},"  }",[818,1384,1385],{"class":824}," catch",[818,1387,1202],{"class":881},[818,1389,1390],{"class":832},"err",[818,1392,1258],{"class":881},[818,1394,1261],{"class":828},[818,1396,1398,1400,1402,1404,1406,1409,1412,1414,1417,1419,1422,1425],{"class":820,"line":1397},20,[818,1399,1266],{"class":990},[818,1401,994],{"class":881},[818,1403,1205],{"class":832},[818,1405,936],{"class":828},[818,1407,1408],{"class":832}," err",[818,1410,1411],{"class":828}," instanceof",[818,1413,1132],{"class":1003},[818,1415,1416],{"class":828}," ?",[818,1418,1276],{"class":1275},[818,1420,1421],{"class":828}," :",[818,1423,1424],{"class":1275}," 500",[818,1426,1029],{"class":881},[818,1428,1430,1432,1434,1436,1438,1440,1443,1445],{"class":820,"line":1429},21,[818,1431,1283],{"class":824},[818,1433,829],{"class":828},[818,1435,1288],{"class":881},[818,1437,885],{"class":828},[818,1439,842],{"class":828},[818,1441,1442],{"class":845},"invalid payload",[818,1444,891],{"class":828},[818,1446,1300],{"class":828},[818,1448,1450],{"class":820,"line":1449},22,[818,1451,1305],{"class":828},[818,1453,1455,1457],{"class":820,"line":1454},23,[818,1456,968],{"class":828},[818,1458,1029],{"class":832},[808,1460,1464],{"className":810,"code":1461,"filename":1462,"language":813,"meta":1463,"style":814},"import { IngestValidationError } from '@evlog\u002Ftelemetry\u002Fingest'\nimport { parseTelemetryBody } from '@\u002Flib\u002Ftelemetry-ingest'\nimport { storeRunEvents } from '@\u002Flib\u002Ftelemetry-store'\n\nexport async function POST(request: Request) {\n  const raw = await request.text()\n  try {\n    const events = parseTelemetryBody(raw)\n    await storeRunEvents(events)\n    return new Response(null, { status: 204 })\n  } catch (err) {\n    const status = err instanceof IngestValidationError ? 400 : 500\n    return Response.json({ error: 'invalid payload' }, { status })\n  }\n}\n","Next.js App Router","app\u002Fapi\u002Ftelemetry\u002Fingest\u002Froute.ts",[618,1465,1466,1484,1503,1522,1526,1552,1573,1579,1595,1607,1635,1649,1672,1709,1713],{"__ignoreMap":814},[818,1467,1468,1470,1472,1474,1476,1478,1480,1482],{"class":820,"line":821},[818,1469,825],{"class":824},[818,1471,829],{"class":828},[818,1473,1132],{"class":832},[818,1475,836],{"class":828},[818,1477,839],{"class":824},[818,1479,842],{"class":828},[818,1481,846],{"class":845},[818,1483,849],{"class":828},[818,1485,1486,1488,1490,1492,1494,1496,1498,1501],{"class":820,"line":852},[818,1487,825],{"class":824},[818,1489,829],{"class":828},[818,1491,991],{"class":832},[818,1493,836],{"class":828},[818,1495,839],{"class":824},[818,1497,842],{"class":828},[818,1499,1500],{"class":845},"@\u002Flib\u002Ftelemetry-ingest",[818,1502,849],{"class":828},[818,1504,1505,1507,1509,1511,1513,1515,1517,1520],{"class":820,"line":859},[818,1506,825],{"class":824},[818,1508,829],{"class":828},[818,1510,1170],{"class":832},[818,1512,836],{"class":828},[818,1514,839],{"class":824},[818,1516,842],{"class":828},[818,1518,1519],{"class":845},"@\u002Flib\u002Ftelemetry-store",[818,1521,849],{"class":828},[818,1523,1524],{"class":820,"line":878},[818,1525,856],{"emptyLinePlaceholder":855},[818,1527,1528,1530,1533,1535,1538,1540,1543,1545,1548,1550],{"class":820,"line":905},[818,1529,862],{"class":824},[818,1531,1532],{"class":865}," async",[818,1534,987],{"class":865},[818,1536,1537],{"class":990}," POST",[818,1539,994],{"class":828},[818,1541,1542],{"class":997},"request",[818,1544,885],{"class":828},[818,1546,1547],{"class":1003}," Request",[818,1549,1007],{"class":828},[818,1551,875],{"class":828},[818,1553,1554,1556,1558,1560,1562,1565,1567,1570],{"class":820,"line":915},[818,1555,1217],{"class":865},[818,1557,1220],{"class":832},[818,1559,1223],{"class":828},[818,1561,1226],{"class":824},[818,1563,1564],{"class":832}," request",[818,1566,621],{"class":828},[818,1568,1569],{"class":990},"text",[818,1571,1572],{"class":881},"()\n",[818,1574,1575,1577],{"class":820,"line":959},[818,1576,1316],{"class":824},[818,1578,875],{"class":828},[818,1580,1581,1583,1585,1587,1589,1591,1593],{"class":820,"line":965},[818,1582,1324],{"class":865},[818,1584,1327],{"class":832},[818,1586,1223],{"class":828},[818,1588,991],{"class":990},[818,1590,994],{"class":881},[818,1592,998],{"class":832},[818,1594,1029],{"class":881},[818,1596,1597,1599,1601,1603,1605],{"class":820,"line":977},[818,1598,1343],{"class":824},[818,1600,1170],{"class":990},[818,1602,994],{"class":881},[818,1604,1350],{"class":832},[818,1606,1029],{"class":881},[818,1608,1609,1611,1614,1617,1619,1622,1624,1627,1629,1631,1633],{"class":820,"line":982},[818,1610,1283],{"class":824},[818,1612,1613],{"class":828}," new",[818,1615,1616],{"class":990}," Response",[818,1618,994],{"class":881},[818,1620,1621],{"class":828},"null,",[818,1623,829],{"class":828},[818,1625,1626],{"class":881}," status",[818,1628,885],{"class":828},[818,1630,1366],{"class":1275},[818,1632,836],{"class":828},[818,1634,1029],{"class":881},[818,1636,1637,1639,1641,1643,1645,1647],{"class":820,"line":1012},[818,1638,1382],{"class":828},[818,1640,1385],{"class":824},[818,1642,1202],{"class":881},[818,1644,1390],{"class":832},[818,1646,1258],{"class":881},[818,1648,1261],{"class":828},[818,1650,1651,1653,1655,1657,1659,1661,1663,1665,1667,1669],{"class":820,"line":1032},[818,1652,1324],{"class":865},[818,1654,1626],{"class":832},[818,1656,1223],{"class":828},[818,1658,1408],{"class":832},[818,1660,1411],{"class":828},[818,1662,1132],{"class":1003},[818,1664,1416],{"class":828},[818,1666,1276],{"class":1275},[818,1668,1421],{"class":828},[818,1670,1671],{"class":1275}," 500\n",[818,1673,1674,1676,1678,1680,1683,1685,1688,1690,1692,1694,1696,1698,1701,1703,1705,1707],{"class":820,"line":1308},[818,1675,1283],{"class":824},[818,1677,1616],{"class":832},[818,1679,621],{"class":828},[818,1681,1682],{"class":990},"json",[818,1684,994],{"class":881},[818,1686,1687],{"class":828},"{",[818,1689,1288],{"class":881},[818,1691,885],{"class":828},[818,1693,842],{"class":828},[818,1695,1442],{"class":845},[818,1697,891],{"class":828},[818,1699,1700],{"class":828}," },",[818,1702,829],{"class":828},[818,1704,1626],{"class":832},[818,1706,836],{"class":828},[818,1708,1029],{"class":881},[818,1710,1711],{"class":820,"line":1313},[818,1712,1305],{"class":828},[818,1714,1715],{"class":820,"line":1321},[818,1716,1035],{"class":828},[808,1718,1721],{"className":810,"code":1719,"filename":275,"language":813,"meta":1720,"style":814},"import { Hono } from 'hono'\nimport { IngestValidationError } from '@evlog\u002Ftelemetry\u002Fingest'\nimport { parseTelemetryBody } from '..\u002Flib\u002Ftelemetry-ingest'\nimport { storeRunEvents } from '..\u002Flib\u002Ftelemetry-store'\n\nconst app = new Hono()\n\napp.post('\u002Fapi\u002Ftelemetry\u002Fingest', async (c) => {\n  const raw = await c.req.text()\n  try {\n    const events = parseTelemetryBody(raw)\n    await storeRunEvents(events)\n    return c.body(null, 204)\n  } catch (err) {\n    const status = err instanceof IngestValidationError ? 400 : 500\n    return c.json({ error: 'invalid payload' }, status)\n  }\n})\n\nexport default app\n","src\u002Froutes\u002Ftelemetry.ts",[618,1722,1723,1743,1761,1780,1799,1803,1819,1823,1857,1881,1887,1903,1915,1934,1948,1970,2000,2004,2010,2014],{"__ignoreMap":814},[818,1724,1725,1727,1729,1732,1734,1736,1738,1741],{"class":820,"line":821},[818,1726,825],{"class":824},[818,1728,829],{"class":828},[818,1730,1731],{"class":832}," Hono",[818,1733,836],{"class":828},[818,1735,839],{"class":824},[818,1737,842],{"class":828},[818,1739,1740],{"class":845},"hono",[818,1742,849],{"class":828},[818,1744,1745,1747,1749,1751,1753,1755,1757,1759],{"class":820,"line":852},[818,1746,825],{"class":824},[818,1748,829],{"class":828},[818,1750,1132],{"class":832},[818,1752,836],{"class":828},[818,1754,839],{"class":824},[818,1756,842],{"class":828},[818,1758,846],{"class":845},[818,1760,849],{"class":828},[818,1762,1763,1765,1767,1769,1771,1773,1775,1778],{"class":820,"line":859},[818,1764,825],{"class":824},[818,1766,829],{"class":828},[818,1768,991],{"class":832},[818,1770,836],{"class":828},[818,1772,839],{"class":824},[818,1774,842],{"class":828},[818,1776,1777],{"class":845},"..\u002Flib\u002Ftelemetry-ingest",[818,1779,849],{"class":828},[818,1781,1782,1784,1786,1788,1790,1792,1794,1797],{"class":820,"line":878},[818,1783,825],{"class":824},[818,1785,829],{"class":828},[818,1787,1170],{"class":832},[818,1789,836],{"class":828},[818,1791,839],{"class":824},[818,1793,842],{"class":828},[818,1795,1796],{"class":845},"..\u002Flib\u002Ftelemetry-store",[818,1798,849],{"class":828},[818,1800,1801],{"class":820,"line":905},[818,1802,856],{"emptyLinePlaceholder":855},[818,1804,1805,1808,1811,1813,1815,1817],{"class":820,"line":915},[818,1806,1807],{"class":865},"const",[818,1809,1810],{"class":832}," app ",[818,1812,872],{"class":828},[818,1814,1613],{"class":828},[818,1816,1731],{"class":990},[818,1818,1572],{"class":832},[818,1820,1821],{"class":820,"line":959},[818,1822,856],{"emptyLinePlaceholder":855},[818,1824,1825,1828,1830,1833,1835,1837,1840,1842,1844,1846,1848,1851,1853,1855],{"class":820,"line":965},[818,1826,1827],{"class":832},"app",[818,1829,621],{"class":828},[818,1831,1832],{"class":990},"post",[818,1834,994],{"class":832},[818,1836,891],{"class":828},[818,1838,1839],{"class":845},"\u002Fapi\u002Ftelemetry\u002Fingest",[818,1841,891],{"class":828},[818,1843,936],{"class":828},[818,1845,1532],{"class":865},[818,1847,1202],{"class":828},[818,1849,1850],{"class":997},"c",[818,1852,1007],{"class":828},[818,1854,1210],{"class":865},[818,1856,875],{"class":828},[818,1858,1859,1861,1863,1865,1867,1870,1872,1875,1877,1879],{"class":820,"line":977},[818,1860,1217],{"class":865},[818,1862,1220],{"class":832},[818,1864,1223],{"class":828},[818,1866,1226],{"class":824},[818,1868,1869],{"class":832}," c",[818,1871,621],{"class":828},[818,1873,1874],{"class":832},"req",[818,1876,621],{"class":828},[818,1878,1569],{"class":990},[818,1880,1572],{"class":881},[818,1882,1883,1885],{"class":820,"line":982},[818,1884,1316],{"class":824},[818,1886,875],{"class":828},[818,1888,1889,1891,1893,1895,1897,1899,1901],{"class":820,"line":1012},[818,1890,1324],{"class":865},[818,1892,1327],{"class":832},[818,1894,1223],{"class":828},[818,1896,991],{"class":990},[818,1898,994],{"class":881},[818,1900,998],{"class":832},[818,1902,1029],{"class":881},[818,1904,1905,1907,1909,1911,1913],{"class":820,"line":1032},[818,1906,1343],{"class":824},[818,1908,1170],{"class":990},[818,1910,994],{"class":881},[818,1912,1350],{"class":832},[818,1914,1029],{"class":881},[818,1916,1917,1919,1921,1923,1926,1928,1930,1932],{"class":820,"line":1308},[818,1918,1283],{"class":824},[818,1920,1869],{"class":832},[818,1922,621],{"class":828},[818,1924,1925],{"class":990},"body",[818,1927,994],{"class":881},[818,1929,1621],{"class":828},[818,1931,1366],{"class":1275},[818,1933,1029],{"class":881},[818,1935,1936,1938,1940,1942,1944,1946],{"class":820,"line":1313},[818,1937,1382],{"class":828},[818,1939,1385],{"class":824},[818,1941,1202],{"class":881},[818,1943,1390],{"class":832},[818,1945,1258],{"class":881},[818,1947,1261],{"class":828},[818,1949,1950,1952,1954,1956,1958,1960,1962,1964,1966,1968],{"class":820,"line":1321},[818,1951,1324],{"class":865},[818,1953,1626],{"class":832},[818,1955,1223],{"class":828},[818,1957,1408],{"class":832},[818,1959,1411],{"class":828},[818,1961,1132],{"class":1003},[818,1963,1416],{"class":828},[818,1965,1276],{"class":1275},[818,1967,1421],{"class":828},[818,1969,1671],{"class":1275},[818,1971,1972,1974,1976,1978,1980,1982,1984,1986,1988,1990,1992,1994,1996,1998],{"class":820,"line":1340},[818,1973,1283],{"class":824},[818,1975,1869],{"class":832},[818,1977,621],{"class":828},[818,1979,1682],{"class":990},[818,1981,994],{"class":881},[818,1983,1687],{"class":828},[818,1985,1288],{"class":881},[818,1987,885],{"class":828},[818,1989,842],{"class":828},[818,1991,1442],{"class":845},[818,1993,891],{"class":828},[818,1995,1700],{"class":828},[818,1997,1626],{"class":832},[818,1999,1029],{"class":881},[818,2001,2002],{"class":820,"line":1355},[818,2003,1305],{"class":828},[818,2005,2006,2008],{"class":820,"line":1371},[818,2007,968],{"class":828},[818,2009,1029],{"class":832},[818,2011,2012],{"class":820,"line":1379},[818,2013,856],{"emptyLinePlaceholder":855},[818,2015,2016,2018,2020],{"class":820,"line":1397},[818,2017,862],{"class":824},[818,2019,1192],{"class":824},[818,2021,2022],{"class":832}," app\n",[631,2024,2026],{"id":2025},"step-3-store-idempotently","Step 3: Store idempotently",[609,2028,2029,2030,2032],{},"Retries and backlog drains can POST the same ",[618,2031,752],{}," twice. Upsert (or skip) so metrics stay correct:",[808,2034,2037],{"className":810,"code":2035,"filename":2036,"language":813,"meta":814,"style":814},"import type { RunEvent } from '@evlog\u002Ftelemetry'\n\nexport async function storeRunEvents(events: RunEvent[]): Promise\u003Cvoid> {\n  for (const run of events) {\n    await db.telemetryRun.upsert({\n      where: { idempotencyKey: run.idempotencyKey },\n      create: {\n        tool: run.tool.name,\n        version: run.tool.version,\n        command: run.command,\n        outcome: run.outcome,\n        durationMs: run.durationMs,\n        custom: run.custom,\n        recordedAt: run.timestamp,\n      },\n      update: {},\n    })\n  }\n\n  \u002F\u002F Or forward into evlog's drain pipeline for Axiom \u002F Datadog \u002F OTLP:\n  \u002F\u002F await ingestWideEvents(events.map(run => ({ source: 'telemetry', ...run })))\n}\n","lib\u002Ftelemetry-store.ts",[618,2038,2039,2061,2065,2103,2124,2145,2168,2177,2197,2217,2233,2249,2265,2280,2296,2301,2311,2318,2322,2326,2332,2337],{"__ignoreMap":814},[818,2040,2041,2043,2046,2048,2051,2053,2055,2057,2059],{"class":820,"line":821},[818,2042,825],{"class":824},[818,2044,2045],{"class":824}," type",[818,2047,829],{"class":828},[818,2049,2050],{"class":832}," RunEvent",[818,2052,836],{"class":828},[818,2054,839],{"class":824},[818,2056,842],{"class":828},[818,2058,781],{"class":845},[818,2060,849],{"class":828},[818,2062,2063],{"class":820,"line":852},[818,2064,856],{"emptyLinePlaceholder":855},[818,2066,2067,2069,2071,2073,2075,2077,2079,2081,2083,2086,2089,2092,2095,2098,2101],{"class":820,"line":859},[818,2068,862],{"class":824},[818,2070,1532],{"class":865},[818,2072,987],{"class":865},[818,2074,1170],{"class":990},[818,2076,994],{"class":828},[818,2078,1350],{"class":997},[818,2080,885],{"class":828},[818,2082,2050],{"class":1003},[818,2084,2085],{"class":832},"[]",[818,2087,2088],{"class":828},"):",[818,2090,2091],{"class":1003}," Promise",[818,2093,2094],{"class":828},"\u003C",[818,2096,2097],{"class":1003},"void",[818,2099,2100],{"class":828},">",[818,2102,875],{"class":828},[818,2104,2105,2108,2110,2112,2115,2118,2120,2122],{"class":820,"line":878},[818,2106,2107],{"class":824},"  for",[818,2109,1202],{"class":881},[818,2111,1807],{"class":865},[818,2113,2114],{"class":832}," run",[818,2116,2117],{"class":828}," of",[818,2119,1327],{"class":832},[818,2121,1258],{"class":881},[818,2123,1261],{"class":828},[818,2125,2126,2128,2131,2133,2136,2138,2141,2143],{"class":820,"line":905},[818,2127,1343],{"class":824},[818,2129,2130],{"class":832}," db",[818,2132,621],{"class":828},[818,2134,2135],{"class":832},"telemetryRun",[818,2137,621],{"class":828},[818,2139,2140],{"class":990},"upsert",[818,2142,994],{"class":881},[818,2144,1261],{"class":828},[818,2146,2147,2150,2152,2154,2157,2159,2161,2163,2165],{"class":820,"line":915},[818,2148,2149],{"class":881},"      where",[818,2151,885],{"class":828},[818,2153,829],{"class":828},[818,2155,2156],{"class":881}," idempotencyKey",[818,2158,885],{"class":828},[818,2160,2114],{"class":832},[818,2162,621],{"class":828},[818,2164,752],{"class":832},[818,2166,2167],{"class":828}," },\n",[818,2169,2170,2173,2175],{"class":820,"line":959},[818,2171,2172],{"class":881},"      create",[818,2174,885],{"class":828},[818,2176,875],{"class":828},[818,2178,2179,2182,2184,2186,2188,2191,2193,2195],{"class":820,"line":965},[818,2180,2181],{"class":881},"        tool",[818,2183,885],{"class":828},[818,2185,2114],{"class":832},[818,2187,621],{"class":828},[818,2189,2190],{"class":832},"tool",[818,2192,621],{"class":828},[818,2194,800],{"class":832},[818,2196,902],{"class":828},[818,2198,2199,2202,2204,2206,2208,2210,2212,2215],{"class":820,"line":977},[818,2200,2201],{"class":881},"        version",[818,2203,885],{"class":828},[818,2205,2114],{"class":832},[818,2207,621],{"class":828},[818,2209,2190],{"class":832},[818,2211,621],{"class":828},[818,2213,2214],{"class":832},"version",[818,2216,902],{"class":828},[818,2218,2219,2222,2224,2226,2228,2231],{"class":820,"line":982},[818,2220,2221],{"class":881},"        command",[818,2223,885],{"class":828},[818,2225,2114],{"class":832},[818,2227,621],{"class":828},[818,2229,2230],{"class":832},"command",[818,2232,902],{"class":828},[818,2234,2235,2238,2240,2242,2244,2247],{"class":820,"line":1012},[818,2236,2237],{"class":881},"        outcome",[818,2239,885],{"class":828},[818,2241,2114],{"class":832},[818,2243,621],{"class":828},[818,2245,2246],{"class":832},"outcome",[818,2248,902],{"class":828},[818,2250,2251,2254,2256,2258,2260,2263],{"class":820,"line":1032},[818,2252,2253],{"class":881},"        durationMs",[818,2255,885],{"class":828},[818,2257,2114],{"class":832},[818,2259,621],{"class":828},[818,2261,2262],{"class":832},"durationMs",[818,2264,902],{"class":828},[818,2266,2267,2270,2272,2274,2276,2278],{"class":820,"line":1308},[818,2268,2269],{"class":881},"        custom",[818,2271,885],{"class":828},[818,2273,2114],{"class":832},[818,2275,621],{"class":828},[818,2277,734],{"class":832},[818,2279,902],{"class":828},[818,2281,2282,2285,2287,2289,2291,2294],{"class":820,"line":1313},[818,2283,2284],{"class":881},"        recordedAt",[818,2286,885],{"class":828},[818,2288,2114],{"class":832},[818,2290,621],{"class":828},[818,2292,2293],{"class":832},"timestamp",[818,2295,902],{"class":828},[818,2297,2298],{"class":820,"line":1321},[818,2299,2300],{"class":828},"      },\n",[818,2302,2303,2306,2308],{"class":820,"line":1340},[818,2304,2305],{"class":881},"      update",[818,2307,885],{"class":828},[818,2309,2310],{"class":828}," {},\n",[818,2312,2313,2316],{"class":820,"line":1355},[818,2314,2315],{"class":828},"    }",[818,2317,1029],{"class":881},[818,2319,2320],{"class":820,"line":1371},[818,2321,1305],{"class":828},[818,2323,2324],{"class":820,"line":1379},[818,2325,856],{"emptyLinePlaceholder":855},[818,2327,2328],{"class":820,"line":1397},[818,2329,2331],{"class":2330},"sHwdD","  \u002F\u002F Or forward into evlog's drain pipeline for Axiom \u002F Datadog \u002F OTLP:\n",[818,2333,2334],{"class":820,"line":1429},[818,2335,2336],{"class":2330},"  \u002F\u002F await ingestWideEvents(events.map(run => ({ source: 'telemetry', ...run })))\n",[818,2338,2339],{"class":820,"line":1449},[818,2340,1035],{"class":828},[631,2342,2344],{"id":2343},"step-4-rate-limit-at-the-edge","Step 4: Rate-limit at the edge",[609,2346,2347,2349,2350,2353],{},[618,2348,787],{}," is your last line of schema defense, not your only one. Add rate limits where traffic enters (CDN, API gateway, or middleware), especially per IP. Optional: also bucket by ",[618,2351,2352],{},"machineId"," hash inside the handler if you need tighter control.",[609,2355,2356,2357,2359,2360,2363],{},"Non-2xx responses keep events in the user's outbox; they will retry on the next CLI invocation. Return ",[626,2358,1064],{}," (or any ",[618,2361,2362],{},"2xx",") only when storage succeeded.",[2365,2366,2367],"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 .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 pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}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":814,"searchDepth":852,"depth":852,"links":2369},[2370,2371,2373,2374,2375],{"id":633,"depth":852,"text":634},{"id":791,"depth":852,"text":2372},"Step 1: Validate with parseIngestBody()",{"id":1057,"depth":852,"text":1058},{"id":2025,"depth":852,"text":2026},{"id":2343,"depth":852,"text":2344},"Build the ingestion endpoint for @evlog\u002Ftelemetry: the threat model, parseIngestBody validation, framework routes, storage, and rate limiting.","md",[2379,2382,2383],{"label":41,"icon":44,"to":423,"color":2380,"variant":2381},"neutral","subtle",{"label":426,"icon":429,"to":427,"color":2380,"variant":2381},{"label":436,"icon":84,"to":437,"color":2380,"variant":2381},{},{"title":431,"icon":434},{"title":604,"description":2376},"4xOInV-u8ylfgQLtnJj5TS0WE9bcCS-4I64jJLFaMxc",[2389,2391],{"title":426,"path":427,"stem":428,"description":2390,"icon":429,"children":-1},"Wire @evlog\u002Ftelemetry into citty CLIs, standalone scripts, and GitHub Actions — delivery config, automatic flag capture, telemetry.set(), and debug mode.",{"title":436,"path":437,"stem":438,"description":2392,"icon":84,"children":-1},"RunEvent envelope, extending the schema with collect and custom fields, privacy rules, TELEMETRY.md disclosure, and consent \u002F outbox reliability.",1791058670285]