[{"data":1,"prerenderedAt":2642},["ShallowReactive",2],{"navigation_docs":3,"-use-cases-telemetry-setup":525,"-use-cases-telemetry-setup-surround":2637},[4,30,80,128,308,440,495],{"title":5,"path":6,"stem":7,"children":8,"page":29},"Start","\u002Fstart","1.start",[9,14,19,24],{"title":10,"path":11,"stem":12,"icon":13},"Introduction","\u002Fstart\u002Fintroduction","1.start\u002F1.introduction","i-lucide-info",{"title":15,"path":16,"stem":17,"icon":18},"Why start with evlog","\u002Fstart\u002Fwhy-evlog","1.start\u002F2.why-evlog","i-lucide-rocket",{"title":20,"path":21,"stem":22,"icon":23},"Installation","\u002Fstart\u002Finstallation","1.start\u002F3.installation","i-lucide-download",{"title":25,"path":26,"stem":27,"icon":28},"Quick Start","\u002Fstart\u002Fquick-start","1.start\u002F4.quick-start","i-lucide-zap",false,{"title":31,"path":32,"stem":33,"children":34,"page":29},"Learn","\u002Flearn","2.learn",[35,40,45,50,55,60,65,70,75],{"title":36,"path":37,"stem":38,"icon":39},"Overview","\u002Flearn\u002Foverview","2.learn\u002F0.overview","i-lucide-list",{"title":41,"path":42,"stem":43,"icon":44},"Simple Logging","\u002Flearn\u002Fsimple-logging","2.learn\u002F1.simple-logging","i-lucide-terminal",{"title":46,"path":47,"stem":48,"icon":49},"Wide Events","\u002Flearn\u002Fwide-events","2.learn\u002F2.wide-events","i-lucide-layers",{"title":51,"path":52,"stem":53,"icon":54},"Structured Errors","\u002Flearn\u002Fstructured-errors","2.learn\u002F3.structured-errors","i-lucide-shield-alert",{"title":56,"path":57,"stem":58,"icon":59},"Lifecycle","\u002Flearn\u002Flifecycle","2.learn\u002F4.lifecycle","i-lucide-arrow-right-left",{"title":61,"path":62,"stem":63,"icon":64},"Sampling","\u002Flearn\u002Fsampling","2.learn\u002F5.sampling","i-lucide-filter",{"title":66,"path":67,"stem":68,"icon":69},"Auto-Redaction","\u002Flearn\u002Fredaction","2.learn\u002F6.redaction","i-lucide-eye-off",{"title":71,"path":72,"stem":73,"icon":74},"Typed Fields","\u002Flearn\u002Ftyped-fields","2.learn\u002F7.typed-fields","i-simple-icons-typescript",{"title":76,"path":77,"stem":78,"icon":79},"Catalogs","\u002Flearn\u002Fcatalogs","2.learn\u002F8.catalogs","i-lucide-book-open",{"title":81,"path":82,"stem":83,"children":84,"page":29},"CLI","\u002Fcli","3.cli",[85,88,93,98,103,108,113,118,123],{"title":36,"path":86,"stem":87,"icon":44},"\u002Fcli\u002Foverview","3.cli\u002F0.overview",{"title":89,"path":90,"stem":91,"icon":92},"init","\u002Fcli\u002Finit","3.cli\u002F1.init","i-lucide-wand-sparkles",{"title":94,"path":95,"stem":96,"icon":97},"map","\u002Fcli\u002Fmap","3.cli\u002F2.map","i-lucide-radar",{"title":99,"path":100,"stem":101,"icon":102},"Rules","\u002Fcli\u002Frules","3.cli\u002F3.rules","i-lucide-list-checks",{"title":104,"path":105,"stem":106,"icon":107},"Scoring","\u002Fcli\u002Fscoring","3.cli\u002F4.scoring","i-lucide-gauge",{"title":109,"path":110,"stem":111,"icon":112},"CI","\u002Fcli\u002Fci","3.cli\u002F5.ci","i-lucide-git-pull-request",{"title":114,"path":115,"stem":116,"icon":117},"doctor","\u002Fcli\u002Fdoctor","3.cli\u002F6.doctor","i-lucide-stethoscope",{"title":119,"path":120,"stem":121,"icon":122},"telemetry","\u002Fcli\u002Ftelemetry","3.cli\u002F7.telemetry","i-lucide-bar-chart-3",{"title":124,"path":125,"stem":126,"icon":127},"agents","\u002Fcli\u002Fagents","3.cli\u002F8.agents","i-lucide-bot",{"title":129,"path":130,"stem":131,"children":132,"page":29},"Integrate","\u002Fintegrate","4.integrate",[133,137,220],{"title":36,"path":134,"stem":135,"icon":136},"\u002Fintegrate\u002Foverview","4.integrate\u002F0.overview","i-lucide-plug",{"title":138,"path":139,"stem":140,"children":141,"page":29},"Adapters","\u002Fintegrate\u002Fadapters","4.integrate\u002Fadapters",[142,145,175,200],{"title":36,"path":143,"stem":144,"icon":39},"\u002Fintegrate\u002Fadapters\u002Foverview","4.integrate\u002Fadapters\u002F01.overview",{"title":146,"path":147,"stem":148,"children":149,"page":29},"Cloud","\u002Fintegrate\u002Fadapters\u002Fcloud","4.integrate\u002Fadapters\u002Fcloud",[150,155,160,165,170],{"title":151,"path":152,"stem":153,"icon":154},"Axiom","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Faxiom","4.integrate\u002Fadapters\u002Fcloud\u002F01.axiom","i-custom-axiom",{"title":156,"path":157,"stem":158,"icon":159},"PostHog","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fposthog","4.integrate\u002Fadapters\u002Fcloud\u002F02.posthog","i-simple-icons-posthog",{"title":161,"path":162,"stem":163,"icon":164},"Sentry","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fsentry","4.integrate\u002Fadapters\u002Fcloud\u002F03.sentry","i-simple-icons-sentry",{"title":166,"path":167,"stem":168,"icon":169},"Better Stack","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fbetter-stack","4.integrate\u002Fadapters\u002Fcloud\u002F04.better-stack","i-simple-icons-betterstack",{"title":171,"path":172,"stem":173,"icon":174},"Datadog","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fdatadog","4.integrate\u002Fadapters\u002Fcloud\u002F05.datadog","i-simple-icons-datadog",{"title":176,"path":177,"stem":178,"children":179,"page":29},"Cloud or Self-Hosted","\u002Fintegrate\u002Fadapters\u002Fhybrid","4.integrate\u002Fadapters\u002Fhybrid",[180,185,190,195],{"title":181,"path":182,"stem":183,"icon":184},"Grafana Loki","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Floki","4.integrate\u002Fadapters\u002Fhybrid\u002F01.loki","i-simple-icons-grafana",{"title":186,"path":187,"stem":188,"icon":189},"ClickHouse","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Fclickhouse","4.integrate\u002Fadapters\u002Fhybrid\u002F02.clickhouse","i-simple-icons-clickhouse",{"title":191,"path":192,"stem":193,"icon":194},"OTLP","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Fotlp","4.integrate\u002Fadapters\u002Fhybrid\u002F03.otlp","i-simple-icons-opentelemetry",{"title":196,"path":197,"stem":198,"icon":199},"HyperDX","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Fhyperdx","4.integrate\u002Fadapters\u002Fhybrid\u002F04.hyperdx","i-custom-hyperdx",{"title":201,"path":202,"stem":203,"children":204,"page":29},"Self-Hosted","\u002Fintegrate\u002Fadapters\u002Fself-hosted","4.integrate\u002Fadapters\u002Fself-hosted",[205,210,215],{"title":206,"path":207,"stem":208,"icon":209},"File System","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Ffs","4.integrate\u002Fadapters\u002Fself-hosted\u002F01.fs","i-lucide-hard-drive",{"title":211,"path":212,"stem":213,"icon":214},"NuxtHub","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Fnuxthub","4.integrate\u002Fadapters\u002Fself-hosted\u002F02.nuxthub","i-simple-icons-nuxt",{"title":216,"path":217,"stem":218,"icon":219},"Memory","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Fmemory","4.integrate\u002Fadapters\u002Fself-hosted\u002F03.memory","i-lucide-cpu",{"title":221,"path":222,"stem":223,"children":224,"page":29},"Frameworks","\u002Fintegrate\u002Fframeworks","4.integrate\u002Fframeworks",[225,229,234,239,244,249,254,259,264,269,274,279,284,289,293,298,303],{"title":36,"path":226,"stem":227,"icon":228},"\u002Fintegrate\u002Fframeworks\u002Foverview","4.integrate\u002Fframeworks\u002F00.overview","i-lucide-layout-grid",{"title":230,"path":231,"stem":232,"icon":233},"Nuxt","\u002Fintegrate\u002Fframeworks\u002Fnuxt","4.integrate\u002Fframeworks\u002F01.nuxt","i-simple-icons-nuxtdotjs",{"title":235,"path":236,"stem":237,"icon":238},"Next.js","\u002Fintegrate\u002Fframeworks\u002Fnextjs","4.integrate\u002Fframeworks\u002F02.nextjs","i-simple-icons-nextdotjs",{"title":240,"path":241,"stem":242,"icon":243},"SvelteKit","\u002Fintegrate\u002Fframeworks\u002Fsveltekit","4.integrate\u002Fframeworks\u002F03.sveltekit","i-simple-icons-svelte",{"title":245,"path":246,"stem":247,"icon":248},"Nitro","\u002Fintegrate\u002Fframeworks\u002Fnitro","4.integrate\u002Fframeworks\u002F04.nitro","i-custom-nitro",{"title":250,"path":251,"stem":252,"icon":253},"TanStack Start","\u002Fintegrate\u002Fframeworks\u002Ftanstack-start","4.integrate\u002Fframeworks\u002F05.tanstack-start","i-custom-tanstack",{"title":255,"path":256,"stem":257,"icon":258},"NestJS","\u002Fintegrate\u002Fframeworks\u002Fnestjs","4.integrate\u002Fframeworks\u002F06.nestjs","i-simple-icons-nestjs",{"title":260,"path":261,"stem":262,"icon":263},"Express","\u002Fintegrate\u002Fframeworks\u002Fexpress","4.integrate\u002Fframeworks\u002F07.express","i-simple-icons-express",{"title":265,"path":266,"stem":267,"icon":268},"Hono","\u002Fintegrate\u002Fframeworks\u002Fhono","4.integrate\u002Fframeworks\u002F08.hono","i-simple-icons-hono",{"title":270,"path":271,"stem":272,"icon":273},"Fastify","\u002Fintegrate\u002Fframeworks\u002Ffastify","4.integrate\u002Fframeworks\u002F09.fastify","i-simple-icons-fastify",{"title":275,"path":276,"stem":277,"icon":278},"Elysia","\u002Fintegrate\u002Fframeworks\u002Felysia","4.integrate\u002Fframeworks\u002F10.elysia","i-custom-elysia",{"title":280,"path":281,"stem":282,"icon":283},"React Router","\u002Fintegrate\u002Fframeworks\u002Freact-router","4.integrate\u002Fframeworks\u002F11.react-router","i-custom-reactrouter",{"title":285,"path":286,"stem":287,"icon":288},"Cloudflare Workers","\u002Fintegrate\u002Fframeworks\u002Fcloudflare-workers","4.integrate\u002Fframeworks\u002F12.cloudflare-workers","i-simple-icons-cloudflare",{"title":290,"path":291,"stem":292,"icon":74},"Standalone","\u002Fintegrate\u002Fframeworks\u002Fstandalone","4.integrate\u002Fframeworks\u002F13.standalone",{"title":294,"path":295,"stem":296,"icon":297},"Astro","\u002Fintegrate\u002Fframeworks\u002Fastro","4.integrate\u002Fframeworks\u002F14.astro","i-simple-icons-astro",{"title":299,"path":300,"stem":301,"icon":302},"oRPC","\u002Fintegrate\u002Fframeworks\u002Forpc","4.integrate\u002Fframeworks\u002F15.orpc","i-lucide-network",{"title":304,"path":305,"stem":306,"icon":307},"AWS Lambda","\u002Fintegrate\u002Fframeworks\u002Faws-lambda","4.integrate\u002Fframeworks\u002F16.aws-lambda","i-custom-lambda",{"title":309,"path":310,"stem":311,"children":312,"page":29},"Use Cases","\u002Fuse-cases","5.use-cases",[313,316,321,350,377,409,430,435],{"title":36,"path":314,"stem":315,"icon":102},"\u002Fuse-cases\u002Foverview","5.use-cases\u002F0.overview",{"title":317,"path":318,"stem":319,"icon":320},"Client Logging","\u002Fuse-cases\u002Fclient-logging","5.use-cases\u002F1.client-logging","i-lucide-monitor",{"title":322,"icon":323,"path":324,"stem":325,"children":326,"page":29},"AI SDK","i-simple-icons-vercel","\u002Fuse-cases\u002Fai-sdk","5.use-cases\u002F2.ai-sdk",[327,330,335,340,345],{"title":36,"path":328,"stem":329,"icon":39},"\u002Fuse-cases\u002Fai-sdk\u002Foverview","5.use-cases\u002F2.ai-sdk\u002F01.overview",{"title":331,"path":332,"stem":333,"icon":334},"Usage","\u002Fuse-cases\u002Fai-sdk\u002Fusage","5.use-cases\u002F2.ai-sdk\u002F02.usage","i-lucide-code",{"title":336,"path":337,"stem":338,"icon":339},"Options","\u002Fuse-cases\u002Fai-sdk\u002Foptions","5.use-cases\u002F2.ai-sdk\u002F03.options","i-lucide-sliders",{"title":341,"path":342,"stem":343,"icon":344},"Metadata","\u002Fuse-cases\u002Fai-sdk\u002Fmetadata","5.use-cases\u002F2.ai-sdk\u002F04.metadata","i-lucide-database",{"title":346,"path":347,"stem":348,"icon":349},"Telemetry","\u002Fuse-cases\u002Fai-sdk\u002Ftelemetry","5.use-cases\u002F2.ai-sdk\u002F05.telemetry","i-lucide-activity",{"title":351,"icon":352,"path":353,"stem":354,"children":355,"page":29},"Better Auth","i-simple-icons-betterauth","\u002Fuse-cases\u002Fbetter-auth","5.use-cases\u002F3.better-auth",[356,359,364,369,373],{"title":36,"path":357,"stem":358,"icon":39},"\u002Fuse-cases\u002Fbetter-auth\u002Foverview","5.use-cases\u002F3.better-auth\u002F01.overview",{"title":360,"path":361,"stem":362,"icon":363},"Identify User","\u002Fuse-cases\u002Fbetter-auth\u002Fidentify-user","5.use-cases\u002F3.better-auth\u002F02.identify-user","i-lucide-user-check",{"title":365,"path":366,"stem":367,"icon":368},"Middleware","\u002Fuse-cases\u002Fbetter-auth\u002Fmiddleware","5.use-cases\u002F3.better-auth\u002F03.middleware","i-lucide-shield",{"title":370,"path":371,"stem":372,"icon":320},"Client Sync","\u002Fuse-cases\u002Fbetter-auth\u002Fclient-sync","5.use-cases\u002F3.better-auth\u002F04.client-sync",{"title":374,"path":375,"stem":376,"icon":107},"Performance","\u002Fuse-cases\u002Fbetter-auth\u002Fperformance","5.use-cases\u002F3.better-auth\u002F05.performance",{"title":378,"icon":379,"path":380,"stem":381,"children":382,"page":29},"Audit Logs","i-lucide-shield-check","\u002Fuse-cases\u002Faudit","5.use-cases\u002F4.audit",[383,386,391,396,401,405],{"title":36,"path":384,"stem":385,"icon":39},"\u002Fuse-cases\u002Faudit\u002Foverview","5.use-cases\u002F4.audit\u002F01.overview",{"title":387,"path":388,"stem":389,"icon":390},"Schema","\u002Fuse-cases\u002Faudit\u002Fschema","5.use-cases\u002F4.audit\u002F02.schema","i-lucide-file-text",{"title":392,"path":393,"stem":394,"icon":395},"Recording","\u002Fuse-cases\u002Faudit\u002Frecording","5.use-cases\u002F4.audit\u002F03.recording","i-lucide-pen-line",{"title":397,"path":398,"stem":399,"icon":400},"Drains","\u002Fuse-cases\u002Faudit\u002Fpipeline","5.use-cases\u002F4.audit\u002F04.pipeline","i-lucide-link",{"title":402,"path":403,"stem":404,"icon":379},"Compliance","\u002Fuse-cases\u002Faudit\u002Fcompliance","5.use-cases\u002F4.audit\u002F05.compliance",{"title":406,"path":407,"stem":408,"icon":79},"Recipes","\u002Fuse-cases\u002Faudit\u002Frecipes","5.use-cases\u002F4.audit\u002F06.recipes",{"title":346,"icon":107,"path":410,"stem":411,"children":412,"page":29},"\u002Fuse-cases\u002Ftelemetry","5.use-cases\u002F4.telemetry",[413,416,421,426],{"title":36,"path":414,"stem":415,"icon":39},"\u002Fuse-cases\u002Ftelemetry\u002Foverview","5.use-cases\u002F4.telemetry\u002F01.overview",{"title":417,"path":418,"stem":419,"icon":420},"Setup","\u002Fuse-cases\u002Ftelemetry\u002Fsetup","5.use-cases\u002F4.telemetry\u002F02.setup","i-lucide-wrench",{"title":422,"path":423,"stem":424,"icon":425},"Ingest","\u002Fuse-cases\u002Ftelemetry\u002Fingest","5.use-cases\u002F4.telemetry\u002F03.ingest","i-lucide-server",{"title":427,"path":428,"stem":429,"icon":79},"Reference","\u002Fuse-cases\u002Ftelemetry\u002Freference","5.use-cases\u002F4.telemetry\u002F04.reference",{"title":431,"path":432,"stem":433,"icon":434},"Enrichers","\u002Fuse-cases\u002Fenrichers","5.use-cases\u002F5.enrichers","i-lucide-sparkles",{"title":436,"path":437,"stem":438,"icon":439},"eve","\u002Fuse-cases\u002Feve","5.use-cases\u002F5.eve","i-custom-eve",{"title":441,"path":442,"stem":443,"children":444,"page":29},"Extend","\u002Fextend","6.extend",[445,449,454,459,464,468,472,476,480,485,490],{"title":36,"path":446,"stem":447,"icon":448},"\u002Fextend\u002Foverview","6.extend\u002F0.overview","i-lucide-blocks",{"title":450,"path":451,"stem":452,"icon":453},"Stream","\u002Fextend\u002Fstream","6.extend\u002F1.stream","i-lucide-radio-tower",{"title":455,"path":456,"stem":457,"icon":458},"Custom framework","\u002Fextend\u002Fcustom-framework","6.extend\u002F10.custom-framework","i-lucide-puzzle",{"title":460,"path":461,"stem":462,"icon":463},"FS reader","\u002Fextend\u002Ffs-reader","6.extend\u002F2.fs-reader","i-lucide-folder-search",{"title":406,"path":465,"stem":466,"icon":467},"\u002Fextend\u002Fconsumer-recipes","6.extend\u002F3.consumer-recipes","i-lucide-chef-hat",{"title":469,"path":470,"stem":471,"icon":448},"Plugins","\u002Fextend\u002Fplugins","6.extend\u002F4.plugins",{"title":473,"path":474,"stem":475,"icon":434},"Custom enrichers","\u002Fextend\u002Fcustom-enrichers","6.extend\u002F5.custom-enrichers",{"title":477,"path":478,"stem":479,"icon":64},"Tail sampling","\u002Fextend\u002Ftail-sampling","6.extend\u002F6.tail-sampling",{"title":481,"path":482,"stem":483,"icon":484},"Identity headers","\u002Fextend\u002Fidentity-headers","6.extend\u002F7.identity-headers","i-lucide-fingerprint",{"title":486,"path":487,"stem":488,"icon":489},"Custom drains","\u002Fextend\u002Fcustom-drains","6.extend\u002F8.custom-drains","i-lucide-share-2",{"title":491,"path":492,"stem":493,"icon":494},"Drain pipeline","\u002Fextend\u002Fdrain-pipeline","6.extend\u002F9.drain-pipeline","i-lucide-workflow",{"title":427,"path":496,"stem":497,"children":498,"page":29},"\u002Freference","7.reference",[499,504,507,512,516,521],{"title":500,"path":501,"stem":502,"icon":503},"Configuration","\u002Freference\u002Fconfiguration","7.reference\u002F1.configuration","i-lucide-settings",{"title":374,"path":505,"stem":506,"icon":107},"\u002Freference\u002Fperformance","7.reference\u002F2.performance",{"title":508,"path":509,"stem":510,"icon":511},"Vite Plugin","\u002Freference\u002Fvite-plugin","7.reference\u002F3.vite-plugin","i-custom-vite",{"title":513,"path":514,"stem":515,"icon":379},"Best Practices","\u002Freference\u002Fbest-practices","7.reference\u002F4.best-practices",{"title":517,"path":518,"stem":519,"icon":520},"vs Other Loggers","\u002Freference\u002Fvs-other-loggers","7.reference\u002F5.vs-other-loggers","i-lucide-scale",{"title":522,"path":523,"stem":524,"icon":434},"Agent Skills","\u002Freference\u002Fagent-skills","7.reference\u002F6.agent-skills",{"id":526,"title":527,"body":528,"description":2625,"extension":2626,"links":2627,"meta":2633,"navigation":2634,"path":418,"seo":2635,"stem":419,"__hash__":2636},"docs\u002F5.use-cases\u002F4.telemetry\u002F02.setup.md","Telemetry Setup",{"type":529,"value":530,"toc":2616},"minimark",[531,536,540,629,683,702,706,724,1191,1196,1205,1316,1327,1331,1338,1904,1918,1970,1977,2172,2176,2186,2381,2411,2567,2571,2609,2612],[532,533,535],"h2",{"id":534},"configure-delivery","Configure delivery",[537,538,539],"p",{},"Point the CLI at your ingestion URL when you ship it — baked into the binary, overridable per environment:",[541,542,548],"pre",{"className":543,"code":544,"filename":545,"language":546,"meta":547,"style":547},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","withTelemetry(command, {\n  name: TOOL,\n  version: VERSION,\n  endpoint: 'https:\u002F\u002Ftelemetry.my-tool.dev\u002Fapi\u002Ftelemetry\u002Fingest',\n})\n","src\u002Findex.ts","ts","",[549,550,551,571,587,600,620],"code",{"__ignoreMap":547},[552,553,556,560,564,568],"span",{"class":554,"line":555},"line",1,[552,557,559],{"class":558},"s2Zo4","withTelemetry",[552,561,563],{"class":562},"sTEyZ","(command",[552,565,567],{"class":566},"sMK4o",",",[552,569,570],{"class":566}," {\n",[552,572,574,578,581,584],{"class":554,"line":573},2,[552,575,577],{"class":576},"swJcz","  name",[552,579,580],{"class":566},":",[552,582,583],{"class":562}," TOOL",[552,585,586],{"class":566},",\n",[552,588,590,593,595,598],{"class":554,"line":589},3,[552,591,592],{"class":576},"  version",[552,594,580],{"class":566},[552,596,597],{"class":562}," VERSION",[552,599,586],{"class":566},[552,601,603,606,608,611,615,618],{"class":554,"line":602},4,[552,604,605],{"class":576},"  endpoint",[552,607,580],{"class":566},[552,609,610],{"class":566}," '",[552,612,614],{"class":613},"sfazB","https:\u002F\u002Ftelemetry.my-tool.dev\u002Fapi\u002Ftelemetry\u002Fingest",[552,616,617],{"class":566},"'",[552,619,586],{"class":566},[552,621,623,626],{"class":554,"line":622},5,[552,624,625],{"class":566},"}",[552,627,628],{"class":562},")\n",[630,631,632,645],"table",{},[633,634,635],"thead",{},[636,637,638,642],"tr",{},[639,640,641],"th",{},"Override",[639,643,644],{},"Effect",[646,647,648,659,673],"tbody",{},[636,649,650,656],{},[651,652,653],"td",{},[549,654,655],{},"EVLOG_TELEMETRY_ENDPOINT",[651,657,658],{},"Replaces the baked-in URL (staging, self-hosted)",[636,660,661,670],{},[651,662,663,666,667],{},[549,664,665],{},"EVLOG_TELEMETRY=0"," \u002F ",[549,668,669],{},"DO_NOT_TRACK=1",[651,671,672],{},"No recording, no send",[636,674,675,680],{},[651,676,677],{},[549,678,679],{},"EVLOG_TELEMETRY_DEBUG=1",[651,681,682],{},"Print payloads to stderr without sending",[537,684,685,686,689,690,693,694,697,698,701],{},"The built-in HTTP drain POSTs ",[549,687,688],{},"Content-Type: application\u002Fjson"," with body ",[549,691,692],{},"{ events: RunEvent[] }"," and a 400ms timeout. On success (",[549,695,696],{},"res.ok","), delivered keys are removed from the outbox. ",[549,699,700],{},"flush()"," is capped at 500ms and never throws.",[532,703,705],{"id":704},"setup-with-citty","Setup with citty",[537,707,708,709,712,713,715,716,719,720,723],{},"Wrap your root command in ",[549,710,711],{},"withTelemetry()"," — typically in ",[549,714,545],{},", the file that calls ",[549,717,718],{},"runMain()",". Subcommands can live in the same file or in ",[549,721,722],{},"src\u002Fcommands\u002F*.ts","; only the entrypoint needs the wrapper.",[541,725,727],{"className":543,"code":726,"filename":545,"language":546,"meta":547,"style":547},"import { defineCommand, runMain } from 'citty'\nimport { withTelemetry, defineTelemetryCommands } from '@evlog\u002Ftelemetry'\nimport { doctorCommand } from '.\u002Fcommands\u002Fdoctor'\nimport { syncCommand } from '.\u002Fcommands\u002Fsync'\n\nconst TOOL = 'my-tool'\nconst VERSION = '1.0.0'\n\nexport const main = withTelemetry(\n  defineCommand({\n    meta: { name: 'my-tool', description: '…', version: VERSION },\n    subCommands: {\n      doctor: doctorCommand,\n      sync: syncCommand,\n      telemetry: defineTelemetryCommands({ name: TOOL }),\n    },\n  }),\n  {\n    name: TOOL,\n    version: VERSION,\n    endpoint: 'https:\u002F\u002Ftelemetry.my-tool.dev\u002Fapi\u002Ftelemetry\u002Fingest',\n    collect: {\n      flags: { format: ['json', 'csv'] },\n      fields: { framework: ['nuxt', 'next'] },\n    },\n  },\n)\n\nrunMain(main)\n",[549,728,729,760,785,805,825,831,851,868,873,892,904,951,961,973,985,1013,1019,1029,1035,1047,1059,1075,1085,1124,1161,1166,1172,1177,1182],{"__ignoreMap":547},[552,730,731,735,738,741,743,746,749,752,754,757],{"class":554,"line":555},[552,732,734],{"class":733},"s7zQu","import",[552,736,737],{"class":566}," {",[552,739,740],{"class":562}," defineCommand",[552,742,567],{"class":566},[552,744,745],{"class":562}," runMain",[552,747,748],{"class":566}," }",[552,750,751],{"class":733}," from",[552,753,610],{"class":566},[552,755,756],{"class":613},"citty",[552,758,759],{"class":566},"'\n",[552,761,762,764,766,769,771,774,776,778,780,783],{"class":554,"line":573},[552,763,734],{"class":733},[552,765,737],{"class":566},[552,767,768],{"class":562}," withTelemetry",[552,770,567],{"class":566},[552,772,773],{"class":562}," defineTelemetryCommands",[552,775,748],{"class":566},[552,777,751],{"class":733},[552,779,610],{"class":566},[552,781,782],{"class":613},"@evlog\u002Ftelemetry",[552,784,759],{"class":566},[552,786,787,789,791,794,796,798,800,803],{"class":554,"line":589},[552,788,734],{"class":733},[552,790,737],{"class":566},[552,792,793],{"class":562}," doctorCommand",[552,795,748],{"class":566},[552,797,751],{"class":733},[552,799,610],{"class":566},[552,801,802],{"class":613},".\u002Fcommands\u002Fdoctor",[552,804,759],{"class":566},[552,806,807,809,811,814,816,818,820,823],{"class":554,"line":602},[552,808,734],{"class":733},[552,810,737],{"class":566},[552,812,813],{"class":562}," syncCommand",[552,815,748],{"class":566},[552,817,751],{"class":733},[552,819,610],{"class":566},[552,821,822],{"class":613},".\u002Fcommands\u002Fsync",[552,824,759],{"class":566},[552,826,827],{"class":554,"line":622},[552,828,830],{"emptyLinePlaceholder":829},true,"\n",[552,832,834,838,841,844,846,849],{"class":554,"line":833},6,[552,835,837],{"class":836},"spNyl","const",[552,839,840],{"class":562}," TOOL ",[552,842,843],{"class":566},"=",[552,845,610],{"class":566},[552,847,848],{"class":613},"my-tool",[552,850,759],{"class":566},[552,852,854,856,859,861,863,866],{"class":554,"line":853},7,[552,855,837],{"class":836},[552,857,858],{"class":562}," VERSION ",[552,860,843],{"class":566},[552,862,610],{"class":566},[552,864,865],{"class":613},"1.0.0",[552,867,759],{"class":566},[552,869,871],{"class":554,"line":870},8,[552,872,830],{"emptyLinePlaceholder":829},[552,874,876,879,882,885,887,889],{"class":554,"line":875},9,[552,877,878],{"class":733},"export",[552,880,881],{"class":836}," const",[552,883,884],{"class":562}," main ",[552,886,843],{"class":566},[552,888,768],{"class":558},[552,890,891],{"class":562},"(\n",[552,893,895,898,901],{"class":554,"line":894},10,[552,896,897],{"class":558},"  defineCommand",[552,899,900],{"class":562},"(",[552,902,903],{"class":566},"{\n",[552,905,907,910,912,914,917,919,921,923,925,927,930,932,934,937,939,941,944,946,948],{"class":554,"line":906},11,[552,908,909],{"class":576},"    meta",[552,911,580],{"class":566},[552,913,737],{"class":566},[552,915,916],{"class":576}," name",[552,918,580],{"class":566},[552,920,610],{"class":566},[552,922,848],{"class":613},[552,924,617],{"class":566},[552,926,567],{"class":566},[552,928,929],{"class":576}," description",[552,931,580],{"class":566},[552,933,610],{"class":566},[552,935,936],{"class":613},"…",[552,938,617],{"class":566},[552,940,567],{"class":566},[552,942,943],{"class":576}," version",[552,945,580],{"class":566},[552,947,858],{"class":562},[552,949,950],{"class":566},"},\n",[552,952,954,957,959],{"class":554,"line":953},12,[552,955,956],{"class":576},"    subCommands",[552,958,580],{"class":566},[552,960,570],{"class":566},[552,962,964,967,969,971],{"class":554,"line":963},13,[552,965,966],{"class":576},"      doctor",[552,968,580],{"class":566},[552,970,793],{"class":562},[552,972,586],{"class":566},[552,974,976,979,981,983],{"class":554,"line":975},14,[552,977,978],{"class":576},"      sync",[552,980,580],{"class":566},[552,982,813],{"class":562},[552,984,586],{"class":566},[552,986,988,991,993,995,997,1000,1002,1004,1006,1008,1011],{"class":554,"line":987},15,[552,989,990],{"class":576},"      telemetry",[552,992,580],{"class":566},[552,994,773],{"class":558},[552,996,900],{"class":562},[552,998,999],{"class":566},"{",[552,1001,916],{"class":576},[552,1003,580],{"class":566},[552,1005,840],{"class":562},[552,1007,625],{"class":566},[552,1009,1010],{"class":562},")",[552,1012,586],{"class":566},[552,1014,1016],{"class":554,"line":1015},16,[552,1017,1018],{"class":566},"    },\n",[552,1020,1022,1025,1027],{"class":554,"line":1021},17,[552,1023,1024],{"class":566},"  }",[552,1026,1010],{"class":562},[552,1028,586],{"class":566},[552,1030,1032],{"class":554,"line":1031},18,[552,1033,1034],{"class":566},"  {\n",[552,1036,1038,1041,1043,1045],{"class":554,"line":1037},19,[552,1039,1040],{"class":576},"    name",[552,1042,580],{"class":566},[552,1044,583],{"class":562},[552,1046,586],{"class":566},[552,1048,1050,1053,1055,1057],{"class":554,"line":1049},20,[552,1051,1052],{"class":576},"    version",[552,1054,580],{"class":566},[552,1056,597],{"class":562},[552,1058,586],{"class":566},[552,1060,1062,1065,1067,1069,1071,1073],{"class":554,"line":1061},21,[552,1063,1064],{"class":576},"    endpoint",[552,1066,580],{"class":566},[552,1068,610],{"class":566},[552,1070,614],{"class":613},[552,1072,617],{"class":566},[552,1074,586],{"class":566},[552,1076,1078,1081,1083],{"class":554,"line":1077},22,[552,1079,1080],{"class":576},"    collect",[552,1082,580],{"class":566},[552,1084,570],{"class":566},[552,1086,1088,1091,1093,1095,1098,1100,1103,1105,1108,1110,1112,1114,1117,1119,1122],{"class":554,"line":1087},23,[552,1089,1090],{"class":576},"      flags",[552,1092,580],{"class":566},[552,1094,737],{"class":566},[552,1096,1097],{"class":576}," format",[552,1099,580],{"class":566},[552,1101,1102],{"class":562}," [",[552,1104,617],{"class":566},[552,1106,1107],{"class":613},"json",[552,1109,617],{"class":566},[552,1111,567],{"class":566},[552,1113,610],{"class":566},[552,1115,1116],{"class":613},"csv",[552,1118,617],{"class":566},[552,1120,1121],{"class":562},"] ",[552,1123,950],{"class":566},[552,1125,1127,1130,1132,1134,1137,1139,1141,1143,1146,1148,1150,1152,1155,1157,1159],{"class":554,"line":1126},24,[552,1128,1129],{"class":576},"      fields",[552,1131,580],{"class":566},[552,1133,737],{"class":566},[552,1135,1136],{"class":576}," framework",[552,1138,580],{"class":566},[552,1140,1102],{"class":562},[552,1142,617],{"class":566},[552,1144,1145],{"class":613},"nuxt",[552,1147,617],{"class":566},[552,1149,567],{"class":566},[552,1151,610],{"class":566},[552,1153,1154],{"class":613},"next",[552,1156,617],{"class":566},[552,1158,1121],{"class":562},[552,1160,950],{"class":566},[552,1162,1164],{"class":554,"line":1163},25,[552,1165,1018],{"class":566},[552,1167,1169],{"class":554,"line":1168},26,[552,1170,1171],{"class":566},"  },\n",[552,1173,1175],{"class":554,"line":1174},27,[552,1176,628],{"class":562},[552,1178,1180],{"class":554,"line":1179},28,[552,1181,830],{"emptyLinePlaceholder":829},[552,1183,1185,1188],{"class":554,"line":1184},29,[552,1186,1187],{"class":558},"runMain",[552,1189,1190],{"class":562},"(main)\n",[1192,1193,1195],"h3",{"id":1194},"what-gets-recorded-automatically","What gets recorded automatically",[537,1197,1198,1200,1201,1204],{},[549,1199,559],{}," walks your citty tree. Each ",[549,1202,1203],{},"run"," handler produces one event — no per-command telemetry boilerplate.",[630,1206,1207,1225],{},[633,1208,1209],{},[636,1210,1211,1214,1219],{},[639,1212,1213],{},"Invocation",[639,1215,1216],{},[549,1217,1218],{},"event.command",[639,1220,1221,1222],{},"Notes on ",[549,1223,1224],{},"flags",[646,1226,1227,1244,1259,1281,1301],{},[636,1228,1229,1234,1238],{},[651,1230,1231],{},[549,1232,1233],{},"my-tool doctor",[651,1235,1236],{},[549,1237,114],{},[651,1239,1240,1243],{},[549,1241,1242],{},"{ json: true }"," — booleans captured as values",[636,1245,1246,1251,1255],{},[651,1247,1248],{},[549,1249,1250],{},"my-tool doctor --json",[651,1252,1253],{},[549,1254,114],{},[651,1256,1257],{},[549,1258,1242],{},[636,1260,1261,1266,1271],{},[651,1262,1263],{},[549,1264,1265],{},"my-tool sync --dry-run --output .\u002Fout",[651,1267,1268],{},[549,1269,1270],{},"sync",[651,1272,1273,1276,1277],{},[549,1274,1275],{},"{ dryRun: true, output: true }"," — string path is ",[1278,1279,1280],"strong",{},"presence only",[636,1282,1283,1288,1292],{},[651,1284,1285],{},[549,1286,1287],{},"my-tool sync --format json",[651,1289,1290],{},[549,1291,1270],{},[651,1293,1294,1297,1298],{},[549,1295,1296],{},"{ format: \"json\" }"," only if allowlisted in ",[549,1299,1300],{},"collect.flags",[636,1302,1303,1308,1313],{},[651,1304,1305],{},[549,1306,1307],{},"my-tool telemetry status",[651,1309,1310],{},[549,1311,1312],{},"telemetry status",[651,1314,1315],{},"nested subcommands join with a space",[537,1317,1318,1319,1322,1323,1326],{},"The root ",[549,1320,1321],{},"meta.name"," is not prefixed when the root only delegates to ",[549,1324,1325],{},"subCommands",".",[1192,1328,1330],{"id":1329},"enriching-a-run","Enriching a run",[537,1332,1333,1334,1337],{},"Call ",[549,1335,1336],{},"telemetry.set()"," anywhere inside a command handler — or in helpers that run on the same async stack (the run context is preserved via AsyncLocalStorage).",[1339,1340,1341],"code-collapse",{},[541,1342,1345],{"className":543,"code":1343,"filename":1344,"language":546,"meta":547,"style":547},"import { telemetry } from '@evlog\u002Ftelemetry'\nimport { existsSync } from 'node:fs'\nimport { resolveConfigPath } from '..\u002Flib\u002Fconfig'\n\nasync function runHealthChecks() {\n  let checksFailed = 0\n  let checksWarn = 0\n\n  const configPath = resolveConfigPath()\n  if (!existsSync(configPath)) {\n    checksFailed++\n  }\n\n  try {\n    await fetch('https:\u002F\u002Fregistry.npmjs.org\u002Fmy-tool')\n  } catch {\n    checksWarn++\n  }\n\n  \u002F\u002F Counters land in event.custom on the wide event for this run\n  telemetry.set({ checksFailed, checksWarn })\n  return checksFailed === 0\n}\n\nexport const doctorCommand = {\n  meta: { name: 'doctor', description: 'Check environment' },\n  args: {\n    json: { type: 'boolean', alias: 'j' },\n  },\n  async run({ args }: { args: { json?: boolean } }) {\n    const ok = await runHealthChecks()\n    if (!ok) {\n      throw Object.assign(new Error('Health checks failed'), { code: 'DOCTOR_FAILED' })\n    }\n    if (!args.json) process.stdout.write('ok\\n')\n  },\n}\n","src\u002Fcommands\u002Fdoctor.ts",[549,1346,1347,1366,1386,1406,1410,1426,1441,1452,1456,1471,1495,1503,1508,1512,1519,1538,1547,1554,1558,1562,1568,1592,1604,1609,1613,1626,1661,1670,1707,1711,1755,1773,1791,1844,1850,1894,1899],{"__ignoreMap":547},[552,1348,1349,1351,1353,1356,1358,1360,1362,1364],{"class":554,"line":555},[552,1350,734],{"class":733},[552,1352,737],{"class":566},[552,1354,1355],{"class":562}," telemetry",[552,1357,748],{"class":566},[552,1359,751],{"class":733},[552,1361,610],{"class":566},[552,1363,782],{"class":613},[552,1365,759],{"class":566},[552,1367,1368,1370,1372,1375,1377,1379,1381,1384],{"class":554,"line":573},[552,1369,734],{"class":733},[552,1371,737],{"class":566},[552,1373,1374],{"class":562}," existsSync",[552,1376,748],{"class":566},[552,1378,751],{"class":733},[552,1380,610],{"class":566},[552,1382,1383],{"class":613},"node:fs",[552,1385,759],{"class":566},[552,1387,1388,1390,1392,1395,1397,1399,1401,1404],{"class":554,"line":589},[552,1389,734],{"class":733},[552,1391,737],{"class":566},[552,1393,1394],{"class":562}," resolveConfigPath",[552,1396,748],{"class":566},[552,1398,751],{"class":733},[552,1400,610],{"class":566},[552,1402,1403],{"class":613},"..\u002Flib\u002Fconfig",[552,1405,759],{"class":566},[552,1407,1408],{"class":554,"line":602},[552,1409,830],{"emptyLinePlaceholder":829},[552,1411,1412,1415,1418,1421,1424],{"class":554,"line":622},[552,1413,1414],{"class":836},"async",[552,1416,1417],{"class":836}," function",[552,1419,1420],{"class":558}," runHealthChecks",[552,1422,1423],{"class":566},"()",[552,1425,570],{"class":566},[552,1427,1428,1431,1434,1437],{"class":554,"line":833},[552,1429,1430],{"class":836},"  let",[552,1432,1433],{"class":562}," checksFailed",[552,1435,1436],{"class":566}," =",[552,1438,1440],{"class":1439},"sbssI"," 0\n",[552,1442,1443,1445,1448,1450],{"class":554,"line":853},[552,1444,1430],{"class":836},[552,1446,1447],{"class":562}," checksWarn",[552,1449,1436],{"class":566},[552,1451,1440],{"class":1439},[552,1453,1454],{"class":554,"line":870},[552,1455,830],{"emptyLinePlaceholder":829},[552,1457,1458,1461,1464,1466,1468],{"class":554,"line":875},[552,1459,1460],{"class":836},"  const",[552,1462,1463],{"class":562}," configPath",[552,1465,1436],{"class":566},[552,1467,1394],{"class":558},[552,1469,1470],{"class":576},"()\n",[552,1472,1473,1476,1479,1482,1485,1487,1490,1493],{"class":554,"line":894},[552,1474,1475],{"class":733},"  if",[552,1477,1478],{"class":576}," (",[552,1480,1481],{"class":566},"!",[552,1483,1484],{"class":558},"existsSync",[552,1486,900],{"class":576},[552,1488,1489],{"class":562},"configPath",[552,1491,1492],{"class":576},")) ",[552,1494,903],{"class":566},[552,1496,1497,1500],{"class":554,"line":906},[552,1498,1499],{"class":562},"    checksFailed",[552,1501,1502],{"class":566},"++\n",[552,1504,1505],{"class":554,"line":953},[552,1506,1507],{"class":566},"  }\n",[552,1509,1510],{"class":554,"line":963},[552,1511,830],{"emptyLinePlaceholder":829},[552,1513,1514,1517],{"class":554,"line":975},[552,1515,1516],{"class":733},"  try",[552,1518,570],{"class":566},[552,1520,1521,1524,1527,1529,1531,1534,1536],{"class":554,"line":987},[552,1522,1523],{"class":733},"    await",[552,1525,1526],{"class":558}," fetch",[552,1528,900],{"class":576},[552,1530,617],{"class":566},[552,1532,1533],{"class":613},"https:\u002F\u002Fregistry.npmjs.org\u002Fmy-tool",[552,1535,617],{"class":566},[552,1537,628],{"class":576},[552,1539,1540,1542,1545],{"class":554,"line":1015},[552,1541,1024],{"class":566},[552,1543,1544],{"class":733}," catch",[552,1546,570],{"class":566},[552,1548,1549,1552],{"class":554,"line":1021},[552,1550,1551],{"class":562},"    checksWarn",[552,1553,1502],{"class":566},[552,1555,1556],{"class":554,"line":1031},[552,1557,1507],{"class":566},[552,1559,1560],{"class":554,"line":1037},[552,1561,830],{"emptyLinePlaceholder":829},[552,1563,1564],{"class":554,"line":1049},[552,1565,1567],{"class":1566},"sHwdD","  \u002F\u002F Counters land in event.custom on the wide event for this run\n",[552,1569,1570,1573,1575,1578,1580,1582,1584,1586,1588,1590],{"class":554,"line":1061},[552,1571,1572],{"class":562},"  telemetry",[552,1574,1326],{"class":566},[552,1576,1577],{"class":558},"set",[552,1579,900],{"class":576},[552,1581,999],{"class":566},[552,1583,1433],{"class":562},[552,1585,567],{"class":566},[552,1587,1447],{"class":562},[552,1589,748],{"class":566},[552,1591,628],{"class":576},[552,1593,1594,1597,1599,1602],{"class":554,"line":1077},[552,1595,1596],{"class":733},"  return",[552,1598,1433],{"class":562},[552,1600,1601],{"class":566}," ===",[552,1603,1440],{"class":1439},[552,1605,1606],{"class":554,"line":1087},[552,1607,1608],{"class":566},"}\n",[552,1610,1611],{"class":554,"line":1126},[552,1612,830],{"emptyLinePlaceholder":829},[552,1614,1615,1617,1619,1622,1624],{"class":554,"line":1163},[552,1616,878],{"class":733},[552,1618,881],{"class":836},[552,1620,1621],{"class":562}," doctorCommand ",[552,1623,843],{"class":566},[552,1625,570],{"class":566},[552,1627,1628,1631,1633,1635,1637,1639,1641,1643,1645,1647,1649,1651,1653,1656,1658],{"class":554,"line":1168},[552,1629,1630],{"class":576},"  meta",[552,1632,580],{"class":566},[552,1634,737],{"class":566},[552,1636,916],{"class":576},[552,1638,580],{"class":566},[552,1640,610],{"class":566},[552,1642,114],{"class":613},[552,1644,617],{"class":566},[552,1646,567],{"class":566},[552,1648,929],{"class":576},[552,1650,580],{"class":566},[552,1652,610],{"class":566},[552,1654,1655],{"class":613},"Check environment",[552,1657,617],{"class":566},[552,1659,1660],{"class":566}," },\n",[552,1662,1663,1666,1668],{"class":554,"line":1174},[552,1664,1665],{"class":576},"  args",[552,1667,580],{"class":566},[552,1669,570],{"class":566},[552,1671,1672,1675,1677,1679,1682,1684,1686,1689,1691,1693,1696,1698,1700,1703,1705],{"class":554,"line":1179},[552,1673,1674],{"class":576},"    json",[552,1676,580],{"class":566},[552,1678,737],{"class":566},[552,1680,1681],{"class":576}," type",[552,1683,580],{"class":566},[552,1685,610],{"class":566},[552,1687,1688],{"class":613},"boolean",[552,1690,617],{"class":566},[552,1692,567],{"class":566},[552,1694,1695],{"class":576}," alias",[552,1697,580],{"class":566},[552,1699,610],{"class":566},[552,1701,1702],{"class":613},"j",[552,1704,617],{"class":566},[552,1706,1660],{"class":566},[552,1708,1709],{"class":554,"line":1184},[552,1710,1171],{"class":566},[552,1712,1714,1717,1720,1723,1727,1730,1732,1734,1736,1738,1741,1744,1748,1750,1753],{"class":554,"line":1713},30,[552,1715,1716],{"class":836},"  async",[552,1718,1719],{"class":576}," run",[552,1721,1722],{"class":566},"({",[552,1724,1726],{"class":1725},"sHdIc"," args",[552,1728,1729],{"class":566}," }:",[552,1731,737],{"class":566},[552,1733,1726],{"class":576},[552,1735,580],{"class":566},[552,1737,737],{"class":566},[552,1739,1740],{"class":576}," json",[552,1742,1743],{"class":566},"?:",[552,1745,1747],{"class":1746},"sBMFI"," boolean",[552,1749,748],{"class":566},[552,1751,1752],{"class":566}," })",[552,1754,570],{"class":566},[552,1756,1758,1761,1764,1766,1769,1771],{"class":554,"line":1757},31,[552,1759,1760],{"class":836},"    const",[552,1762,1763],{"class":562}," ok",[552,1765,1436],{"class":566},[552,1767,1768],{"class":733}," await",[552,1770,1420],{"class":558},[552,1772,1470],{"class":576},[552,1774,1776,1779,1781,1783,1786,1789],{"class":554,"line":1775},32,[552,1777,1778],{"class":733},"    if",[552,1780,1478],{"class":576},[552,1782,1481],{"class":566},[552,1784,1785],{"class":562},"ok",[552,1787,1788],{"class":576},") ",[552,1790,903],{"class":566},[552,1792,1794,1797,1800,1802,1805,1807,1810,1813,1815,1817,1820,1822,1824,1826,1828,1831,1833,1835,1838,1840,1842],{"class":554,"line":1793},33,[552,1795,1796],{"class":733},"      throw",[552,1798,1799],{"class":562}," Object",[552,1801,1326],{"class":566},[552,1803,1804],{"class":558},"assign",[552,1806,900],{"class":576},[552,1808,1809],{"class":566},"new",[552,1811,1812],{"class":558}," Error",[552,1814,900],{"class":576},[552,1816,617],{"class":566},[552,1818,1819],{"class":613},"Health checks failed",[552,1821,617],{"class":566},[552,1823,1010],{"class":576},[552,1825,567],{"class":566},[552,1827,737],{"class":566},[552,1829,1830],{"class":576}," code",[552,1832,580],{"class":566},[552,1834,610],{"class":566},[552,1836,1837],{"class":613},"DOCTOR_FAILED",[552,1839,617],{"class":566},[552,1841,748],{"class":566},[552,1843,628],{"class":576},[552,1845,1847],{"class":554,"line":1846},34,[552,1848,1849],{"class":566},"    }\n",[552,1851,1853,1855,1857,1859,1862,1864,1866,1868,1871,1873,1876,1878,1881,1883,1885,1887,1890,1892],{"class":554,"line":1852},35,[552,1854,1778],{"class":733},[552,1856,1478],{"class":576},[552,1858,1481],{"class":566},[552,1860,1861],{"class":562},"args",[552,1863,1326],{"class":566},[552,1865,1107],{"class":562},[552,1867,1788],{"class":576},[552,1869,1870],{"class":562},"process",[552,1872,1326],{"class":566},[552,1874,1875],{"class":562},"stdout",[552,1877,1326],{"class":566},[552,1879,1880],{"class":558},"write",[552,1882,900],{"class":576},[552,1884,617],{"class":566},[552,1886,1785],{"class":613},[552,1888,1889],{"class":562},"\\n",[552,1891,617],{"class":566},[552,1893,628],{"class":576},[552,1895,1897],{"class":554,"line":1896},36,[552,1898,1171],{"class":566},[552,1900,1902],{"class":554,"line":1901},37,[552,1903,1608],{"class":566},[537,1905,1906,1907,1909,1910,1913,1914,1917],{},"Throw an error with a ",[549,1908,549],{}," property and ",[549,1911,1912],{},"outcome: \"error\""," plus ",[549,1915,1916],{},"errorCode"," are recorded automatically:",[541,1919,1921],{"className":543,"code":1920,"filename":1344,"language":546,"meta":547,"style":547},"throw Object.assign(new Error('Config missing'), { code: 'CONFIG_NOT_FOUND' })\n",[549,1922,1923],{"__ignoreMap":547},[552,1924,1925,1928,1930,1932,1934,1936,1938,1940,1942,1944,1947,1949,1951,1953,1955,1957,1959,1961,1964,1966,1968],{"class":554,"line":555},[552,1926,1927],{"class":733},"throw",[552,1929,1799],{"class":562},[552,1931,1326],{"class":566},[552,1933,1804],{"class":558},[552,1935,900],{"class":562},[552,1937,1809],{"class":566},[552,1939,1812],{"class":558},[552,1941,900],{"class":562},[552,1943,617],{"class":566},[552,1945,1946],{"class":613},"Config missing",[552,1948,617],{"class":566},[552,1950,1010],{"class":562},[552,1952,567],{"class":566},[552,1954,737],{"class":566},[552,1956,1830],{"class":576},[552,1958,580],{"class":566},[552,1960,610],{"class":566},[552,1962,1963],{"class":613},"CONFIG_NOT_FOUND",[552,1965,617],{"class":566},[552,1967,748],{"class":566},[552,1969,628],{"class":562},[537,1971,1972,1973,1976],{},"A minimal sync handler for comparison — flags are auto-captured, you only ",[549,1974,1975],{},"set()"," business counters:",[541,1978,1981],{"className":543,"code":1979,"filename":1980,"language":546,"meta":547,"style":547},"import { telemetry } from '@evlog\u002Ftelemetry'\n\nexport const syncCommand = {\n  meta: { name: 'sync', description: 'Pull remote state' },\n  args: {\n    dryRun: { type: 'boolean' },\n    output: { type: 'string', description: 'Output path' },\n  },\n  async run() {\n    const itemsSynced = await pullRemoteState()\n    telemetry.set({ itemsSynced })\n  },\n}\n","src\u002Fcommands\u002Fsync.ts",[549,1982,1983,2001,2005,2018,2051,2059,2080,2115,2119,2129,2145,2164,2168],{"__ignoreMap":547},[552,1984,1985,1987,1989,1991,1993,1995,1997,1999],{"class":554,"line":555},[552,1986,734],{"class":733},[552,1988,737],{"class":566},[552,1990,1355],{"class":562},[552,1992,748],{"class":566},[552,1994,751],{"class":733},[552,1996,610],{"class":566},[552,1998,782],{"class":613},[552,2000,759],{"class":566},[552,2002,2003],{"class":554,"line":573},[552,2004,830],{"emptyLinePlaceholder":829},[552,2006,2007,2009,2011,2014,2016],{"class":554,"line":589},[552,2008,878],{"class":733},[552,2010,881],{"class":836},[552,2012,2013],{"class":562}," syncCommand ",[552,2015,843],{"class":566},[552,2017,570],{"class":566},[552,2019,2020,2022,2024,2026,2028,2030,2032,2034,2036,2038,2040,2042,2044,2047,2049],{"class":554,"line":602},[552,2021,1630],{"class":576},[552,2023,580],{"class":566},[552,2025,737],{"class":566},[552,2027,916],{"class":576},[552,2029,580],{"class":566},[552,2031,610],{"class":566},[552,2033,1270],{"class":613},[552,2035,617],{"class":566},[552,2037,567],{"class":566},[552,2039,929],{"class":576},[552,2041,580],{"class":566},[552,2043,610],{"class":566},[552,2045,2046],{"class":613},"Pull remote state",[552,2048,617],{"class":566},[552,2050,1660],{"class":566},[552,2052,2053,2055,2057],{"class":554,"line":622},[552,2054,1665],{"class":576},[552,2056,580],{"class":566},[552,2058,570],{"class":566},[552,2060,2061,2064,2066,2068,2070,2072,2074,2076,2078],{"class":554,"line":833},[552,2062,2063],{"class":576},"    dryRun",[552,2065,580],{"class":566},[552,2067,737],{"class":566},[552,2069,1681],{"class":576},[552,2071,580],{"class":566},[552,2073,610],{"class":566},[552,2075,1688],{"class":613},[552,2077,617],{"class":566},[552,2079,1660],{"class":566},[552,2081,2082,2085,2087,2089,2091,2093,2095,2098,2100,2102,2104,2106,2108,2111,2113],{"class":554,"line":853},[552,2083,2084],{"class":576},"    output",[552,2086,580],{"class":566},[552,2088,737],{"class":566},[552,2090,1681],{"class":576},[552,2092,580],{"class":566},[552,2094,610],{"class":566},[552,2096,2097],{"class":613},"string",[552,2099,617],{"class":566},[552,2101,567],{"class":566},[552,2103,929],{"class":576},[552,2105,580],{"class":566},[552,2107,610],{"class":566},[552,2109,2110],{"class":613},"Output path",[552,2112,617],{"class":566},[552,2114,1660],{"class":566},[552,2116,2117],{"class":554,"line":870},[552,2118,1171],{"class":566},[552,2120,2121,2123,2125,2127],{"class":554,"line":875},[552,2122,1716],{"class":836},[552,2124,1719],{"class":576},[552,2126,1423],{"class":566},[552,2128,570],{"class":566},[552,2130,2131,2133,2136,2138,2140,2143],{"class":554,"line":894},[552,2132,1760],{"class":836},[552,2134,2135],{"class":562}," itemsSynced",[552,2137,1436],{"class":566},[552,2139,1768],{"class":733},[552,2141,2142],{"class":558}," pullRemoteState",[552,2144,1470],{"class":576},[552,2146,2147,2150,2152,2154,2156,2158,2160,2162],{"class":554,"line":906},[552,2148,2149],{"class":562},"    telemetry",[552,2151,1326],{"class":566},[552,2153,1577],{"class":558},[552,2155,900],{"class":576},[552,2157,999],{"class":566},[552,2159,2135],{"class":562},[552,2161,748],{"class":566},[552,2163,628],{"class":576},[552,2165,2166],{"class":554,"line":953},[552,2167,1171],{"class":566},[552,2169,2170],{"class":554,"line":963},[552,2171,1608],{"class":566},[532,2173,2175],{"id":2174},"setup-without-citty","Setup without citty",[537,2177,2178,2179,2182,2183,580],{},"For scripts, migrators, or custom CLIs, use ",[549,2180,2181],{},"createTelemetry()"," and wrap each logical run with ",[549,2184,2185],{},"t.run()",[541,2187,2190],{"className":543,"code":2188,"filename":2189,"language":546,"meta":547,"style":547},"import { createTelemetry, telemetry } from '@evlog\u002Ftelemetry'\n\nconst t = createTelemetry({ name: 'my-migrator', version: '2.0.0' })\n\nawait t.run('migrate', async () => {\n  const rows = await migrateBatch()\n  telemetry.set({ rowsMigrated: rows.length, batchSize: 500 })\n})\n\nawait t.flush() \u002F\u002F optional — also runs at end of each t.run()\n","scripts\u002Fmigrate.ts",[549,2191,2192,2215,2219,2262,2266,2300,2316,2354,2360,2364],{"__ignoreMap":547},[552,2193,2194,2196,2198,2201,2203,2205,2207,2209,2211,2213],{"class":554,"line":555},[552,2195,734],{"class":733},[552,2197,737],{"class":566},[552,2199,2200],{"class":562}," createTelemetry",[552,2202,567],{"class":566},[552,2204,1355],{"class":562},[552,2206,748],{"class":566},[552,2208,751],{"class":733},[552,2210,610],{"class":566},[552,2212,782],{"class":613},[552,2214,759],{"class":566},[552,2216,2217],{"class":554,"line":573},[552,2218,830],{"emptyLinePlaceholder":829},[552,2220,2221,2223,2226,2228,2230,2232,2234,2236,2238,2240,2243,2245,2247,2249,2251,2253,2256,2258,2260],{"class":554,"line":589},[552,2222,837],{"class":836},[552,2224,2225],{"class":562}," t ",[552,2227,843],{"class":566},[552,2229,2200],{"class":558},[552,2231,900],{"class":562},[552,2233,999],{"class":566},[552,2235,916],{"class":576},[552,2237,580],{"class":566},[552,2239,610],{"class":566},[552,2241,2242],{"class":613},"my-migrator",[552,2244,617],{"class":566},[552,2246,567],{"class":566},[552,2248,943],{"class":576},[552,2250,580],{"class":566},[552,2252,610],{"class":566},[552,2254,2255],{"class":613},"2.0.0",[552,2257,617],{"class":566},[552,2259,748],{"class":566},[552,2261,628],{"class":562},[552,2263,2264],{"class":554,"line":602},[552,2265,830],{"emptyLinePlaceholder":829},[552,2267,2268,2271,2274,2276,2278,2280,2282,2285,2287,2289,2292,2295,2298],{"class":554,"line":622},[552,2269,2270],{"class":733},"await",[552,2272,2273],{"class":562}," t",[552,2275,1326],{"class":566},[552,2277,1203],{"class":558},[552,2279,900],{"class":562},[552,2281,617],{"class":566},[552,2283,2284],{"class":613},"migrate",[552,2286,617],{"class":566},[552,2288,567],{"class":566},[552,2290,2291],{"class":836}," async",[552,2293,2294],{"class":566}," ()",[552,2296,2297],{"class":836}," =>",[552,2299,570],{"class":566},[552,2301,2302,2304,2307,2309,2311,2314],{"class":554,"line":833},[552,2303,1460],{"class":836},[552,2305,2306],{"class":562}," rows",[552,2308,1436],{"class":566},[552,2310,1768],{"class":733},[552,2312,2313],{"class":558}," migrateBatch",[552,2315,1470],{"class":576},[552,2317,2318,2320,2322,2324,2326,2328,2331,2333,2335,2337,2340,2342,2345,2347,2350,2352],{"class":554,"line":853},[552,2319,1572],{"class":562},[552,2321,1326],{"class":566},[552,2323,1577],{"class":558},[552,2325,900],{"class":576},[552,2327,999],{"class":566},[552,2329,2330],{"class":576}," rowsMigrated",[552,2332,580],{"class":566},[552,2334,2306],{"class":562},[552,2336,1326],{"class":566},[552,2338,2339],{"class":562},"length",[552,2341,567],{"class":566},[552,2343,2344],{"class":576}," batchSize",[552,2346,580],{"class":566},[552,2348,2349],{"class":1439}," 500",[552,2351,748],{"class":566},[552,2353,628],{"class":576},[552,2355,2356,2358],{"class":554,"line":870},[552,2357,625],{"class":566},[552,2359,628],{"class":562},[552,2361,2362],{"class":554,"line":875},[552,2363,830],{"emptyLinePlaceholder":829},[552,2365,2366,2368,2370,2372,2375,2378],{"class":554,"line":894},[552,2367,2270],{"class":733},[552,2369,2273],{"class":562},[552,2371,1326],{"class":566},[552,2373,2374],{"class":558},"flush",[552,2376,2377],{"class":562},"() ",[552,2379,2380],{"class":1566},"\u002F\u002F optional — also runs at end of each t.run()\n",[537,2382,2383,2384,2387,2388,2391,2392,2395,2396,2399,2400,2403,2404,666,2407,2410],{},"GitHub Actions: swap ",[549,2385,2386],{},"createTelemetry"," for ",[549,2389,2390],{},"createGitHubActionsTelemetry()"," in the same file — it adds ",[549,2393,2394],{},"ghaAction"," and ",[549,2397,2398],{},"ghaEvent"," to ",[549,2401,2402],{},"custom"," from ",[549,2405,2406],{},"GITHUB_ACTION",[549,2408,2409],{},"GITHUB_EVENT_NAME"," only (never repo content).",[541,2412,2415],{"className":543,"code":2413,"filename":2414,"language":546,"meta":547,"style":547},"import { createGitHubActionsTelemetry, telemetry } from '@evlog\u002Ftelemetry'\n\nconst t = createGitHubActionsTelemetry({ name: 'my-action', version: '1.0.0' })\n\nawait t.run('report', async () => {\n  const artifacts = await collectArtifacts()\n  telemetry.set({ artifactCount: artifacts.length })\n})\n","scripts\u002Fci-report.ts",[549,2416,2417,2440,2444,2485,2489,2518,2534,2561],{"__ignoreMap":547},[552,2418,2419,2421,2423,2426,2428,2430,2432,2434,2436,2438],{"class":554,"line":555},[552,2420,734],{"class":733},[552,2422,737],{"class":566},[552,2424,2425],{"class":562}," createGitHubActionsTelemetry",[552,2427,567],{"class":566},[552,2429,1355],{"class":562},[552,2431,748],{"class":566},[552,2433,751],{"class":733},[552,2435,610],{"class":566},[552,2437,782],{"class":613},[552,2439,759],{"class":566},[552,2441,2442],{"class":554,"line":573},[552,2443,830],{"emptyLinePlaceholder":829},[552,2445,2446,2448,2450,2452,2454,2456,2458,2460,2462,2464,2467,2469,2471,2473,2475,2477,2479,2481,2483],{"class":554,"line":589},[552,2447,837],{"class":836},[552,2449,2225],{"class":562},[552,2451,843],{"class":566},[552,2453,2425],{"class":558},[552,2455,900],{"class":562},[552,2457,999],{"class":566},[552,2459,916],{"class":576},[552,2461,580],{"class":566},[552,2463,610],{"class":566},[552,2465,2466],{"class":613},"my-action",[552,2468,617],{"class":566},[552,2470,567],{"class":566},[552,2472,943],{"class":576},[552,2474,580],{"class":566},[552,2476,610],{"class":566},[552,2478,865],{"class":613},[552,2480,617],{"class":566},[552,2482,748],{"class":566},[552,2484,628],{"class":562},[552,2486,2487],{"class":554,"line":602},[552,2488,830],{"emptyLinePlaceholder":829},[552,2490,2491,2493,2495,2497,2499,2501,2503,2506,2508,2510,2512,2514,2516],{"class":554,"line":622},[552,2492,2270],{"class":733},[552,2494,2273],{"class":562},[552,2496,1326],{"class":566},[552,2498,1203],{"class":558},[552,2500,900],{"class":562},[552,2502,617],{"class":566},[552,2504,2505],{"class":613},"report",[552,2507,617],{"class":566},[552,2509,567],{"class":566},[552,2511,2291],{"class":836},[552,2513,2294],{"class":566},[552,2515,2297],{"class":836},[552,2517,570],{"class":566},[552,2519,2520,2522,2525,2527,2529,2532],{"class":554,"line":833},[552,2521,1460],{"class":836},[552,2523,2524],{"class":562}," artifacts",[552,2526,1436],{"class":566},[552,2528,1768],{"class":733},[552,2530,2531],{"class":558}," collectArtifacts",[552,2533,1470],{"class":576},[552,2535,2536,2538,2540,2542,2544,2546,2549,2551,2553,2555,2557,2559],{"class":554,"line":853},[552,2537,1572],{"class":562},[552,2539,1326],{"class":566},[552,2541,1577],{"class":558},[552,2543,900],{"class":576},[552,2545,999],{"class":566},[552,2547,2548],{"class":576}," artifactCount",[552,2550,580],{"class":566},[552,2552,2524],{"class":562},[552,2554,1326],{"class":566},[552,2556,2339],{"class":562},[552,2558,748],{"class":566},[552,2560,628],{"class":576},[552,2562,2563,2565],{"class":554,"line":870},[552,2564,625],{"class":566},[552,2566,628],{"class":562},[532,2568,2570],{"id":2569},"debug","Debug",[541,2572,2576],{"className":2573,"code":2574,"language":2575,"meta":547,"style":547},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","EVLOG_TELEMETRY_DEBUG=1 my-tool doctor\nEVLOG_TELEMETRY=0 my-tool sync\n","bash",[549,2577,2578,2594],{"__ignoreMap":547},[552,2579,2580,2583,2585,2588,2591],{"class":554,"line":555},[552,2581,2582],{"class":562},"EVLOG_TELEMETRY_DEBUG",[552,2584,843],{"class":566},[552,2586,2587],{"class":613},"1",[552,2589,2590],{"class":1746}," my-tool",[552,2592,2593],{"class":613}," doctor\n",[552,2595,2596,2599,2601,2604,2606],{"class":554,"line":573},[552,2597,2598],{"class":562},"EVLOG_TELEMETRY",[552,2600,843],{"class":566},[552,2602,2603],{"class":613},"0",[552,2605,2590],{"class":1746},[552,2607,2608],{"class":613}," sync\n",[537,2610,2611],{},"Debug mode prints would-be payloads to stderr. Nothing is sent unless an endpoint is configured and delivery succeeds.",[2613,2614,2615],"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 .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}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":547,"searchDepth":573,"depth":573,"links":2617},[2618,2619,2623,2624],{"id":534,"depth":573,"text":535},{"id":704,"depth":573,"text":705,"children":2620},[2621,2622],{"id":1194,"depth":589,"text":1195},{"id":1329,"depth":589,"text":1330},{"id":2174,"depth":573,"text":2175},{"id":2569,"depth":573,"text":2570},"Wire @evlog\u002Ftelemetry into citty CLIs, standalone scripts, and GitHub Actions — delivery config, automatic flag capture, telemetry.set(), and debug mode.","md",[2628,2631,2632],{"label":36,"icon":39,"to":414,"color":2629,"variant":2630},"neutral","subtle",{"label":422,"icon":425,"to":423,"color":2629,"variant":2630},{"label":427,"icon":79,"to":428,"color":2629,"variant":2630},{},{"title":417,"icon":420},{"title":527,"description":2625},"oB2Z8HFQAgrgwt9VvByTiwE6WeyUAMQi5iYEWm95RU4",[2638,2640],{"title":36,"path":414,"stem":415,"description":2639,"icon":39,"children":-1},"Wide-event telemetry for CLIs and automation — evlog's one-event-per-run model for tools on user machines, with privacy-safe flags, consent, outbox, and auto-generated disclosure.",{"title":422,"path":423,"stem":424,"description":2641,"icon":425,"children":-1},"Build a server ingestion endpoint for @evlog\u002Ftelemetry — semi-public threat model, parseIngestBody validation, framework routes, idempotent storage, and rate limiting.",1785671133049]