[{"data":1,"prerenderedAt":2373},["ShallowReactive",2],{"navigation_docs":3,"-use-cases-telemetry-ingest":602,"-use-cases-telemetry-ingest-surround":2368},[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":2356,"extension":2357,"links":2358,"meta":2364,"navigation":2365,"path":432,"seo":2366,"stem":433,"__hash__":2367},"docs\u002F5.use-cases\u002F4.telemetry\u002F03.ingest.md","Telemetry Ingest",{"type":606,"value":607,"toc":2348},"minimark",[608,622,630,635,642,647,658,663,674,769,775,789,795,807,1036,1055,1059,1066,2003,2007,2013,2321,2325,2334,2344],[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,1439,1697],"framework-tabs",{},[808,1070,1073],{"className":810,"code":1071,"filename":255,"language":813,"meta":1072,"style":814},"import { defineEventHandler, 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 defineEventHandler(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,1105,1124,1143,1163,1167,1194,1225,1243,1260,1282,1287,1291,1299,1318,1333,1349,1357,1375,1407,1427,1432],{"__ignoreMap":814},[818,1076,1077,1079,1081,1084,1086,1089,1091,1094,1096,1098,1100,1103],{"class":820,"line":821},[818,1078,825],{"class":824},[818,1080,829],{"class":828},[818,1082,1083],{"class":832}," defineEventHandler",[818,1085,936],{"class":828},[818,1087,1088],{"class":832}," readRawBody",[818,1090,936],{"class":828},[818,1092,1093],{"class":832}," setResponseStatus",[818,1095,836],{"class":828},[818,1097,839],{"class":824},[818,1099,842],{"class":828},[818,1101,1102],{"class":845},"h3",[818,1104,849],{"class":828},[818,1106,1107,1109,1111,1114,1116,1118,1120,1122],{"class":820,"line":852},[818,1108,825],{"class":824},[818,1110,829],{"class":828},[818,1112,1113],{"class":832}," IngestValidationError",[818,1115,836],{"class":828},[818,1117,839],{"class":824},[818,1119,842],{"class":828},[818,1121,846],{"class":845},[818,1123,849],{"class":828},[818,1125,1126,1128,1130,1132,1134,1136,1138,1141],{"class":820,"line":859},[818,1127,825],{"class":824},[818,1129,829],{"class":828},[818,1131,991],{"class":832},[818,1133,836],{"class":828},[818,1135,839],{"class":824},[818,1137,842],{"class":828},[818,1139,1140],{"class":845},"~\u002Flib\u002Ftelemetry-ingest",[818,1142,849],{"class":828},[818,1144,1145,1147,1149,1152,1154,1156,1158,1161],{"class":820,"line":878},[818,1146,825],{"class":824},[818,1148,829],{"class":828},[818,1150,1151],{"class":832}," storeRunEvents",[818,1153,836],{"class":828},[818,1155,839],{"class":824},[818,1157,842],{"class":828},[818,1159,1160],{"class":845},"~\u002Flib\u002Ftelemetry-store",[818,1162,849],{"class":828},[818,1164,1165],{"class":820,"line":905},[818,1166,856],{"emptyLinePlaceholder":855},[818,1168,1169,1171,1174,1176,1178,1181,1184,1187,1189,1192],{"class":820,"line":915},[818,1170,862],{"class":824},[818,1172,1173],{"class":824}," default",[818,1175,1083],{"class":990},[818,1177,994],{"class":832},[818,1179,1180],{"class":865},"async",[818,1182,1183],{"class":828}," (",[818,1185,1186],{"class":997},"event",[818,1188,1007],{"class":828},[818,1190,1191],{"class":865}," =>",[818,1193,875],{"class":828},[818,1195,1196,1199,1202,1205,1208,1210,1212,1214,1216,1218,1221,1223],{"class":820,"line":959},[818,1197,1198],{"class":865},"  const",[818,1200,1201],{"class":832}," raw",[818,1203,1204],{"class":828}," =",[818,1206,1207],{"class":824}," await",[818,1209,1088],{"class":990},[818,1211,994],{"class":881},[818,1213,1186],{"class":832},[818,1215,936],{"class":828},[818,1217,842],{"class":828},[818,1219,1220],{"class":845},"utf8",[818,1222,891],{"class":828},[818,1224,1029],{"class":881},[818,1226,1227,1230,1232,1235,1237,1240],{"class":820,"line":965},[818,1228,1229],{"class":824},"  if",[818,1231,1183],{"class":881},[818,1233,1234],{"class":828},"!",[818,1236,998],{"class":832},[818,1238,1239],{"class":881},") ",[818,1241,1242],{"class":828},"{\n",[818,1244,1245,1248,1250,1252,1254,1258],{"class":820,"line":977},[818,1246,1247],{"class":990},"    setResponseStatus",[818,1249,994],{"class":881},[818,1251,1186],{"class":832},[818,1253,936],{"class":828},[818,1255,1257],{"class":1256},"sbssI"," 400",[818,1259,1029],{"class":881},[818,1261,1262,1265,1267,1270,1272,1274,1277,1279],{"class":820,"line":982},[818,1263,1264],{"class":824},"    return",[818,1266,829],{"class":828},[818,1268,1269],{"class":881}," error",[818,1271,885],{"class":828},[818,1273,842],{"class":828},[818,1275,1276],{"class":845},"empty body",[818,1278,891],{"class":828},[818,1280,1281],{"class":828}," }\n",[818,1283,1284],{"class":820,"line":1012},[818,1285,1286],{"class":828},"  }\n",[818,1288,1289],{"class":820,"line":1032},[818,1290,856],{"emptyLinePlaceholder":855},[818,1292,1294,1297],{"class":820,"line":1293},13,[818,1295,1296],{"class":824},"  try",[818,1298,875],{"class":828},[818,1300,1302,1305,1308,1310,1312,1314,1316],{"class":820,"line":1301},14,[818,1303,1304],{"class":865},"    const",[818,1306,1307],{"class":832}," events",[818,1309,1204],{"class":828},[818,1311,991],{"class":990},[818,1313,994],{"class":881},[818,1315,998],{"class":832},[818,1317,1029],{"class":881},[818,1319,1321,1324,1326,1328,1331],{"class":820,"line":1320},15,[818,1322,1323],{"class":824},"    await",[818,1325,1151],{"class":990},[818,1327,994],{"class":881},[818,1329,1330],{"class":832},"events",[818,1332,1029],{"class":881},[818,1334,1336,1338,1340,1342,1344,1347],{"class":820,"line":1335},16,[818,1337,1247],{"class":990},[818,1339,994],{"class":881},[818,1341,1186],{"class":832},[818,1343,936],{"class":828},[818,1345,1346],{"class":1256}," 204",[818,1348,1029],{"class":881},[818,1350,1352,1354],{"class":820,"line":1351},17,[818,1353,1264],{"class":824},[818,1355,1356],{"class":828}," null\n",[818,1358,1360,1363,1366,1368,1371,1373],{"class":820,"line":1359},18,[818,1361,1362],{"class":828},"  }",[818,1364,1365],{"class":824}," catch",[818,1367,1183],{"class":881},[818,1369,1370],{"class":832},"err",[818,1372,1239],{"class":881},[818,1374,1242],{"class":828},[818,1376,1378,1380,1382,1384,1386,1389,1392,1394,1397,1399,1402,1405],{"class":820,"line":1377},19,[818,1379,1247],{"class":990},[818,1381,994],{"class":881},[818,1383,1186],{"class":832},[818,1385,936],{"class":828},[818,1387,1388],{"class":832}," err",[818,1390,1391],{"class":828}," instanceof",[818,1393,1113],{"class":1003},[818,1395,1396],{"class":828}," ?",[818,1398,1257],{"class":1256},[818,1400,1401],{"class":828}," :",[818,1403,1404],{"class":1256}," 500",[818,1406,1029],{"class":881},[818,1408,1410,1412,1414,1416,1418,1420,1423,1425],{"class":820,"line":1409},20,[818,1411,1264],{"class":824},[818,1413,829],{"class":828},[818,1415,1269],{"class":881},[818,1417,885],{"class":828},[818,1419,842],{"class":828},[818,1421,1422],{"class":845},"invalid payload",[818,1424,891],{"class":828},[818,1426,1281],{"class":828},[818,1428,1430],{"class":820,"line":1429},21,[818,1431,1286],{"class":828},[818,1433,1435,1437],{"class":820,"line":1434},22,[818,1436,968],{"class":828},[818,1438,1029],{"class":832},[808,1440,1444],{"className":810,"code":1441,"filename":1442,"language":813,"meta":1443,"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,1445,1446,1464,1483,1502,1506,1532,1553,1559,1575,1587,1615,1629,1652,1689,1693],{"__ignoreMap":814},[818,1447,1448,1450,1452,1454,1456,1458,1460,1462],{"class":820,"line":821},[818,1449,825],{"class":824},[818,1451,829],{"class":828},[818,1453,1113],{"class":832},[818,1455,836],{"class":828},[818,1457,839],{"class":824},[818,1459,842],{"class":828},[818,1461,846],{"class":845},[818,1463,849],{"class":828},[818,1465,1466,1468,1470,1472,1474,1476,1478,1481],{"class":820,"line":852},[818,1467,825],{"class":824},[818,1469,829],{"class":828},[818,1471,991],{"class":832},[818,1473,836],{"class":828},[818,1475,839],{"class":824},[818,1477,842],{"class":828},[818,1479,1480],{"class":845},"@\u002Flib\u002Ftelemetry-ingest",[818,1482,849],{"class":828},[818,1484,1485,1487,1489,1491,1493,1495,1497,1500],{"class":820,"line":859},[818,1486,825],{"class":824},[818,1488,829],{"class":828},[818,1490,1151],{"class":832},[818,1492,836],{"class":828},[818,1494,839],{"class":824},[818,1496,842],{"class":828},[818,1498,1499],{"class":845},"@\u002Flib\u002Ftelemetry-store",[818,1501,849],{"class":828},[818,1503,1504],{"class":820,"line":878},[818,1505,856],{"emptyLinePlaceholder":855},[818,1507,1508,1510,1513,1515,1518,1520,1523,1525,1528,1530],{"class":820,"line":905},[818,1509,862],{"class":824},[818,1511,1512],{"class":865}," async",[818,1514,987],{"class":865},[818,1516,1517],{"class":990}," POST",[818,1519,994],{"class":828},[818,1521,1522],{"class":997},"request",[818,1524,885],{"class":828},[818,1526,1527],{"class":1003}," Request",[818,1529,1007],{"class":828},[818,1531,875],{"class":828},[818,1533,1534,1536,1538,1540,1542,1545,1547,1550],{"class":820,"line":915},[818,1535,1198],{"class":865},[818,1537,1201],{"class":832},[818,1539,1204],{"class":828},[818,1541,1207],{"class":824},[818,1543,1544],{"class":832}," request",[818,1546,621],{"class":828},[818,1548,1549],{"class":990},"text",[818,1551,1552],{"class":881},"()\n",[818,1554,1555,1557],{"class":820,"line":959},[818,1556,1296],{"class":824},[818,1558,875],{"class":828},[818,1560,1561,1563,1565,1567,1569,1571,1573],{"class":820,"line":965},[818,1562,1304],{"class":865},[818,1564,1307],{"class":832},[818,1566,1204],{"class":828},[818,1568,991],{"class":990},[818,1570,994],{"class":881},[818,1572,998],{"class":832},[818,1574,1029],{"class":881},[818,1576,1577,1579,1581,1583,1585],{"class":820,"line":977},[818,1578,1323],{"class":824},[818,1580,1151],{"class":990},[818,1582,994],{"class":881},[818,1584,1330],{"class":832},[818,1586,1029],{"class":881},[818,1588,1589,1591,1594,1597,1599,1602,1604,1607,1609,1611,1613],{"class":820,"line":982},[818,1590,1264],{"class":824},[818,1592,1593],{"class":828}," new",[818,1595,1596],{"class":990}," Response",[818,1598,994],{"class":881},[818,1600,1601],{"class":828},"null,",[818,1603,829],{"class":828},[818,1605,1606],{"class":881}," status",[818,1608,885],{"class":828},[818,1610,1346],{"class":1256},[818,1612,836],{"class":828},[818,1614,1029],{"class":881},[818,1616,1617,1619,1621,1623,1625,1627],{"class":820,"line":1012},[818,1618,1362],{"class":828},[818,1620,1365],{"class":824},[818,1622,1183],{"class":881},[818,1624,1370],{"class":832},[818,1626,1239],{"class":881},[818,1628,1242],{"class":828},[818,1630,1631,1633,1635,1637,1639,1641,1643,1645,1647,1649],{"class":820,"line":1032},[818,1632,1304],{"class":865},[818,1634,1606],{"class":832},[818,1636,1204],{"class":828},[818,1638,1388],{"class":832},[818,1640,1391],{"class":828},[818,1642,1113],{"class":1003},[818,1644,1396],{"class":828},[818,1646,1257],{"class":1256},[818,1648,1401],{"class":828},[818,1650,1651],{"class":1256}," 500\n",[818,1653,1654,1656,1658,1660,1663,1665,1668,1670,1672,1674,1676,1678,1681,1683,1685,1687],{"class":820,"line":1293},[818,1655,1264],{"class":824},[818,1657,1596],{"class":832},[818,1659,621],{"class":828},[818,1661,1662],{"class":990},"json",[818,1664,994],{"class":881},[818,1666,1667],{"class":828},"{",[818,1669,1269],{"class":881},[818,1671,885],{"class":828},[818,1673,842],{"class":828},[818,1675,1422],{"class":845},[818,1677,891],{"class":828},[818,1679,1680],{"class":828}," },",[818,1682,829],{"class":828},[818,1684,1606],{"class":832},[818,1686,836],{"class":828},[818,1688,1029],{"class":881},[818,1690,1691],{"class":820,"line":1301},[818,1692,1286],{"class":828},[818,1694,1695],{"class":820,"line":1320},[818,1696,1035],{"class":828},[808,1698,1701],{"className":810,"code":1699,"filename":275,"language":813,"meta":1700,"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,1702,1703,1723,1741,1760,1779,1783,1799,1803,1837,1861,1867,1883,1895,1914,1928,1950,1980,1984,1990,1994],{"__ignoreMap":814},[818,1704,1705,1707,1709,1712,1714,1716,1718,1721],{"class":820,"line":821},[818,1706,825],{"class":824},[818,1708,829],{"class":828},[818,1710,1711],{"class":832}," Hono",[818,1713,836],{"class":828},[818,1715,839],{"class":824},[818,1717,842],{"class":828},[818,1719,1720],{"class":845},"hono",[818,1722,849],{"class":828},[818,1724,1725,1727,1729,1731,1733,1735,1737,1739],{"class":820,"line":852},[818,1726,825],{"class":824},[818,1728,829],{"class":828},[818,1730,1113],{"class":832},[818,1732,836],{"class":828},[818,1734,839],{"class":824},[818,1736,842],{"class":828},[818,1738,846],{"class":845},[818,1740,849],{"class":828},[818,1742,1743,1745,1747,1749,1751,1753,1755,1758],{"class":820,"line":859},[818,1744,825],{"class":824},[818,1746,829],{"class":828},[818,1748,991],{"class":832},[818,1750,836],{"class":828},[818,1752,839],{"class":824},[818,1754,842],{"class":828},[818,1756,1757],{"class":845},"..\u002Flib\u002Ftelemetry-ingest",[818,1759,849],{"class":828},[818,1761,1762,1764,1766,1768,1770,1772,1774,1777],{"class":820,"line":878},[818,1763,825],{"class":824},[818,1765,829],{"class":828},[818,1767,1151],{"class":832},[818,1769,836],{"class":828},[818,1771,839],{"class":824},[818,1773,842],{"class":828},[818,1775,1776],{"class":845},"..\u002Flib\u002Ftelemetry-store",[818,1778,849],{"class":828},[818,1780,1781],{"class":820,"line":905},[818,1782,856],{"emptyLinePlaceholder":855},[818,1784,1785,1788,1791,1793,1795,1797],{"class":820,"line":915},[818,1786,1787],{"class":865},"const",[818,1789,1790],{"class":832}," app ",[818,1792,872],{"class":828},[818,1794,1593],{"class":828},[818,1796,1711],{"class":990},[818,1798,1552],{"class":832},[818,1800,1801],{"class":820,"line":959},[818,1802,856],{"emptyLinePlaceholder":855},[818,1804,1805,1808,1810,1813,1815,1817,1820,1822,1824,1826,1828,1831,1833,1835],{"class":820,"line":965},[818,1806,1807],{"class":832},"app",[818,1809,621],{"class":828},[818,1811,1812],{"class":990},"post",[818,1814,994],{"class":832},[818,1816,891],{"class":828},[818,1818,1819],{"class":845},"\u002Fapi\u002Ftelemetry\u002Fingest",[818,1821,891],{"class":828},[818,1823,936],{"class":828},[818,1825,1512],{"class":865},[818,1827,1183],{"class":828},[818,1829,1830],{"class":997},"c",[818,1832,1007],{"class":828},[818,1834,1191],{"class":865},[818,1836,875],{"class":828},[818,1838,1839,1841,1843,1845,1847,1850,1852,1855,1857,1859],{"class":820,"line":977},[818,1840,1198],{"class":865},[818,1842,1201],{"class":832},[818,1844,1204],{"class":828},[818,1846,1207],{"class":824},[818,1848,1849],{"class":832}," c",[818,1851,621],{"class":828},[818,1853,1854],{"class":832},"req",[818,1856,621],{"class":828},[818,1858,1549],{"class":990},[818,1860,1552],{"class":881},[818,1862,1863,1865],{"class":820,"line":982},[818,1864,1296],{"class":824},[818,1866,875],{"class":828},[818,1868,1869,1871,1873,1875,1877,1879,1881],{"class":820,"line":1012},[818,1870,1304],{"class":865},[818,1872,1307],{"class":832},[818,1874,1204],{"class":828},[818,1876,991],{"class":990},[818,1878,994],{"class":881},[818,1880,998],{"class":832},[818,1882,1029],{"class":881},[818,1884,1885,1887,1889,1891,1893],{"class":820,"line":1032},[818,1886,1323],{"class":824},[818,1888,1151],{"class":990},[818,1890,994],{"class":881},[818,1892,1330],{"class":832},[818,1894,1029],{"class":881},[818,1896,1897,1899,1901,1903,1906,1908,1910,1912],{"class":820,"line":1293},[818,1898,1264],{"class":824},[818,1900,1849],{"class":832},[818,1902,621],{"class":828},[818,1904,1905],{"class":990},"body",[818,1907,994],{"class":881},[818,1909,1601],{"class":828},[818,1911,1346],{"class":1256},[818,1913,1029],{"class":881},[818,1915,1916,1918,1920,1922,1924,1926],{"class":820,"line":1301},[818,1917,1362],{"class":828},[818,1919,1365],{"class":824},[818,1921,1183],{"class":881},[818,1923,1370],{"class":832},[818,1925,1239],{"class":881},[818,1927,1242],{"class":828},[818,1929,1930,1932,1934,1936,1938,1940,1942,1944,1946,1948],{"class":820,"line":1320},[818,1931,1304],{"class":865},[818,1933,1606],{"class":832},[818,1935,1204],{"class":828},[818,1937,1388],{"class":832},[818,1939,1391],{"class":828},[818,1941,1113],{"class":1003},[818,1943,1396],{"class":828},[818,1945,1257],{"class":1256},[818,1947,1401],{"class":828},[818,1949,1651],{"class":1256},[818,1951,1952,1954,1956,1958,1960,1962,1964,1966,1968,1970,1972,1974,1976,1978],{"class":820,"line":1335},[818,1953,1264],{"class":824},[818,1955,1849],{"class":832},[818,1957,621],{"class":828},[818,1959,1662],{"class":990},[818,1961,994],{"class":881},[818,1963,1667],{"class":828},[818,1965,1269],{"class":881},[818,1967,885],{"class":828},[818,1969,842],{"class":828},[818,1971,1422],{"class":845},[818,1973,891],{"class":828},[818,1975,1680],{"class":828},[818,1977,1606],{"class":832},[818,1979,1029],{"class":881},[818,1981,1982],{"class":820,"line":1351},[818,1983,1286],{"class":828},[818,1985,1986,1988],{"class":820,"line":1359},[818,1987,968],{"class":828},[818,1989,1029],{"class":832},[818,1991,1992],{"class":820,"line":1377},[818,1993,856],{"emptyLinePlaceholder":855},[818,1995,1996,1998,2000],{"class":820,"line":1409},[818,1997,862],{"class":824},[818,1999,1173],{"class":824},[818,2001,2002],{"class":832}," app\n",[631,2004,2006],{"id":2005},"step-3-store-idempotently","Step 3: Store idempotently",[609,2008,2009,2010,2012],{},"Retries and backlog drains can POST the same ",[618,2011,752],{}," twice. Upsert (or skip) so metrics stay correct:",[808,2014,2017],{"className":810,"code":2015,"filename":2016,"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,2018,2019,2041,2045,2083,2104,2125,2148,2157,2177,2197,2213,2229,2245,2260,2276,2281,2291,2298,2302,2306,2312,2317],{"__ignoreMap":814},[818,2020,2021,2023,2026,2028,2031,2033,2035,2037,2039],{"class":820,"line":821},[818,2022,825],{"class":824},[818,2024,2025],{"class":824}," type",[818,2027,829],{"class":828},[818,2029,2030],{"class":832}," RunEvent",[818,2032,836],{"class":828},[818,2034,839],{"class":824},[818,2036,842],{"class":828},[818,2038,781],{"class":845},[818,2040,849],{"class":828},[818,2042,2043],{"class":820,"line":852},[818,2044,856],{"emptyLinePlaceholder":855},[818,2046,2047,2049,2051,2053,2055,2057,2059,2061,2063,2066,2069,2072,2075,2078,2081],{"class":820,"line":859},[818,2048,862],{"class":824},[818,2050,1512],{"class":865},[818,2052,987],{"class":865},[818,2054,1151],{"class":990},[818,2056,994],{"class":828},[818,2058,1330],{"class":997},[818,2060,885],{"class":828},[818,2062,2030],{"class":1003},[818,2064,2065],{"class":832},"[]",[818,2067,2068],{"class":828},"):",[818,2070,2071],{"class":1003}," Promise",[818,2073,2074],{"class":828},"\u003C",[818,2076,2077],{"class":1003},"void",[818,2079,2080],{"class":828},">",[818,2082,875],{"class":828},[818,2084,2085,2088,2090,2092,2095,2098,2100,2102],{"class":820,"line":878},[818,2086,2087],{"class":824},"  for",[818,2089,1183],{"class":881},[818,2091,1787],{"class":865},[818,2093,2094],{"class":832}," run",[818,2096,2097],{"class":828}," of",[818,2099,1307],{"class":832},[818,2101,1239],{"class":881},[818,2103,1242],{"class":828},[818,2105,2106,2108,2111,2113,2116,2118,2121,2123],{"class":820,"line":905},[818,2107,1323],{"class":824},[818,2109,2110],{"class":832}," db",[818,2112,621],{"class":828},[818,2114,2115],{"class":832},"telemetryRun",[818,2117,621],{"class":828},[818,2119,2120],{"class":990},"upsert",[818,2122,994],{"class":881},[818,2124,1242],{"class":828},[818,2126,2127,2130,2132,2134,2137,2139,2141,2143,2145],{"class":820,"line":915},[818,2128,2129],{"class":881},"      where",[818,2131,885],{"class":828},[818,2133,829],{"class":828},[818,2135,2136],{"class":881}," idempotencyKey",[818,2138,885],{"class":828},[818,2140,2094],{"class":832},[818,2142,621],{"class":828},[818,2144,752],{"class":832},[818,2146,2147],{"class":828}," },\n",[818,2149,2150,2153,2155],{"class":820,"line":959},[818,2151,2152],{"class":881},"      create",[818,2154,885],{"class":828},[818,2156,875],{"class":828},[818,2158,2159,2162,2164,2166,2168,2171,2173,2175],{"class":820,"line":965},[818,2160,2161],{"class":881},"        tool",[818,2163,885],{"class":828},[818,2165,2094],{"class":832},[818,2167,621],{"class":828},[818,2169,2170],{"class":832},"tool",[818,2172,621],{"class":828},[818,2174,800],{"class":832},[818,2176,902],{"class":828},[818,2178,2179,2182,2184,2186,2188,2190,2192,2195],{"class":820,"line":977},[818,2180,2181],{"class":881},"        version",[818,2183,885],{"class":828},[818,2185,2094],{"class":832},[818,2187,621],{"class":828},[818,2189,2170],{"class":832},[818,2191,621],{"class":828},[818,2193,2194],{"class":832},"version",[818,2196,902],{"class":828},[818,2198,2199,2202,2204,2206,2208,2211],{"class":820,"line":982},[818,2200,2201],{"class":881},"        command",[818,2203,885],{"class":828},[818,2205,2094],{"class":832},[818,2207,621],{"class":828},[818,2209,2210],{"class":832},"command",[818,2212,902],{"class":828},[818,2214,2215,2218,2220,2222,2224,2227],{"class":820,"line":1012},[818,2216,2217],{"class":881},"        outcome",[818,2219,885],{"class":828},[818,2221,2094],{"class":832},[818,2223,621],{"class":828},[818,2225,2226],{"class":832},"outcome",[818,2228,902],{"class":828},[818,2230,2231,2234,2236,2238,2240,2243],{"class":820,"line":1032},[818,2232,2233],{"class":881},"        durationMs",[818,2235,885],{"class":828},[818,2237,2094],{"class":832},[818,2239,621],{"class":828},[818,2241,2242],{"class":832},"durationMs",[818,2244,902],{"class":828},[818,2246,2247,2250,2252,2254,2256,2258],{"class":820,"line":1293},[818,2248,2249],{"class":881},"        custom",[818,2251,885],{"class":828},[818,2253,2094],{"class":832},[818,2255,621],{"class":828},[818,2257,734],{"class":832},[818,2259,902],{"class":828},[818,2261,2262,2265,2267,2269,2271,2274],{"class":820,"line":1301},[818,2263,2264],{"class":881},"        recordedAt",[818,2266,885],{"class":828},[818,2268,2094],{"class":832},[818,2270,621],{"class":828},[818,2272,2273],{"class":832},"timestamp",[818,2275,902],{"class":828},[818,2277,2278],{"class":820,"line":1320},[818,2279,2280],{"class":828},"      },\n",[818,2282,2283,2286,2288],{"class":820,"line":1335},[818,2284,2285],{"class":881},"      update",[818,2287,885],{"class":828},[818,2289,2290],{"class":828}," {},\n",[818,2292,2293,2296],{"class":820,"line":1351},[818,2294,2295],{"class":828},"    }",[818,2297,1029],{"class":881},[818,2299,2300],{"class":820,"line":1359},[818,2301,1286],{"class":828},[818,2303,2304],{"class":820,"line":1377},[818,2305,856],{"emptyLinePlaceholder":855},[818,2307,2308],{"class":820,"line":1409},[818,2309,2311],{"class":2310},"sHwdD","  \u002F\u002F Or forward into evlog's drain pipeline for Axiom \u002F Datadog \u002F OTLP:\n",[818,2313,2314],{"class":820,"line":1429},[818,2315,2316],{"class":2310},"  \u002F\u002F await ingestWideEvents(events.map(run => ({ source: 'telemetry', ...run })))\n",[818,2318,2319],{"class":820,"line":1434},[818,2320,1035],{"class":828},[631,2322,2324],{"id":2323},"step-4-rate-limit-at-the-edge","Step 4: Rate-limit at the edge",[609,2326,2327,2329,2330,2333],{},[618,2328,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,2331,2332],{},"machineId"," hash inside the handler if you need tighter control.",[609,2335,2336,2337,2339,2340,2343],{},"Non-2xx responses keep events in the user's outbox; they will retry on the next CLI invocation. Return ",[626,2338,1064],{}," (or any ",[618,2341,2342],{},"2xx",") only when storage succeeded.",[2345,2346,2347],"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":2349},[2350,2351,2353,2354,2355],{"id":633,"depth":852,"text":634},{"id":791,"depth":852,"text":2352},"Step 1: Validate with parseIngestBody()",{"id":1057,"depth":852,"text":1058},{"id":2005,"depth":852,"text":2006},{"id":2323,"depth":852,"text":2324},"Build the ingestion endpoint for @evlog\u002Ftelemetry: the threat model, parseIngestBody validation, framework routes, storage, and rate limiting.","md",[2359,2362,2363],{"label":41,"icon":44,"to":423,"color":2360,"variant":2361},"neutral","subtle",{"label":426,"icon":429,"to":427,"color":2360,"variant":2361},{"label":436,"icon":84,"to":437,"color":2360,"variant":2361},{},{"title":431,"icon":434},{"title":604,"description":2356},"q59Ct0NBv9utG9yIAG9L0U4v6eyBe0nzYUWL7hojGsc",[2369,2371],{"title":426,"path":427,"stem":428,"description":2370,"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":2372,"icon":84,"children":-1},"RunEvent envelope, extending the schema with collect and custom fields, privacy rules, TELEMETRY.md disclosure, and consent \u002F outbox reliability.",1791054010606]