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