[{"data":1,"prerenderedAt":3277},["ShallowReactive",2],{"navigation_docs":3,"-use-cases-telemetry-reference":612,"-use-cases-telemetry-reference-surround":3272},[4,35,85,138,318,453,489,548,587],{"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],{"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,"path":455,"stem":456,"children":457,"page":34},"Libraries","\u002Flibraries","6.libraries",[458,462,467,470,474,479,484],{"title":41,"path":459,"stem":460,"icon":461},"\u002Flibraries\u002Foverview","6.libraries\u002F0.overview","i-lucide-package",{"title":463,"path":464,"stem":465,"icon":466},"Emitting Events","\u002Flibraries\u002Femitting","6.libraries\u002F1.emitting","i-lucide-radio",{"title":56,"path":468,"stem":469,"icon":59},"\u002Flibraries\u002Ferrors","6.libraries\u002F2.errors",{"title":471,"path":472,"stem":473,"icon":132},"Errors Agents Can Act On","\u002Flibraries\u002Fagents","6.libraries\u002F3.agents",{"title":475,"path":476,"stem":477,"icon":478},"Exporting the Catalog","\u002Flibraries\u002Fexporting","6.libraries\u002F4.exporting","i-lucide-file-output",{"title":480,"path":481,"stem":482,"icon":483},"Migrating","\u002Flibraries\u002Fmigrating","6.libraries\u002F5.migrating","i-lucide-route",{"title":485,"path":486,"stem":487,"icon":488},"Testing","\u002Flibraries\u002Ftesting","6.libraries\u002F6.testing","i-lucide-flask-conical",{"title":490,"path":491,"stem":492,"children":493,"page":34},"Extend","\u002Fextend","7.extend",[494,498,503,508,512,517,521,525,529,533,538,543],{"title":41,"path":495,"stem":496,"icon":497},"\u002Fextend\u002Foverview","7.extend\u002F0.overview","i-lucide-blocks",{"title":499,"path":500,"stem":501,"icon":502},"Stream","\u002Fextend\u002Fstream","7.extend\u002F1.stream","i-lucide-radio-tower",{"title":504,"path":505,"stem":506,"icon":507},"Custom framework","\u002Fextend\u002Fcustom-framework","7.extend\u002F10.custom-framework","i-lucide-puzzle",{"title":509,"path":510,"stem":511,"icon":502},"Diagnostics channel","\u002Fextend\u002Fdiagnostics-channel","7.extend\u002F11.diagnostics-channel",{"title":513,"path":514,"stem":515,"icon":516},"FS reader","\u002Fextend\u002Ffs-reader","7.extend\u002F2.fs-reader","i-lucide-folder-search",{"title":415,"path":518,"stem":519,"icon":520},"\u002Fextend\u002Fconsumer-recipes","7.extend\u002F3.consumer-recipes","i-lucide-chef-hat",{"title":522,"path":523,"stem":524,"icon":497},"Plugins","\u002Fextend\u002Fplugins","7.extend\u002F4.plugins",{"title":526,"path":527,"stem":528,"icon":443},"Custom enrichers","\u002Fextend\u002Fcustom-enrichers","7.extend\u002F5.custom-enrichers",{"title":530,"path":531,"stem":532,"icon":69},"Tail sampling","\u002Fextend\u002Ftail-sampling","7.extend\u002F6.tail-sampling",{"title":534,"path":535,"stem":536,"icon":537},"Identity headers","\u002Fextend\u002Fidentity-headers","7.extend\u002F7.identity-headers","i-lucide-fingerprint",{"title":539,"path":540,"stem":541,"icon":542},"Custom drains","\u002Fextend\u002Fcustom-drains","7.extend\u002F8.custom-drains","i-lucide-share-2",{"title":544,"path":545,"stem":546,"icon":547},"Drain pipeline","\u002Fextend\u002Fdrain-pipeline","7.extend\u002F9.drain-pipeline","i-lucide-workflow",{"title":436,"path":549,"stem":550,"children":551,"page":34},"\u002Freference","8.reference",[552,556,561,564,569,573,578,582],{"title":41,"path":553,"stem":554,"icon":555},"\u002Freference\u002Foverview","8.reference\u002F0.overview","i-lucide-book-marked",{"title":557,"path":558,"stem":559,"icon":560},"Configuration","\u002Freference\u002Fconfiguration","8.reference\u002F1.configuration","i-lucide-settings",{"title":383,"path":562,"stem":563,"icon":112},"\u002Freference\u002Fperformance","8.reference\u002F2.performance",{"title":565,"path":566,"stem":567,"icon":568},"Vite Plugin","\u002Freference\u002Fvite-plugin","8.reference\u002F3.vite-plugin","i-custom-vite",{"title":570,"path":571,"stem":572,"icon":388},"Best Practices","\u002Freference\u002Fbest-practices","8.reference\u002F4.best-practices",{"title":574,"path":575,"stem":576,"icon":577},"vs Other Loggers","\u002Freference\u002Fvs-other-loggers","8.reference\u002F5.vs-other-loggers","i-lucide-scale",{"title":579,"path":580,"stem":581,"icon":443},"Agent Skills","\u002Freference\u002Fagent-skills","8.reference\u002F6.agent-skills",{"title":583,"path":584,"stem":585,"icon":586},"Cost","\u002Freference\u002Fcost","8.reference\u002F7.cost","i-lucide-receipt",{"title":588,"path":589,"stem":590,"children":591,"page":34},"Compare","\u002Fcompare","9.compare",[592,596,600,604,608],{"title":593,"path":594,"stem":595,"icon":577},"evlog vs Pino","\u002Fcompare\u002Fpino","9.compare\u002F1.pino",{"title":597,"path":598,"stem":599,"icon":204},"evlog vs OpenTelemetry","\u002Fcompare\u002Fopentelemetry","9.compare\u002F2.opentelemetry",{"title":601,"path":602,"stem":603,"icon":577},"evlog vs LogTape","\u002Fcompare\u002Flogtape","9.compare\u002F3.logtape",{"title":605,"path":606,"stem":607,"icon":577},"evlog vs Winston: formats and request events","\u002Fcompare\u002Fwinston","9.compare\u002F4.winston",{"title":609,"path":610,"stem":611,"icon":577},"evlog vs Consola: reporters and request context","\u002Fcompare\u002Fconsola","9.compare\u002F5.consola",{"id":613,"title":614,"body":615,"description":3260,"extension":3261,"links":3262,"meta":3268,"navigation":3269,"path":437,"seo":3270,"stem":438,"__hash__":3271},"docs\u002F5.use-cases\u002F4.telemetry\u002F04.reference.md","Telemetry Reference",{"type":616,"value":617,"toc":3244},"minimark",[618,623,627,1002,1006,1024,1027,1084,1087,1120,1125,1136,1439,1442,1599,1608,1628,1632,1635,1905,1913,1917,1924,2209,2218,2224,2233,2312,2322,2326,2332,2470,2474,2569,2584,2588,2591,2600,2772,2781,2794,2800,2804,2815,2854,2947,2953,2996,3010,3021,3025,3037,3175,3185,3189,3208,3218,3227,3240],[619,620,622],"h2",{"id":621},"standard-envelope","Standard envelope",[624,625,626],"p",{},"Every run shares the same shape. You do not declare per-command schemas.",[628,629,634],"pre",{"className":630,"code":631,"language":632,"meta":633,"style":633},"language-jsonc shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"event\": \"run\",\n  \"command\": \"sync\",\n  \"durationMs\": 412,\n  \"outcome\": \"success\",\n  \"flags\": { \"dryRun\": true, \"output\": \"\u003Cset>\" },\n  \"tool\": { \"name\": \"my-tool\", \"version\": \"1.0.0\" },\n  \"env\": {\n    \"node\": \"20.11\",\n    \"ci\": false,\n    \"provider\": null,\n    \"tty\": true,\n    \"agent\": \"cursor\"   \u002F\u002F std-env: cursor, claude, codex, … or null\n  },\n  \"machineId\": \"ab3f…\", \u002F\u002F hashed; omitted in ephemeral CI\n  \"custom\": { \"itemsSynced\": 42 }\n}\n","jsonc","",[635,636,637,646,674,695,713,734,781,832,847,869,884,899,914,937,943,967,996],"code",{"__ignoreMap":633},[638,639,642],"span",{"class":640,"line":641},"line",1,[638,643,645],{"class":644},"sMK4o","{\n",[638,647,649,652,656,659,662,665,669,671],{"class":640,"line":648},2,[638,650,651],{"class":644},"  \"",[638,653,655],{"class":654},"spNyl","event",[638,657,658],{"class":644},"\"",[638,660,661],{"class":644},":",[638,663,664],{"class":644}," \"",[638,666,668],{"class":667},"sfazB","run",[638,670,658],{"class":644},[638,672,673],{"class":644},",\n",[638,675,677,679,682,684,686,688,691,693],{"class":640,"line":676},3,[638,678,651],{"class":644},[638,680,681],{"class":654},"command",[638,683,658],{"class":644},[638,685,661],{"class":644},[638,687,664],{"class":644},[638,689,690],{"class":667},"sync",[638,692,658],{"class":644},[638,694,673],{"class":644},[638,696,698,700,703,705,707,711],{"class":640,"line":697},4,[638,699,651],{"class":644},[638,701,702],{"class":654},"durationMs",[638,704,658],{"class":644},[638,706,661],{"class":644},[638,708,710],{"class":709},"sbssI"," 412",[638,712,673],{"class":644},[638,714,716,718,721,723,725,727,730,732],{"class":640,"line":715},5,[638,717,651],{"class":644},[638,719,720],{"class":654},"outcome",[638,722,658],{"class":644},[638,724,661],{"class":644},[638,726,664],{"class":644},[638,728,729],{"class":667},"success",[638,731,658],{"class":644},[638,733,673],{"class":644},[638,735,737,739,742,744,746,749,751,755,757,759,762,764,767,769,771,773,776,778],{"class":640,"line":736},6,[638,738,651],{"class":644},[638,740,741],{"class":654},"flags",[638,743,658],{"class":644},[638,745,661],{"class":644},[638,747,748],{"class":644}," {",[638,750,664],{"class":644},[638,752,754],{"class":753},"sBMFI","dryRun",[638,756,658],{"class":644},[638,758,661],{"class":644},[638,760,761],{"class":644}," true,",[638,763,664],{"class":644},[638,765,766],{"class":753},"output",[638,768,658],{"class":644},[638,770,661],{"class":644},[638,772,664],{"class":644},[638,774,775],{"class":667},"\u003Cset>",[638,777,658],{"class":644},[638,779,780],{"class":644}," },\n",[638,782,784,786,789,791,793,795,797,800,802,804,806,809,811,814,816,819,821,823,825,828,830],{"class":640,"line":783},7,[638,785,651],{"class":644},[638,787,788],{"class":654},"tool",[638,790,658],{"class":644},[638,792,661],{"class":644},[638,794,748],{"class":644},[638,796,664],{"class":644},[638,798,799],{"class":753},"name",[638,801,658],{"class":644},[638,803,661],{"class":644},[638,805,664],{"class":644},[638,807,808],{"class":667},"my-tool",[638,810,658],{"class":644},[638,812,813],{"class":644},",",[638,815,664],{"class":644},[638,817,818],{"class":753},"version",[638,820,658],{"class":644},[638,822,661],{"class":644},[638,824,664],{"class":644},[638,826,827],{"class":667},"1.0.0",[638,829,658],{"class":644},[638,831,780],{"class":644},[638,833,835,837,840,842,844],{"class":640,"line":834},8,[638,836,651],{"class":644},[638,838,839],{"class":654},"env",[638,841,658],{"class":644},[638,843,661],{"class":644},[638,845,846],{"class":644}," {\n",[638,848,850,853,856,858,860,862,865,867],{"class":640,"line":849},9,[638,851,852],{"class":644},"    \"",[638,854,855],{"class":753},"node",[638,857,658],{"class":644},[638,859,661],{"class":644},[638,861,664],{"class":644},[638,863,864],{"class":667},"20.11",[638,866,658],{"class":644},[638,868,673],{"class":644},[638,870,872,874,877,879,881],{"class":640,"line":871},10,[638,873,852],{"class":644},[638,875,876],{"class":753},"ci",[638,878,658],{"class":644},[638,880,661],{"class":644},[638,882,883],{"class":644}," false,\n",[638,885,887,889,892,894,896],{"class":640,"line":886},11,[638,888,852],{"class":644},[638,890,891],{"class":753},"provider",[638,893,658],{"class":644},[638,895,661],{"class":644},[638,897,898],{"class":644}," null,\n",[638,900,902,904,907,909,911],{"class":640,"line":901},12,[638,903,852],{"class":644},[638,905,906],{"class":753},"tty",[638,908,658],{"class":644},[638,910,661],{"class":644},[638,912,913],{"class":644}," true,\n",[638,915,917,919,922,924,926,928,931,933],{"class":640,"line":916},13,[638,918,852],{"class":644},[638,920,921],{"class":753},"agent",[638,923,658],{"class":644},[638,925,661],{"class":644},[638,927,664],{"class":644},[638,929,930],{"class":667},"cursor",[638,932,658],{"class":644},[638,934,936],{"class":935},"sHwdD","   \u002F\u002F std-env: cursor, claude, codex, … or null\n",[638,938,940],{"class":640,"line":939},14,[638,941,942],{"class":644},"  },\n",[638,944,946,948,951,953,955,957,960,962,964],{"class":640,"line":945},15,[638,947,651],{"class":644},[638,949,950],{"class":654},"machineId",[638,952,658],{"class":644},[638,954,661],{"class":644},[638,956,664],{"class":644},[638,958,959],{"class":667},"ab3f…",[638,961,658],{"class":644},[638,963,813],{"class":644},[638,965,966],{"class":935}," \u002F\u002F hashed; omitted in ephemeral CI\n",[638,968,970,972,975,977,979,981,983,986,988,990,993],{"class":640,"line":969},16,[638,971,651],{"class":644},[638,973,974],{"class":654},"custom",[638,976,658],{"class":644},[638,978,661],{"class":644},[638,980,748],{"class":644},[638,982,664],{"class":644},[638,984,985],{"class":753},"itemsSynced",[638,987,658],{"class":644},[638,989,661],{"class":644},[638,991,992],{"class":709}," 42",[638,994,995],{"class":644}," }\n",[638,997,999],{"class":640,"line":998},17,[638,1000,1001],{"class":644},"}\n",[619,1003,1005],{"id":1004},"extending-the-schema","Extending the schema",[624,1007,1008,1009,1013,1014,1017,1018,1020,1021,1023],{},"The envelope above is ",[1010,1011,1012],"strong",{},"fixed",": every tool sends the same top-level shape so ",[635,1015,1016],{},"parseIngestBody()"," and disclosure stay predictable. You do not add fields next to ",[635,1019,681],{}," or ",[635,1022,702],{},".",[624,1025,1026],{},"Your product schema lives in two extension zones:",[1028,1029,1030,1046],"table",{},[1031,1032,1033],"thead",{},[1034,1035,1036,1040,1043],"tr",{},[1037,1038,1039],"th",{},"Zone",[1037,1041,1042],{},"Who sets it",[1037,1044,1045],{},"What goes there",[1047,1048,1049,1065],"tbody",{},[1034,1050,1051,1056,1062],{},[1052,1053,1054],"td",{},[635,1055,741],{},[1052,1057,1058,1059],{},"citty (auto) + ",[635,1060,1061],{},"collect.flags",[1052,1063,1064],{},"Flags you passed — booleans\u002Fnumbers as values, strings only when allowlisted",[1034,1066,1067,1071,1081],{},[1052,1068,1069],{},[635,1070,974],{},[1052,1072,1073,1074,1077,1078],{},"you via ",[635,1075,1076],{},"telemetry.set()"," + ",[635,1079,1080],{},"collect.fields",[1052,1082,1083],{},"Business counters, categorical dimensions, schema version",[624,1085,1086],{},"Think of it as two contracts:",[1088,1089,1090,1105],"ul",{},[1091,1092,1093,1096,1097,1100,1101,1104],"li",{},[1010,1094,1095],{},"Transport contract"," (",[635,1098,1099],{},"RunEvent","): owned by ",[635,1102,1103],{},"@evlog\u002Ftelemetry",", stable across tools",[1091,1106,1107,1096,1110,1112,1113,1115,1116,1119],{},[1010,1108,1109],{},"Product contract",[635,1111,974],{}," + declared ",[635,1114,741],{},"): owned by you, declared in ",[635,1117,1118],{},"collect",", mirrored on the server",[1121,1122,1124],"h3",{"id":1123},"declare-your-extensions-once","Declare your extensions once",[624,1126,1127,1128,1131,1132,1135],{},"Everything you collect beyond the standard envelope is declared inline in the same ",[635,1129,1130],{},"withTelemetry()"," \u002F ",[635,1133,1134],{},"createTelemetry()"," call:",[628,1137,1142],{"className":1138,"code":1139,"filename":1140,"language":1141,"meta":633,"style":633},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","withTelemetry(command, {\n  name: 'acme-cli',\n  version: '2.1.0',\n  endpoint: 'https:\u002F\u002Ftelemetry.acme.dev\u002Fapi\u002Fingest',\n  collect: {\n    flags: {\n      format: ['json', 'yaml', 'table'],\n      target: ['staging', 'production'],\n    },\n    fields: {\n      product: ['cli', 'action', 'migrator'],\n      plan: ['free', 'pro', 'enterprise'],\n      framework: ['nuxt', 'next', 'remix'],\n    },\n  },\n})\n","src\u002Findex.ts","ts",[635,1143,1144,1158,1177,1193,1209,1218,1227,1266,1295,1300,1309,1347,1385,1423,1427,1431],{"__ignoreMap":633},[638,1145,1146,1150,1154,1156],{"class":640,"line":641},[638,1147,1149],{"class":1148},"s2Zo4","withTelemetry",[638,1151,1153],{"class":1152},"sTEyZ","(command",[638,1155,813],{"class":644},[638,1157,846],{"class":644},[638,1159,1160,1164,1166,1169,1172,1175],{"class":640,"line":648},[638,1161,1163],{"class":1162},"swJcz","  name",[638,1165,661],{"class":644},[638,1167,1168],{"class":644}," '",[638,1170,1171],{"class":667},"acme-cli",[638,1173,1174],{"class":644},"'",[638,1176,673],{"class":644},[638,1178,1179,1182,1184,1186,1189,1191],{"class":640,"line":676},[638,1180,1181],{"class":1162},"  version",[638,1183,661],{"class":644},[638,1185,1168],{"class":644},[638,1187,1188],{"class":667},"2.1.0",[638,1190,1174],{"class":644},[638,1192,673],{"class":644},[638,1194,1195,1198,1200,1202,1205,1207],{"class":640,"line":697},[638,1196,1197],{"class":1162},"  endpoint",[638,1199,661],{"class":644},[638,1201,1168],{"class":644},[638,1203,1204],{"class":667},"https:\u002F\u002Ftelemetry.acme.dev\u002Fapi\u002Fingest",[638,1206,1174],{"class":644},[638,1208,673],{"class":644},[638,1210,1211,1214,1216],{"class":640,"line":715},[638,1212,1213],{"class":1162},"  collect",[638,1215,661],{"class":644},[638,1217,846],{"class":644},[638,1219,1220,1223,1225],{"class":640,"line":736},[638,1221,1222],{"class":1162},"    flags",[638,1224,661],{"class":644},[638,1226,846],{"class":644},[638,1228,1229,1232,1234,1237,1239,1242,1244,1246,1248,1251,1253,1255,1257,1259,1261,1264],{"class":640,"line":783},[638,1230,1231],{"class":1162},"      format",[638,1233,661],{"class":644},[638,1235,1236],{"class":1152}," [",[638,1238,1174],{"class":644},[638,1240,1241],{"class":667},"json",[638,1243,1174],{"class":644},[638,1245,813],{"class":644},[638,1247,1168],{"class":644},[638,1249,1250],{"class":667},"yaml",[638,1252,1174],{"class":644},[638,1254,813],{"class":644},[638,1256,1168],{"class":644},[638,1258,1028],{"class":667},[638,1260,1174],{"class":644},[638,1262,1263],{"class":1152},"]",[638,1265,673],{"class":644},[638,1267,1268,1271,1273,1275,1277,1280,1282,1284,1286,1289,1291,1293],{"class":640,"line":834},[638,1269,1270],{"class":1162},"      target",[638,1272,661],{"class":644},[638,1274,1236],{"class":1152},[638,1276,1174],{"class":644},[638,1278,1279],{"class":667},"staging",[638,1281,1174],{"class":644},[638,1283,813],{"class":644},[638,1285,1168],{"class":644},[638,1287,1288],{"class":667},"production",[638,1290,1174],{"class":644},[638,1292,1263],{"class":1152},[638,1294,673],{"class":644},[638,1296,1297],{"class":640,"line":849},[638,1298,1299],{"class":644},"    },\n",[638,1301,1302,1305,1307],{"class":640,"line":871},[638,1303,1304],{"class":1162},"    fields",[638,1306,661],{"class":644},[638,1308,846],{"class":644},[638,1310,1311,1314,1316,1318,1320,1323,1325,1327,1329,1332,1334,1336,1338,1341,1343,1345],{"class":640,"line":886},[638,1312,1313],{"class":1162},"      product",[638,1315,661],{"class":644},[638,1317,1236],{"class":1152},[638,1319,1174],{"class":644},[638,1321,1322],{"class":667},"cli",[638,1324,1174],{"class":644},[638,1326,813],{"class":644},[638,1328,1168],{"class":644},[638,1330,1331],{"class":667},"action",[638,1333,1174],{"class":644},[638,1335,813],{"class":644},[638,1337,1168],{"class":644},[638,1339,1340],{"class":667},"migrator",[638,1342,1174],{"class":644},[638,1344,1263],{"class":1152},[638,1346,673],{"class":644},[638,1348,1349,1352,1354,1356,1358,1361,1363,1365,1367,1370,1372,1374,1376,1379,1381,1383],{"class":640,"line":901},[638,1350,1351],{"class":1162},"      plan",[638,1353,661],{"class":644},[638,1355,1236],{"class":1152},[638,1357,1174],{"class":644},[638,1359,1360],{"class":667},"free",[638,1362,1174],{"class":644},[638,1364,813],{"class":644},[638,1366,1168],{"class":644},[638,1368,1369],{"class":667},"pro",[638,1371,1174],{"class":644},[638,1373,813],{"class":644},[638,1375,1168],{"class":644},[638,1377,1378],{"class":667},"enterprise",[638,1380,1174],{"class":644},[638,1382,1263],{"class":1152},[638,1384,673],{"class":644},[638,1386,1387,1390,1392,1394,1396,1399,1401,1403,1405,1408,1410,1412,1414,1417,1419,1421],{"class":640,"line":916},[638,1388,1389],{"class":1162},"      framework",[638,1391,661],{"class":644},[638,1393,1236],{"class":1152},[638,1395,1174],{"class":644},[638,1397,1398],{"class":667},"nuxt",[638,1400,1174],{"class":644},[638,1402,813],{"class":644},[638,1404,1168],{"class":644},[638,1406,1407],{"class":667},"next",[638,1409,1174],{"class":644},[638,1411,813],{"class":644},[638,1413,1168],{"class":644},[638,1415,1416],{"class":667},"remix",[638,1418,1174],{"class":644},[638,1420,1263],{"class":1152},[638,1422,673],{"class":644},[638,1424,1425],{"class":640,"line":939},[638,1426,1299],{"class":644},[638,1428,1429],{"class":640,"line":945},[638,1430,942],{"class":644},[638,1432,1433,1436],{"class":640,"line":969},[638,1434,1435],{"class":644},"}",[638,1437,1438],{"class":1152},")\n",[624,1440,1441],{},"Inside handlers, add counters and dimensions:",[628,1443,1446],{"className":1138,"code":1444,"filename":1445,"language":1141,"meta":633,"style":633},"await t.run('deploy', async () => {\n  const result = await deployServices()\n  telemetry.set({\n    servicesDeployed: result.count,   \u002F\u002F number — always allowed\n    rollbackUsed: false,              \u002F\u002F boolean — always allowed\n    framework: 'nuxt',                \u002F\u002F string — allowed (in collect.fields)\n    schemaVersion: 2,                 \u002F\u002F number — version your custom shape\n  })\n})\n","src\u002Fcommands\u002Fdeploy.ts",[635,1447,1448,1484,1504,1518,1537,1553,1571,1586,1593],{"__ignoreMap":633},[638,1449,1450,1454,1457,1459,1461,1464,1466,1469,1471,1473,1476,1479,1482],{"class":640,"line":641},[638,1451,1453],{"class":1452},"s7zQu","await",[638,1455,1456],{"class":1152}," t",[638,1458,1023],{"class":644},[638,1460,668],{"class":1148},[638,1462,1463],{"class":1152},"(",[638,1465,1174],{"class":644},[638,1467,1468],{"class":667},"deploy",[638,1470,1174],{"class":644},[638,1472,813],{"class":644},[638,1474,1475],{"class":654}," async",[638,1477,1478],{"class":644}," ()",[638,1480,1481],{"class":654}," =>",[638,1483,846],{"class":644},[638,1485,1486,1489,1492,1495,1498,1501],{"class":640,"line":648},[638,1487,1488],{"class":654},"  const",[638,1490,1491],{"class":1152}," result",[638,1493,1494],{"class":644}," =",[638,1496,1497],{"class":1452}," await",[638,1499,1500],{"class":1148}," deployServices",[638,1502,1503],{"class":1162},"()\n",[638,1505,1506,1509,1511,1514,1516],{"class":640,"line":676},[638,1507,1508],{"class":1152},"  telemetry",[638,1510,1023],{"class":644},[638,1512,1513],{"class":1148},"set",[638,1515,1463],{"class":1162},[638,1517,645],{"class":644},[638,1519,1520,1523,1525,1527,1529,1532,1534],{"class":640,"line":697},[638,1521,1522],{"class":1162},"    servicesDeployed",[638,1524,661],{"class":644},[638,1526,1491],{"class":1152},[638,1528,1023],{"class":644},[638,1530,1531],{"class":1152},"count",[638,1533,813],{"class":644},[638,1535,1536],{"class":935},"   \u002F\u002F number — always allowed\n",[638,1538,1539,1542,1544,1548,1550],{"class":640,"line":715},[638,1540,1541],{"class":1162},"    rollbackUsed",[638,1543,661],{"class":644},[638,1545,1547],{"class":1546},"sfNiH"," false",[638,1549,813],{"class":644},[638,1551,1552],{"class":935},"              \u002F\u002F boolean — always allowed\n",[638,1554,1555,1558,1560,1562,1564,1566,1568],{"class":640,"line":736},[638,1556,1557],{"class":1162},"    framework",[638,1559,661],{"class":644},[638,1561,1168],{"class":644},[638,1563,1398],{"class":667},[638,1565,1174],{"class":644},[638,1567,813],{"class":644},[638,1569,1570],{"class":935},"                \u002F\u002F string — allowed (in collect.fields)\n",[638,1572,1573,1576,1578,1581,1583],{"class":640,"line":783},[638,1574,1575],{"class":1162},"    schemaVersion",[638,1577,661],{"class":644},[638,1579,1580],{"class":709}," 2",[638,1582,813],{"class":644},[638,1584,1585],{"class":935},"                 \u002F\u002F number — version your custom shape\n",[638,1587,1588,1591],{"class":640,"line":834},[638,1589,1590],{"class":644},"  }",[638,1592,1438],{"class":1162},[638,1594,1595,1597],{"class":640,"line":849},[638,1596,1435],{"class":644},[638,1598,1438],{"class":1152},[624,1600,1601,1602,1605,1606,1023],{},"Undeclared strings are ",[1010,1603,1604],{},"dropped at runtime",", never thrown. That is the privacy guarantee: no accidental paths, tokens, or free-form PII in ",[635,1607,974],{},[1609,1610,1611,1614,1615,1618,1619,1621,1622,1624,1625,1627],"note",{},[1010,1612,1613],{},"Typing:"," ",[635,1616,1617],{},"TelemetryHandle.set()"," autocomplete covers declared ",[635,1620,1080],{}," keys. Use the ambient ",[635,1623,1076],{}," for extra numeric\u002Fboolean counters in the same run, and both merge into ",[635,1626,974],{}," before the event is recorded.",[1121,1629,1631],{"id":1630},"mirror-on-the-server","Mirror on the server",[624,1633,1634],{},"Your ingest handler is the second gate. Pass the same tool name and custom keys you declared on the CLI:",[628,1636,1639],{"className":1138,"code":1637,"filename":1638,"language":1141,"meta":633,"style":633},"import { parseIngestBody } from '@evlog\u002Ftelemetry\u002Fingest'\n\nconst ALLOWED_CUSTOM = [\n  'servicesDeployed', 'rollbackUsed', 'framework',\n  'product', 'plan', 'schemaVersion',\n  'ghaAction', 'ghaEvent',\n] as const\n\nexport async function POST(req: Request) {\n  const raw = await req.text()\n  const events = parseIngestBody(raw, {\n    allowedTools: ['acme-cli'],\n    allowedCustomKeys: { 'acme-cli': ALLOWED_CUSTOM },\n  })\n  \u002F\u002F dedupe on idempotencyKey, then persist\n}\n","app\u002Fapi\u002Ftelemetry\u002Fingest\u002Froute.ts",[635,1640,1641,1665,1671,1685,1715,1744,1764,1775,1779,1808,1829,1849,1868,1890,1896,1901],{"__ignoreMap":633},[638,1642,1643,1646,1648,1651,1654,1657,1659,1662],{"class":640,"line":641},[638,1644,1645],{"class":1452},"import",[638,1647,748],{"class":644},[638,1649,1650],{"class":1152}," parseIngestBody",[638,1652,1653],{"class":644}," }",[638,1655,1656],{"class":1452}," from",[638,1658,1168],{"class":644},[638,1660,1661],{"class":667},"@evlog\u002Ftelemetry\u002Fingest",[638,1663,1664],{"class":644},"'\n",[638,1666,1667],{"class":640,"line":648},[638,1668,1670],{"emptyLinePlaceholder":1669},true,"\n",[638,1672,1673,1676,1679,1682],{"class":640,"line":676},[638,1674,1675],{"class":654},"const",[638,1677,1678],{"class":1152}," ALLOWED_CUSTOM ",[638,1680,1681],{"class":644},"=",[638,1683,1684],{"class":1152}," [\n",[638,1686,1687,1690,1693,1695,1697,1699,1702,1704,1706,1708,1711,1713],{"class":640,"line":697},[638,1688,1689],{"class":644},"  '",[638,1691,1692],{"class":667},"servicesDeployed",[638,1694,1174],{"class":644},[638,1696,813],{"class":644},[638,1698,1168],{"class":644},[638,1700,1701],{"class":667},"rollbackUsed",[638,1703,1174],{"class":644},[638,1705,813],{"class":644},[638,1707,1168],{"class":644},[638,1709,1710],{"class":667},"framework",[638,1712,1174],{"class":644},[638,1714,673],{"class":644},[638,1716,1717,1719,1722,1724,1726,1728,1731,1733,1735,1737,1740,1742],{"class":640,"line":715},[638,1718,1689],{"class":644},[638,1720,1721],{"class":667},"product",[638,1723,1174],{"class":644},[638,1725,813],{"class":644},[638,1727,1168],{"class":644},[638,1729,1730],{"class":667},"plan",[638,1732,1174],{"class":644},[638,1734,813],{"class":644},[638,1736,1168],{"class":644},[638,1738,1739],{"class":667},"schemaVersion",[638,1741,1174],{"class":644},[638,1743,673],{"class":644},[638,1745,1746,1748,1751,1753,1755,1757,1760,1762],{"class":640,"line":736},[638,1747,1689],{"class":644},[638,1749,1750],{"class":667},"ghaAction",[638,1752,1174],{"class":644},[638,1754,813],{"class":644},[638,1756,1168],{"class":644},[638,1758,1759],{"class":667},"ghaEvent",[638,1761,1174],{"class":644},[638,1763,673],{"class":644},[638,1765,1766,1769,1772],{"class":640,"line":783},[638,1767,1768],{"class":1152},"] ",[638,1770,1771],{"class":1452},"as",[638,1773,1774],{"class":654}," const\n",[638,1776,1777],{"class":640,"line":834},[638,1778,1670],{"emptyLinePlaceholder":1669},[638,1780,1781,1784,1786,1789,1792,1794,1798,1800,1803,1806],{"class":640,"line":849},[638,1782,1783],{"class":1452},"export",[638,1785,1475],{"class":654},[638,1787,1788],{"class":654}," function",[638,1790,1791],{"class":1148}," POST",[638,1793,1463],{"class":644},[638,1795,1797],{"class":1796},"sHdIc","req",[638,1799,661],{"class":644},[638,1801,1802],{"class":753}," Request",[638,1804,1805],{"class":644},")",[638,1807,846],{"class":644},[638,1809,1810,1812,1815,1817,1819,1822,1824,1827],{"class":640,"line":871},[638,1811,1488],{"class":654},[638,1813,1814],{"class":1152}," raw",[638,1816,1494],{"class":644},[638,1818,1497],{"class":1452},[638,1820,1821],{"class":1152}," req",[638,1823,1023],{"class":644},[638,1825,1826],{"class":1148},"text",[638,1828,1503],{"class":1162},[638,1830,1831,1833,1836,1838,1840,1842,1845,1847],{"class":640,"line":886},[638,1832,1488],{"class":654},[638,1834,1835],{"class":1152}," events",[638,1837,1494],{"class":644},[638,1839,1650],{"class":1148},[638,1841,1463],{"class":1162},[638,1843,1844],{"class":1152},"raw",[638,1846,813],{"class":644},[638,1848,846],{"class":644},[638,1850,1851,1854,1856,1858,1860,1862,1864,1866],{"class":640,"line":901},[638,1852,1853],{"class":1162},"    allowedTools",[638,1855,661],{"class":644},[638,1857,1236],{"class":1162},[638,1859,1174],{"class":644},[638,1861,1171],{"class":667},[638,1863,1174],{"class":644},[638,1865,1263],{"class":1162},[638,1867,673],{"class":644},[638,1869,1870,1873,1875,1877,1879,1881,1883,1885,1888],{"class":640,"line":916},[638,1871,1872],{"class":1162},"    allowedCustomKeys",[638,1874,661],{"class":644},[638,1876,748],{"class":644},[638,1878,1168],{"class":644},[638,1880,1171],{"class":1162},[638,1882,1174],{"class":644},[638,1884,661],{"class":644},[638,1886,1887],{"class":1152}," ALLOWED_CUSTOM",[638,1889,780],{"class":644},[638,1891,1892,1894],{"class":640,"line":939},[638,1893,1590],{"class":644},[638,1895,1438],{"class":1162},[638,1897,1898],{"class":640,"line":945},[638,1899,1900],{"class":935},"  \u002F\u002F dedupe on idempotencyKey, then persist\n",[638,1902,1903],{"class":640,"line":969},[638,1904,1001],{"class":644},[624,1906,1907,1909,1910,1912],{},[635,1908,1016],{}," strips any ",[635,1911,974],{}," key you did not list, even if a client somehow sent it.",[1121,1914,1916],{"id":1915},"map-to-your-warehouse-schema","Map to your warehouse schema",[624,1918,1919,1920,1923],{},"After validation, shape the event for ",[1010,1921,1922],{},"your"," database. The evlog envelope is the wire format; your tables are your choice:",[628,1925,1928],{"className":1138,"code":1926,"filename":1927,"language":1141,"meta":633,"style":633},"function toRow(event: RunEvent) {\n  return {\n    command: event.command,\n    duration_ms: event.durationMs,\n    outcome: event.outcome,\n    tool_version: event.tool.version,\n    format: event.flags.format,\n    target: event.flags.target,\n    services_deployed: event.custom.servicesDeployed,\n    framework: event.custom.framework,\n    plan: event.custom.plan,\n    schema_version: event.custom.schemaVersion ?? 1,\n    is_ci: event.env.ci,\n    node: event.env.node,\n    received_at: new Date(),\n  }\n}\n","lib\u002Ftelemetry-store.ts",[635,1929,1930,1951,1958,1974,1989,2004,2023,2043,2063,2082,2100,2119,2144,2163,2182,2200,2205],{"__ignoreMap":633},[638,1931,1932,1935,1938,1940,1942,1944,1947,1949],{"class":640,"line":641},[638,1933,1934],{"class":654},"function",[638,1936,1937],{"class":1148}," toRow",[638,1939,1463],{"class":644},[638,1941,655],{"class":1796},[638,1943,661],{"class":644},[638,1945,1946],{"class":753}," RunEvent",[638,1948,1805],{"class":644},[638,1950,846],{"class":644},[638,1952,1953,1956],{"class":640,"line":648},[638,1954,1955],{"class":1452},"  return",[638,1957,846],{"class":644},[638,1959,1960,1963,1965,1968,1970,1972],{"class":640,"line":676},[638,1961,1962],{"class":1162},"    command",[638,1964,661],{"class":644},[638,1966,1967],{"class":1152}," event",[638,1969,1023],{"class":644},[638,1971,681],{"class":1152},[638,1973,673],{"class":644},[638,1975,1976,1979,1981,1983,1985,1987],{"class":640,"line":697},[638,1977,1978],{"class":1162},"    duration_ms",[638,1980,661],{"class":644},[638,1982,1967],{"class":1152},[638,1984,1023],{"class":644},[638,1986,702],{"class":1152},[638,1988,673],{"class":644},[638,1990,1991,1994,1996,1998,2000,2002],{"class":640,"line":715},[638,1992,1993],{"class":1162},"    outcome",[638,1995,661],{"class":644},[638,1997,1967],{"class":1152},[638,1999,1023],{"class":644},[638,2001,720],{"class":1152},[638,2003,673],{"class":644},[638,2005,2006,2009,2011,2013,2015,2017,2019,2021],{"class":640,"line":736},[638,2007,2008],{"class":1162},"    tool_version",[638,2010,661],{"class":644},[638,2012,1967],{"class":1152},[638,2014,1023],{"class":644},[638,2016,788],{"class":1152},[638,2018,1023],{"class":644},[638,2020,818],{"class":1152},[638,2022,673],{"class":644},[638,2024,2025,2028,2030,2032,2034,2036,2038,2041],{"class":640,"line":783},[638,2026,2027],{"class":1162},"    format",[638,2029,661],{"class":644},[638,2031,1967],{"class":1152},[638,2033,1023],{"class":644},[638,2035,741],{"class":1152},[638,2037,1023],{"class":644},[638,2039,2040],{"class":1152},"format",[638,2042,673],{"class":644},[638,2044,2045,2048,2050,2052,2054,2056,2058,2061],{"class":640,"line":834},[638,2046,2047],{"class":1162},"    target",[638,2049,661],{"class":644},[638,2051,1967],{"class":1152},[638,2053,1023],{"class":644},[638,2055,741],{"class":1152},[638,2057,1023],{"class":644},[638,2059,2060],{"class":1152},"target",[638,2062,673],{"class":644},[638,2064,2065,2068,2070,2072,2074,2076,2078,2080],{"class":640,"line":849},[638,2066,2067],{"class":1162},"    services_deployed",[638,2069,661],{"class":644},[638,2071,1967],{"class":1152},[638,2073,1023],{"class":644},[638,2075,974],{"class":1152},[638,2077,1023],{"class":644},[638,2079,1692],{"class":1152},[638,2081,673],{"class":644},[638,2083,2084,2086,2088,2090,2092,2094,2096,2098],{"class":640,"line":871},[638,2085,1557],{"class":1162},[638,2087,661],{"class":644},[638,2089,1967],{"class":1152},[638,2091,1023],{"class":644},[638,2093,974],{"class":1152},[638,2095,1023],{"class":644},[638,2097,1710],{"class":1152},[638,2099,673],{"class":644},[638,2101,2102,2105,2107,2109,2111,2113,2115,2117],{"class":640,"line":886},[638,2103,2104],{"class":1162},"    plan",[638,2106,661],{"class":644},[638,2108,1967],{"class":1152},[638,2110,1023],{"class":644},[638,2112,974],{"class":1152},[638,2114,1023],{"class":644},[638,2116,1730],{"class":1152},[638,2118,673],{"class":644},[638,2120,2121,2124,2126,2128,2130,2132,2134,2136,2139,2142],{"class":640,"line":901},[638,2122,2123],{"class":1162},"    schema_version",[638,2125,661],{"class":644},[638,2127,1967],{"class":1152},[638,2129,1023],{"class":644},[638,2131,974],{"class":1152},[638,2133,1023],{"class":644},[638,2135,1739],{"class":1152},[638,2137,2138],{"class":644}," ??",[638,2140,2141],{"class":709}," 1",[638,2143,673],{"class":644},[638,2145,2146,2149,2151,2153,2155,2157,2159,2161],{"class":640,"line":916},[638,2147,2148],{"class":1162},"    is_ci",[638,2150,661],{"class":644},[638,2152,1967],{"class":1152},[638,2154,1023],{"class":644},[638,2156,839],{"class":1152},[638,2158,1023],{"class":644},[638,2160,876],{"class":1152},[638,2162,673],{"class":644},[638,2164,2165,2168,2170,2172,2174,2176,2178,2180],{"class":640,"line":939},[638,2166,2167],{"class":1162},"    node",[638,2169,661],{"class":644},[638,2171,1967],{"class":1152},[638,2173,1023],{"class":644},[638,2175,839],{"class":1152},[638,2177,1023],{"class":644},[638,2179,855],{"class":1152},[638,2181,673],{"class":644},[638,2183,2184,2187,2189,2192,2195,2198],{"class":640,"line":945},[638,2185,2186],{"class":1162},"    received_at",[638,2188,661],{"class":644},[638,2190,2191],{"class":644}," new",[638,2193,2194],{"class":1148}," Date",[638,2196,2197],{"class":1162},"()",[638,2199,673],{"class":644},[638,2201,2202],{"class":640,"line":969},[638,2203,2204],{"class":644},"  }\n",[638,2206,2207],{"class":640,"line":998},[638,2208,1001],{"class":644},[624,2210,2211,2212,2214,2215,2217],{},"This is where a company \"modifies the schema\" in practice: not by changing ",[635,2213,1099],{},", but by defining how ",[635,2216,974],{}," maps into internal analytics tables.",[1121,2219,2221,2222],{"id":2220},"version-breaking-changes-in-custom","Version breaking changes in ",[635,2223,974],{},[624,2225,2226,2227,2229,2230,2232],{},"When your product counters evolve, bump a numeric ",[635,2228,1739],{}," in ",[635,2231,974],{}," (no allowlist needed) and branch in the ingest mapper:",[628,2234,2236],{"className":1138,"code":2235,"language":1141,"meta":633,"style":633},"const version = (event.custom.schemaVersion as number | undefined) ?? 1\nif (version === 1) return mapV1(event)\nreturn mapV2(event)\n",[635,2237,2238,2279,2303],{"__ignoreMap":633},[638,2239,2240,2242,2245,2247,2250,2252,2254,2256,2259,2261,2264,2267,2270,2273,2276],{"class":640,"line":641},[638,2241,1675],{"class":654},[638,2243,2244],{"class":1152}," version ",[638,2246,1681],{"class":644},[638,2248,2249],{"class":1152}," (event",[638,2251,1023],{"class":644},[638,2253,974],{"class":1152},[638,2255,1023],{"class":644},[638,2257,2258],{"class":1152},"schemaVersion ",[638,2260,1771],{"class":1452},[638,2262,2263],{"class":753}," number",[638,2265,2266],{"class":644}," |",[638,2268,2269],{"class":753}," undefined",[638,2271,2272],{"class":1152},") ",[638,2274,2275],{"class":644},"??",[638,2277,2278],{"class":709}," 1\n",[638,2280,2281,2284,2287,2290,2292,2294,2297,2300],{"class":640,"line":648},[638,2282,2283],{"class":1452},"if",[638,2285,2286],{"class":1152}," (version ",[638,2288,2289],{"class":644},"===",[638,2291,2141],{"class":709},[638,2293,2272],{"class":1152},[638,2295,2296],{"class":1452},"return",[638,2298,2299],{"class":1148}," mapV1",[638,2301,2302],{"class":1152},"(event)\n",[638,2304,2305,2307,2310],{"class":640,"line":676},[638,2306,2296],{"class":1452},[638,2308,2309],{"class":1148}," mapV2",[638,2311,2302],{"class":1152},[624,2313,2314,2315,2318,2319,2321],{},"Commit an updated ",[635,2316,2317],{},"TELEMETRY.md"," whenever ",[635,2320,1118],{}," changes so disclosure stays aligned with releases.",[1121,2323,2325],{"id":2324},"multiple-tools-one-endpoint","Multiple tools, one endpoint",[624,2327,2328,2329,661],{},"If several CLIs POST to the same ingest URL, namespace custom keys or rely on ",[635,2330,2331],{},"tool.name",[628,2333,2335],{"className":1138,"code":2334,"language":1141,"meta":633,"style":633},"\u002F\u002F Option A — prefix keys per product line\ntelemetry.set({ acme_product: 'cli', deployCount: 3 })\n\n\u002F\u002F Option B — separate allowedCustomKeys per tool.name in parseIngestBody\nallowedCustomKeys: {\n  'acme-cli': ['deployCount', 'framework'],\n  'acme-action': ['jobDuration', 'ghaAction', 'ghaEvent'],\n}\n",[635,2336,2337,2342,2380,2384,2389,2398,2428,2466],{"__ignoreMap":633},[638,2338,2339],{"class":640,"line":641},[638,2340,2341],{"class":935},"\u002F\u002F Option A — prefix keys per product line\n",[638,2343,2344,2346,2348,2350,2352,2355,2358,2360,2362,2364,2366,2368,2371,2373,2376,2378],{"class":640,"line":648},[638,2345,124],{"class":1152},[638,2347,1023],{"class":644},[638,2349,1513],{"class":1148},[638,2351,1463],{"class":1152},[638,2353,2354],{"class":644},"{",[638,2356,2357],{"class":1162}," acme_product",[638,2359,661],{"class":644},[638,2361,1168],{"class":644},[638,2363,1322],{"class":667},[638,2365,1174],{"class":644},[638,2367,813],{"class":644},[638,2369,2370],{"class":1162}," deployCount",[638,2372,661],{"class":644},[638,2374,2375],{"class":709}," 3",[638,2377,1653],{"class":644},[638,2379,1438],{"class":1152},[638,2381,2382],{"class":640,"line":676},[638,2383,1670],{"emptyLinePlaceholder":1669},[638,2385,2386],{"class":640,"line":697},[638,2387,2388],{"class":935},"\u002F\u002F Option B — separate allowedCustomKeys per tool.name in parseIngestBody\n",[638,2390,2391,2394,2396],{"class":640,"line":715},[638,2392,2393],{"class":753},"allowedCustomKeys",[638,2395,661],{"class":644},[638,2397,846],{"class":644},[638,2399,2400,2402,2404,2406,2409,2411,2414,2416,2418,2420,2422,2424,2426],{"class":640,"line":736},[638,2401,1689],{"class":644},[638,2403,1171],{"class":667},[638,2405,1174],{"class":644},[638,2407,2408],{"class":1162},": [",[638,2410,1174],{"class":644},[638,2412,2413],{"class":667},"deployCount",[638,2415,1174],{"class":644},[638,2417,813],{"class":644},[638,2419,1168],{"class":644},[638,2421,1710],{"class":667},[638,2423,1174],{"class":644},[638,2425,1263],{"class":1162},[638,2427,673],{"class":644},[638,2429,2430,2432,2435,2437,2439,2441,2444,2446,2448,2450,2452,2454,2456,2458,2460,2462,2464],{"class":640,"line":783},[638,2431,1689],{"class":644},[638,2433,2434],{"class":667},"acme-action",[638,2436,1174],{"class":644},[638,2438,2408],{"class":1162},[638,2440,1174],{"class":644},[638,2442,2443],{"class":667},"jobDuration",[638,2445,1174],{"class":644},[638,2447,813],{"class":644},[638,2449,1168],{"class":644},[638,2451,1750],{"class":667},[638,2453,1174],{"class":644},[638,2455,813],{"class":644},[638,2457,1168],{"class":644},[638,2459,1759],{"class":667},[638,2461,1174],{"class":644},[638,2463,1263],{"class":1162},[638,2465,673],{"class":644},[638,2467,2468],{"class":640,"line":834},[638,2469,1001],{"class":644},[1121,2471,2473],{"id":2472},"what-v1-does-not-support","What v1 does not support",[1028,2475,2476,2489],{},[1031,2477,2478],{},[1034,2479,2480,2483,2486],{},[1037,2481,2482],{},"Need",[1037,2484,2485],{},"v1 answer",[1037,2487,2488],{},"Workaround",[1047,2490,2491,2510,2530,2547,2558],{},[1034,2492,2493,2499,2502],{},[1052,2494,2495,2496,1805],{},"New top-level field (",[635,2497,2498],{},"tenantId",[1052,2500,2501],{},"Not on the wire",[1052,2503,2504,2505,2507,2508],{},"Flat key in ",[635,2506,974],{}," + allowlist, or map server-side from ",[635,2509,950],{},[1034,2511,2512,2518,2521],{},[1052,2513,2514,2515,1805],{},"Nested objects (",[635,2516,2517],{},"custom.user.plan",[1052,2519,2520],{},"Flat records only",[1052,2522,2523,2524,2527,2528],{},"Flatten: ",[635,2525,2526],{},"userPlan: 'pro'"," with ",[635,2529,1080],{},[1034,2531,2532,2535,2538],{},[1052,2533,2534],{},"Free-form strings (paths, emails)",[1052,2536,2537],{},"Blocked by design",[1052,2539,2540,2541,2544,2545],{},"Flags record ",[635,2542,2543],{},"\"\u003Cset>\""," instead of the value; hash before ",[635,2546,1076],{},[1034,2548,2549,2552,2555],{},[1052,2550,2551],{},"Different schema per command",[1052,2553,2554],{},"One envelope per run",[1052,2556,2557],{},"Convention: only set relevant keys per command",[1034,2559,2560,2563,2566],{},[1052,2561,2562],{},"Transform before outbox",[1052,2564,2565],{},"No hook yet",[1052,2567,2568],{},"Map on the server (recommended) or see planned v2 below",[2570,2571,2572,2575,2576,2578,2579,1077,2581,2583],"tip",{},[1010,2573,2574],{},"Rule of thumb:"," if it is safe to print in ",[635,2577,2317],{}," and fits a closed set or a number, it belongs in ",[635,2580,1118],{},[635,2582,974],{},". Everything else stays server-side.",[1121,2585,2587],{"id":2586},"planned-v2-extensions","Planned v2 extensions",[624,2589,2590],{},"Not shipped yet. These are design targets for when the v1 extension zones are not enough:",[624,2592,2593,2599],{},[1010,2594,2595,2598],{},[635,2596,2597],{},"enrich"," hook."," Runs after sanitization, before the outbox append. Lets you inject computed fields without forking the package:",[628,2601,2603],{"className":1138,"code":2602,"language":1141,"meta":633,"style":633},"\u002F\u002F Planned API — not available in v1\ncreateTelemetry({\n  name: 'acme-cli',\n  version: '3.0.0',\n  collect: { fields: { product: ['cli', 'action'] } },\n  enrich(event) {\n    return {\n      ...event,\n      custom: {\n        ...event.custom,\n        schemaVersion: 2,\n      },\n    }\n  },\n})\n",[635,2604,2605,2610,2619,2633,2648,2690,2703,2710,2719,2728,2741,2752,2757,2762,2766],{"__ignoreMap":633},[638,2606,2607],{"class":640,"line":641},[638,2608,2609],{"class":935},"\u002F\u002F Planned API — not available in v1\n",[638,2611,2612,2615,2617],{"class":640,"line":648},[638,2613,2614],{"class":1148},"createTelemetry",[638,2616,1463],{"class":1152},[638,2618,645],{"class":644},[638,2620,2621,2623,2625,2627,2629,2631],{"class":640,"line":676},[638,2622,1163],{"class":1162},[638,2624,661],{"class":644},[638,2626,1168],{"class":644},[638,2628,1171],{"class":667},[638,2630,1174],{"class":644},[638,2632,673],{"class":644},[638,2634,2635,2637,2639,2641,2644,2646],{"class":640,"line":697},[638,2636,1181],{"class":1162},[638,2638,661],{"class":644},[638,2640,1168],{"class":644},[638,2642,2643],{"class":667},"3.0.0",[638,2645,1174],{"class":644},[638,2647,673],{"class":644},[638,2649,2650,2652,2654,2656,2659,2661,2663,2666,2668,2670,2672,2674,2676,2678,2680,2682,2684,2686,2688],{"class":640,"line":715},[638,2651,1213],{"class":1162},[638,2653,661],{"class":644},[638,2655,748],{"class":644},[638,2657,2658],{"class":1162}," fields",[638,2660,661],{"class":644},[638,2662,748],{"class":644},[638,2664,2665],{"class":1162}," product",[638,2667,661],{"class":644},[638,2669,1236],{"class":1152},[638,2671,1174],{"class":644},[638,2673,1322],{"class":667},[638,2675,1174],{"class":644},[638,2677,813],{"class":644},[638,2679,1168],{"class":644},[638,2681,1331],{"class":667},[638,2683,1174],{"class":644},[638,2685,1768],{"class":1152},[638,2687,1435],{"class":644},[638,2689,780],{"class":644},[638,2691,2692,2695,2697,2699,2701],{"class":640,"line":736},[638,2693,2694],{"class":1162},"  enrich",[638,2696,1463],{"class":644},[638,2698,655],{"class":1796},[638,2700,1805],{"class":644},[638,2702,846],{"class":644},[638,2704,2705,2708],{"class":640,"line":783},[638,2706,2707],{"class":1452},"    return",[638,2709,846],{"class":644},[638,2711,2712,2715,2717],{"class":640,"line":834},[638,2713,2714],{"class":644},"      ...",[638,2716,655],{"class":1152},[638,2718,673],{"class":644},[638,2720,2721,2724,2726],{"class":640,"line":849},[638,2722,2723],{"class":1162},"      custom",[638,2725,661],{"class":644},[638,2727,846],{"class":644},[638,2729,2730,2733,2735,2737,2739],{"class":640,"line":871},[638,2731,2732],{"class":644},"        ...",[638,2734,655],{"class":1152},[638,2736,1023],{"class":644},[638,2738,974],{"class":1152},[638,2740,673],{"class":644},[638,2742,2743,2746,2748,2750],{"class":640,"line":886},[638,2744,2745],{"class":1162},"        schemaVersion",[638,2747,661],{"class":644},[638,2749,1580],{"class":709},[638,2751,673],{"class":644},[638,2753,2754],{"class":640,"line":901},[638,2755,2756],{"class":644},"      },\n",[638,2758,2759],{"class":640,"line":916},[638,2760,2761],{"class":644},"    }\n",[638,2763,2764],{"class":640,"line":939},[638,2765,942],{"class":644},[638,2767,2768,2770],{"class":640,"line":945},[638,2769,1435],{"class":644},[638,2771,1438],{"class":1152},[624,2773,2774,2775,2777,2778,2780],{},"The hook cannot bypass sanitization rules, and strings still require ",[635,2776,1080],{},". Server-side ",[635,2779,2393],{}," stays the source of truth.",[624,2782,2783,2786,2787,2790,2791,1023],{},[1010,2784,2785],{},"Namespaced keys."," An optional ",[635,2788,2789],{},"acme.product"," convention for multi-tool endpoints without prefix collisions. Would be documented in disclosure as ",[635,2792,2793],{},"acme.product: cli | action",[624,2795,2796,2797,2799],{},"If you need one of these before v2 lands, open a discussion on the repo. The v1 path (",[635,2798,974],{}," + server mapping) covers most product analytics needs.",[619,2801,2803],{"id":2802},"privacy","Privacy",[624,2805,2806,2807,2810,2811,2814],{},"Raw ",[635,2808,2809],{},"argv"," is never read. Sanitization applies to ",[1010,2812,2813],{},"citty-parsed"," flags only:",[1088,2816,2817,2830,2844],{},[1091,2818,2819,2822,2823,2826,2827,1805],{},[1010,2820,2821],{},"Booleans \u002F numbers"," → value stored (",[635,2824,2825],{},"json: true",", ",[635,2828,2829],{},"limit: 50",[1091,2831,2832,2835,2836,1096,2838,2841,2842],{},[1010,2833,2834],{},"Strings"," → ",[635,2837,2543],{},[635,2839,2840],{},"output: \"\u003Cset>\"",") unless allowlisted in ",[635,2843,1061],{},[1091,2845,2846,2850,2851,2853],{},[1010,2847,2848],{},[635,2849,1076],{}," → numbers and booleans always; strings only via ",[635,2852,1080],{}," (undeclared values are dropped at runtime, never thrown)",[628,2855,2857],{"className":1138,"code":2856,"filename":1140,"language":1141,"meta":633,"style":633},"collect: {\n  flags: { format: ['json', 'csv'] },           \u002F\u002F --format json → \"json\"; --format yaml → \"\u003Cset>\"\n  fields: { framework: ['nuxt', 'next'] },      \u002F\u002F telemetry.set({ framework: 'nuxt' }) ok\n}\n",[635,2858,2859,2867,2906,2943],{"__ignoreMap":633},[638,2860,2861,2863,2865],{"class":640,"line":641},[638,2862,1118],{"class":753},[638,2864,661],{"class":644},[638,2866,846],{"class":644},[638,2868,2869,2872,2874,2876,2879,2881,2883,2885,2887,2889,2891,2893,2896,2898,2900,2903],{"class":640,"line":648},[638,2870,2871],{"class":753},"  flags",[638,2873,661],{"class":644},[638,2875,748],{"class":644},[638,2877,2878],{"class":753}," format",[638,2880,661],{"class":644},[638,2882,1236],{"class":1162},[638,2884,1174],{"class":644},[638,2886,1241],{"class":667},[638,2888,1174],{"class":644},[638,2890,813],{"class":644},[638,2892,1168],{"class":644},[638,2894,2895],{"class":667},"csv",[638,2897,1174],{"class":644},[638,2899,1768],{"class":1162},[638,2901,2902],{"class":644},"},",[638,2904,2905],{"class":935},"           \u002F\u002F --format json → \"json\"; --format yaml → \"\u003Cset>\"\n",[638,2907,2908,2911,2913,2915,2918,2920,2922,2924,2926,2928,2930,2932,2934,2936,2938,2940],{"class":640,"line":676},[638,2909,2910],{"class":753},"  fields",[638,2912,661],{"class":644},[638,2914,748],{"class":644},[638,2916,2917],{"class":753}," framework",[638,2919,661],{"class":644},[638,2921,1236],{"class":1162},[638,2923,1174],{"class":644},[638,2925,1398],{"class":667},[638,2927,1174],{"class":644},[638,2929,813],{"class":644},[638,2931,1168],{"class":644},[638,2933,1407],{"class":667},[638,2935,1174],{"class":644},[638,2937,1768],{"class":1162},[638,2939,2902],{"class":644},[638,2941,2942],{"class":935},"      \u002F\u002F telemetry.set({ framework: 'nuxt' }) ok\n",[638,2944,2945],{"class":640,"line":697},[638,2946,1001],{"class":644},[624,2948,2949,2950,2952],{},"Three kinds of parser noise are dropped before the event is built, so ",[635,2951,741],{}," reads\nas what the user asked for rather than what the parser filled in:",[1088,2954,2955,2965,2975],{},[1091,2956,2957,2960,2961,2964],{},[1010,2958,2959],{},"Positionals",": citty's ",[635,2962,2963],{},"_"," bucket holds argument values, not flag names",[1091,2966,2967,2970,2971,2974],{},[1010,2968,2969],{},"Defaults",": a flag still sitting at its declared ",[635,2972,2973],{},"default"," is not a choice anyone made",[1091,2976,2977,2980,2981,2984,2985,2988,2989,2992,2993,2995],{},[1010,2978,2979],{},"Kebab-case duplicates",": ",[635,2982,2983],{},"--min-score"," arrives as both ",[635,2986,2987],{},"minScore"," and ",[635,2990,2991],{},"min-score","; only the camelCase name is kept, and that is the name ",[635,2994,1061],{}," allowlists",[624,2997,2998,2999,3002,3003,3006,3007,1023],{},"Negation still reports: ",[635,3000,3001],{},"--no-write"," against ",[635,3004,3005],{},"write: { default: true }"," records ",[635,3008,3009],{},"write: false",[624,3011,3012,3013,1131,3015,3017,3018,3020],{},"Declare allowlists in the same ",[635,3014,1130],{},[635,3016,1134],{}," call as ",[635,3019,1118],{},", with no separate config file.",[619,3022,3024],{"id":3023},"disclosure","Disclosure",[624,3026,3027,3030,3031,3033,3034,3036],{},[635,3028,3029],{},"generateDisclosure()"," produces markdown + JSON from the standard envelope plus your ",[635,3032,1118],{}," extensions. Commit the output (e.g. ",[635,3035,2317],{},") so it stays in sync with releases:",[628,3038,3041],{"className":1138,"code":3039,"filename":3040,"language":1141,"meta":633,"style":633},"import { writeFile } from 'node:fs\u002Fpromises'\nimport { generateDisclosure } from '@evlog\u002Ftelemetry'\n\nconst { markdown } = generateDisclosure('my-tool', {\n  flags: { format: ['json', 'csv'] },\n})\n\nawait writeFile('TELEMETRY.md', markdown)\n","scripts\u002Fgenerate-disclosure.ts",[635,3042,3043,3063,3082,3086,3113,3146,3152,3156],{"__ignoreMap":633},[638,3044,3045,3047,3049,3052,3054,3056,3058,3061],{"class":640,"line":641},[638,3046,1645],{"class":1452},[638,3048,748],{"class":644},[638,3050,3051],{"class":1152}," writeFile",[638,3053,1653],{"class":644},[638,3055,1656],{"class":1452},[638,3057,1168],{"class":644},[638,3059,3060],{"class":667},"node:fs\u002Fpromises",[638,3062,1664],{"class":644},[638,3064,3065,3067,3069,3072,3074,3076,3078,3080],{"class":640,"line":648},[638,3066,1645],{"class":1452},[638,3068,748],{"class":644},[638,3070,3071],{"class":1152}," generateDisclosure",[638,3073,1653],{"class":644},[638,3075,1656],{"class":1452},[638,3077,1168],{"class":644},[638,3079,1103],{"class":667},[638,3081,1664],{"class":644},[638,3083,3084],{"class":640,"line":676},[638,3085,1670],{"emptyLinePlaceholder":1669},[638,3087,3088,3090,3092,3095,3097,3099,3101,3103,3105,3107,3109,3111],{"class":640,"line":697},[638,3089,1675],{"class":654},[638,3091,748],{"class":644},[638,3093,3094],{"class":1152}," markdown ",[638,3096,1435],{"class":644},[638,3098,1494],{"class":644},[638,3100,3071],{"class":1148},[638,3102,1463],{"class":1152},[638,3104,1174],{"class":644},[638,3106,808],{"class":667},[638,3108,1174],{"class":644},[638,3110,813],{"class":644},[638,3112,846],{"class":644},[638,3114,3115,3117,3119,3121,3123,3125,3127,3129,3131,3133,3135,3137,3139,3141,3143],{"class":640,"line":715},[638,3116,2871],{"class":1162},[638,3118,661],{"class":644},[638,3120,748],{"class":644},[638,3122,2878],{"class":1162},[638,3124,661],{"class":644},[638,3126,1236],{"class":1152},[638,3128,1174],{"class":644},[638,3130,1241],{"class":667},[638,3132,1174],{"class":644},[638,3134,813],{"class":644},[638,3136,1168],{"class":644},[638,3138,2895],{"class":667},[638,3140,1174],{"class":644},[638,3142,1768],{"class":1152},[638,3144,3145],{"class":644},"},\n",[638,3147,3148,3150],{"class":640,"line":736},[638,3149,1435],{"class":644},[638,3151,1438],{"class":1152},[638,3153,3154],{"class":640,"line":783},[638,3155,1670],{"emptyLinePlaceholder":1669},[638,3157,3158,3160,3162,3164,3166,3168,3170,3172],{"class":640,"line":834},[638,3159,1453],{"class":1452},[638,3161,3051],{"class":1148},[638,3163,1463],{"class":1152},[638,3165,1174],{"class":644},[638,3167,2317],{"class":667},[638,3169,1174],{"class":644},[638,3171,813],{"class":644},[638,3173,3174],{"class":1152}," markdown)\n",[624,3176,3177,3178,3181,3182,1023],{},"Users can also read it at runtime via ",[635,3179,3180],{},"my-tool telemetry status"," when you wire ",[635,3183,3184],{},"defineTelemetryCommands()",[619,3186,3188],{"id":3187},"consent-and-reliability","Consent and reliability",[624,3190,3191,1614,3194,2835,3197,3200,3201,1131,3204,3207],{},[1010,3192,3193],{},"Opt-out priority:",[635,3195,3196],{},"DO_NOT_TRACK=1",[635,3198,3199],{},"EVLOG_TELEMETRY=0"," → persisted preference (",[635,3202,3203],{},"disableTelemetry()",[635,3205,3206],{},"telemetry disable","). Opt-out purges the undelivered outbox.",[624,3209,3210,3213,3214,3217],{},[1010,3211,3212],{},"Never harms the host:"," telemetry never throws, never blocks exit; ",[635,3215,3216],{},"flush()"," has a 500ms hard cap.",[624,3219,3220,3223,3224,1023],{},[1010,3221,3222],{},"Outbox:"," events append locally before any network attempt. Offline machines and CI matrix jobs drain the backlog on the next invocation once your ingestion endpoint returns ",[635,3225,3226],{},"2xx",[624,3228,3229,1614,3232,3235,3236,3239],{},[1010,3230,3231],{},"Endpoint:",[635,3233,3234],{},"EVLOG_TELEMETRY_ENDPOINT"," env → ",[635,3237,3238],{},"endpoint"," option baked into the CLI. Omit both during local development; ship the URL when your ingest handler is live.",[3241,3242,3243],"style",{},"html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}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 .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 .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}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}html pre.shiki code .sfNiH, html code.shiki .sfNiH{--shiki-light:#FF5370;--shiki-default:#FF9CAC;--shiki-dark:#FF9CAC}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}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}",{"title":633,"searchDepth":648,"depth":648,"links":3245},[3246,3247,3257,3258,3259],{"id":621,"depth":648,"text":622},{"id":1004,"depth":648,"text":1005,"children":3248},[3249,3250,3251,3252,3254,3255,3256],{"id":1123,"depth":676,"text":1124},{"id":1630,"depth":676,"text":1631},{"id":1915,"depth":676,"text":1916},{"id":2220,"depth":676,"text":3253},"Version breaking changes in custom",{"id":2324,"depth":676,"text":2325},{"id":2472,"depth":676,"text":2473},{"id":2586,"depth":676,"text":2587},{"id":2802,"depth":648,"text":2803},{"id":3023,"depth":648,"text":3024},{"id":3187,"depth":648,"text":3188},"RunEvent envelope, extending the schema with collect and custom fields, privacy rules, TELEMETRY.md disclosure, and consent \u002F outbox reliability.","md",[3263,3266,3267],{"label":41,"icon":44,"to":423,"color":3264,"variant":3265},"neutral","subtle",{"label":426,"icon":429,"to":427,"color":3264,"variant":3265},{"label":431,"icon":434,"to":432,"color":3264,"variant":3265},{},{"title":436,"icon":84},{"title":614,"description":3260},"9QIMa3arrtXM1ogwvMDBj2bkaTzJC1sft1nHE9vGiwU",[3273,3275],{"title":431,"path":432,"stem":433,"description":3274,"icon":434,"children":-1},"Build the ingestion endpoint for @evlog\u002Ftelemetry: the threat model, parseIngestBody validation, framework routes, storage, and rate limiting.",{"title":440,"path":441,"stem":442,"description":3276,"icon":443,"children":-1},"Add derived context to every wide event, from user agent and geo to your own computed fields.",1789294028393]