[{"data":1,"prerenderedAt":2308},["ShallowReactive",2],{"navigation_docs":3,"-use-cases-telemetry-ingest":538,"-use-cases-telemetry-ingest-surround":2303},[4,30,80,128,308,440,499],{"title":5,"path":6,"stem":7,"children":8,"page":29},"Start","\u002Fstart","1.start",[9,14,19,24],{"title":10,"path":11,"stem":12,"icon":13},"Introduction","\u002Fstart\u002Fintroduction","1.start\u002F1.introduction","i-lucide-info",{"title":15,"path":16,"stem":17,"icon":18},"Why start with evlog","\u002Fstart\u002Fwhy-evlog","1.start\u002F2.why-evlog","i-lucide-rocket",{"title":20,"path":21,"stem":22,"icon":23},"Installation","\u002Fstart\u002Finstallation","1.start\u002F3.installation","i-lucide-download",{"title":25,"path":26,"stem":27,"icon":28},"Quick Start","\u002Fstart\u002Fquick-start","1.start\u002F4.quick-start","i-lucide-zap",false,{"title":31,"path":32,"stem":33,"children":34,"page":29},"Learn","\u002Flearn","2.learn",[35,40,45,50,55,60,65,70,75],{"title":36,"path":37,"stem":38,"icon":39},"Overview","\u002Flearn\u002Foverview","2.learn\u002F0.overview","i-lucide-list",{"title":41,"path":42,"stem":43,"icon":44},"Simple Logging","\u002Flearn\u002Fsimple-logging","2.learn\u002F1.simple-logging","i-lucide-terminal",{"title":46,"path":47,"stem":48,"icon":49},"Wide Events","\u002Flearn\u002Fwide-events","2.learn\u002F2.wide-events","i-lucide-layers",{"title":51,"path":52,"stem":53,"icon":54},"Structured Errors","\u002Flearn\u002Fstructured-errors","2.learn\u002F3.structured-errors","i-lucide-shield-alert",{"title":56,"path":57,"stem":58,"icon":59},"Lifecycle","\u002Flearn\u002Flifecycle","2.learn\u002F4.lifecycle","i-lucide-arrow-right-left",{"title":61,"path":62,"stem":63,"icon":64},"Sampling","\u002Flearn\u002Fsampling","2.learn\u002F5.sampling","i-lucide-filter",{"title":66,"path":67,"stem":68,"icon":69},"Auto-Redaction","\u002Flearn\u002Fredaction","2.learn\u002F6.redaction","i-lucide-eye-off",{"title":71,"path":72,"stem":73,"icon":74},"Typed Fields","\u002Flearn\u002Ftyped-fields","2.learn\u002F7.typed-fields","i-simple-icons-typescript",{"title":76,"path":77,"stem":78,"icon":79},"Catalogs","\u002Flearn\u002Fcatalogs","2.learn\u002F8.catalogs","i-lucide-book-open",{"title":81,"path":82,"stem":83,"children":84,"page":29},"CLI","\u002Fcli","3.cli",[85,88,93,98,103,108,113,118,123],{"title":36,"path":86,"stem":87,"icon":44},"\u002Fcli\u002Foverview","3.cli\u002F0.overview",{"title":89,"path":90,"stem":91,"icon":92},"init","\u002Fcli\u002Finit","3.cli\u002F1.init","i-lucide-wand-sparkles",{"title":94,"path":95,"stem":96,"icon":97},"map","\u002Fcli\u002Fmap","3.cli\u002F2.map","i-lucide-radar",{"title":99,"path":100,"stem":101,"icon":102},"Rules","\u002Fcli\u002Frules","3.cli\u002F3.rules","i-lucide-list-checks",{"title":104,"path":105,"stem":106,"icon":107},"Scoring","\u002Fcli\u002Fscoring","3.cli\u002F4.scoring","i-lucide-gauge",{"title":109,"path":110,"stem":111,"icon":112},"CI","\u002Fcli\u002Fci","3.cli\u002F5.ci","i-lucide-git-pull-request",{"title":114,"path":115,"stem":116,"icon":117},"doctor","\u002Fcli\u002Fdoctor","3.cli\u002F6.doctor","i-lucide-stethoscope",{"title":119,"path":120,"stem":121,"icon":122},"telemetry","\u002Fcli\u002Ftelemetry","3.cli\u002F7.telemetry","i-lucide-bar-chart-3",{"title":124,"path":125,"stem":126,"icon":127},"agents","\u002Fcli\u002Fagents","3.cli\u002F8.agents","i-lucide-bot",{"title":129,"path":130,"stem":131,"children":132,"page":29},"Integrate","\u002Fintegrate","4.integrate",[133,137,220],{"title":36,"path":134,"stem":135,"icon":136},"\u002Fintegrate\u002Foverview","4.integrate\u002F0.overview","i-lucide-plug",{"title":138,"path":139,"stem":140,"children":141,"page":29},"Adapters","\u002Fintegrate\u002Fadapters","4.integrate\u002Fadapters",[142,145,175,200],{"title":36,"path":143,"stem":144,"icon":39},"\u002Fintegrate\u002Fadapters\u002Foverview","4.integrate\u002Fadapters\u002F01.overview",{"title":146,"path":147,"stem":148,"children":149,"page":29},"Cloud","\u002Fintegrate\u002Fadapters\u002Fcloud","4.integrate\u002Fadapters\u002Fcloud",[150,155,160,165,170],{"title":151,"path":152,"stem":153,"icon":154},"Axiom","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Faxiom","4.integrate\u002Fadapters\u002Fcloud\u002F01.axiom","i-custom-axiom",{"title":156,"path":157,"stem":158,"icon":159},"PostHog","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fposthog","4.integrate\u002Fadapters\u002Fcloud\u002F02.posthog","i-simple-icons-posthog",{"title":161,"path":162,"stem":163,"icon":164},"Sentry","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fsentry","4.integrate\u002Fadapters\u002Fcloud\u002F03.sentry","i-simple-icons-sentry",{"title":166,"path":167,"stem":168,"icon":169},"Better Stack","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fbetter-stack","4.integrate\u002Fadapters\u002Fcloud\u002F04.better-stack","i-simple-icons-betterstack",{"title":171,"path":172,"stem":173,"icon":174},"Datadog","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fdatadog","4.integrate\u002Fadapters\u002Fcloud\u002F05.datadog","i-simple-icons-datadog",{"title":176,"path":177,"stem":178,"children":179,"page":29},"Cloud or Self-Hosted","\u002Fintegrate\u002Fadapters\u002Fhybrid","4.integrate\u002Fadapters\u002Fhybrid",[180,185,190,195],{"title":181,"path":182,"stem":183,"icon":184},"Grafana Loki","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Floki","4.integrate\u002Fadapters\u002Fhybrid\u002F01.loki","i-simple-icons-grafana",{"title":186,"path":187,"stem":188,"icon":189},"ClickHouse","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Fclickhouse","4.integrate\u002Fadapters\u002Fhybrid\u002F02.clickhouse","i-simple-icons-clickhouse",{"title":191,"path":192,"stem":193,"icon":194},"OTLP","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Fotlp","4.integrate\u002Fadapters\u002Fhybrid\u002F03.otlp","i-simple-icons-opentelemetry",{"title":196,"path":197,"stem":198,"icon":199},"HyperDX","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Fhyperdx","4.integrate\u002Fadapters\u002Fhybrid\u002F04.hyperdx","i-custom-hyperdx",{"title":201,"path":202,"stem":203,"children":204,"page":29},"Self-Hosted","\u002Fintegrate\u002Fadapters\u002Fself-hosted","4.integrate\u002Fadapters\u002Fself-hosted",[205,210,215],{"title":206,"path":207,"stem":208,"icon":209},"File System","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Ffs","4.integrate\u002Fadapters\u002Fself-hosted\u002F01.fs","i-lucide-hard-drive",{"title":211,"path":212,"stem":213,"icon":214},"NuxtHub","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Fnuxthub","4.integrate\u002Fadapters\u002Fself-hosted\u002F02.nuxthub","i-simple-icons-nuxt",{"title":216,"path":217,"stem":218,"icon":219},"Memory","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Fmemory","4.integrate\u002Fadapters\u002Fself-hosted\u002F03.memory","i-lucide-cpu",{"title":221,"path":222,"stem":223,"children":224,"page":29},"Frameworks","\u002Fintegrate\u002Fframeworks","4.integrate\u002Fframeworks",[225,229,234,239,244,249,254,259,264,269,274,279,284,289,293,298,303],{"title":36,"path":226,"stem":227,"icon":228},"\u002Fintegrate\u002Fframeworks\u002Foverview","4.integrate\u002Fframeworks\u002F00.overview","i-lucide-layout-grid",{"title":230,"path":231,"stem":232,"icon":233},"Nuxt","\u002Fintegrate\u002Fframeworks\u002Fnuxt","4.integrate\u002Fframeworks\u002F01.nuxt","i-simple-icons-nuxtdotjs",{"title":235,"path":236,"stem":237,"icon":238},"Next.js","\u002Fintegrate\u002Fframeworks\u002Fnextjs","4.integrate\u002Fframeworks\u002F02.nextjs","i-simple-icons-nextdotjs",{"title":240,"path":241,"stem":242,"icon":243},"SvelteKit","\u002Fintegrate\u002Fframeworks\u002Fsveltekit","4.integrate\u002Fframeworks\u002F03.sveltekit","i-simple-icons-svelte",{"title":245,"path":246,"stem":247,"icon":248},"Nitro","\u002Fintegrate\u002Fframeworks\u002Fnitro","4.integrate\u002Fframeworks\u002F04.nitro","i-custom-nitro",{"title":250,"path":251,"stem":252,"icon":253},"TanStack Start","\u002Fintegrate\u002Fframeworks\u002Ftanstack-start","4.integrate\u002Fframeworks\u002F05.tanstack-start","i-custom-tanstack",{"title":255,"path":256,"stem":257,"icon":258},"NestJS","\u002Fintegrate\u002Fframeworks\u002Fnestjs","4.integrate\u002Fframeworks\u002F06.nestjs","i-simple-icons-nestjs",{"title":260,"path":261,"stem":262,"icon":263},"Express","\u002Fintegrate\u002Fframeworks\u002Fexpress","4.integrate\u002Fframeworks\u002F07.express","i-simple-icons-express",{"title":265,"path":266,"stem":267,"icon":268},"Hono","\u002Fintegrate\u002Fframeworks\u002Fhono","4.integrate\u002Fframeworks\u002F08.hono","i-simple-icons-hono",{"title":270,"path":271,"stem":272,"icon":273},"Fastify","\u002Fintegrate\u002Fframeworks\u002Ffastify","4.integrate\u002Fframeworks\u002F09.fastify","i-simple-icons-fastify",{"title":275,"path":276,"stem":277,"icon":278},"Elysia","\u002Fintegrate\u002Fframeworks\u002Felysia","4.integrate\u002Fframeworks\u002F10.elysia","i-custom-elysia",{"title":280,"path":281,"stem":282,"icon":283},"React Router","\u002Fintegrate\u002Fframeworks\u002Freact-router","4.integrate\u002Fframeworks\u002F11.react-router","i-custom-reactrouter",{"title":285,"path":286,"stem":287,"icon":288},"Cloudflare Workers","\u002Fintegrate\u002Fframeworks\u002Fcloudflare-workers","4.integrate\u002Fframeworks\u002F12.cloudflare-workers","i-simple-icons-cloudflare",{"title":290,"path":291,"stem":292,"icon":74},"Standalone","\u002Fintegrate\u002Fframeworks\u002Fstandalone","4.integrate\u002Fframeworks\u002F13.standalone",{"title":294,"path":295,"stem":296,"icon":297},"Astro","\u002Fintegrate\u002Fframeworks\u002Fastro","4.integrate\u002Fframeworks\u002F14.astro","i-simple-icons-astro",{"title":299,"path":300,"stem":301,"icon":302},"oRPC","\u002Fintegrate\u002Fframeworks\u002Forpc","4.integrate\u002Fframeworks\u002F15.orpc","i-lucide-network",{"title":304,"path":305,"stem":306,"icon":307},"AWS Lambda","\u002Fintegrate\u002Fframeworks\u002Faws-lambda","4.integrate\u002Fframeworks\u002F16.aws-lambda","i-custom-lambda",{"title":309,"path":310,"stem":311,"children":312,"page":29},"Use Cases","\u002Fuse-cases","5.use-cases",[313,316,321,350,377,409,430,435],{"title":36,"path":314,"stem":315,"icon":102},"\u002Fuse-cases\u002Foverview","5.use-cases\u002F0.overview",{"title":317,"path":318,"stem":319,"icon":320},"Client Logging","\u002Fuse-cases\u002Fclient-logging","5.use-cases\u002F1.client-logging","i-lucide-monitor",{"title":322,"icon":323,"path":324,"stem":325,"children":326,"page":29},"AI SDK","i-simple-icons-vercel","\u002Fuse-cases\u002Fai-sdk","5.use-cases\u002F2.ai-sdk",[327,330,335,340,345],{"title":36,"path":328,"stem":329,"icon":39},"\u002Fuse-cases\u002Fai-sdk\u002Foverview","5.use-cases\u002F2.ai-sdk\u002F01.overview",{"title":331,"path":332,"stem":333,"icon":334},"Usage","\u002Fuse-cases\u002Fai-sdk\u002Fusage","5.use-cases\u002F2.ai-sdk\u002F02.usage","i-lucide-code",{"title":336,"path":337,"stem":338,"icon":339},"Options","\u002Fuse-cases\u002Fai-sdk\u002Foptions","5.use-cases\u002F2.ai-sdk\u002F03.options","i-lucide-sliders",{"title":341,"path":342,"stem":343,"icon":344},"Metadata","\u002Fuse-cases\u002Fai-sdk\u002Fmetadata","5.use-cases\u002F2.ai-sdk\u002F04.metadata","i-lucide-database",{"title":346,"path":347,"stem":348,"icon":349},"Telemetry","\u002Fuse-cases\u002Fai-sdk\u002Ftelemetry","5.use-cases\u002F2.ai-sdk\u002F05.telemetry","i-lucide-activity",{"title":351,"icon":352,"path":353,"stem":354,"children":355,"page":29},"Better Auth","i-simple-icons-betterauth","\u002Fuse-cases\u002Fbetter-auth","5.use-cases\u002F3.better-auth",[356,359,364,369,373],{"title":36,"path":357,"stem":358,"icon":39},"\u002Fuse-cases\u002Fbetter-auth\u002Foverview","5.use-cases\u002F3.better-auth\u002F01.overview",{"title":360,"path":361,"stem":362,"icon":363},"Identify User","\u002Fuse-cases\u002Fbetter-auth\u002Fidentify-user","5.use-cases\u002F3.better-auth\u002F02.identify-user","i-lucide-user-check",{"title":365,"path":366,"stem":367,"icon":368},"Middleware","\u002Fuse-cases\u002Fbetter-auth\u002Fmiddleware","5.use-cases\u002F3.better-auth\u002F03.middleware","i-lucide-shield",{"title":370,"path":371,"stem":372,"icon":320},"Client Sync","\u002Fuse-cases\u002Fbetter-auth\u002Fclient-sync","5.use-cases\u002F3.better-auth\u002F04.client-sync",{"title":374,"path":375,"stem":376,"icon":107},"Performance","\u002Fuse-cases\u002Fbetter-auth\u002Fperformance","5.use-cases\u002F3.better-auth\u002F05.performance",{"title":378,"icon":379,"path":380,"stem":381,"children":382,"page":29},"Audit Logs","i-lucide-shield-check","\u002Fuse-cases\u002Faudit","5.use-cases\u002F4.audit",[383,386,391,396,401,405],{"title":36,"path":384,"stem":385,"icon":39},"\u002Fuse-cases\u002Faudit\u002Foverview","5.use-cases\u002F4.audit\u002F01.overview",{"title":387,"path":388,"stem":389,"icon":390},"Schema","\u002Fuse-cases\u002Faudit\u002Fschema","5.use-cases\u002F4.audit\u002F02.schema","i-lucide-file-text",{"title":392,"path":393,"stem":394,"icon":395},"Recording","\u002Fuse-cases\u002Faudit\u002Frecording","5.use-cases\u002F4.audit\u002F03.recording","i-lucide-pen-line",{"title":397,"path":398,"stem":399,"icon":400},"Drains","\u002Fuse-cases\u002Faudit\u002Fpipeline","5.use-cases\u002F4.audit\u002F04.pipeline","i-lucide-link",{"title":402,"path":403,"stem":404,"icon":379},"Compliance","\u002Fuse-cases\u002Faudit\u002Fcompliance","5.use-cases\u002F4.audit\u002F05.compliance",{"title":406,"path":407,"stem":408,"icon":79},"Recipes","\u002Fuse-cases\u002Faudit\u002Frecipes","5.use-cases\u002F4.audit\u002F06.recipes",{"title":346,"icon":107,"path":410,"stem":411,"children":412,"page":29},"\u002Fuse-cases\u002Ftelemetry","5.use-cases\u002F4.telemetry",[413,416,421,426],{"title":36,"path":414,"stem":415,"icon":39},"\u002Fuse-cases\u002Ftelemetry\u002Foverview","5.use-cases\u002F4.telemetry\u002F01.overview",{"title":417,"path":418,"stem":419,"icon":420},"Setup","\u002Fuse-cases\u002Ftelemetry\u002Fsetup","5.use-cases\u002F4.telemetry\u002F02.setup","i-lucide-wrench",{"title":422,"path":423,"stem":424,"icon":425},"Ingest","\u002Fuse-cases\u002Ftelemetry\u002Fingest","5.use-cases\u002F4.telemetry\u002F03.ingest","i-lucide-server",{"title":427,"path":428,"stem":429,"icon":79},"Reference","\u002Fuse-cases\u002Ftelemetry\u002Freference","5.use-cases\u002F4.telemetry\u002F04.reference",{"title":431,"path":432,"stem":433,"icon":434},"Enrichers","\u002Fuse-cases\u002Fenrichers","5.use-cases\u002F5.enrichers","i-lucide-sparkles",{"title":436,"path":437,"stem":438,"icon":439},"eve","\u002Fuse-cases\u002Feve","5.use-cases\u002F5.eve","i-custom-eve",{"title":441,"path":442,"stem":443,"children":444,"page":29},"Extend","\u002Fextend","6.extend",[445,449,454,459,463,468,472,476,480,484,489,494],{"title":36,"path":446,"stem":447,"icon":448},"\u002Fextend\u002Foverview","6.extend\u002F0.overview","i-lucide-blocks",{"title":450,"path":451,"stem":452,"icon":453},"Stream","\u002Fextend\u002Fstream","6.extend\u002F1.stream","i-lucide-radio-tower",{"title":455,"path":456,"stem":457,"icon":458},"Custom framework","\u002Fextend\u002Fcustom-framework","6.extend\u002F10.custom-framework","i-lucide-puzzle",{"title":460,"path":461,"stem":462,"icon":453},"Diagnostics channel","\u002Fextend\u002Fdiagnostics-channel","6.extend\u002F11.diagnostics-channel",{"title":464,"path":465,"stem":466,"icon":467},"FS reader","\u002Fextend\u002Ffs-reader","6.extend\u002F2.fs-reader","i-lucide-folder-search",{"title":406,"path":469,"stem":470,"icon":471},"\u002Fextend\u002Fconsumer-recipes","6.extend\u002F3.consumer-recipes","i-lucide-chef-hat",{"title":473,"path":474,"stem":475,"icon":448},"Plugins","\u002Fextend\u002Fplugins","6.extend\u002F4.plugins",{"title":477,"path":478,"stem":479,"icon":434},"Custom enrichers","\u002Fextend\u002Fcustom-enrichers","6.extend\u002F5.custom-enrichers",{"title":481,"path":482,"stem":483,"icon":64},"Tail sampling","\u002Fextend\u002Ftail-sampling","6.extend\u002F6.tail-sampling",{"title":485,"path":486,"stem":487,"icon":488},"Identity headers","\u002Fextend\u002Fidentity-headers","6.extend\u002F7.identity-headers","i-lucide-fingerprint",{"title":490,"path":491,"stem":492,"icon":493},"Custom drains","\u002Fextend\u002Fcustom-drains","6.extend\u002F8.custom-drains","i-lucide-share-2",{"title":495,"path":496,"stem":497,"icon":498},"Drain pipeline","\u002Fextend\u002Fdrain-pipeline","6.extend\u002F9.drain-pipeline","i-lucide-workflow",{"title":427,"path":500,"stem":501,"children":502,"page":29},"\u002Freference","7.reference",[503,507,512,515,520,524,529,533],{"title":36,"path":504,"stem":505,"icon":506},"\u002Freference\u002Foverview","7.reference\u002F0.overview","i-lucide-book-marked",{"title":508,"path":509,"stem":510,"icon":511},"Configuration","\u002Freference\u002Fconfiguration","7.reference\u002F1.configuration","i-lucide-settings",{"title":374,"path":513,"stem":514,"icon":107},"\u002Freference\u002Fperformance","7.reference\u002F2.performance",{"title":516,"path":517,"stem":518,"icon":519},"Vite Plugin","\u002Freference\u002Fvite-plugin","7.reference\u002F3.vite-plugin","i-custom-vite",{"title":521,"path":522,"stem":523,"icon":379},"Best Practices","\u002Freference\u002Fbest-practices","7.reference\u002F4.best-practices",{"title":525,"path":526,"stem":527,"icon":528},"vs Other Loggers","\u002Freference\u002Fvs-other-loggers","7.reference\u002F5.vs-other-loggers","i-lucide-scale",{"title":530,"path":531,"stem":532,"icon":434},"Agent Skills","\u002Freference\u002Fagent-skills","7.reference\u002F6.agent-skills",{"title":534,"path":535,"stem":536,"icon":537},"Cost","\u002Freference\u002Fcost","7.reference\u002F7.cost","i-lucide-receipt",{"id":539,"title":540,"body":541,"description":2291,"extension":2292,"links":2293,"meta":2299,"navigation":2300,"path":423,"seo":2301,"stem":424,"__hash__":2302},"docs\u002F5.use-cases\u002F4.telemetry\u002F03.ingest.md","Telemetry Ingest",{"type":542,"value":543,"toc":2283},"minimark",[544,558,566,571,578,583,594,599,610,705,711,725,731,743,972,991,995,1002,1938,1942,1948,2256,2260,2269,2279],[545,546,547,548,552,553,557],"p",{},"You ship a CLI. Users run it on their machines. You want to know ",[549,550,551],"em",{},"which commands run, how often they fail, and which versions are out there",", without building a separate analytics SDK or reading raw ",[554,555,556],"code",{},"argv",".",[545,559,560,561,565],{},"That means a ",[562,563,564],"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.",[567,568,570],"h2",{"id":569},"the-security-question-read-this-first","The security question (read this first)",[572,573,574,577],"tip",{},[562,575,576],{},"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.",[545,579,580],{},[562,581,582],{},"\"I put the ingest URL in my CLI. Isn't that a secret?\"",[545,584,585,586,589,590,593],{},"No. The URL lives in your npm package or binary. Anyone can read it with ",[554,587,588],{},"strings",", by installing the package, or by watching network traffic. The same applies to an API key or ",[554,591,592],{},"Authorization"," header baked into the CLI is extractable, not a real barrier.",[545,595,596],{},[562,597,598],{},"\"So can't anyone send fake events?\"",[545,600,601,602,605,606,609],{},"In theory, yes: someone could ",[554,603,604],{},"curl"," your endpoint with forged JSON. That is why you treat the endpoint as ",[562,607,608],{},"semi-public"," (like a browser analytics key) and defend on the server:",[611,612,613,626],"table",{},[614,615,616],"thead",{},[617,618,619,623],"tr",{},[620,621,622],"th",{},"What you might worry about",[620,624,625],{},"Practical answer",[627,628,629,641,652,663,678,690],"tbody",{},[617,630,631,635],{},[632,633,634],"td",{},"Random internet bots",[632,636,637,638],{},"Validate the payload shape; reject garbage with ",[554,639,640],{},"400",[617,642,643,649],{},[632,644,645,646,648],{},"Someone spamming fake ",[554,647,114],{}," runs",[632,650,651],{},"Rate-limit by IP; data is low-value counters, not money",[617,653,654,660],{},[632,655,656,657],{},"Forged ",[554,658,659],{},"tool.name",[632,661,662],{},"Allowlist only your published tool names server-side",[617,664,665,671],{},[632,666,667,668],{},"Unexpected fields in ",[554,669,670],{},"custom",[632,672,673,674,677],{},"Filter to the keys you declared — same list as ",[554,675,676],{},"collect"," on the CLI",[617,679,680,683],{},[632,681,682],{},"Double-counting on retry",[632,684,685,686,689],{},"Dedupe on ",[554,687,688],{},"idempotencyKey"," when storing",[617,691,692,695],{},[632,693,694],{},"Leaking user secrets",[632,696,697,698,700,701,704],{},"CLI never reads raw ",[554,699,556],{},"; you only allowlisted flags and ",[554,702,703],{},"telemetry.set()"," counters",[545,706,707,710],{},[562,708,709],{},"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.",[712,713,715,718,719,724],"callout",{"color":714,"icon":379},"info",[554,716,717],{},"@evlog\u002Ftelemetry"," ships ",[562,720,721],{},[554,722,723],{},"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.",[567,726,728,729],{"id":727},"step-1-validate-with-parseingestbody","Step 1: Validate with ",[554,730,723],{},[545,732,733,734,737,738,740,741,557],{},"Mirror the CLI config on the server: same ",[554,735,736],{},"name",", same custom keys you allow via ",[554,739,676],{}," \u002F ",[554,742,703],{},[744,745,751],"pre",{"className":746,"code":747,"filename":748,"language":749,"meta":750,"style":750},"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","",[554,752,753,786,793,812,839,849,893,899,911,916,946,966],{"__ignoreMap":750},[754,755,758,762,766,770,773,776,779,783],"span",{"class":756,"line":757},"line",1,[754,759,761],{"class":760},"s7zQu","import",[754,763,765],{"class":764},"sMK4o"," {",[754,767,769],{"class":768},"sTEyZ"," parseIngestBody",[754,771,772],{"class":764}," }",[754,774,775],{"class":760}," from",[754,777,778],{"class":764}," '",[754,780,782],{"class":781},"sfazB","@evlog\u002Ftelemetry\u002Fingest",[754,784,785],{"class":764},"'\n",[754,787,789],{"class":756,"line":788},2,[754,790,792],{"emptyLinePlaceholder":791},true,"\n",[754,794,796,799,803,806,809],{"class":756,"line":795},3,[754,797,798],{"class":760},"export",[754,800,802],{"class":801},"spNyl"," const",[754,804,805],{"class":768}," ingestOptions ",[754,807,808],{"class":764},"=",[754,810,811],{"class":764}," {\n",[754,813,815,819,822,825,828,831,833,836],{"class":756,"line":814},4,[754,816,818],{"class":817},"swJcz","  allowedTools",[754,820,821],{"class":764},":",[754,823,824],{"class":768}," [",[754,826,827],{"class":764},"'",[754,829,830],{"class":781},"my-tool",[754,832,827],{"class":764},[754,834,835],{"class":768},"]",[754,837,838],{"class":764},",\n",[754,840,842,845,847],{"class":756,"line":841},5,[754,843,844],{"class":817},"  allowedCustomKeys",[754,846,821],{"class":764},[754,848,811],{"class":764},[754,850,852,855,857,859,861,863,865,868,870,873,875,878,880,882,884,887,889,891],{"class":756,"line":851},6,[754,853,854],{"class":764},"    '",[754,856,830],{"class":817},[754,858,827],{"class":764},[754,860,821],{"class":764},[754,862,824],{"class":768},[754,864,827],{"class":764},[754,866,867],{"class":781},"checksFailed",[754,869,827],{"class":764},[754,871,872],{"class":764},",",[754,874,778],{"class":764},[754,876,877],{"class":781},"checksWarn",[754,879,827],{"class":764},[754,881,872],{"class":764},[754,883,778],{"class":764},[754,885,886],{"class":781},"itemsSynced",[754,888,827],{"class":764},[754,890,835],{"class":768},[754,892,838],{"class":764},[754,894,896],{"class":756,"line":895},7,[754,897,898],{"class":764},"  },\n",[754,900,902,905,908],{"class":756,"line":901},8,[754,903,904],{"class":764},"}",[754,906,907],{"class":760}," as",[754,909,910],{"class":801}," const\n",[754,912,914],{"class":756,"line":913},9,[754,915,792],{"emptyLinePlaceholder":791},[754,917,919,921,924,928,931,935,937,941,944],{"class":756,"line":918},10,[754,920,798],{"class":760},[754,922,923],{"class":801}," function",[754,925,927],{"class":926},"s2Zo4"," parseTelemetryBody",[754,929,930],{"class":764},"(",[754,932,934],{"class":933},"sHdIc","raw",[754,936,821],{"class":764},[754,938,940],{"class":939},"sBMFI"," string",[754,942,943],{"class":764},")",[754,945,811],{"class":764},[754,947,949,952,954,956,958,960,963],{"class":756,"line":948},11,[754,950,951],{"class":760},"  return",[754,953,769],{"class":926},[754,955,930],{"class":817},[754,957,934],{"class":768},[754,959,872],{"class":764},[754,961,962],{"class":768}," ingestOptions",[754,964,965],{"class":817},")\n",[754,967,969],{"class":756,"line":968},12,[754,970,971],{"class":764},"}\n",[545,973,974,976,977,980,981,983,984,987,988,990],{},[554,975,723],{}," checks batch size, JSON shape, ",[554,978,979],{},"event: 'run'",", tool allowlist, envelope types, ISO timestamp, and strips ",[554,982,670],{}," keys you did not declare. Throws ",[554,985,986],{},"IngestValidationError"," on failure, so return ",[554,989,640],{}," from your route.",[567,992,994],{"id":993},"step-2-wire-your-route","Step 2: Wire your route",[545,996,997,998,1001],{},"Same contract for any framework: read the raw body, validate, store, return ",[562,999,1000],{},"204"," so the CLI clears its outbox:",[1003,1004,1005,1375,1632],"code-group",{},[744,1006,1009],{"className":746,"code":1007,"filename":1008,"language":749,"meta":750,"style":750},"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 (Nitro)",[554,1010,1011,1041,1060,1079,1099,1103,1130,1161,1179,1196,1218,1223,1227,1235,1254,1269,1285,1293,1311,1343,1363,1368],{"__ignoreMap":750},[754,1012,1013,1015,1017,1020,1022,1025,1027,1030,1032,1034,1036,1039],{"class":756,"line":757},[754,1014,761],{"class":760},[754,1016,765],{"class":764},[754,1018,1019],{"class":768}," defineEventHandler",[754,1021,872],{"class":764},[754,1023,1024],{"class":768}," readRawBody",[754,1026,872],{"class":764},[754,1028,1029],{"class":768}," setResponseStatus",[754,1031,772],{"class":764},[754,1033,775],{"class":760},[754,1035,778],{"class":764},[754,1037,1038],{"class":781},"h3",[754,1040,785],{"class":764},[754,1042,1043,1045,1047,1050,1052,1054,1056,1058],{"class":756,"line":788},[754,1044,761],{"class":760},[754,1046,765],{"class":764},[754,1048,1049],{"class":768}," IngestValidationError",[754,1051,772],{"class":764},[754,1053,775],{"class":760},[754,1055,778],{"class":764},[754,1057,782],{"class":781},[754,1059,785],{"class":764},[754,1061,1062,1064,1066,1068,1070,1072,1074,1077],{"class":756,"line":795},[754,1063,761],{"class":760},[754,1065,765],{"class":764},[754,1067,927],{"class":768},[754,1069,772],{"class":764},[754,1071,775],{"class":760},[754,1073,778],{"class":764},[754,1075,1076],{"class":781},"~\u002Flib\u002Ftelemetry-ingest",[754,1078,785],{"class":764},[754,1080,1081,1083,1085,1088,1090,1092,1094,1097],{"class":756,"line":814},[754,1082,761],{"class":760},[754,1084,765],{"class":764},[754,1086,1087],{"class":768}," storeRunEvents",[754,1089,772],{"class":764},[754,1091,775],{"class":760},[754,1093,778],{"class":764},[754,1095,1096],{"class":781},"~\u002Flib\u002Ftelemetry-store",[754,1098,785],{"class":764},[754,1100,1101],{"class":756,"line":841},[754,1102,792],{"emptyLinePlaceholder":791},[754,1104,1105,1107,1110,1112,1114,1117,1120,1123,1125,1128],{"class":756,"line":851},[754,1106,798],{"class":760},[754,1108,1109],{"class":760}," default",[754,1111,1019],{"class":926},[754,1113,930],{"class":768},[754,1115,1116],{"class":801},"async",[754,1118,1119],{"class":764}," (",[754,1121,1122],{"class":933},"event",[754,1124,943],{"class":764},[754,1126,1127],{"class":801}," =>",[754,1129,811],{"class":764},[754,1131,1132,1135,1138,1141,1144,1146,1148,1150,1152,1154,1157,1159],{"class":756,"line":895},[754,1133,1134],{"class":801},"  const",[754,1136,1137],{"class":768}," raw",[754,1139,1140],{"class":764}," =",[754,1142,1143],{"class":760}," await",[754,1145,1024],{"class":926},[754,1147,930],{"class":817},[754,1149,1122],{"class":768},[754,1151,872],{"class":764},[754,1153,778],{"class":764},[754,1155,1156],{"class":781},"utf8",[754,1158,827],{"class":764},[754,1160,965],{"class":817},[754,1162,1163,1166,1168,1171,1173,1176],{"class":756,"line":901},[754,1164,1165],{"class":760},"  if",[754,1167,1119],{"class":817},[754,1169,1170],{"class":764},"!",[754,1172,934],{"class":768},[754,1174,1175],{"class":817},") ",[754,1177,1178],{"class":764},"{\n",[754,1180,1181,1184,1186,1188,1190,1194],{"class":756,"line":913},[754,1182,1183],{"class":926},"    setResponseStatus",[754,1185,930],{"class":817},[754,1187,1122],{"class":768},[754,1189,872],{"class":764},[754,1191,1193],{"class":1192},"sbssI"," 400",[754,1195,965],{"class":817},[754,1197,1198,1201,1203,1206,1208,1210,1213,1215],{"class":756,"line":918},[754,1199,1200],{"class":760},"    return",[754,1202,765],{"class":764},[754,1204,1205],{"class":817}," error",[754,1207,821],{"class":764},[754,1209,778],{"class":764},[754,1211,1212],{"class":781},"empty body",[754,1214,827],{"class":764},[754,1216,1217],{"class":764}," }\n",[754,1219,1220],{"class":756,"line":948},[754,1221,1222],{"class":764},"  }\n",[754,1224,1225],{"class":756,"line":968},[754,1226,792],{"emptyLinePlaceholder":791},[754,1228,1230,1233],{"class":756,"line":1229},13,[754,1231,1232],{"class":760},"  try",[754,1234,811],{"class":764},[754,1236,1238,1241,1244,1246,1248,1250,1252],{"class":756,"line":1237},14,[754,1239,1240],{"class":801},"    const",[754,1242,1243],{"class":768}," events",[754,1245,1140],{"class":764},[754,1247,927],{"class":926},[754,1249,930],{"class":817},[754,1251,934],{"class":768},[754,1253,965],{"class":817},[754,1255,1257,1260,1262,1264,1267],{"class":756,"line":1256},15,[754,1258,1259],{"class":760},"    await",[754,1261,1087],{"class":926},[754,1263,930],{"class":817},[754,1265,1266],{"class":768},"events",[754,1268,965],{"class":817},[754,1270,1272,1274,1276,1278,1280,1283],{"class":756,"line":1271},16,[754,1273,1183],{"class":926},[754,1275,930],{"class":817},[754,1277,1122],{"class":768},[754,1279,872],{"class":764},[754,1281,1282],{"class":1192}," 204",[754,1284,965],{"class":817},[754,1286,1288,1290],{"class":756,"line":1287},17,[754,1289,1200],{"class":760},[754,1291,1292],{"class":764}," null\n",[754,1294,1296,1299,1302,1304,1307,1309],{"class":756,"line":1295},18,[754,1297,1298],{"class":764},"  }",[754,1300,1301],{"class":760}," catch",[754,1303,1119],{"class":817},[754,1305,1306],{"class":768},"err",[754,1308,1175],{"class":817},[754,1310,1178],{"class":764},[754,1312,1314,1316,1318,1320,1322,1325,1328,1330,1333,1335,1338,1341],{"class":756,"line":1313},19,[754,1315,1183],{"class":926},[754,1317,930],{"class":817},[754,1319,1122],{"class":768},[754,1321,872],{"class":764},[754,1323,1324],{"class":768}," err",[754,1326,1327],{"class":764}," instanceof",[754,1329,1049],{"class":939},[754,1331,1332],{"class":764}," ?",[754,1334,1193],{"class":1192},[754,1336,1337],{"class":764}," :",[754,1339,1340],{"class":1192}," 500",[754,1342,965],{"class":817},[754,1344,1346,1348,1350,1352,1354,1356,1359,1361],{"class":756,"line":1345},20,[754,1347,1200],{"class":760},[754,1349,765],{"class":764},[754,1351,1205],{"class":817},[754,1353,821],{"class":764},[754,1355,778],{"class":764},[754,1357,1358],{"class":781},"invalid payload",[754,1360,827],{"class":764},[754,1362,1217],{"class":764},[754,1364,1366],{"class":756,"line":1365},21,[754,1367,1222],{"class":764},[754,1369,1371,1373],{"class":756,"line":1370},22,[754,1372,904],{"class":764},[754,1374,965],{"class":768},[744,1376,1379],{"className":746,"code":1377,"filename":1378,"language":749,"meta":750,"style":750},"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","app\u002Fapi\u002Ftelemetry\u002Fingest\u002Froute.ts (Next.js App Router)",[554,1380,1381,1399,1418,1437,1441,1467,1488,1494,1510,1522,1550,1564,1587,1624,1628],{"__ignoreMap":750},[754,1382,1383,1385,1387,1389,1391,1393,1395,1397],{"class":756,"line":757},[754,1384,761],{"class":760},[754,1386,765],{"class":764},[754,1388,1049],{"class":768},[754,1390,772],{"class":764},[754,1392,775],{"class":760},[754,1394,778],{"class":764},[754,1396,782],{"class":781},[754,1398,785],{"class":764},[754,1400,1401,1403,1405,1407,1409,1411,1413,1416],{"class":756,"line":788},[754,1402,761],{"class":760},[754,1404,765],{"class":764},[754,1406,927],{"class":768},[754,1408,772],{"class":764},[754,1410,775],{"class":760},[754,1412,778],{"class":764},[754,1414,1415],{"class":781},"@\u002Flib\u002Ftelemetry-ingest",[754,1417,785],{"class":764},[754,1419,1420,1422,1424,1426,1428,1430,1432,1435],{"class":756,"line":795},[754,1421,761],{"class":760},[754,1423,765],{"class":764},[754,1425,1087],{"class":768},[754,1427,772],{"class":764},[754,1429,775],{"class":760},[754,1431,778],{"class":764},[754,1433,1434],{"class":781},"@\u002Flib\u002Ftelemetry-store",[754,1436,785],{"class":764},[754,1438,1439],{"class":756,"line":814},[754,1440,792],{"emptyLinePlaceholder":791},[754,1442,1443,1445,1448,1450,1453,1455,1458,1460,1463,1465],{"class":756,"line":841},[754,1444,798],{"class":760},[754,1446,1447],{"class":801}," async",[754,1449,923],{"class":801},[754,1451,1452],{"class":926}," POST",[754,1454,930],{"class":764},[754,1456,1457],{"class":933},"request",[754,1459,821],{"class":764},[754,1461,1462],{"class":939}," Request",[754,1464,943],{"class":764},[754,1466,811],{"class":764},[754,1468,1469,1471,1473,1475,1477,1480,1482,1485],{"class":756,"line":851},[754,1470,1134],{"class":801},[754,1472,1137],{"class":768},[754,1474,1140],{"class":764},[754,1476,1143],{"class":760},[754,1478,1479],{"class":768}," request",[754,1481,557],{"class":764},[754,1483,1484],{"class":926},"text",[754,1486,1487],{"class":817},"()\n",[754,1489,1490,1492],{"class":756,"line":895},[754,1491,1232],{"class":760},[754,1493,811],{"class":764},[754,1495,1496,1498,1500,1502,1504,1506,1508],{"class":756,"line":901},[754,1497,1240],{"class":801},[754,1499,1243],{"class":768},[754,1501,1140],{"class":764},[754,1503,927],{"class":926},[754,1505,930],{"class":817},[754,1507,934],{"class":768},[754,1509,965],{"class":817},[754,1511,1512,1514,1516,1518,1520],{"class":756,"line":913},[754,1513,1259],{"class":760},[754,1515,1087],{"class":926},[754,1517,930],{"class":817},[754,1519,1266],{"class":768},[754,1521,965],{"class":817},[754,1523,1524,1526,1529,1532,1534,1537,1539,1542,1544,1546,1548],{"class":756,"line":918},[754,1525,1200],{"class":760},[754,1527,1528],{"class":764}," new",[754,1530,1531],{"class":926}," Response",[754,1533,930],{"class":817},[754,1535,1536],{"class":764},"null,",[754,1538,765],{"class":764},[754,1540,1541],{"class":817}," status",[754,1543,821],{"class":764},[754,1545,1282],{"class":1192},[754,1547,772],{"class":764},[754,1549,965],{"class":817},[754,1551,1552,1554,1556,1558,1560,1562],{"class":756,"line":948},[754,1553,1298],{"class":764},[754,1555,1301],{"class":760},[754,1557,1119],{"class":817},[754,1559,1306],{"class":768},[754,1561,1175],{"class":817},[754,1563,1178],{"class":764},[754,1565,1566,1568,1570,1572,1574,1576,1578,1580,1582,1584],{"class":756,"line":968},[754,1567,1240],{"class":801},[754,1569,1541],{"class":768},[754,1571,1140],{"class":764},[754,1573,1324],{"class":768},[754,1575,1327],{"class":764},[754,1577,1049],{"class":939},[754,1579,1332],{"class":764},[754,1581,1193],{"class":1192},[754,1583,1337],{"class":764},[754,1585,1586],{"class":1192}," 500\n",[754,1588,1589,1591,1593,1595,1598,1600,1603,1605,1607,1609,1611,1613,1616,1618,1620,1622],{"class":756,"line":1229},[754,1590,1200],{"class":760},[754,1592,1531],{"class":768},[754,1594,557],{"class":764},[754,1596,1597],{"class":926},"json",[754,1599,930],{"class":817},[754,1601,1602],{"class":764},"{",[754,1604,1205],{"class":817},[754,1606,821],{"class":764},[754,1608,778],{"class":764},[754,1610,1358],{"class":781},[754,1612,827],{"class":764},[754,1614,1615],{"class":764}," },",[754,1617,765],{"class":764},[754,1619,1541],{"class":768},[754,1621,772],{"class":764},[754,1623,965],{"class":817},[754,1625,1626],{"class":756,"line":1237},[754,1627,1222],{"class":764},[754,1629,1630],{"class":756,"line":1256},[754,1631,971],{"class":764},[744,1633,1636],{"className":746,"code":1634,"filename":1635,"language":749,"meta":750,"style":750},"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 (Hono)",[554,1637,1638,1658,1676,1695,1714,1718,1734,1738,1772,1796,1802,1818,1830,1849,1863,1885,1915,1919,1925,1929],{"__ignoreMap":750},[754,1639,1640,1642,1644,1647,1649,1651,1653,1656],{"class":756,"line":757},[754,1641,761],{"class":760},[754,1643,765],{"class":764},[754,1645,1646],{"class":768}," Hono",[754,1648,772],{"class":764},[754,1650,775],{"class":760},[754,1652,778],{"class":764},[754,1654,1655],{"class":781},"hono",[754,1657,785],{"class":764},[754,1659,1660,1662,1664,1666,1668,1670,1672,1674],{"class":756,"line":788},[754,1661,761],{"class":760},[754,1663,765],{"class":764},[754,1665,1049],{"class":768},[754,1667,772],{"class":764},[754,1669,775],{"class":760},[754,1671,778],{"class":764},[754,1673,782],{"class":781},[754,1675,785],{"class":764},[754,1677,1678,1680,1682,1684,1686,1688,1690,1693],{"class":756,"line":795},[754,1679,761],{"class":760},[754,1681,765],{"class":764},[754,1683,927],{"class":768},[754,1685,772],{"class":764},[754,1687,775],{"class":760},[754,1689,778],{"class":764},[754,1691,1692],{"class":781},"..\u002Flib\u002Ftelemetry-ingest",[754,1694,785],{"class":764},[754,1696,1697,1699,1701,1703,1705,1707,1709,1712],{"class":756,"line":814},[754,1698,761],{"class":760},[754,1700,765],{"class":764},[754,1702,1087],{"class":768},[754,1704,772],{"class":764},[754,1706,775],{"class":760},[754,1708,778],{"class":764},[754,1710,1711],{"class":781},"..\u002Flib\u002Ftelemetry-store",[754,1713,785],{"class":764},[754,1715,1716],{"class":756,"line":841},[754,1717,792],{"emptyLinePlaceholder":791},[754,1719,1720,1723,1726,1728,1730,1732],{"class":756,"line":851},[754,1721,1722],{"class":801},"const",[754,1724,1725],{"class":768}," app ",[754,1727,808],{"class":764},[754,1729,1528],{"class":764},[754,1731,1646],{"class":926},[754,1733,1487],{"class":768},[754,1735,1736],{"class":756,"line":895},[754,1737,792],{"emptyLinePlaceholder":791},[754,1739,1740,1743,1745,1748,1750,1752,1755,1757,1759,1761,1763,1766,1768,1770],{"class":756,"line":901},[754,1741,1742],{"class":768},"app",[754,1744,557],{"class":764},[754,1746,1747],{"class":926},"post",[754,1749,930],{"class":768},[754,1751,827],{"class":764},[754,1753,1754],{"class":781},"\u002Fapi\u002Ftelemetry\u002Fingest",[754,1756,827],{"class":764},[754,1758,872],{"class":764},[754,1760,1447],{"class":801},[754,1762,1119],{"class":764},[754,1764,1765],{"class":933},"c",[754,1767,943],{"class":764},[754,1769,1127],{"class":801},[754,1771,811],{"class":764},[754,1773,1774,1776,1778,1780,1782,1785,1787,1790,1792,1794],{"class":756,"line":913},[754,1775,1134],{"class":801},[754,1777,1137],{"class":768},[754,1779,1140],{"class":764},[754,1781,1143],{"class":760},[754,1783,1784],{"class":768}," c",[754,1786,557],{"class":764},[754,1788,1789],{"class":768},"req",[754,1791,557],{"class":764},[754,1793,1484],{"class":926},[754,1795,1487],{"class":817},[754,1797,1798,1800],{"class":756,"line":918},[754,1799,1232],{"class":760},[754,1801,811],{"class":764},[754,1803,1804,1806,1808,1810,1812,1814,1816],{"class":756,"line":948},[754,1805,1240],{"class":801},[754,1807,1243],{"class":768},[754,1809,1140],{"class":764},[754,1811,927],{"class":926},[754,1813,930],{"class":817},[754,1815,934],{"class":768},[754,1817,965],{"class":817},[754,1819,1820,1822,1824,1826,1828],{"class":756,"line":968},[754,1821,1259],{"class":760},[754,1823,1087],{"class":926},[754,1825,930],{"class":817},[754,1827,1266],{"class":768},[754,1829,965],{"class":817},[754,1831,1832,1834,1836,1838,1841,1843,1845,1847],{"class":756,"line":1229},[754,1833,1200],{"class":760},[754,1835,1784],{"class":768},[754,1837,557],{"class":764},[754,1839,1840],{"class":926},"body",[754,1842,930],{"class":817},[754,1844,1536],{"class":764},[754,1846,1282],{"class":1192},[754,1848,965],{"class":817},[754,1850,1851,1853,1855,1857,1859,1861],{"class":756,"line":1237},[754,1852,1298],{"class":764},[754,1854,1301],{"class":760},[754,1856,1119],{"class":817},[754,1858,1306],{"class":768},[754,1860,1175],{"class":817},[754,1862,1178],{"class":764},[754,1864,1865,1867,1869,1871,1873,1875,1877,1879,1881,1883],{"class":756,"line":1256},[754,1866,1240],{"class":801},[754,1868,1541],{"class":768},[754,1870,1140],{"class":764},[754,1872,1324],{"class":768},[754,1874,1327],{"class":764},[754,1876,1049],{"class":939},[754,1878,1332],{"class":764},[754,1880,1193],{"class":1192},[754,1882,1337],{"class":764},[754,1884,1586],{"class":1192},[754,1886,1887,1889,1891,1893,1895,1897,1899,1901,1903,1905,1907,1909,1911,1913],{"class":756,"line":1271},[754,1888,1200],{"class":760},[754,1890,1784],{"class":768},[754,1892,557],{"class":764},[754,1894,1597],{"class":926},[754,1896,930],{"class":817},[754,1898,1602],{"class":764},[754,1900,1205],{"class":817},[754,1902,821],{"class":764},[754,1904,778],{"class":764},[754,1906,1358],{"class":781},[754,1908,827],{"class":764},[754,1910,1615],{"class":764},[754,1912,1541],{"class":768},[754,1914,965],{"class":817},[754,1916,1917],{"class":756,"line":1287},[754,1918,1222],{"class":764},[754,1920,1921,1923],{"class":756,"line":1295},[754,1922,904],{"class":764},[754,1924,965],{"class":768},[754,1926,1927],{"class":756,"line":1313},[754,1928,792],{"emptyLinePlaceholder":791},[754,1930,1931,1933,1935],{"class":756,"line":1345},[754,1932,798],{"class":760},[754,1934,1109],{"class":760},[754,1936,1937],{"class":768}," app\n",[567,1939,1941],{"id":1940},"step-3-store-idempotently","Step 3: Store idempotently",[545,1943,1944,1945,1947],{},"Retries and backlog drains can POST the same ",[554,1946,688],{}," twice. Upsert (or skip) so metrics stay correct:",[744,1949,1952],{"className":746,"code":1950,"filename":1951,"language":749,"meta":750,"style":750},"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",[554,1953,1954,1976,1980,2018,2039,2060,2083,2092,2112,2132,2148,2164,2180,2195,2211,2216,2226,2233,2237,2241,2247,2252],{"__ignoreMap":750},[754,1955,1956,1958,1961,1963,1966,1968,1970,1972,1974],{"class":756,"line":757},[754,1957,761],{"class":760},[754,1959,1960],{"class":760}," type",[754,1962,765],{"class":764},[754,1964,1965],{"class":768}," RunEvent",[754,1967,772],{"class":764},[754,1969,775],{"class":760},[754,1971,778],{"class":764},[754,1973,717],{"class":781},[754,1975,785],{"class":764},[754,1977,1978],{"class":756,"line":788},[754,1979,792],{"emptyLinePlaceholder":791},[754,1981,1982,1984,1986,1988,1990,1992,1994,1996,1998,2001,2004,2007,2010,2013,2016],{"class":756,"line":795},[754,1983,798],{"class":760},[754,1985,1447],{"class":801},[754,1987,923],{"class":801},[754,1989,1087],{"class":926},[754,1991,930],{"class":764},[754,1993,1266],{"class":933},[754,1995,821],{"class":764},[754,1997,1965],{"class":939},[754,1999,2000],{"class":768},"[]",[754,2002,2003],{"class":764},"):",[754,2005,2006],{"class":939}," Promise",[754,2008,2009],{"class":764},"\u003C",[754,2011,2012],{"class":939},"void",[754,2014,2015],{"class":764},">",[754,2017,811],{"class":764},[754,2019,2020,2023,2025,2027,2030,2033,2035,2037],{"class":756,"line":814},[754,2021,2022],{"class":760},"  for",[754,2024,1119],{"class":817},[754,2026,1722],{"class":801},[754,2028,2029],{"class":768}," run",[754,2031,2032],{"class":764}," of",[754,2034,1243],{"class":768},[754,2036,1175],{"class":817},[754,2038,1178],{"class":764},[754,2040,2041,2043,2046,2048,2051,2053,2056,2058],{"class":756,"line":841},[754,2042,1259],{"class":760},[754,2044,2045],{"class":768}," db",[754,2047,557],{"class":764},[754,2049,2050],{"class":768},"telemetryRun",[754,2052,557],{"class":764},[754,2054,2055],{"class":926},"upsert",[754,2057,930],{"class":817},[754,2059,1178],{"class":764},[754,2061,2062,2065,2067,2069,2072,2074,2076,2078,2080],{"class":756,"line":851},[754,2063,2064],{"class":817},"      where",[754,2066,821],{"class":764},[754,2068,765],{"class":764},[754,2070,2071],{"class":817}," idempotencyKey",[754,2073,821],{"class":764},[754,2075,2029],{"class":768},[754,2077,557],{"class":764},[754,2079,688],{"class":768},[754,2081,2082],{"class":764}," },\n",[754,2084,2085,2088,2090],{"class":756,"line":895},[754,2086,2087],{"class":817},"      create",[754,2089,821],{"class":764},[754,2091,811],{"class":764},[754,2093,2094,2097,2099,2101,2103,2106,2108,2110],{"class":756,"line":901},[754,2095,2096],{"class":817},"        tool",[754,2098,821],{"class":764},[754,2100,2029],{"class":768},[754,2102,557],{"class":764},[754,2104,2105],{"class":768},"tool",[754,2107,557],{"class":764},[754,2109,736],{"class":768},[754,2111,838],{"class":764},[754,2113,2114,2117,2119,2121,2123,2125,2127,2130],{"class":756,"line":913},[754,2115,2116],{"class":817},"        version",[754,2118,821],{"class":764},[754,2120,2029],{"class":768},[754,2122,557],{"class":764},[754,2124,2105],{"class":768},[754,2126,557],{"class":764},[754,2128,2129],{"class":768},"version",[754,2131,838],{"class":764},[754,2133,2134,2137,2139,2141,2143,2146],{"class":756,"line":918},[754,2135,2136],{"class":817},"        command",[754,2138,821],{"class":764},[754,2140,2029],{"class":768},[754,2142,557],{"class":764},[754,2144,2145],{"class":768},"command",[754,2147,838],{"class":764},[754,2149,2150,2153,2155,2157,2159,2162],{"class":756,"line":948},[754,2151,2152],{"class":817},"        outcome",[754,2154,821],{"class":764},[754,2156,2029],{"class":768},[754,2158,557],{"class":764},[754,2160,2161],{"class":768},"outcome",[754,2163,838],{"class":764},[754,2165,2166,2169,2171,2173,2175,2178],{"class":756,"line":968},[754,2167,2168],{"class":817},"        durationMs",[754,2170,821],{"class":764},[754,2172,2029],{"class":768},[754,2174,557],{"class":764},[754,2176,2177],{"class":768},"durationMs",[754,2179,838],{"class":764},[754,2181,2182,2185,2187,2189,2191,2193],{"class":756,"line":1229},[754,2183,2184],{"class":817},"        custom",[754,2186,821],{"class":764},[754,2188,2029],{"class":768},[754,2190,557],{"class":764},[754,2192,670],{"class":768},[754,2194,838],{"class":764},[754,2196,2197,2200,2202,2204,2206,2209],{"class":756,"line":1237},[754,2198,2199],{"class":817},"        recordedAt",[754,2201,821],{"class":764},[754,2203,2029],{"class":768},[754,2205,557],{"class":764},[754,2207,2208],{"class":768},"timestamp",[754,2210,838],{"class":764},[754,2212,2213],{"class":756,"line":1256},[754,2214,2215],{"class":764},"      },\n",[754,2217,2218,2221,2223],{"class":756,"line":1271},[754,2219,2220],{"class":817},"      update",[754,2222,821],{"class":764},[754,2224,2225],{"class":764}," {},\n",[754,2227,2228,2231],{"class":756,"line":1287},[754,2229,2230],{"class":764},"    }",[754,2232,965],{"class":817},[754,2234,2235],{"class":756,"line":1295},[754,2236,1222],{"class":764},[754,2238,2239],{"class":756,"line":1313},[754,2240,792],{"emptyLinePlaceholder":791},[754,2242,2243],{"class":756,"line":1345},[754,2244,2246],{"class":2245},"sHwdD","  \u002F\u002F Or forward into evlog's drain pipeline for Axiom \u002F Datadog \u002F OTLP:\n",[754,2248,2249],{"class":756,"line":1365},[754,2250,2251],{"class":2245},"  \u002F\u002F await ingestWideEvents(events.map(run => ({ source: 'telemetry', ...run })))\n",[754,2253,2254],{"class":756,"line":1370},[754,2255,971],{"class":764},[567,2257,2259],{"id":2258},"step-4-rate-limit-at-the-edge","Step 4: Rate-limit at the edge",[545,2261,2262,2264,2265,2268],{},[554,2263,723],{}," 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 ",[554,2266,2267],{},"machineId"," hash inside the handler if you need tighter control.",[545,2270,2271,2272,2274,2275,2278],{},"Non-2xx responses keep events in the user's outbox; they will retry on the next CLI invocation. Return ",[562,2273,1000],{}," (or any ",[554,2276,2277],{},"2xx",") only when storage succeeded.",[2280,2281,2282],"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":750,"searchDepth":788,"depth":788,"links":2284},[2285,2286,2288,2289,2290],{"id":569,"depth":788,"text":570},{"id":727,"depth":788,"text":2287},"Step 1: Validate with parseIngestBody()",{"id":993,"depth":788,"text":994},{"id":1940,"depth":788,"text":1941},{"id":2258,"depth":788,"text":2259},"Build the ingestion endpoint for @evlog\u002Ftelemetry: the threat model, parseIngestBody validation, framework routes, storage, and rate limiting.","md",[2294,2297,2298],{"label":36,"icon":39,"to":414,"color":2295,"variant":2296},"neutral","subtle",{"label":417,"icon":420,"to":418,"color":2295,"variant":2296},{"label":427,"icon":79,"to":428,"color":2295,"variant":2296},{},{"title":422,"icon":425},{"title":540,"description":2291},"rFp9uwlFbw94P_AK3Grez6dlVtWQc2B56C4Go2gQXgc",[2304,2306],{"title":417,"path":418,"stem":419,"description":2305,"icon":420,"children":-1},"Wire @evlog\u002Ftelemetry into citty CLIs, standalone scripts, and GitHub Actions — delivery config, automatic flag capture, telemetry.set(), and debug mode.",{"title":427,"path":428,"stem":429,"description":2307,"icon":79,"children":-1},"RunEvent envelope, extending the schema with collect and custom fields, privacy rules, TELEMETRY.md disclosure, and consent \u002F outbox reliability.",1786817430805]