[{"data":1,"prerenderedAt":1483},["ShallowReactive",2],{"navigation_docs":3,"-build-on-top-scenarios-tenant-aware-logging":547,"-build-on-top-scenarios-tenant-aware-logging-surround":1478},[4,35,159,201,289,446,531],{"title":5,"path":6,"stem":7,"children":8,"page":34},"Getting Started","\u002Fgetting-started","1.getting-started",[9,14,19,24,29],{"title":10,"path":11,"stem":12,"icon":13},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F1.introduction","i-lucide-info",{"title":15,"path":16,"stem":17,"icon":18},"Installation","\u002Fgetting-started\u002Finstallation","1.getting-started\u002F2.installation","i-lucide-download",{"title":20,"path":21,"stem":22,"icon":23},"Quick Start","\u002Fgetting-started\u002Fquick-start","1.getting-started\u002F3.quick-start","i-lucide-zap",{"title":25,"path":26,"stem":27,"icon":28},"Agent Skills","\u002Fgetting-started\u002Fagent-skills","1.getting-started\u002F4.agent-skills","i-lucide-sparkles",{"title":30,"path":31,"stem":32,"icon":33},"vs Other Loggers","\u002Fgetting-started\u002Fvs-other-loggers","1.getting-started\u002F5.vs-other-loggers","i-lucide-scale",false,{"title":36,"path":37,"stem":38,"children":39,"page":34},"Logging","\u002Flogging","2.logging",[40,45,50,55,60,65,70,99,127],{"title":41,"path":42,"stem":43,"icon":44},"Overview","\u002Flogging\u002Foverview","2.logging\u002F0.overview","i-lucide-list",{"title":46,"path":47,"stem":48,"icon":49},"Simple Logging","\u002Flogging\u002Fsimple-logging","2.logging\u002F1.simple-logging","i-lucide-terminal",{"title":51,"path":52,"stem":53,"icon":54},"Wide Events","\u002Flogging\u002Fwide-events","2.logging\u002F2.wide-events","i-lucide-layers",{"title":56,"path":57,"stem":58,"icon":59},"Structured Errors","\u002Flogging\u002Fstructured-errors","2.logging\u002F3.structured-errors","i-lucide-shield-alert",{"title":61,"path":62,"stem":63,"icon":64},"Catalogs","\u002Flogging\u002Fcatalogs","2.logging\u002F4.catalogs","i-lucide-book-open",{"title":66,"path":67,"stem":68,"icon":69},"Client Logging","\u002Flogging\u002Fclient-logging","2.logging\u002F5.client-logging","i-lucide-monitor",{"title":71,"icon":72,"path":73,"stem":74,"children":75,"page":34},"AI SDK","i-simple-icons-vercel","\u002Flogging\u002Fai-sdk","2.logging\u002F6.ai-sdk",[76,79,84,89,94],{"title":41,"path":77,"stem":78,"icon":44},"\u002Flogging\u002Fai-sdk\u002Foverview","2.logging\u002F6.ai-sdk\u002F01.overview",{"title":80,"path":81,"stem":82,"icon":83},"Usage","\u002Flogging\u002Fai-sdk\u002Fusage","2.logging\u002F6.ai-sdk\u002F02.usage","i-lucide-code",{"title":85,"path":86,"stem":87,"icon":88},"Options","\u002Flogging\u002Fai-sdk\u002Foptions","2.logging\u002F6.ai-sdk\u002F03.options","i-lucide-sliders",{"title":90,"path":91,"stem":92,"icon":93},"Metadata","\u002Flogging\u002Fai-sdk\u002Fmetadata","2.logging\u002F6.ai-sdk\u002F04.metadata","i-lucide-database",{"title":95,"path":96,"stem":97,"icon":98},"Telemetry","\u002Flogging\u002Fai-sdk\u002Ftelemetry","2.logging\u002F6.ai-sdk\u002F05.telemetry","i-lucide-activity",{"title":100,"icon":101,"path":102,"stem":103,"children":104,"page":34},"Better Auth","i-simple-icons-betterauth","\u002Flogging\u002Fbetter-auth","2.logging\u002F7.better-auth",[105,108,113,118,122],{"title":41,"path":106,"stem":107,"icon":44},"\u002Flogging\u002Fbetter-auth\u002Foverview","2.logging\u002F7.better-auth\u002F01.overview",{"title":109,"path":110,"stem":111,"icon":112},"Identify User","\u002Flogging\u002Fbetter-auth\u002Fidentify-user","2.logging\u002F7.better-auth\u002F02.identify-user","i-lucide-user-check",{"title":114,"path":115,"stem":116,"icon":117},"Middleware","\u002Flogging\u002Fbetter-auth\u002Fmiddleware","2.logging\u002F7.better-auth\u002F03.middleware","i-lucide-shield",{"title":119,"path":120,"stem":121,"icon":69},"Client Sync","\u002Flogging\u002Fbetter-auth\u002Fclient-sync","2.logging\u002F7.better-auth\u002F04.client-sync",{"title":123,"path":124,"stem":125,"icon":126},"Performance","\u002Flogging\u002Fbetter-auth\u002Fperformance","2.logging\u002F7.better-auth\u002F05.performance","i-lucide-gauge",{"title":128,"icon":129,"path":130,"stem":131,"children":132,"page":34},"Audit Logs","i-lucide-shield-check","\u002Flogging\u002Faudit","2.logging\u002F8.audit",[133,136,141,146,151,155],{"title":41,"path":134,"stem":135,"icon":44},"\u002Flogging\u002Faudit\u002Foverview","2.logging\u002F8.audit\u002F01.overview",{"title":137,"path":138,"stem":139,"icon":140},"Schema","\u002Flogging\u002Faudit\u002Fschema","2.logging\u002F8.audit\u002F02.schema","i-lucide-file-text",{"title":142,"path":143,"stem":144,"icon":145},"Recording","\u002Flogging\u002Faudit\u002Frecording","2.logging\u002F8.audit\u002F03.recording","i-lucide-pen-line",{"title":147,"path":148,"stem":149,"icon":150},"Drains","\u002Flogging\u002Faudit\u002Fpipeline","2.logging\u002F8.audit\u002F04.pipeline","i-lucide-link",{"title":152,"path":153,"stem":154,"icon":129},"Compliance","\u002Flogging\u002Faudit\u002Fcompliance","2.logging\u002F8.audit\u002F05.compliance",{"title":156,"path":157,"stem":158,"icon":64},"Recipes","\u002Flogging\u002Faudit\u002Frecipes","2.logging\u002F8.audit\u002F06.recipes",{"title":160,"path":161,"stem":162,"children":163,"page":34},"Core Concepts","\u002Fcore-concepts","3.core-concepts",[164,169,174,179,184,188,191,196],{"title":165,"path":166,"stem":167,"icon":168},"Lifecycle","\u002Fcore-concepts\u002Flifecycle","3.core-concepts\u002F0.lifecycle","i-lucide-arrow-right-left",{"title":170,"path":171,"stem":172,"icon":173},"Configuration","\u002Fcore-concepts\u002Fconfiguration","3.core-concepts\u002F1.configuration","i-lucide-settings",{"title":175,"path":176,"stem":177,"icon":178},"Sampling","\u002Fcore-concepts\u002Fsampling","3.core-concepts\u002F2.sampling","i-lucide-filter",{"title":180,"path":181,"stem":182,"icon":183},"Typed Fields","\u002Fcore-concepts\u002Ftyped-fields","3.core-concepts\u002F3.typed-fields","i-simple-icons-typescript",{"title":185,"path":186,"stem":187,"icon":129},"Best Practices","\u002Fcore-concepts\u002Fbest-practices","3.core-concepts\u002F4.best-practices",{"title":123,"path":189,"stem":190,"icon":126},"\u002Fcore-concepts\u002Fperformance","3.core-concepts\u002F5.performance",{"title":192,"path":193,"stem":194,"icon":195},"Vite Plugin","\u002Fcore-concepts\u002Fvite-plugin","3.core-concepts\u002F6.vite-plugin","i-custom-vite",{"title":197,"path":198,"stem":199,"icon":200},"Auto-Redaction","\u002Fcore-concepts\u002Fredaction","3.core-concepts\u002F7.redaction","i-lucide-eye-off",{"title":202,"path":203,"stem":204,"children":205,"page":34},"Frameworks","\u002Fframeworks","4.frameworks",[206,210,215,220,225,230,235,240,245,250,255,260,265,270,274,279,284],{"title":41,"path":207,"stem":208,"icon":209},"\u002Fframeworks\u002Foverview","4.frameworks\u002F00.overview","i-lucide-layout-grid",{"title":211,"path":212,"stem":213,"icon":214},"Nuxt","\u002Fframeworks\u002Fnuxt","4.frameworks\u002F01.nuxt","i-simple-icons-nuxtdotjs",{"title":216,"path":217,"stem":218,"icon":219},"Next.js","\u002Fframeworks\u002Fnextjs","4.frameworks\u002F02.nextjs","i-simple-icons-nextdotjs",{"title":221,"path":222,"stem":223,"icon":224},"SvelteKit","\u002Fframeworks\u002Fsveltekit","4.frameworks\u002F03.sveltekit","i-simple-icons-svelte",{"title":226,"path":227,"stem":228,"icon":229},"Nitro","\u002Fframeworks\u002Fnitro","4.frameworks\u002F04.nitro","i-custom-nitro",{"title":231,"path":232,"stem":233,"icon":234},"TanStack Start","\u002Fframeworks\u002Ftanstack-start","4.frameworks\u002F05.tanstack-start","i-custom-tanstack",{"title":236,"path":237,"stem":238,"icon":239},"NestJS","\u002Fframeworks\u002Fnestjs","4.frameworks\u002F06.nestjs","i-simple-icons-nestjs",{"title":241,"path":242,"stem":243,"icon":244},"Express","\u002Fframeworks\u002Fexpress","4.frameworks\u002F07.express","i-simple-icons-express",{"title":246,"path":247,"stem":248,"icon":249},"Hono","\u002Fframeworks\u002Fhono","4.frameworks\u002F08.hono","i-simple-icons-hono",{"title":251,"path":252,"stem":253,"icon":254},"Fastify","\u002Fframeworks\u002Ffastify","4.frameworks\u002F09.fastify","i-simple-icons-fastify",{"title":256,"path":257,"stem":258,"icon":259},"Elysia","\u002Fframeworks\u002Felysia","4.frameworks\u002F10.elysia","i-custom-elysia",{"title":261,"path":262,"stem":263,"icon":264},"React Router","\u002Fframeworks\u002Freact-router","4.frameworks\u002F11.react-router","i-custom-reactrouter",{"title":266,"path":267,"stem":268,"icon":269},"Cloudflare Workers","\u002Fframeworks\u002Fcloudflare-workers","4.frameworks\u002F12.cloudflare-workers","i-simple-icons-cloudflare",{"title":271,"path":272,"stem":273,"icon":183},"Standalone","\u002Fframeworks\u002Fstandalone","4.frameworks\u002F13.standalone",{"title":275,"path":276,"stem":277,"icon":278},"Astro","\u002Fframeworks\u002Fastro","4.frameworks\u002F14.astro","i-simple-icons-astro",{"title":280,"path":281,"stem":282,"icon":283},"AWS Lambda","\u002Fframeworks\u002Faws-lambda","4.frameworks\u002F16.aws-lambda","i-custom-lambda",{"title":285,"path":286,"stem":287,"icon":288},"Custom Integration","\u002Fframeworks\u002Fcustom-integration","4.frameworks\u002F17.custom-integration","i-lucide-puzzle",{"title":290,"path":291,"stem":292,"children":293,"page":34},"Build on top","\u002Fbuild-on-top","5.build-on-top",[294,297,325,346,373,400,428],{"title":41,"path":295,"stem":296,"icon":54},"\u002Fbuild-on-top\u002Foverview","5.build-on-top\u002F0.overview",{"title":298,"path":299,"stem":300,"children":301,"page":34},"Observers","\u002Fbuild-on-top\u002Fobservers","5.build-on-top\u002Fobservers",[302,306,311,316,321],{"title":41,"path":303,"stem":304,"icon":305},"\u002Fbuild-on-top\u002Fobservers\u002Foverview","5.build-on-top\u002Fobservers\u002F1.overview","i-lucide-eye",{"title":307,"path":308,"stem":309,"icon":310},"Stream API","\u002Fbuild-on-top\u002Fobservers\u002Fin-process-stream","5.build-on-top\u002Fobservers\u002F2.in-process-stream","i-lucide-radio-tower",{"title":312,"path":313,"stem":314,"icon":315},"Stream server","\u002Fbuild-on-top\u002Fobservers\u002Fstream-server","5.build-on-top\u002Fobservers\u002F3.stream-server","i-lucide-radio",{"title":317,"path":318,"stem":319,"icon":320},"FS reader","\u002Fbuild-on-top\u002Fobservers\u002Ffs-reader","5.build-on-top\u002Fobservers\u002F4.fs-reader","i-lucide-folder-search",{"title":156,"path":322,"stem":323,"icon":324},"\u002Fbuild-on-top\u002Fobservers\u002Fconsumer-recipes","5.build-on-top\u002Fobservers\u002F5.consumer-recipes","i-lucide-chef-hat",{"title":326,"path":327,"stem":328,"children":329,"page":34},"Pipeline","\u002Fbuild-on-top\u002Fpipeline","5.build-on-top\u002Fpipeline",[330,334,338,342],{"title":41,"path":331,"stem":332,"icon":333},"\u002Fbuild-on-top\u002Fpipeline\u002Foverview","5.build-on-top\u002Fpipeline\u002F1.overview","i-lucide-workflow",{"title":335,"path":336,"stem":337,"icon":288},"Plugins","\u002Fbuild-on-top\u002Fpipeline\u002Fplugins","5.build-on-top\u002Fpipeline\u002F2.plugins",{"title":339,"path":340,"stem":341,"icon":28},"Custom enrichers","\u002Fbuild-on-top\u002Fpipeline\u002Fcustom-enrichers","5.build-on-top\u002Fpipeline\u002F3.custom-enrichers",{"title":343,"path":344,"stem":345,"icon":178},"Tail sampling","\u002Fbuild-on-top\u002Fpipeline\u002Ftail-sampling","5.build-on-top\u002Fpipeline\u002F4.tail-sampling",{"title":347,"path":348,"stem":349,"children":350,"page":34},"Scenarios","\u002Fbuild-on-top\u002Fscenarios","5.build-on-top\u002Fscenarios",[351,355,359,364,368],{"title":41,"path":352,"stem":353,"icon":354},"\u002Fbuild-on-top\u002Fscenarios\u002Foverview","5.build-on-top\u002Fscenarios\u002F0.overview","i-lucide-clipboard-list",{"title":356,"path":357,"stem":358,"icon":49},"Local debugging toolkit","\u002Fbuild-on-top\u002Fscenarios\u002Flocal-debugging-toolkit","5.build-on-top\u002Fscenarios\u002F1.local-debugging-toolkit",{"title":360,"path":361,"stem":362,"icon":363},"Tenant-aware logging","\u002Fbuild-on-top\u002Fscenarios\u002Ftenant-aware-logging","5.build-on-top\u002Fscenarios\u002F2.tenant-aware-logging","i-lucide-users",{"title":365,"path":366,"stem":367,"icon":129},"Compliance audit","\u002Fbuild-on-top\u002Fscenarios\u002Fcompliance-audit","5.build-on-top\u002Fscenarios\u002F3.compliance-audit",{"title":369,"path":370,"stem":371,"icon":372},"Cross-app error vocab","\u002Fbuild-on-top\u002Fscenarios\u002Fcross-app-error-vocab","5.build-on-top\u002Fscenarios\u002F4.cross-app-error-vocab","i-lucide-book",{"title":374,"path":375,"stem":376,"children":377,"page":34},"Shared packages","\u002Fbuild-on-top\u002Fshared","5.build-on-top\u002Fshared",[378,382,386,391,395],{"title":41,"path":379,"stem":380,"icon":381},"\u002Fbuild-on-top\u002Fshared\u002Foverview","5.build-on-top\u002Fshared\u002F1.overview","i-lucide-package",{"title":383,"path":384,"stem":385,"icon":381},"Catalogs as packages","\u002Fbuild-on-top\u002Fshared\u002Fcatalogs-as-packages","5.build-on-top\u002Fshared\u002F2.catalogs-as-packages",{"title":387,"path":388,"stem":389,"icon":390},"Drains as packages","\u002Fbuild-on-top\u002Fshared\u002Fdrains-as-packages","5.build-on-top\u002Fshared\u002F3.drains-as-packages","i-lucide-package-2",{"title":392,"path":393,"stem":394,"icon":28},"Enrichers as packages","\u002Fbuild-on-top\u002Fshared\u002Fenrichers-as-packages","5.build-on-top\u002Fshared\u002F4.enrichers-as-packages",{"title":396,"path":397,"stem":398,"icon":399},"Integration as package","\u002Fbuild-on-top\u002Fshared\u002Fintegration-as-package","5.build-on-top\u002Fshared\u002F5.integration-as-package","i-lucide-package-check",{"title":401,"path":402,"stem":403,"children":404,"page":34},"Sinks","\u002Fbuild-on-top\u002Fsinks","5.build-on-top\u002Fsinks",[405,409,414,418,423],{"title":41,"path":406,"stem":407,"icon":408},"\u002Fbuild-on-top\u002Fsinks\u002Foverview","5.build-on-top\u002Fsinks\u002F1.overview","i-lucide-arrow-up-from-line",{"title":410,"path":411,"stem":412,"icon":413},"Custom drains","\u002Fbuild-on-top\u002Fsinks\u002Fcustom-drains","5.build-on-top\u002Fsinks\u002F2.custom-drains","i-lucide-code-2",{"title":415,"path":416,"stem":417,"icon":333},"Drain pipeline","\u002Fbuild-on-top\u002Fsinks\u002Fdrain-pipeline","5.build-on-top\u002Fsinks\u002F3.drain-pipeline",{"title":419,"path":420,"stem":421,"icon":422},"Identity headers","\u002Fbuild-on-top\u002Fsinks\u002Fidentity-headers","5.build-on-top\u002Fsinks\u002F4.identity-headers","i-lucide-fingerprint",{"title":424,"path":425,"stem":426,"icon":427},"Fanout","\u002Fbuild-on-top\u002Fsinks\u002Ffanout-and-multi-drain","5.build-on-top\u002Fsinks\u002F5.fanout-and-multi-drain","i-lucide-share-2",{"title":429,"path":430,"stem":431,"children":432,"page":34},"Sources","\u002Fbuild-on-top\u002Fsources","5.build-on-top\u002Fsources",[433,437,441],{"title":41,"path":434,"stem":435,"icon":436},"\u002Fbuild-on-top\u002Fsources\u002Foverview","5.build-on-top\u002Fsources\u002F1.overview","i-lucide-arrow-down-to-line",{"title":438,"path":439,"stem":440,"icon":288},"Custom framework","\u002Fbuild-on-top\u002Fsources\u002Fcustom-framework","5.build-on-top\u002Fsources\u002F2.custom-framework",{"title":442,"path":443,"stem":444,"icon":445},"Middleware toolkit","\u002Fbuild-on-top\u002Fsources\u002Fmiddleware-toolkit","5.build-on-top\u002Fsources\u002F3.middleware-toolkit","i-lucide-wrench",{"title":447,"path":448,"stem":449,"children":450,"page":34},"Adapters","\u002Fadapters","6.adapters",[451,454,494,509],{"title":41,"path":452,"stem":453,"icon":44},"\u002Fadapters\u002Foverview","6.adapters\u002F01.overview",{"title":455,"path":456,"stem":457,"children":458,"page":34},"Cloud destinations","\u002Fadapters\u002Fcloud","6.adapters\u002F02.cloud",[459,464,469,474,479,484,489],{"title":460,"path":461,"stem":462,"icon":463},"Axiom","\u002Fadapters\u002Fcloud\u002Faxiom","6.adapters\u002F02.cloud\u002F01.axiom","i-custom-axiom",{"title":465,"path":466,"stem":467,"icon":468},"OTLP","\u002Fadapters\u002Fcloud\u002Fotlp","6.adapters\u002F02.cloud\u002F02.otlp","i-simple-icons-opentelemetry",{"title":470,"path":471,"stem":472,"icon":473},"PostHog","\u002Fadapters\u002Fcloud\u002Fposthog","6.adapters\u002F02.cloud\u002F03.posthog","i-simple-icons-posthog",{"title":475,"path":476,"stem":477,"icon":478},"Sentry","\u002Fadapters\u002Fcloud\u002Fsentry","6.adapters\u002F02.cloud\u002F04.sentry","i-simple-icons-sentry",{"title":480,"path":481,"stem":482,"icon":483},"Better Stack","\u002Fadapters\u002Fcloud\u002Fbetter-stack","6.adapters\u002F02.cloud\u002F05.better-stack","i-simple-icons-betterstack",{"title":485,"path":486,"stem":487,"icon":488},"Datadog","\u002Fadapters\u002Fcloud\u002Fdatadog","6.adapters\u002F02.cloud\u002F06.datadog","i-simple-icons-datadog",{"title":490,"path":491,"stem":492,"icon":493},"HyperDX","\u002Fadapters\u002Fcloud\u002Fhyperdx","6.adapters\u002F02.cloud\u002F07.hyperdx","i-custom-hyperdx",{"title":495,"path":496,"stem":497,"children":498,"page":34},"Self-hosted","\u002Fadapters\u002Fself-hosted","6.adapters\u002F03.self-hosted",[499,504],{"title":500,"path":501,"stem":502,"icon":503},"File System","\u002Fadapters\u002Fself-hosted\u002Ffs","6.adapters\u002F03.self-hosted\u002F01.fs","i-lucide-hard-drive",{"title":505,"path":506,"stem":507,"icon":508},"NuxtHub","\u002Fadapters\u002Fself-hosted\u002Fnuxthub","6.adapters\u002F03.self-hosted\u002F02.nuxthub","i-simple-icons-nuxt",{"title":510,"path":511,"stem":512,"children":513,"page":34},"Building blocks","\u002Fadapters\u002Fbuilding-blocks","6.adapters\u002F04.building-blocks",[514,517,522,526],{"title":326,"path":515,"stem":516,"icon":333},"\u002Fadapters\u002Fbuilding-blocks\u002Fpipeline","6.adapters\u002F04.building-blocks\u002F01.pipeline",{"title":518,"path":519,"stem":520,"icon":521},"HTTP","\u002Fadapters\u002Fbuilding-blocks\u002Fhttp","6.adapters\u002F04.building-blocks\u002F02.http","i-lucide-globe",{"title":523,"path":524,"stem":525,"icon":83},"Custom Adapters","\u002Fadapters\u002Fbuilding-blocks\u002Fcustom","6.adapters\u002F04.building-blocks\u002F03.custom",{"title":527,"path":528,"stem":529,"icon":530},"Toolkit","\u002Fadapters\u002Fbuilding-blocks\u002Ftoolkit","6.adapters\u002F04.building-blocks\u002F04.toolkit","i-lucide-blocks",{"title":532,"path":533,"stem":534,"children":535,"page":34},"Enrichers","\u002Fenrichers","7.enrichers",[536,539,543],{"title":41,"path":537,"stem":538,"icon":28},"\u002Fenrichers\u002Foverview","7.enrichers\u002F1.overview",{"title":540,"path":541,"stem":542,"icon":288},"Built-in","\u002Fenrichers\u002Fbuilt-in","7.enrichers\u002F2.built-in",{"title":544,"path":545,"stem":546,"icon":83},"Custom","\u002Fenrichers\u002Fcustom","7.enrichers\u002F3.custom",{"id":548,"title":360,"body":549,"description":1471,"extension":1472,"links":1473,"meta":1474,"navigation":1475,"path":361,"seo":1476,"stem":362,"__hash__":1477},"docs\u002F5.build-on-top\u002Fscenarios\u002F2.tenant-aware-logging.md",{"type":550,"value":551,"toc":1459},"minimark",[552,557,566,588,595,599,604,611,1141,1149,1258,1262,1345,1356,1360,1388,1392,1425,1429,1455],[553,554,556],"h2",{"id":555},"the-problem","The problem",[558,559,560,561,565],"p",{},"You run a multi-tenant app. Every request is \"for\" a specific tenant (header, JWT claim, subdomain). You want ",[562,563,564],"strong",{},"every"," wide event from a tenant's request to carry their id, so you can:",[567,568,569,573,576],"ul",{},[570,571,572],"li",{},"Filter logs by tenant when debugging a customer issue",[570,574,575],{},"Group analytics by tenant",[570,577,578,579,583,584,587],{},"Apply tail sampling differently per tier (",[580,581,582],"code",{},"enterprise"," always kept, ",[580,585,586],{},"free"," heavily sampled)",[558,589,590,591,594],{},"You don't want to add ",[580,592,593],{},"logger.set({ tenant: { id } })"," at every handler — error-prone.",[553,596,598],{"id":597},"the-full-code","The full code",[600,601,603],"h3",{"id":602},"_1-the-plugin","1. The plugin",[558,605,606,607,610],{},"A single plugin handles three concerns: extract the id, attach it on ",[580,608,609],{},"onRequestStart",", force-keep enterprise errors via tail sampling.",[612,613,619],"pre",{"className":614,"code":615,"filename":616,"language":617,"meta":618,"style":618},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import { definePlugin, getGlobalPluginRunner } from 'evlog\u002Ftoolkit'\n\ninterface TenantPlanMap {\n  [id: string]: 'free' | 'pro' | 'enterprise'\n}\n\n\u002F\u002F In a real app this would come from a cache \u002F DB lookup.\n\u002F\u002F Keeping it inline for the recipe.\nconst TENANT_PLANS: TenantPlanMap = {\n  acme: 'enterprise',\n  pied_piper: 'pro',\n}\n\nexport default definePlugin({\n  name: 'tenant',\n  onRequestStart({ logger, headers }) {\n    const tenantId = headers?.['x-tenant-id']\n    if (!tenantId) return\n\n    const plan = TENANT_PLANS[tenantId] ?? 'free'\n    logger.set({ tenant: { id: tenantId, plan } })\n  },\n  keep(ctx) {\n    \u002F\u002F Always keep errors from enterprise tenants\n    if (ctx.context.tenant?.plan === 'enterprise' && ctx.status >= 500) {\n      ctx.shouldKeep = true\n    }\n  },\n})\n\n\u002F\u002F Register on app boot\ngetGlobalPluginRunner().add(plugin)\n","server\u002Fplugins\u002Fevlog-tenant.ts","ts","",[580,620,621,660,667,681,727,733,738,745,751,769,787,803,808,813,831,848,870,899,920,925,953,995,1001,1017,1023,1077,1094,1100,1105,1113,1118,1124],{"__ignoreMap":618},[622,623,626,630,634,638,641,644,647,650,653,657],"span",{"class":624,"line":625},"line",1,[622,627,629],{"class":628},"s7zQu","import",[622,631,633],{"class":632},"sMK4o"," {",[622,635,637],{"class":636},"sTEyZ"," definePlugin",[622,639,640],{"class":632},",",[622,642,643],{"class":636}," getGlobalPluginRunner",[622,645,646],{"class":632}," }",[622,648,649],{"class":628}," from",[622,651,652],{"class":632}," '",[622,654,656],{"class":655},"sfazB","evlog\u002Ftoolkit",[622,658,659],{"class":632},"'\n",[622,661,663],{"class":624,"line":662},2,[622,664,666],{"emptyLinePlaceholder":665},true,"\n",[622,668,670,674,678],{"class":624,"line":669},3,[622,671,673],{"class":672},"spNyl","interface",[622,675,677],{"class":676},"sBMFI"," TenantPlanMap",[622,679,680],{"class":632}," {\n",[622,682,684,687,691,694,697,700,702,704,706,709,712,714,717,719,721,723,725],{"class":624,"line":683},4,[622,685,686],{"class":636},"  [",[622,688,690],{"class":689},"sHdIc","id",[622,692,693],{"class":632},":",[622,695,696],{"class":676}," string",[622,698,699],{"class":636},"]",[622,701,693],{"class":632},[622,703,652],{"class":632},[622,705,586],{"class":655},[622,707,708],{"class":632},"'",[622,710,711],{"class":632}," |",[622,713,652],{"class":632},[622,715,716],{"class":655},"pro",[622,718,708],{"class":632},[622,720,711],{"class":632},[622,722,652],{"class":632},[622,724,582],{"class":655},[622,726,659],{"class":632},[622,728,730],{"class":624,"line":729},5,[622,731,732],{"class":632},"}\n",[622,734,736],{"class":624,"line":735},6,[622,737,666],{"emptyLinePlaceholder":665},[622,739,741],{"class":624,"line":740},7,[622,742,744],{"class":743},"sHwdD","\u002F\u002F In a real app this would come from a cache \u002F DB lookup.\n",[622,746,748],{"class":624,"line":747},8,[622,749,750],{"class":743},"\u002F\u002F Keeping it inline for the recipe.\n",[622,752,754,757,760,762,764,767],{"class":624,"line":753},9,[622,755,756],{"class":672},"const",[622,758,759],{"class":636}," TENANT_PLANS",[622,761,693],{"class":632},[622,763,677],{"class":676},[622,765,766],{"class":632}," =",[622,768,680],{"class":632},[622,770,772,776,778,780,782,784],{"class":624,"line":771},10,[622,773,775],{"class":774},"swJcz","  acme",[622,777,693],{"class":632},[622,779,652],{"class":632},[622,781,582],{"class":655},[622,783,708],{"class":632},[622,785,786],{"class":632},",\n",[622,788,790,793,795,797,799,801],{"class":624,"line":789},11,[622,791,792],{"class":774},"  pied_piper",[622,794,693],{"class":632},[622,796,652],{"class":632},[622,798,716],{"class":655},[622,800,708],{"class":632},[622,802,786],{"class":632},[622,804,806],{"class":624,"line":805},12,[622,807,732],{"class":632},[622,809,811],{"class":624,"line":810},13,[622,812,666],{"emptyLinePlaceholder":665},[622,814,816,819,822,825,828],{"class":624,"line":815},14,[622,817,818],{"class":628},"export",[622,820,821],{"class":628}," default",[622,823,637],{"class":824},"s2Zo4",[622,826,827],{"class":636},"(",[622,829,830],{"class":632},"{\n",[622,832,834,837,839,841,844,846],{"class":624,"line":833},15,[622,835,836],{"class":774},"  name",[622,838,693],{"class":632},[622,840,652],{"class":632},[622,842,843],{"class":655},"tenant",[622,845,708],{"class":632},[622,847,786],{"class":632},[622,849,851,854,857,860,862,865,868],{"class":624,"line":850},16,[622,852,853],{"class":774},"  onRequestStart",[622,855,856],{"class":632},"({",[622,858,859],{"class":689}," logger",[622,861,640],{"class":632},[622,863,864],{"class":689}," headers",[622,866,867],{"class":632}," })",[622,869,680],{"class":632},[622,871,873,876,879,881,883,886,889,891,894,896],{"class":624,"line":872},17,[622,874,875],{"class":672},"    const",[622,877,878],{"class":636}," tenantId",[622,880,766],{"class":632},[622,882,864],{"class":636},[622,884,885],{"class":632},"?.",[622,887,888],{"class":774},"[",[622,890,708],{"class":632},[622,892,893],{"class":655},"x-tenant-id",[622,895,708],{"class":632},[622,897,898],{"class":774},"]\n",[622,900,902,905,908,911,914,917],{"class":624,"line":901},18,[622,903,904],{"class":628},"    if",[622,906,907],{"class":774}," (",[622,909,910],{"class":632},"!",[622,912,913],{"class":636},"tenantId",[622,915,916],{"class":774},") ",[622,918,919],{"class":628},"return\n",[622,921,923],{"class":624,"line":922},19,[622,924,666],{"emptyLinePlaceholder":665},[622,926,928,930,933,935,937,939,941,944,947,949,951],{"class":624,"line":927},20,[622,929,875],{"class":672},[622,931,932],{"class":636}," plan",[622,934,766],{"class":632},[622,936,759],{"class":636},[622,938,888],{"class":774},[622,940,913],{"class":636},[622,942,943],{"class":774},"] ",[622,945,946],{"class":632},"??",[622,948,652],{"class":632},[622,950,586],{"class":655},[622,952,659],{"class":632},[622,954,956,959,962,965,967,970,973,975,977,980,982,984,986,988,990,992],{"class":624,"line":955},21,[622,957,958],{"class":636},"    logger",[622,960,961],{"class":632},".",[622,963,964],{"class":824},"set",[622,966,827],{"class":774},[622,968,969],{"class":632},"{",[622,971,972],{"class":774}," tenant",[622,974,693],{"class":632},[622,976,633],{"class":632},[622,978,979],{"class":774}," id",[622,981,693],{"class":632},[622,983,878],{"class":636},[622,985,640],{"class":632},[622,987,932],{"class":636},[622,989,646],{"class":632},[622,991,646],{"class":632},[622,993,994],{"class":774},")\n",[622,996,998],{"class":624,"line":997},22,[622,999,1000],{"class":632},"  },\n",[622,1002,1004,1007,1009,1012,1015],{"class":624,"line":1003},23,[622,1005,1006],{"class":774},"  keep",[622,1008,827],{"class":632},[622,1010,1011],{"class":689},"ctx",[622,1013,1014],{"class":632},")",[622,1016,680],{"class":632},[622,1018,1020],{"class":624,"line":1019},24,[622,1021,1022],{"class":743},"    \u002F\u002F Always keep errors from enterprise tenants\n",[622,1024,1026,1028,1030,1032,1034,1037,1039,1041,1043,1046,1049,1051,1053,1055,1058,1061,1063,1066,1069,1073,1075],{"class":624,"line":1025},25,[622,1027,904],{"class":628},[622,1029,907],{"class":774},[622,1031,1011],{"class":636},[622,1033,961],{"class":632},[622,1035,1036],{"class":636},"context",[622,1038,961],{"class":632},[622,1040,843],{"class":636},[622,1042,885],{"class":632},[622,1044,1045],{"class":636},"plan",[622,1047,1048],{"class":632}," ===",[622,1050,652],{"class":632},[622,1052,582],{"class":655},[622,1054,708],{"class":632},[622,1056,1057],{"class":632}," &&",[622,1059,1060],{"class":636}," ctx",[622,1062,961],{"class":632},[622,1064,1065],{"class":636},"status",[622,1067,1068],{"class":632}," >=",[622,1070,1072],{"class":1071},"sbssI"," 500",[622,1074,916],{"class":774},[622,1076,830],{"class":632},[622,1078,1080,1083,1085,1088,1090],{"class":624,"line":1079},26,[622,1081,1082],{"class":636},"      ctx",[622,1084,961],{"class":632},[622,1086,1087],{"class":636},"shouldKeep",[622,1089,766],{"class":632},[622,1091,1093],{"class":1092},"sfNiH"," true\n",[622,1095,1097],{"class":624,"line":1096},27,[622,1098,1099],{"class":632},"    }\n",[622,1101,1103],{"class":624,"line":1102},28,[622,1104,1000],{"class":632},[622,1106,1108,1111],{"class":624,"line":1107},29,[622,1109,1110],{"class":632},"}",[622,1112,994],{"class":636},[622,1114,1116],{"class":624,"line":1115},30,[622,1117,666],{"emptyLinePlaceholder":665},[622,1119,1121],{"class":624,"line":1120},31,[622,1122,1123],{"class":743},"\u002F\u002F Register on app boot\n",[622,1125,1127,1130,1133,1135,1138],{"class":624,"line":1126},32,[622,1128,1129],{"class":824},"getGlobalPluginRunner",[622,1131,1132],{"class":636},"()",[622,1134,961],{"class":632},[622,1136,1137],{"class":824},"add",[622,1139,1140],{"class":636},"(plugin)\n",[600,1142,1144,1145,1148],{"id":1143},"_2-type-augmentation-so-loggerset-tenant-autocompletes","2. Type augmentation (so ",[580,1146,1147],{},"logger.set({ tenant })"," autocompletes)",[612,1150,1153],{"className":614,"code":1151,"filename":1152,"language":617,"meta":618,"style":618},"import 'evlog'\n\ndeclare module 'evlog' {\n  interface BaseWideEvent {\n    tenant?: {\n      id: string\n      plan: 'free' | 'pro' | 'enterprise'\n    }\n  }\n}\n","types\u002Fevlog.d.ts",[580,1154,1155,1166,1170,1186,1196,1206,1216,1245,1249,1254],{"__ignoreMap":618},[622,1156,1157,1159,1161,1164],{"class":624,"line":625},[622,1158,629],{"class":628},[622,1160,652],{"class":632},[622,1162,1163],{"class":655},"evlog",[622,1165,659],{"class":632},[622,1167,1168],{"class":624,"line":662},[622,1169,666],{"emptyLinePlaceholder":665},[622,1171,1172,1175,1178,1180,1182,1184],{"class":624,"line":669},[622,1173,1174],{"class":672},"declare",[622,1176,1177],{"class":672}," module",[622,1179,652],{"class":632},[622,1181,1163],{"class":655},[622,1183,708],{"class":632},[622,1185,680],{"class":632},[622,1187,1188,1191,1194],{"class":624,"line":683},[622,1189,1190],{"class":672},"  interface",[622,1192,1193],{"class":676}," BaseWideEvent",[622,1195,680],{"class":632},[622,1197,1198,1201,1204],{"class":624,"line":729},[622,1199,1200],{"class":774},"    tenant",[622,1202,1203],{"class":632},"?:",[622,1205,680],{"class":632},[622,1207,1208,1211,1213],{"class":624,"line":735},[622,1209,1210],{"class":774},"      id",[622,1212,693],{"class":632},[622,1214,1215],{"class":676}," string\n",[622,1217,1218,1221,1223,1225,1227,1229,1231,1233,1235,1237,1239,1241,1243],{"class":624,"line":740},[622,1219,1220],{"class":774},"      plan",[622,1222,693],{"class":632},[622,1224,652],{"class":632},[622,1226,586],{"class":655},[622,1228,708],{"class":632},[622,1230,711],{"class":632},[622,1232,652],{"class":632},[622,1234,716],{"class":655},[622,1236,708],{"class":632},[622,1238,711],{"class":632},[622,1240,652],{"class":632},[622,1242,582],{"class":655},[622,1244,659],{"class":632},[622,1246,1247],{"class":624,"line":747},[622,1248,1099],{"class":632},[622,1250,1251],{"class":624,"line":753},[622,1252,1253],{"class":632},"  }\n",[622,1255,1256],{"class":624,"line":771},[622,1257,732],{"class":632},[600,1259,1261],{"id":1260},"_3-adjust-sampling-in-your-evlog-config","3. Adjust sampling in your evlog config",[612,1263,1266],{"className":614,"code":1264,"filename":1265,"language":617,"meta":618,"style":618},"evlog: {\n  sampling: {\n    rates: { info: 5 },        \u002F\u002F aggressive: 5% of info events\n    keep: [{ status: 400 }],   \u002F\u002F keep 4xx + 5xx (the plugin force-keeps enterprise 5xx)\n  },\n}\n","nuxt.config.ts",[580,1267,1268,1276,1285,1308,1337,1341],{"__ignoreMap":618},[622,1269,1270,1272,1274],{"class":624,"line":625},[622,1271,1163],{"class":676},[622,1273,693],{"class":632},[622,1275,680],{"class":632},[622,1277,1278,1281,1283],{"class":624,"line":662},[622,1279,1280],{"class":676},"  sampling",[622,1282,693],{"class":632},[622,1284,680],{"class":632},[622,1286,1287,1290,1292,1294,1297,1299,1302,1305],{"class":624,"line":669},[622,1288,1289],{"class":676},"    rates",[622,1291,693],{"class":632},[622,1293,633],{"class":632},[622,1295,1296],{"class":676}," info",[622,1298,693],{"class":632},[622,1300,1301],{"class":1071}," 5",[622,1303,1304],{"class":632}," },",[622,1306,1307],{"class":743},"        \u002F\u002F aggressive: 5% of info events\n",[622,1309,1310,1313,1315,1318,1320,1323,1325,1328,1330,1332,1334],{"class":624,"line":683},[622,1311,1312],{"class":676},"    keep",[622,1314,693],{"class":632},[622,1316,1317],{"class":774}," [",[622,1319,969],{"class":632},[622,1321,1322],{"class":774}," status",[622,1324,693],{"class":632},[622,1326,1327],{"class":1071}," 400",[622,1329,646],{"class":632},[622,1331,699],{"class":774},[622,1333,640],{"class":632},[622,1335,1336],{"class":743},"   \u002F\u002F keep 4xx + 5xx (the plugin force-keeps enterprise 5xx)\n",[622,1338,1339],{"class":624,"line":729},[622,1340,1000],{"class":632},[622,1342,1343],{"class":624,"line":735},[622,1344,732],{"class":632},[558,1346,1347,1348,1351,1352,1355],{},"That's it. Every wide event from a request with ",[580,1349,1350],{},"x-tenant-id: acme"," carries ",[580,1353,1354],{},"tenant: { id: 'acme', plan: 'enterprise' }",", and 5xx from enterprise tenants are always recorded regardless of sampling.",[553,1357,1359],{"id":1358},"what-it-gives-you","What it gives you",[567,1361,1362,1372,1382],{},[570,1363,1364,1367,1368,1371],{},[562,1365,1366],{},"Zero per-call-site code"," — handlers just call ",[580,1369,1370],{},"logger.error(err)"," or whatever, the tenant context rides along automatically",[570,1373,1374,1377,1378,1381],{},[562,1375,1376],{},"Type-safe"," — ",[580,1379,1380],{},"logger.set({ tenant: { ... } })"," autocompletes the right shape",[570,1383,1384,1387],{},[562,1385,1386],{},"Compatible with sampling"," — heavy sampling for free tier, full retention for enterprise errors",[553,1389,1391],{"id":1390},"variants","Variants",[567,1393,1394,1407,1416],{},[570,1395,1396,1399,1400,1403,1404,1406],{},[562,1397,1398],{},"JWT claim instead of header"," — read ",[580,1401,1402],{},"getRequestHeader('authorization')"," in ",[580,1405,609],{},", decode, extract claim",[570,1408,1409,1399,1412,1415],{},[562,1410,1411],{},"Subdomain-based tenant",[580,1413,1414],{},"getRequestHost()",", parse the leftmost label",[570,1417,1418,1421,1422,1424],{},[562,1419,1420],{},"Resolved against a DB"," — make ",[580,1423,609],{}," async (note: blocks the request until resolved; cache aggressively)",[553,1426,1428],{"id":1427},"where-to-go-next","Where to go next",[567,1430,1431,1437,1446],{},[570,1432,1433,1436],{},[1434,1435,335],"a",{"href":336}," — the canonical contract used here",[570,1438,1439,1441,1442,1445],{},[1434,1440,343],{"href":344}," — the ",[580,1443,1444],{},"keep"," hook in detail",[570,1447,1448,1450,1451,1454],{},[1434,1449,392],{"href":393}," — publish this as ",[580,1452,1453],{},"@my-org\u002Fevlog-tenant-enricher"," for use across services",[1456,1457,1458],"style",{},"html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}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 .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 .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .sfNiH, html code.shiki .sfNiH{--shiki-light:#FF5370;--shiki-default:#FF9CAC;--shiki-dark:#FF9CAC}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);}",{"title":618,"searchDepth":662,"depth":662,"links":1460},[1461,1462,1468,1469,1470],{"id":555,"depth":662,"text":556},{"id":597,"depth":662,"text":598,"children":1463},[1464,1465,1467],{"id":602,"depth":669,"text":603},{"id":1143,"depth":669,"text":1466},"2. Type augmentation (so logger.set({ tenant }) autocompletes)",{"id":1260,"depth":669,"text":1261},{"id":1358,"depth":662,"text":1359},{"id":1390,"depth":662,"text":1391},{"id":1427,"depth":662,"text":1428},"Every wide event automatically carries the right tenant id, drawn from the request — no per-call-site setup, no risk of forgetting.","md",null,{},{"title":360,"icon":363},{"title":360,"description":1471},"xzalWqiqpYXKcqHO8j5Nx3DIUkkZzHg4rKeYHIg3lp0",[1479,1481],{"title":356,"path":357,"stem":358,"description":1480,"icon":49,"children":-1},"A live event panel + replay-from-disk you can drop into any app — combines the stream server, the fs reader, and a tiny consumer page.",{"title":365,"path":366,"stem":367,"description":1482,"icon":129,"children":-1},"A tamper-evident audit pipeline that ships to your secure backend — typed actions via an audit catalog, signed chain optional.",1778338250170]