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