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