[{"data":1,"prerenderedAt":3360},["ShallowReactive",2],{"navigation_docs":3,"-integrate-frameworks-orpc":510,"-integrate-frameworks-orpc-surround":3355},[4,30,80,123,293,425,480],{"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],{"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,"children":127,"page":29},"Integrate","\u002Fintegrate","4.integrate",[128,132,205],{"title":36,"path":129,"stem":130,"icon":131},"\u002Fintegrate\u002Foverview","4.integrate\u002F0.overview","i-lucide-plug",{"title":133,"path":134,"stem":135,"children":136,"page":29},"Adapters","\u002Fintegrate\u002Fadapters","4.integrate\u002Fadapters",[137,140,180],{"title":36,"path":138,"stem":139,"icon":39},"\u002Fintegrate\u002Fadapters\u002Foverview","4.integrate\u002Fadapters\u002F01.overview",{"title":141,"path":142,"stem":143,"children":144,"page":29},"Cloud","\u002Fintegrate\u002Fadapters\u002Fcloud","4.integrate\u002Fadapters\u002Fcloud",[145,150,155,160,165,170,175],{"title":146,"path":147,"stem":148,"icon":149},"Axiom","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Faxiom","4.integrate\u002Fadapters\u002Fcloud\u002F01.axiom","i-custom-axiom",{"title":151,"path":152,"stem":153,"icon":154},"OTLP","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fotlp","4.integrate\u002Fadapters\u002Fcloud\u002F02.otlp","i-simple-icons-opentelemetry",{"title":156,"path":157,"stem":158,"icon":159},"PostHog","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fposthog","4.integrate\u002Fadapters\u002Fcloud\u002F03.posthog","i-simple-icons-posthog",{"title":161,"path":162,"stem":163,"icon":164},"Sentry","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fsentry","4.integrate\u002Fadapters\u002Fcloud\u002F04.sentry","i-simple-icons-sentry",{"title":166,"path":167,"stem":168,"icon":169},"Better Stack","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fbetter-stack","4.integrate\u002Fadapters\u002Fcloud\u002F05.better-stack","i-simple-icons-betterstack",{"title":171,"path":172,"stem":173,"icon":174},"Datadog","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fdatadog","4.integrate\u002Fadapters\u002Fcloud\u002F06.datadog","i-simple-icons-datadog",{"title":176,"path":177,"stem":178,"icon":179},"HyperDX","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fhyperdx","4.integrate\u002Fadapters\u002Fcloud\u002F07.hyperdx","i-custom-hyperdx",{"title":181,"path":182,"stem":183,"children":184,"page":29},"Self-Hosted","\u002Fintegrate\u002Fadapters\u002Fself-hosted","4.integrate\u002Fadapters\u002Fself-hosted",[185,190,195,200],{"title":186,"path":187,"stem":188,"icon":189},"File System","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Ffs","4.integrate\u002Fadapters\u002Fself-hosted\u002F01.fs","i-lucide-hard-drive",{"title":191,"path":192,"stem":193,"icon":194},"NuxtHub","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Fnuxthub","4.integrate\u002Fadapters\u002Fself-hosted\u002F02.nuxthub","i-simple-icons-nuxt",{"title":196,"path":197,"stem":198,"icon":199},"Memory","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Fmemory","4.integrate\u002Fadapters\u002Fself-hosted\u002F03.memory","i-lucide-cpu",{"title":201,"path":202,"stem":203,"icon":204},"Grafana Loki","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Floki","4.integrate\u002Fadapters\u002Fself-hosted\u002F04.loki","i-simple-icons-grafana",{"title":206,"path":207,"stem":208,"children":209,"page":29},"Frameworks","\u002Fintegrate\u002Fframeworks","4.integrate\u002Fframeworks",[210,214,219,224,229,234,239,244,249,254,259,264,269,274,278,283,288],{"title":36,"path":211,"stem":212,"icon":213},"\u002Fintegrate\u002Fframeworks\u002Foverview","4.integrate\u002Fframeworks\u002F00.overview","i-lucide-layout-grid",{"title":215,"path":216,"stem":217,"icon":218},"Nuxt","\u002Fintegrate\u002Fframeworks\u002Fnuxt","4.integrate\u002Fframeworks\u002F01.nuxt","i-simple-icons-nuxtdotjs",{"title":220,"path":221,"stem":222,"icon":223},"Next.js","\u002Fintegrate\u002Fframeworks\u002Fnextjs","4.integrate\u002Fframeworks\u002F02.nextjs","i-simple-icons-nextdotjs",{"title":225,"path":226,"stem":227,"icon":228},"SvelteKit","\u002Fintegrate\u002Fframeworks\u002Fsveltekit","4.integrate\u002Fframeworks\u002F03.sveltekit","i-simple-icons-svelte",{"title":230,"path":231,"stem":232,"icon":233},"Nitro","\u002Fintegrate\u002Fframeworks\u002Fnitro","4.integrate\u002Fframeworks\u002F04.nitro","i-custom-nitro",{"title":235,"path":236,"stem":237,"icon":238},"TanStack Start","\u002Fintegrate\u002Fframeworks\u002Ftanstack-start","4.integrate\u002Fframeworks\u002F05.tanstack-start","i-custom-tanstack",{"title":240,"path":241,"stem":242,"icon":243},"NestJS","\u002Fintegrate\u002Fframeworks\u002Fnestjs","4.integrate\u002Fframeworks\u002F06.nestjs","i-simple-icons-nestjs",{"title":245,"path":246,"stem":247,"icon":248},"Express","\u002Fintegrate\u002Fframeworks\u002Fexpress","4.integrate\u002Fframeworks\u002F07.express","i-simple-icons-express",{"title":250,"path":251,"stem":252,"icon":253},"Hono","\u002Fintegrate\u002Fframeworks\u002Fhono","4.integrate\u002Fframeworks\u002F08.hono","i-simple-icons-hono",{"title":255,"path":256,"stem":257,"icon":258},"Fastify","\u002Fintegrate\u002Fframeworks\u002Ffastify","4.integrate\u002Fframeworks\u002F09.fastify","i-simple-icons-fastify",{"title":260,"path":261,"stem":262,"icon":263},"Elysia","\u002Fintegrate\u002Fframeworks\u002Felysia","4.integrate\u002Fframeworks\u002F10.elysia","i-custom-elysia",{"title":265,"path":266,"stem":267,"icon":268},"React Router","\u002Fintegrate\u002Fframeworks\u002Freact-router","4.integrate\u002Fframeworks\u002F11.react-router","i-custom-reactrouter",{"title":270,"path":271,"stem":272,"icon":273},"Cloudflare Workers","\u002Fintegrate\u002Fframeworks\u002Fcloudflare-workers","4.integrate\u002Fframeworks\u002F12.cloudflare-workers","i-simple-icons-cloudflare",{"title":275,"path":276,"stem":277,"icon":74},"Standalone","\u002Fintegrate\u002Fframeworks\u002Fstandalone","4.integrate\u002Fframeworks\u002F13.standalone",{"title":279,"path":280,"stem":281,"icon":282},"Astro","\u002Fintegrate\u002Fframeworks\u002Fastro","4.integrate\u002Fframeworks\u002F14.astro","i-simple-icons-astro",{"title":284,"path":285,"stem":286,"icon":287},"oRPC","\u002Fintegrate\u002Fframeworks\u002Forpc","4.integrate\u002Fframeworks\u002F15.orpc","i-lucide-network",{"title":289,"path":290,"stem":291,"icon":292},"AWS Lambda","\u002Fintegrate\u002Fframeworks\u002Faws-lambda","4.integrate\u002Fframeworks\u002F16.aws-lambda","i-custom-lambda",{"title":294,"path":295,"stem":296,"children":297,"page":29},"Use Cases","\u002Fuse-cases","5.use-cases",[298,301,306,335,362,394,415,420],{"title":36,"path":299,"stem":300,"icon":102},"\u002Fuse-cases\u002Foverview","5.use-cases\u002F0.overview",{"title":302,"path":303,"stem":304,"icon":305},"Client Logging","\u002Fuse-cases\u002Fclient-logging","5.use-cases\u002F1.client-logging","i-lucide-monitor",{"title":307,"icon":308,"path":309,"stem":310,"children":311,"page":29},"AI SDK","i-simple-icons-vercel","\u002Fuse-cases\u002Fai-sdk","5.use-cases\u002F2.ai-sdk",[312,315,320,325,330],{"title":36,"path":313,"stem":314,"icon":39},"\u002Fuse-cases\u002Fai-sdk\u002Foverview","5.use-cases\u002F2.ai-sdk\u002F01.overview",{"title":316,"path":317,"stem":318,"icon":319},"Usage","\u002Fuse-cases\u002Fai-sdk\u002Fusage","5.use-cases\u002F2.ai-sdk\u002F02.usage","i-lucide-code",{"title":321,"path":322,"stem":323,"icon":324},"Options","\u002Fuse-cases\u002Fai-sdk\u002Foptions","5.use-cases\u002F2.ai-sdk\u002F03.options","i-lucide-sliders",{"title":326,"path":327,"stem":328,"icon":329},"Metadata","\u002Fuse-cases\u002Fai-sdk\u002Fmetadata","5.use-cases\u002F2.ai-sdk\u002F04.metadata","i-lucide-database",{"title":331,"path":332,"stem":333,"icon":334},"Telemetry","\u002Fuse-cases\u002Fai-sdk\u002Ftelemetry","5.use-cases\u002F2.ai-sdk\u002F05.telemetry","i-lucide-activity",{"title":336,"icon":337,"path":338,"stem":339,"children":340,"page":29},"Better Auth","i-simple-icons-betterauth","\u002Fuse-cases\u002Fbetter-auth","5.use-cases\u002F3.better-auth",[341,344,349,354,358],{"title":36,"path":342,"stem":343,"icon":39},"\u002Fuse-cases\u002Fbetter-auth\u002Foverview","5.use-cases\u002F3.better-auth\u002F01.overview",{"title":345,"path":346,"stem":347,"icon":348},"Identify User","\u002Fuse-cases\u002Fbetter-auth\u002Fidentify-user","5.use-cases\u002F3.better-auth\u002F02.identify-user","i-lucide-user-check",{"title":350,"path":351,"stem":352,"icon":353},"Middleware","\u002Fuse-cases\u002Fbetter-auth\u002Fmiddleware","5.use-cases\u002F3.better-auth\u002F03.middleware","i-lucide-shield",{"title":355,"path":356,"stem":357,"icon":305},"Client Sync","\u002Fuse-cases\u002Fbetter-auth\u002Fclient-sync","5.use-cases\u002F3.better-auth\u002F04.client-sync",{"title":359,"path":360,"stem":361,"icon":107},"Performance","\u002Fuse-cases\u002Fbetter-auth\u002Fperformance","5.use-cases\u002F3.better-auth\u002F05.performance",{"title":363,"icon":364,"path":365,"stem":366,"children":367,"page":29},"Audit Logs","i-lucide-shield-check","\u002Fuse-cases\u002Faudit","5.use-cases\u002F4.audit",[368,371,376,381,386,390],{"title":36,"path":369,"stem":370,"icon":39},"\u002Fuse-cases\u002Faudit\u002Foverview","5.use-cases\u002F4.audit\u002F01.overview",{"title":372,"path":373,"stem":374,"icon":375},"Schema","\u002Fuse-cases\u002Faudit\u002Fschema","5.use-cases\u002F4.audit\u002F02.schema","i-lucide-file-text",{"title":377,"path":378,"stem":379,"icon":380},"Recording","\u002Fuse-cases\u002Faudit\u002Frecording","5.use-cases\u002F4.audit\u002F03.recording","i-lucide-pen-line",{"title":382,"path":383,"stem":384,"icon":385},"Drains","\u002Fuse-cases\u002Faudit\u002Fpipeline","5.use-cases\u002F4.audit\u002F04.pipeline","i-lucide-link",{"title":387,"path":388,"stem":389,"icon":364},"Compliance","\u002Fuse-cases\u002Faudit\u002Fcompliance","5.use-cases\u002F4.audit\u002F05.compliance",{"title":391,"path":392,"stem":393,"icon":79},"Recipes","\u002Fuse-cases\u002Faudit\u002Frecipes","5.use-cases\u002F4.audit\u002F06.recipes",{"title":331,"icon":107,"path":395,"stem":396,"children":397,"page":29},"\u002Fuse-cases\u002Ftelemetry","5.use-cases\u002F4.telemetry",[398,401,406,411],{"title":36,"path":399,"stem":400,"icon":39},"\u002Fuse-cases\u002Ftelemetry\u002Foverview","5.use-cases\u002F4.telemetry\u002F01.overview",{"title":402,"path":403,"stem":404,"icon":405},"Setup","\u002Fuse-cases\u002Ftelemetry\u002Fsetup","5.use-cases\u002F4.telemetry\u002F02.setup","i-lucide-wrench",{"title":407,"path":408,"stem":409,"icon":410},"Ingest","\u002Fuse-cases\u002Ftelemetry\u002Fingest","5.use-cases\u002F4.telemetry\u002F03.ingest","i-lucide-server",{"title":412,"path":413,"stem":414,"icon":79},"Reference","\u002Fuse-cases\u002Ftelemetry\u002Freference","5.use-cases\u002F4.telemetry\u002F04.reference",{"title":416,"path":417,"stem":418,"icon":419},"Enrichers","\u002Fuse-cases\u002Fenrichers","5.use-cases\u002F5.enrichers","i-lucide-sparkles",{"title":421,"path":422,"stem":423,"icon":424},"eve","\u002Fuse-cases\u002Feve","5.use-cases\u002F5.eve","i-custom-eve",{"title":426,"path":427,"stem":428,"children":429,"page":29},"Extend","\u002Fextend","6.extend",[430,434,439,444,449,453,457,461,465,470,475],{"title":36,"path":431,"stem":432,"icon":433},"\u002Fextend\u002Foverview","6.extend\u002F0.overview","i-lucide-blocks",{"title":435,"path":436,"stem":437,"icon":438},"Stream","\u002Fextend\u002Fstream","6.extend\u002F1.stream","i-lucide-radio-tower",{"title":440,"path":441,"stem":442,"icon":443},"Custom framework","\u002Fextend\u002Fcustom-framework","6.extend\u002F10.custom-framework","i-lucide-puzzle",{"title":445,"path":446,"stem":447,"icon":448},"FS reader","\u002Fextend\u002Ffs-reader","6.extend\u002F2.fs-reader","i-lucide-folder-search",{"title":391,"path":450,"stem":451,"icon":452},"\u002Fextend\u002Fconsumer-recipes","6.extend\u002F3.consumer-recipes","i-lucide-chef-hat",{"title":454,"path":455,"stem":456,"icon":433},"Plugins","\u002Fextend\u002Fplugins","6.extend\u002F4.plugins",{"title":458,"path":459,"stem":460,"icon":419},"Custom enrichers","\u002Fextend\u002Fcustom-enrichers","6.extend\u002F5.custom-enrichers",{"title":462,"path":463,"stem":464,"icon":64},"Tail sampling","\u002Fextend\u002Ftail-sampling","6.extend\u002F6.tail-sampling",{"title":466,"path":467,"stem":468,"icon":469},"Identity headers","\u002Fextend\u002Fidentity-headers","6.extend\u002F7.identity-headers","i-lucide-fingerprint",{"title":471,"path":472,"stem":473,"icon":474},"Custom drains","\u002Fextend\u002Fcustom-drains","6.extend\u002F8.custom-drains","i-lucide-share-2",{"title":476,"path":477,"stem":478,"icon":479},"Drain pipeline","\u002Fextend\u002Fdrain-pipeline","6.extend\u002F9.drain-pipeline","i-lucide-workflow",{"title":412,"path":481,"stem":482,"children":483,"page":29},"\u002Freference","7.reference",[484,489,492,497,501,506],{"title":485,"path":486,"stem":487,"icon":488},"Configuration","\u002Freference\u002Fconfiguration","7.reference\u002F1.configuration","i-lucide-settings",{"title":359,"path":490,"stem":491,"icon":107},"\u002Freference\u002Fperformance","7.reference\u002F2.performance",{"title":493,"path":494,"stem":495,"icon":496},"Vite Plugin","\u002Freference\u002Fvite-plugin","7.reference\u002F3.vite-plugin","i-custom-vite",{"title":498,"path":499,"stem":500,"icon":364},"Best Practices","\u002Freference\u002Fbest-practices","7.reference\u002F4.best-practices",{"title":502,"path":503,"stem":504,"icon":505},"vs Other Loggers","\u002Freference\u002Fvs-other-loggers","7.reference\u002F5.vs-other-loggers","i-lucide-scale",{"title":507,"path":508,"stem":509,"icon":419},"Agent Skills","\u002Freference\u002Fagent-skills","7.reference\u002F6.agent-skills",{"id":511,"title":284,"body":512,"description":3345,"extension":3346,"links":3347,"meta":3351,"navigation":3352,"path":285,"seo":3353,"stem":286,"__hash__":3354},"docs\u002F4.integrate\u002Fframeworks\u002F15.orpc.md",{"type":513,"value":514,"toc":3328},"minimark",[515,547,567,612,616,621,701,705,1222,1243,1258,1261,1264,1590,1604,1678,1682,1688,1869,1967,1983,1987,2020,2244,2247,2325,2328,2483,2519,2522,2532,2536,2543,2716,2720,2727,2921,2932,2936,2942,3052,3056,3065,3215,3221,3225,3267,3275,3285,3289,3295,3324],[516,517,518,522,523,526,527,530,531,534,535,538,539,542,543,546],"p",{},[519,520,521],"code",{},"evlog\u002Forpc"," ships two primitives: ",[519,524,525],{},"withEvlog(handler)"," wraps any oRPC handler (",[519,528,529],{},"RPCHandler",", ",[519,532,533],{},"OpenAPIHandler",") so each request becomes one wide event, and ",[519,536,537],{},"evlog()"," is a procedure middleware that exposes ",[519,540,541],{},"context.log"," and tags the wide event with the procedure path as ",[519,544,545],{},"operation",".",[548,549,551,555,556,563,564,566],"callout",{"color":550,"icon":13},"info",[552,553,554],"strong",{},"oRPC v2:"," The oRPC maintainers have ",[557,558,562],"a",{"href":559,"rel":560},"https:\u002F\u002Fgithub.com\u002Fmiddleapi\u002Forpc\u002Fdiscussions\u002F1293#discussioncomment-17032656",[561],"nofollow","announced first-party evlog support in v2"," (edge-ready). Until v2 ships, ",[519,565,521],{}," is the integration path for oRPC v1 — and it remains the entrypoint for evlog's full pipeline (drains, enrichers, tail sampling, structured errors) regardless of how oRPC wires it in later.",[568,569,572,575,600],"prompt",{":actions":570,"description":571,"icon":287},"[\"copy\",\"cursor\",\"claude\"]","Set up evlog in my oRPC app",[516,573,574],{},"Set up evlog in my oRPC app.",[576,577,578,582,585,588,591,594,597],"ul",{},[579,580,581],"li",{},"Install evlog: pnpm add evlog",[579,583,584],{},"Call initLogger({ env: { service: 'my-rpc' } }) at startup",[579,586,587],{},"Wrap your RPCHandler \u002F OpenAPIHandler with withEvlog() from 'evlog\u002Forpc'",[579,589,590],{},"Add os.use(evlog()) on your base procedure for typed context.log + per-procedure operation",[579,592,593],{},"Declare EvlogOrpcContext on your base context to type context.log",[579,595,596],{},"Throw evlog errors (createError or defineErrorCatalog) directly from procedures — evlog\u002Forpc bridges them to ORPCError",[579,598,599],{},"Pass drain, enrich, include, and keep options to withEvlog()",[516,601,602,603,607,608],{},"Docs: ",[557,604,605],{"href":605,"rel":606},"https:\u002F\u002Fwww.evlog.dev\u002Fintegrate\u002Fframeworks\u002Forpc",[561],"\nAdapters: ",[557,609,610],{"href":610,"rel":611},"https:\u002F\u002Fwww.evlog.dev\u002Fintegrate\u002Fadapters\u002Foverview",[561],[613,614,25],"h2",{"id":615},"quick-start",[617,618,620],"h3",{"id":619},"_1-install","1. Install",[622,623,624,652,668,684],"code-group",{},[625,626,632],"pre",{"className":627,"code":628,"filename":629,"language":630,"meta":631,"style":631},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","pnpm add evlog @orpc\u002Fserver\n","pnpm","bash","",[519,633,634],{"__ignoreMap":631},[635,636,639,642,646,649],"span",{"class":637,"line":638},"line",1,[635,640,629],{"class":641},"sBMFI",[635,643,645],{"class":644},"sfazB"," add",[635,647,648],{"class":644}," evlog",[635,650,651],{"class":644}," @orpc\u002Fserver\n",[625,653,656],{"className":627,"code":654,"filename":655,"language":630,"meta":631,"style":631},"bun add evlog @orpc\u002Fserver\n","bun",[519,657,658],{"__ignoreMap":631},[635,659,660,662,664,666],{"class":637,"line":638},[635,661,655],{"class":641},[635,663,645],{"class":644},[635,665,648],{"class":644},[635,667,651],{"class":644},[625,669,672],{"className":627,"code":670,"filename":671,"language":630,"meta":631,"style":631},"yarn add evlog @orpc\u002Fserver\n","yarn",[519,673,674],{"__ignoreMap":631},[635,675,676,678,680,682],{"class":637,"line":638},[635,677,671],{"class":641},[635,679,645],{"class":644},[635,681,648],{"class":644},[635,683,651],{"class":644},[625,685,688],{"className":627,"code":686,"filename":687,"language":630,"meta":631,"style":631},"npm install evlog @orpc\u002Fserver\n","npm",[519,689,690],{"__ignoreMap":631},[635,691,692,694,697,699],{"class":637,"line":638},[635,693,687],{"class":641},[635,695,696],{"class":644}," install",[635,698,648],{"class":644},[635,700,651],{"class":644},[617,702,704],{"id":703},"_2-initialize-and-wire-the-wrappers","2. Initialize and wire the wrappers",[625,706,711],{"className":707,"code":708,"filename":709,"language":710,"meta":631,"style":631},"language-typescript shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import { os } from '@orpc\u002Fserver'\nimport { RPCHandler } from '@orpc\u002Fserver\u002Ffetch'\nimport { initLogger } from 'evlog'\nimport { evlog, withEvlog, type EvlogOrpcContext } from 'evlog\u002Forpc'\n\ninitLogger({\n  env: { service: 'my-rpc' },\n})\n\nconst base = os.$context\u003CEvlogOrpcContext>().use(evlog())\n\nconst router = {\n  health: base.handler(({ context }) => {\n    context.log.set({ route: 'health' })\n    return { ok: true }\n  }),\n}\n\nconst handler = withEvlog(new RPCHandler(router))\n\nexport default async function fetch(request: Request) {\n  const { matched, response } = await handler.handle(request, { prefix: '\u002Frpc' })\n  return matched ? response : new Response('Not Found', { status: 404 })\n}\n","server\u002Forpc.ts","typescript",[519,712,713,742,763,784,817,824,837,865,874,879,923,928,941,974,1011,1031,1043,1049,1054,1076,1081,1113,1169,1217],{"__ignoreMap":631},[635,714,715,719,723,727,730,733,736,739],{"class":637,"line":638},[635,716,718],{"class":717},"s7zQu","import",[635,720,722],{"class":721},"sMK4o"," {",[635,724,726],{"class":725},"sTEyZ"," os",[635,728,729],{"class":721}," }",[635,731,732],{"class":717}," from",[635,734,735],{"class":721}," '",[635,737,738],{"class":644},"@orpc\u002Fserver",[635,740,741],{"class":721},"'\n",[635,743,745,747,749,752,754,756,758,761],{"class":637,"line":744},2,[635,746,718],{"class":717},[635,748,722],{"class":721},[635,750,751],{"class":725}," RPCHandler",[635,753,729],{"class":721},[635,755,732],{"class":717},[635,757,735],{"class":721},[635,759,760],{"class":644},"@orpc\u002Fserver\u002Ffetch",[635,762,741],{"class":721},[635,764,766,768,770,773,775,777,779,782],{"class":637,"line":765},3,[635,767,718],{"class":717},[635,769,722],{"class":721},[635,771,772],{"class":725}," initLogger",[635,774,729],{"class":721},[635,776,732],{"class":717},[635,778,735],{"class":721},[635,780,781],{"class":644},"evlog",[635,783,741],{"class":721},[635,785,787,789,791,793,796,799,801,804,807,809,811,813,815],{"class":637,"line":786},4,[635,788,718],{"class":717},[635,790,722],{"class":721},[635,792,648],{"class":725},[635,794,795],{"class":721},",",[635,797,798],{"class":725}," withEvlog",[635,800,795],{"class":721},[635,802,803],{"class":717}," type",[635,805,806],{"class":725}," EvlogOrpcContext",[635,808,729],{"class":721},[635,810,732],{"class":717},[635,812,735],{"class":721},[635,814,521],{"class":644},[635,816,741],{"class":721},[635,818,820],{"class":637,"line":819},5,[635,821,823],{"emptyLinePlaceholder":822},true,"\n",[635,825,827,831,834],{"class":637,"line":826},6,[635,828,830],{"class":829},"s2Zo4","initLogger",[635,832,833],{"class":725},"(",[635,835,836],{"class":721},"{\n",[635,838,840,844,847,849,852,854,856,859,862],{"class":637,"line":839},7,[635,841,843],{"class":842},"swJcz","  env",[635,845,846],{"class":721},":",[635,848,722],{"class":721},[635,850,851],{"class":842}," service",[635,853,846],{"class":721},[635,855,735],{"class":721},[635,857,858],{"class":644},"my-rpc",[635,860,861],{"class":721},"'",[635,863,864],{"class":721}," },\n",[635,866,868,871],{"class":637,"line":867},8,[635,869,870],{"class":721},"}",[635,872,873],{"class":725},")\n",[635,875,877],{"class":637,"line":876},9,[635,878,823],{"emptyLinePlaceholder":822},[635,880,882,886,889,892,894,896,899,902,905,908,911,913,916,918,920],{"class":637,"line":881},10,[635,883,885],{"class":884},"spNyl","const",[635,887,888],{"class":725}," base ",[635,890,891],{"class":721},"=",[635,893,726],{"class":725},[635,895,546],{"class":721},[635,897,898],{"class":829},"$context",[635,900,901],{"class":721},"\u003C",[635,903,904],{"class":641},"EvlogOrpcContext",[635,906,907],{"class":721},">",[635,909,910],{"class":725},"()",[635,912,546],{"class":721},[635,914,915],{"class":829},"use",[635,917,833],{"class":725},[635,919,781],{"class":829},[635,921,922],{"class":725},"())\n",[635,924,926],{"class":637,"line":925},11,[635,927,823],{"emptyLinePlaceholder":822},[635,929,931,933,936,938],{"class":637,"line":930},12,[635,932,885],{"class":884},[635,934,935],{"class":725}," router ",[635,937,891],{"class":721},[635,939,940],{"class":721}," {\n",[635,942,944,947,949,952,954,957,959,962,966,969,972],{"class":637,"line":943},13,[635,945,946],{"class":842},"  health",[635,948,846],{"class":721},[635,950,951],{"class":725}," base",[635,953,546],{"class":721},[635,955,956],{"class":829},"handler",[635,958,833],{"class":725},[635,960,961],{"class":721},"({",[635,963,965],{"class":964},"sHdIc"," context",[635,967,968],{"class":721}," })",[635,970,971],{"class":884}," =>",[635,973,940],{"class":721},[635,975,977,980,982,985,987,990,992,995,998,1000,1002,1005,1007,1009],{"class":637,"line":976},14,[635,978,979],{"class":725},"    context",[635,981,546],{"class":721},[635,983,984],{"class":725},"log",[635,986,546],{"class":721},[635,988,989],{"class":829},"set",[635,991,833],{"class":842},[635,993,994],{"class":721},"{",[635,996,997],{"class":842}," route",[635,999,846],{"class":721},[635,1001,735],{"class":721},[635,1003,1004],{"class":644},"health",[635,1006,861],{"class":721},[635,1008,729],{"class":721},[635,1010,873],{"class":842},[635,1012,1014,1017,1019,1022,1024,1028],{"class":637,"line":1013},15,[635,1015,1016],{"class":717},"    return",[635,1018,722],{"class":721},[635,1020,1021],{"class":842}," ok",[635,1023,846],{"class":721},[635,1025,1027],{"class":1026},"sfNiH"," true",[635,1029,1030],{"class":721}," }\n",[635,1032,1034,1037,1040],{"class":637,"line":1033},16,[635,1035,1036],{"class":721},"  }",[635,1038,1039],{"class":725},")",[635,1041,1042],{"class":721},",\n",[635,1044,1046],{"class":637,"line":1045},17,[635,1047,1048],{"class":721},"}\n",[635,1050,1052],{"class":637,"line":1051},18,[635,1053,823],{"emptyLinePlaceholder":822},[635,1055,1057,1059,1062,1064,1066,1068,1071,1073],{"class":637,"line":1056},19,[635,1058,885],{"class":884},[635,1060,1061],{"class":725}," handler ",[635,1063,891],{"class":721},[635,1065,798],{"class":829},[635,1067,833],{"class":725},[635,1069,1070],{"class":721},"new",[635,1072,751],{"class":829},[635,1074,1075],{"class":725},"(router))\n",[635,1077,1079],{"class":637,"line":1078},20,[635,1080,823],{"emptyLinePlaceholder":822},[635,1082,1084,1087,1090,1093,1096,1099,1101,1104,1106,1109,1111],{"class":637,"line":1083},21,[635,1085,1086],{"class":717},"export",[635,1088,1089],{"class":717}," default",[635,1091,1092],{"class":884}," async",[635,1094,1095],{"class":884}," function",[635,1097,1098],{"class":829}," fetch",[635,1100,833],{"class":721},[635,1102,1103],{"class":964},"request",[635,1105,846],{"class":721},[635,1107,1108],{"class":641}," Request",[635,1110,1039],{"class":721},[635,1112,940],{"class":721},[635,1114,1116,1119,1121,1124,1126,1129,1131,1134,1137,1140,1142,1145,1147,1149,1151,1153,1156,1158,1160,1163,1165,1167],{"class":637,"line":1115},22,[635,1117,1118],{"class":884},"  const",[635,1120,722],{"class":721},[635,1122,1123],{"class":725}," matched",[635,1125,795],{"class":721},[635,1127,1128],{"class":725}," response",[635,1130,729],{"class":721},[635,1132,1133],{"class":721}," =",[635,1135,1136],{"class":717}," await",[635,1138,1139],{"class":725}," handler",[635,1141,546],{"class":721},[635,1143,1144],{"class":829},"handle",[635,1146,833],{"class":842},[635,1148,1103],{"class":725},[635,1150,795],{"class":721},[635,1152,722],{"class":721},[635,1154,1155],{"class":842}," prefix",[635,1157,846],{"class":721},[635,1159,735],{"class":721},[635,1161,1162],{"class":644},"\u002Frpc",[635,1164,861],{"class":721},[635,1166,729],{"class":721},[635,1168,873],{"class":842},[635,1170,1172,1175,1177,1180,1182,1185,1188,1191,1193,1195,1198,1200,1202,1204,1207,1209,1213,1215],{"class":637,"line":1171},23,[635,1173,1174],{"class":717},"  return",[635,1176,1123],{"class":725},[635,1178,1179],{"class":721}," ?",[635,1181,1128],{"class":725},[635,1183,1184],{"class":721}," :",[635,1186,1187],{"class":721}," new",[635,1189,1190],{"class":829}," Response",[635,1192,833],{"class":842},[635,1194,861],{"class":721},[635,1196,1197],{"class":644},"Not Found",[635,1199,861],{"class":721},[635,1201,795],{"class":721},[635,1203,722],{"class":721},[635,1205,1206],{"class":842}," status",[635,1208,846],{"class":721},[635,1210,1212],{"class":1211},"sbssI"," 404",[635,1214,729],{"class":721},[635,1216,873],{"class":842},[635,1218,1220],{"class":637,"line":1219},24,[635,1221,1048],{"class":721},[548,1223,1224,1227,1228,1234,1235,1238,1239,1242],{"color":550,"icon":496},[552,1225,1226],{},"Using Vite?"," The ",[557,1229,1230,1233],{"href":494},[519,1231,1232],{},"evlog\u002Fvite"," plugin"," replaces the ",[519,1236,1237],{},"initLogger()"," call with compile-time auto-initialization, strips ",[519,1240,1241],{},"log.debug()"," from production builds, and injects source locations.",[516,1244,1245,1247,1248,1251,1252,1254,1255,546],{},[519,1246,904],{}," declares ",[519,1249,1250],{},"log: RequestLogger"," on the procedure context so ",[519,1253,541],{}," is fully typed in every procedure that descends from ",[519,1256,1257],{},"base",[613,1259,46],{"id":1260},"wide-events",[516,1262,1263],{},"Build up context progressively through your handler. One request = one wide event:",[625,1265,1267],{"className":707,"code":1266,"filename":709,"language":710,"meta":631,"style":631},"const getUser = base\n  .input(z.object({ id: z.string() }))\n  .handler(async ({ input, context }) => {\n    context.log.set({ user: { id: input.id } })\n\n    const user = await db.findUser(input.id)\n    context.log.set({ user: { name: user.name, plan: user.plan } })\n\n    const orders = await db.findOrders(input.id)\n    context.log.set({ orders: { count: orders.length, totalRevenue: sum(orders) } })\n\n    return { user, orders }\n  })\n",[519,1268,1269,1281,1322,1349,1389,1393,1422,1476,1480,1508,1566,1570,1584],{"__ignoreMap":631},[635,1270,1271,1273,1276,1278],{"class":637,"line":638},[635,1272,885],{"class":884},[635,1274,1275],{"class":725}," getUser ",[635,1277,891],{"class":721},[635,1279,1280],{"class":725}," base\n",[635,1282,1283,1286,1289,1292,1294,1297,1299,1301,1304,1306,1309,1311,1314,1317,1319],{"class":637,"line":744},[635,1284,1285],{"class":721},"  .",[635,1287,1288],{"class":829},"input",[635,1290,1291],{"class":725},"(z",[635,1293,546],{"class":721},[635,1295,1296],{"class":829},"object",[635,1298,833],{"class":725},[635,1300,994],{"class":721},[635,1302,1303],{"class":842}," id",[635,1305,846],{"class":721},[635,1307,1308],{"class":725}," z",[635,1310,546],{"class":721},[635,1312,1313],{"class":829},"string",[635,1315,1316],{"class":725},"() ",[635,1318,870],{"class":721},[635,1320,1321],{"class":725},"))\n",[635,1323,1324,1326,1328,1330,1333,1336,1339,1341,1343,1345,1347],{"class":637,"line":765},[635,1325,1285],{"class":721},[635,1327,956],{"class":829},[635,1329,833],{"class":725},[635,1331,1332],{"class":884},"async",[635,1334,1335],{"class":721}," ({",[635,1337,1338],{"class":964}," input",[635,1340,795],{"class":721},[635,1342,965],{"class":964},[635,1344,968],{"class":721},[635,1346,971],{"class":884},[635,1348,940],{"class":721},[635,1350,1351,1353,1355,1357,1359,1361,1363,1365,1368,1370,1372,1374,1376,1378,1380,1383,1385,1387],{"class":637,"line":786},[635,1352,979],{"class":725},[635,1354,546],{"class":721},[635,1356,984],{"class":725},[635,1358,546],{"class":721},[635,1360,989],{"class":829},[635,1362,833],{"class":842},[635,1364,994],{"class":721},[635,1366,1367],{"class":842}," user",[635,1369,846],{"class":721},[635,1371,722],{"class":721},[635,1373,1303],{"class":842},[635,1375,846],{"class":721},[635,1377,1338],{"class":725},[635,1379,546],{"class":721},[635,1381,1382],{"class":725},"id",[635,1384,729],{"class":721},[635,1386,729],{"class":721},[635,1388,873],{"class":842},[635,1390,1391],{"class":637,"line":819},[635,1392,823],{"emptyLinePlaceholder":822},[635,1394,1395,1398,1400,1402,1404,1407,1409,1412,1414,1416,1418,1420],{"class":637,"line":826},[635,1396,1397],{"class":884},"    const",[635,1399,1367],{"class":725},[635,1401,1133],{"class":721},[635,1403,1136],{"class":717},[635,1405,1406],{"class":725}," db",[635,1408,546],{"class":721},[635,1410,1411],{"class":829},"findUser",[635,1413,833],{"class":842},[635,1415,1288],{"class":725},[635,1417,546],{"class":721},[635,1419,1382],{"class":725},[635,1421,873],{"class":842},[635,1423,1424,1426,1428,1430,1432,1434,1436,1438,1440,1442,1444,1447,1449,1451,1453,1456,1458,1461,1463,1465,1467,1470,1472,1474],{"class":637,"line":839},[635,1425,979],{"class":725},[635,1427,546],{"class":721},[635,1429,984],{"class":725},[635,1431,546],{"class":721},[635,1433,989],{"class":829},[635,1435,833],{"class":842},[635,1437,994],{"class":721},[635,1439,1367],{"class":842},[635,1441,846],{"class":721},[635,1443,722],{"class":721},[635,1445,1446],{"class":842}," name",[635,1448,846],{"class":721},[635,1450,1367],{"class":725},[635,1452,546],{"class":721},[635,1454,1455],{"class":725},"name",[635,1457,795],{"class":721},[635,1459,1460],{"class":842}," plan",[635,1462,846],{"class":721},[635,1464,1367],{"class":725},[635,1466,546],{"class":721},[635,1468,1469],{"class":725},"plan",[635,1471,729],{"class":721},[635,1473,729],{"class":721},[635,1475,873],{"class":842},[635,1477,1478],{"class":637,"line":867},[635,1479,823],{"emptyLinePlaceholder":822},[635,1481,1482,1484,1487,1489,1491,1493,1495,1498,1500,1502,1504,1506],{"class":637,"line":876},[635,1483,1397],{"class":884},[635,1485,1486],{"class":725}," orders",[635,1488,1133],{"class":721},[635,1490,1136],{"class":717},[635,1492,1406],{"class":725},[635,1494,546],{"class":721},[635,1496,1497],{"class":829},"findOrders",[635,1499,833],{"class":842},[635,1501,1288],{"class":725},[635,1503,546],{"class":721},[635,1505,1382],{"class":725},[635,1507,873],{"class":842},[635,1509,1510,1512,1514,1516,1518,1520,1522,1524,1526,1528,1530,1533,1535,1537,1539,1542,1544,1547,1549,1552,1554,1557,1560,1562,1564],{"class":637,"line":881},[635,1511,979],{"class":725},[635,1513,546],{"class":721},[635,1515,984],{"class":725},[635,1517,546],{"class":721},[635,1519,989],{"class":829},[635,1521,833],{"class":842},[635,1523,994],{"class":721},[635,1525,1486],{"class":842},[635,1527,846],{"class":721},[635,1529,722],{"class":721},[635,1531,1532],{"class":842}," count",[635,1534,846],{"class":721},[635,1536,1486],{"class":725},[635,1538,546],{"class":721},[635,1540,1541],{"class":725},"length",[635,1543,795],{"class":721},[635,1545,1546],{"class":842}," totalRevenue",[635,1548,846],{"class":721},[635,1550,1551],{"class":829}," sum",[635,1553,833],{"class":842},[635,1555,1556],{"class":725},"orders",[635,1558,1559],{"class":842},") ",[635,1561,870],{"class":721},[635,1563,729],{"class":721},[635,1565,873],{"class":842},[635,1567,1568],{"class":637,"line":925},[635,1569,823],{"emptyLinePlaceholder":822},[635,1571,1572,1574,1576,1578,1580,1582],{"class":637,"line":930},[635,1573,1016],{"class":717},[635,1575,722],{"class":721},[635,1577,1367],{"class":725},[635,1579,795],{"class":721},[635,1581,1486],{"class":725},[635,1583,1030],{"class":721},[635,1585,1586,1588],{"class":637,"line":943},[635,1587,1036],{"class":721},[635,1589,873],{"class":725},[516,1591,1592,1593,1595,1596,1599,1600,1603],{},"All fields are merged into a single wide event emitted when the request completes. The ",[519,1594,545],{}," field is filled automatically from the procedure path (nested routers like ",[519,1597,1598],{},"users.profile.get"," surface as ",[519,1601,1602],{},"operation: 'users.profile.get'","):",[625,1605,1608],{"className":627,"code":1606,"filename":1607,"language":630,"meta":631,"style":631},"14:58:15 INFO [my-rpc] POST \u002Frpc\u002FgetUser 200 in 12ms\n  ├─ operation: getUser\n  ├─ orders: count=2 totalRevenue=6298\n  ├─ user: id=usr_123 name=Alice plan=pro\n  └─ requestId: 4a8ff3a8-...\n","Terminal output",[519,1609,1610,1621,1632,1651,1667],{"__ignoreMap":631},[635,1611,1612,1615,1618],{"class":637,"line":638},[635,1613,1614],{"class":641},"14:58:15",[635,1616,1617],{"class":644}," INFO",[635,1619,1620],{"class":725}," [my-rpc] POST \u002Frpc\u002FgetUser 200 in 12ms\n",[635,1622,1623,1626,1629],{"class":637,"line":744},[635,1624,1625],{"class":641},"  ├─",[635,1627,1628],{"class":644}," operation:",[635,1630,1631],{"class":644}," getUser\n",[635,1633,1634,1636,1639,1642,1645,1648],{"class":637,"line":765},[635,1635,1625],{"class":641},[635,1637,1638],{"class":644}," orders:",[635,1640,1641],{"class":644}," count=",[635,1643,1644],{"class":1211},"2",[635,1646,1647],{"class":644}," totalRevenue=",[635,1649,1650],{"class":1211},"6298\n",[635,1652,1653,1655,1658,1661,1664],{"class":637,"line":786},[635,1654,1625],{"class":641},[635,1656,1657],{"class":644}," user:",[635,1659,1660],{"class":644}," id=usr_123",[635,1662,1663],{"class":644}," name=Alice",[635,1665,1666],{"class":644}," plan=pro\n",[635,1668,1669,1672,1675],{"class":637,"line":819},[635,1670,1671],{"class":641},"  └─",[635,1673,1674],{"class":644}," requestId:",[635,1676,1677],{"class":644}," 4a8ff3a8-...\n",[613,1679,1681],{"id":1680},"uselogger","useLogger()",[516,1683,1684,1685,1687],{},"Use ",[519,1686,1681],{}," to access the request-scoped logger from anywhere in the call stack without passing the context through your service layer:",[625,1689,1692],{"className":707,"code":1690,"filename":1691,"language":710,"meta":631,"style":631},"import { useLogger } from 'evlog\u002Forpc'\n\nexport async function findUser(id: string) {\n  const log = useLogger()\n  log.set({ user: { id } })\n\n  const user = await db.findUser(id)\n  log.set({ user: { name: user.name, plan: user.plan } })\n\n  return user\n}\n","server\u002Fservices\u002Fuser.ts",[519,1693,1694,1713,1717,1741,1755,1782,1786,1808,1854,1858,1865],{"__ignoreMap":631},[635,1695,1696,1698,1700,1703,1705,1707,1709,1711],{"class":637,"line":638},[635,1697,718],{"class":717},[635,1699,722],{"class":721},[635,1701,1702],{"class":725}," useLogger",[635,1704,729],{"class":721},[635,1706,732],{"class":717},[635,1708,735],{"class":721},[635,1710,521],{"class":644},[635,1712,741],{"class":721},[635,1714,1715],{"class":637,"line":744},[635,1716,823],{"emptyLinePlaceholder":822},[635,1718,1719,1721,1723,1725,1728,1730,1732,1734,1737,1739],{"class":637,"line":765},[635,1720,1086],{"class":717},[635,1722,1092],{"class":884},[635,1724,1095],{"class":884},[635,1726,1727],{"class":829}," findUser",[635,1729,833],{"class":721},[635,1731,1382],{"class":964},[635,1733,846],{"class":721},[635,1735,1736],{"class":641}," string",[635,1738,1039],{"class":721},[635,1740,940],{"class":721},[635,1742,1743,1745,1748,1750,1752],{"class":637,"line":786},[635,1744,1118],{"class":884},[635,1746,1747],{"class":725}," log",[635,1749,1133],{"class":721},[635,1751,1702],{"class":829},[635,1753,1754],{"class":842},"()\n",[635,1756,1757,1760,1762,1764,1766,1768,1770,1772,1774,1776,1778,1780],{"class":637,"line":819},[635,1758,1759],{"class":725},"  log",[635,1761,546],{"class":721},[635,1763,989],{"class":829},[635,1765,833],{"class":842},[635,1767,994],{"class":721},[635,1769,1367],{"class":842},[635,1771,846],{"class":721},[635,1773,722],{"class":721},[635,1775,1303],{"class":725},[635,1777,729],{"class":721},[635,1779,729],{"class":721},[635,1781,873],{"class":842},[635,1783,1784],{"class":637,"line":826},[635,1785,823],{"emptyLinePlaceholder":822},[635,1787,1788,1790,1792,1794,1796,1798,1800,1802,1804,1806],{"class":637,"line":839},[635,1789,1118],{"class":884},[635,1791,1367],{"class":725},[635,1793,1133],{"class":721},[635,1795,1136],{"class":717},[635,1797,1406],{"class":725},[635,1799,546],{"class":721},[635,1801,1411],{"class":829},[635,1803,833],{"class":842},[635,1805,1382],{"class":725},[635,1807,873],{"class":842},[635,1809,1810,1812,1814,1816,1818,1820,1822,1824,1826,1828,1830,1832,1834,1836,1838,1840,1842,1844,1846,1848,1850,1852],{"class":637,"line":867},[635,1811,1759],{"class":725},[635,1813,546],{"class":721},[635,1815,989],{"class":829},[635,1817,833],{"class":842},[635,1819,994],{"class":721},[635,1821,1367],{"class":842},[635,1823,846],{"class":721},[635,1825,722],{"class":721},[635,1827,1446],{"class":842},[635,1829,846],{"class":721},[635,1831,1367],{"class":725},[635,1833,546],{"class":721},[635,1835,1455],{"class":725},[635,1837,795],{"class":721},[635,1839,1460],{"class":842},[635,1841,846],{"class":721},[635,1843,1367],{"class":725},[635,1845,546],{"class":721},[635,1847,1469],{"class":725},[635,1849,729],{"class":721},[635,1851,729],{"class":721},[635,1853,873],{"class":842},[635,1855,1856],{"class":637,"line":876},[635,1857,823],{"emptyLinePlaceholder":822},[635,1859,1860,1862],{"class":637,"line":881},[635,1861,1174],{"class":717},[635,1863,1864],{"class":725}," user\n",[635,1866,1867],{"class":637,"line":925},[635,1868,1048],{"class":721},[625,1870,1872],{"className":707,"code":1871,"filename":709,"language":710,"meta":631,"style":631},"import { findUser } from '.\u002Fservices\u002Fuser'\n\nconst getUser = base\n  .input(z.object({ id: z.string() }))\n  .handler(async ({ input }) => findUser(input.id))\n",[519,1873,1874,1893,1897,1907,1939],{"__ignoreMap":631},[635,1875,1876,1878,1880,1882,1884,1886,1888,1891],{"class":637,"line":638},[635,1877,718],{"class":717},[635,1879,722],{"class":721},[635,1881,1727],{"class":725},[635,1883,729],{"class":721},[635,1885,732],{"class":717},[635,1887,735],{"class":721},[635,1889,1890],{"class":644},".\u002Fservices\u002Fuser",[635,1892,741],{"class":721},[635,1894,1895],{"class":637,"line":744},[635,1896,823],{"emptyLinePlaceholder":822},[635,1898,1899,1901,1903,1905],{"class":637,"line":765},[635,1900,885],{"class":884},[635,1902,1275],{"class":725},[635,1904,891],{"class":721},[635,1906,1280],{"class":725},[635,1908,1909,1911,1913,1915,1917,1919,1921,1923,1925,1927,1929,1931,1933,1935,1937],{"class":637,"line":786},[635,1910,1285],{"class":721},[635,1912,1288],{"class":829},[635,1914,1291],{"class":725},[635,1916,546],{"class":721},[635,1918,1296],{"class":829},[635,1920,833],{"class":725},[635,1922,994],{"class":721},[635,1924,1303],{"class":842},[635,1926,846],{"class":721},[635,1928,1308],{"class":725},[635,1930,546],{"class":721},[635,1932,1313],{"class":829},[635,1934,1316],{"class":725},[635,1936,870],{"class":721},[635,1938,1321],{"class":725},[635,1940,1941,1943,1945,1947,1949,1951,1953,1955,1957,1959,1962,1964],{"class":637,"line":819},[635,1942,1285],{"class":721},[635,1944,956],{"class":829},[635,1946,833],{"class":725},[635,1948,1332],{"class":884},[635,1950,1335],{"class":721},[635,1952,1338],{"class":964},[635,1954,968],{"class":721},[635,1956,971],{"class":884},[635,1958,1727],{"class":829},[635,1960,1961],{"class":725},"(input",[635,1963,546],{"class":721},[635,1965,1966],{"class":725},"id))\n",[516,1968,1969,1970,1972,1973,1975,1976,1978,1979,1982],{},"Both ",[519,1971,541],{}," and ",[519,1974,1681],{}," return the same logger instance. ",[519,1977,1681],{}," uses ",[519,1980,1981],{},"AsyncLocalStorage"," to propagate the logger across async boundaries.",[613,1984,1986],{"id":1985},"error-handling","Error Handling",[516,1988,1684,1989,1992,1993,530,1996,1999,2000,2003,2004,2006,2007,2010,2011,530,2013,530,2016,2019],{},[519,1990,1991],{},"createError"," for structured errors with ",[519,1994,1995],{},"why",[519,1997,1998],{},"fix",", and ",[519,2001,2002],{},"link"," fields. The ",[519,2005,537],{}," middleware catches the throw, records it on the wide event, and bridges it to an ",[519,2008,2009],{},"ORPCError"," so the wire response carries your ",[519,2012,519],{},[519,2014,2015],{},"status",[519,2017,2018],{},"message",", and the human-guidance fields:",[625,2021,2023],{"className":707,"code":2022,"filename":709,"language":710,"meta":631,"style":631},"import { createError } from 'evlog'\n\nconst checkout = base\n  .handler(({ context }) => {\n    context.log.set({ cart: { items: 3, total: 9999 } })\n\n    throw createError({\n      message: 'Payment failed',\n      code: 'PAYMENT_DECLINED',\n      status: 402,\n      why: 'Card declined by issuer',\n      fix: 'Try a different payment method',\n      link: 'https:\u002F\u002Fdocs.example.com\u002Fpayments\u002Fdeclined',\n    })\n  })\n",[519,2024,2025,2044,2048,2059,2077,2124,2128,2139,2155,2171,2183,2199,2215,2231,2238],{"__ignoreMap":631},[635,2026,2027,2029,2031,2034,2036,2038,2040,2042],{"class":637,"line":638},[635,2028,718],{"class":717},[635,2030,722],{"class":721},[635,2032,2033],{"class":725}," createError",[635,2035,729],{"class":721},[635,2037,732],{"class":717},[635,2039,735],{"class":721},[635,2041,781],{"class":644},[635,2043,741],{"class":721},[635,2045,2046],{"class":637,"line":744},[635,2047,823],{"emptyLinePlaceholder":822},[635,2049,2050,2052,2055,2057],{"class":637,"line":765},[635,2051,885],{"class":884},[635,2053,2054],{"class":725}," checkout ",[635,2056,891],{"class":721},[635,2058,1280],{"class":725},[635,2060,2061,2063,2065,2067,2069,2071,2073,2075],{"class":637,"line":786},[635,2062,1285],{"class":721},[635,2064,956],{"class":829},[635,2066,833],{"class":725},[635,2068,961],{"class":721},[635,2070,965],{"class":964},[635,2072,968],{"class":721},[635,2074,971],{"class":884},[635,2076,940],{"class":721},[635,2078,2079,2081,2083,2085,2087,2089,2091,2093,2096,2098,2100,2103,2105,2108,2110,2113,2115,2118,2120,2122],{"class":637,"line":819},[635,2080,979],{"class":725},[635,2082,546],{"class":721},[635,2084,984],{"class":725},[635,2086,546],{"class":721},[635,2088,989],{"class":829},[635,2090,833],{"class":842},[635,2092,994],{"class":721},[635,2094,2095],{"class":842}," cart",[635,2097,846],{"class":721},[635,2099,722],{"class":721},[635,2101,2102],{"class":842}," items",[635,2104,846],{"class":721},[635,2106,2107],{"class":1211}," 3",[635,2109,795],{"class":721},[635,2111,2112],{"class":842}," total",[635,2114,846],{"class":721},[635,2116,2117],{"class":1211}," 9999",[635,2119,729],{"class":721},[635,2121,729],{"class":721},[635,2123,873],{"class":842},[635,2125,2126],{"class":637,"line":826},[635,2127,823],{"emptyLinePlaceholder":822},[635,2129,2130,2133,2135,2137],{"class":637,"line":839},[635,2131,2132],{"class":717},"    throw",[635,2134,2033],{"class":829},[635,2136,833],{"class":842},[635,2138,836],{"class":721},[635,2140,2141,2144,2146,2148,2151,2153],{"class":637,"line":867},[635,2142,2143],{"class":842},"      message",[635,2145,846],{"class":721},[635,2147,735],{"class":721},[635,2149,2150],{"class":644},"Payment failed",[635,2152,861],{"class":721},[635,2154,1042],{"class":721},[635,2156,2157,2160,2162,2164,2167,2169],{"class":637,"line":876},[635,2158,2159],{"class":842},"      code",[635,2161,846],{"class":721},[635,2163,735],{"class":721},[635,2165,2166],{"class":644},"PAYMENT_DECLINED",[635,2168,861],{"class":721},[635,2170,1042],{"class":721},[635,2172,2173,2176,2178,2181],{"class":637,"line":881},[635,2174,2175],{"class":842},"      status",[635,2177,846],{"class":721},[635,2179,2180],{"class":1211}," 402",[635,2182,1042],{"class":721},[635,2184,2185,2188,2190,2192,2195,2197],{"class":637,"line":925},[635,2186,2187],{"class":842},"      why",[635,2189,846],{"class":721},[635,2191,735],{"class":721},[635,2193,2194],{"class":644},"Card declined by issuer",[635,2196,861],{"class":721},[635,2198,1042],{"class":721},[635,2200,2201,2204,2206,2208,2211,2213],{"class":637,"line":930},[635,2202,2203],{"class":842},"      fix",[635,2205,846],{"class":721},[635,2207,735],{"class":721},[635,2209,2210],{"class":644},"Try a different payment method",[635,2212,861],{"class":721},[635,2214,1042],{"class":721},[635,2216,2217,2220,2222,2224,2227,2229],{"class":637,"line":943},[635,2218,2219],{"class":842},"      link",[635,2221,846],{"class":721},[635,2223,735],{"class":721},[635,2225,2226],{"class":644},"https:\u002F\u002Fdocs.example.com\u002Fpayments\u002Fdeclined",[635,2228,861],{"class":721},[635,2230,1042],{"class":721},[635,2232,2233,2236],{"class":637,"line":976},[635,2234,2235],{"class":721},"    }",[635,2237,873],{"class":842},[635,2239,2240,2242],{"class":637,"line":1013},[635,2241,1036],{"class":721},[635,2243,873],{"class":725},[516,2245,2246],{},"The error is captured and logged with both the custom context and structured error fields:",[625,2248,2250],{"className":627,"code":2249,"filename":1607,"language":630,"meta":631,"style":631},"14:58:20 ERROR [my-rpc] POST \u002Frpc\u002Fcheckout 402 in 3ms\n  ├─ operation: checkout\n  ├─ error: name=EvlogError code=PAYMENT_DECLINED status=402 message=Payment failed\n  ├─ cart: items=3 total=9999\n  └─ requestId: 880a50ac-...\n",[519,2251,2252,2263,2272,2297,2316],{"__ignoreMap":631},[635,2253,2254,2257,2260],{"class":637,"line":638},[635,2255,2256],{"class":641},"14:58:20",[635,2258,2259],{"class":644}," ERROR",[635,2261,2262],{"class":725}," [my-rpc] POST \u002Frpc\u002Fcheckout 402 in 3ms\n",[635,2264,2265,2267,2269],{"class":637,"line":744},[635,2266,1625],{"class":641},[635,2268,1628],{"class":644},[635,2270,2271],{"class":644}," checkout\n",[635,2273,2274,2276,2279,2282,2285,2288,2291,2294],{"class":637,"line":765},[635,2275,1625],{"class":641},[635,2277,2278],{"class":644}," error:",[635,2280,2281],{"class":644}," name=EvlogError",[635,2283,2284],{"class":644}," code=PAYMENT_DECLINED",[635,2286,2287],{"class":644}," status=",[635,2289,2290],{"class":1211},"402",[635,2292,2293],{"class":644}," message=Payment",[635,2295,2296],{"class":644}," failed\n",[635,2298,2299,2301,2304,2307,2310,2313],{"class":637,"line":786},[635,2300,1625],{"class":641},[635,2302,2303],{"class":644}," cart:",[635,2305,2306],{"class":644}," items=",[635,2308,2309],{"class":1211},"3",[635,2311,2312],{"class":644}," total=",[635,2314,2315],{"class":1211},"9999\n",[635,2317,2318,2320,2322],{"class":637,"line":819},[635,2319,1671],{"class":641},[635,2321,1674],{"class":644},[635,2323,2324],{"class":644}," 880a50ac-...\n",[516,2326,2327],{},"Wire response returned to the client:",[625,2329,2334],{"className":2330,"code":2331,"filename":2332,"language":2333,"meta":631,"style":631},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"defined\": false,\n  \"code\": \"PAYMENT_DECLINED\",\n  \"status\": 402,\n  \"message\": \"Payment failed\",\n  \"data\": {\n    \"why\": \"Card declined by issuer\",\n    \"fix\": \"Try a different payment method\",\n    \"link\": \"https:\u002F\u002Fdocs.example.com\u002Fpayments\u002Fdeclined\"\n  }\n}\n","HTTP 402","json",[519,2335,2336,2340,2356,2375,2389,2407,2420,2439,2457,2474,2479],{"__ignoreMap":631},[635,2337,2338],{"class":637,"line":638},[635,2339,836],{"class":721},[635,2341,2342,2345,2348,2351,2353],{"class":637,"line":744},[635,2343,2344],{"class":721},"  \"",[635,2346,2347],{"class":884},"defined",[635,2349,2350],{"class":721},"\"",[635,2352,846],{"class":721},[635,2354,2355],{"class":721}," false,\n",[635,2357,2358,2360,2362,2364,2366,2369,2371,2373],{"class":637,"line":765},[635,2359,2344],{"class":721},[635,2361,519],{"class":884},[635,2363,2350],{"class":721},[635,2365,846],{"class":721},[635,2367,2368],{"class":721}," \"",[635,2370,2166],{"class":644},[635,2372,2350],{"class":721},[635,2374,1042],{"class":721},[635,2376,2377,2379,2381,2383,2385,2387],{"class":637,"line":786},[635,2378,2344],{"class":721},[635,2380,2015],{"class":884},[635,2382,2350],{"class":721},[635,2384,846],{"class":721},[635,2386,2180],{"class":1211},[635,2388,1042],{"class":721},[635,2390,2391,2393,2395,2397,2399,2401,2403,2405],{"class":637,"line":819},[635,2392,2344],{"class":721},[635,2394,2018],{"class":884},[635,2396,2350],{"class":721},[635,2398,846],{"class":721},[635,2400,2368],{"class":721},[635,2402,2150],{"class":644},[635,2404,2350],{"class":721},[635,2406,1042],{"class":721},[635,2408,2409,2411,2414,2416,2418],{"class":637,"line":826},[635,2410,2344],{"class":721},[635,2412,2413],{"class":884},"data",[635,2415,2350],{"class":721},[635,2417,846],{"class":721},[635,2419,940],{"class":721},[635,2421,2422,2425,2427,2429,2431,2433,2435,2437],{"class":637,"line":839},[635,2423,2424],{"class":721},"    \"",[635,2426,1995],{"class":641},[635,2428,2350],{"class":721},[635,2430,846],{"class":721},[635,2432,2368],{"class":721},[635,2434,2194],{"class":644},[635,2436,2350],{"class":721},[635,2438,1042],{"class":721},[635,2440,2441,2443,2445,2447,2449,2451,2453,2455],{"class":637,"line":867},[635,2442,2424],{"class":721},[635,2444,1998],{"class":641},[635,2446,2350],{"class":721},[635,2448,846],{"class":721},[635,2450,2368],{"class":721},[635,2452,2210],{"class":644},[635,2454,2350],{"class":721},[635,2456,1042],{"class":721},[635,2458,2459,2461,2463,2465,2467,2469,2471],{"class":637,"line":876},[635,2460,2424],{"class":721},[635,2462,2002],{"class":641},[635,2464,2350],{"class":721},[635,2466,846],{"class":721},[635,2468,2368],{"class":721},[635,2470,2226],{"class":644},[635,2472,2473],{"class":721},"\"\n",[635,2475,2476],{"class":637,"line":881},[635,2477,2478],{"class":721},"  }\n",[635,2480,2481],{"class":637,"line":925},[635,2482,1048],{"class":721},[548,2484,2485,2486,2489,2490,2493,2494,2497,2498,2500,2501,2500,2503,2505,2506,2508,2509,2511,2512,2518],{"color":550,"icon":13},"oRPC's error envelope is ",[519,2487,2488],{},"{ defined, code, status, message, data }"," — clients deserialize errors as a typed union via ",[519,2491,2492],{},"safe()"," from ",[519,2495,2496],{},"@orpc\u002Fclient",". evlog follows the protocol, so ",[519,2499,1995],{},"\u002F",[519,2502,1998],{},[519,2504,2002],{}," live under ",[519,2507,2413],{}," instead of at the response root. The authoring API (",[519,2510,1991],{}," \u002F ",[557,2513,2515],{"href":2514},"\u002Flearn\u002Fstructured-errors#error-catalogs",[519,2516,2517],{},"defineErrorCatalog",") is identical to the rest of evlog.",[613,2520,485],{"id":2521},"configuration",[516,2523,2524,2525,2528,2529,2531],{},"See the ",[557,2526,2527],{"href":486},"Configuration reference"," for all available options (",[519,2530,830],{},", middleware options, sampling, silent mode, etc.).",[613,2533,2535],{"id":2534},"drain-enrichers","Drain & Enrichers",[516,2537,2538,2539,2542],{},"Configure drain adapters and enrichers directly in the ",[519,2540,2541],{},"withEvlog()"," options:",[625,2544,2546],{"className":707,"code":2545,"filename":709,"language":710,"meta":631,"style":631},"import { createAxiomDrain } from 'evlog\u002Faxiom'\nimport { createUserAgentEnricher } from 'evlog\u002Fenrichers'\n\nconst userAgent = createUserAgentEnricher()\n\nconst handler = withEvlog(new RPCHandler(router), {\n  drain: createAxiomDrain(),\n  enrich: (ctx) => {\n    userAgent(ctx)\n    ctx.event.region = process.env.FLY_REGION\n  },\n})\n",[519,2547,2548,2568,2588,2592,2605,2609,2632,2645,2664,2675,2705,2710],{"__ignoreMap":631},[635,2549,2550,2552,2554,2557,2559,2561,2563,2566],{"class":637,"line":638},[635,2551,718],{"class":717},[635,2553,722],{"class":721},[635,2555,2556],{"class":725}," createAxiomDrain",[635,2558,729],{"class":721},[635,2560,732],{"class":717},[635,2562,735],{"class":721},[635,2564,2565],{"class":644},"evlog\u002Faxiom",[635,2567,741],{"class":721},[635,2569,2570,2572,2574,2577,2579,2581,2583,2586],{"class":637,"line":744},[635,2571,718],{"class":717},[635,2573,722],{"class":721},[635,2575,2576],{"class":725}," createUserAgentEnricher",[635,2578,729],{"class":721},[635,2580,732],{"class":717},[635,2582,735],{"class":721},[635,2584,2585],{"class":644},"evlog\u002Fenrichers",[635,2587,741],{"class":721},[635,2589,2590],{"class":637,"line":765},[635,2591,823],{"emptyLinePlaceholder":822},[635,2593,2594,2596,2599,2601,2603],{"class":637,"line":786},[635,2595,885],{"class":884},[635,2597,2598],{"class":725}," userAgent ",[635,2600,891],{"class":721},[635,2602,2576],{"class":829},[635,2604,1754],{"class":725},[635,2606,2607],{"class":637,"line":819},[635,2608,823],{"emptyLinePlaceholder":822},[635,2610,2611,2613,2615,2617,2619,2621,2623,2625,2628,2630],{"class":637,"line":826},[635,2612,885],{"class":884},[635,2614,1061],{"class":725},[635,2616,891],{"class":721},[635,2618,798],{"class":829},[635,2620,833],{"class":725},[635,2622,1070],{"class":721},[635,2624,751],{"class":829},[635,2626,2627],{"class":725},"(router)",[635,2629,795],{"class":721},[635,2631,940],{"class":721},[635,2633,2634,2637,2639,2641,2643],{"class":637,"line":839},[635,2635,2636],{"class":842},"  drain",[635,2638,846],{"class":721},[635,2640,2556],{"class":829},[635,2642,910],{"class":725},[635,2644,1042],{"class":721},[635,2646,2647,2650,2652,2655,2658,2660,2662],{"class":637,"line":867},[635,2648,2649],{"class":829},"  enrich",[635,2651,846],{"class":721},[635,2653,2654],{"class":721}," (",[635,2656,2657],{"class":964},"ctx",[635,2659,1039],{"class":721},[635,2661,971],{"class":884},[635,2663,940],{"class":721},[635,2665,2666,2669,2671,2673],{"class":637,"line":876},[635,2667,2668],{"class":829},"    userAgent",[635,2670,833],{"class":842},[635,2672,2657],{"class":725},[635,2674,873],{"class":842},[635,2676,2677,2680,2682,2685,2687,2690,2692,2695,2697,2700,2702],{"class":637,"line":881},[635,2678,2679],{"class":725},"    ctx",[635,2681,546],{"class":721},[635,2683,2684],{"class":725},"event",[635,2686,546],{"class":721},[635,2688,2689],{"class":725},"region",[635,2691,1133],{"class":721},[635,2693,2694],{"class":725}," process",[635,2696,546],{"class":721},[635,2698,2699],{"class":725},"env",[635,2701,546],{"class":721},[635,2703,2704],{"class":725},"FLY_REGION\n",[635,2706,2707],{"class":637,"line":925},[635,2708,2709],{"class":721},"  },\n",[635,2711,2712,2714],{"class":637,"line":930},[635,2713,870],{"class":721},[635,2715,873],{"class":725},[617,2717,2719],{"id":2718},"pipeline-batching-retry","Pipeline (Batching & Retry)",[516,2721,2722,2723,2726],{},"For production, wrap your adapter with ",[519,2724,2725],{},"createDrainPipeline"," to batch events and retry on failure:",[625,2728,2730],{"className":707,"code":2729,"filename":709,"language":710,"meta":631,"style":631},"import type { DrainContext } from 'evlog'\nimport { createAxiomDrain } from 'evlog\u002Faxiom'\nimport { createDrainPipeline } from 'evlog\u002Fpipeline'\n\nconst pipeline = createDrainPipeline\u003CDrainContext>({\n  batch: { size: 50, intervalMs: 5000 },\n  retry: { maxAttempts: 3 },\n})\nconst drain = pipeline(createAxiomDrain())\n\nconst handler = withEvlog(new RPCHandler(router), { drain })\n",[519,2731,2732,2753,2771,2791,2795,2817,2846,2864,2870,2889,2893],{"__ignoreMap":631},[635,2733,2734,2736,2738,2740,2743,2745,2747,2749,2751],{"class":637,"line":638},[635,2735,718],{"class":717},[635,2737,803],{"class":717},[635,2739,722],{"class":721},[635,2741,2742],{"class":725}," DrainContext",[635,2744,729],{"class":721},[635,2746,732],{"class":717},[635,2748,735],{"class":721},[635,2750,781],{"class":644},[635,2752,741],{"class":721},[635,2754,2755,2757,2759,2761,2763,2765,2767,2769],{"class":637,"line":744},[635,2756,718],{"class":717},[635,2758,722],{"class":721},[635,2760,2556],{"class":725},[635,2762,729],{"class":721},[635,2764,732],{"class":717},[635,2766,735],{"class":721},[635,2768,2565],{"class":644},[635,2770,741],{"class":721},[635,2772,2773,2775,2777,2780,2782,2784,2786,2789],{"class":637,"line":765},[635,2774,718],{"class":717},[635,2776,722],{"class":721},[635,2778,2779],{"class":725}," createDrainPipeline",[635,2781,729],{"class":721},[635,2783,732],{"class":717},[635,2785,735],{"class":721},[635,2787,2788],{"class":644},"evlog\u002Fpipeline",[635,2790,741],{"class":721},[635,2792,2793],{"class":637,"line":786},[635,2794,823],{"emptyLinePlaceholder":822},[635,2796,2797,2799,2802,2804,2806,2808,2811,2813,2815],{"class":637,"line":819},[635,2798,885],{"class":884},[635,2800,2801],{"class":725}," pipeline ",[635,2803,891],{"class":721},[635,2805,2779],{"class":829},[635,2807,901],{"class":721},[635,2809,2810],{"class":641},"DrainContext",[635,2812,907],{"class":721},[635,2814,833],{"class":725},[635,2816,836],{"class":721},[635,2818,2819,2822,2824,2826,2829,2831,2834,2836,2839,2841,2844],{"class":637,"line":826},[635,2820,2821],{"class":842},"  batch",[635,2823,846],{"class":721},[635,2825,722],{"class":721},[635,2827,2828],{"class":842}," size",[635,2830,846],{"class":721},[635,2832,2833],{"class":1211}," 50",[635,2835,795],{"class":721},[635,2837,2838],{"class":842}," intervalMs",[635,2840,846],{"class":721},[635,2842,2843],{"class":1211}," 5000",[635,2845,864],{"class":721},[635,2847,2848,2851,2853,2855,2858,2860,2862],{"class":637,"line":839},[635,2849,2850],{"class":842},"  retry",[635,2852,846],{"class":721},[635,2854,722],{"class":721},[635,2856,2857],{"class":842}," maxAttempts",[635,2859,846],{"class":721},[635,2861,2107],{"class":1211},[635,2863,864],{"class":721},[635,2865,2866,2868],{"class":637,"line":867},[635,2867,870],{"class":721},[635,2869,873],{"class":725},[635,2871,2872,2874,2877,2879,2882,2884,2887],{"class":637,"line":876},[635,2873,885],{"class":884},[635,2875,2876],{"class":725}," drain ",[635,2878,891],{"class":721},[635,2880,2881],{"class":829}," pipeline",[635,2883,833],{"class":725},[635,2885,2886],{"class":829},"createAxiomDrain",[635,2888,922],{"class":725},[635,2890,2891],{"class":637,"line":881},[635,2892,823],{"emptyLinePlaceholder":822},[635,2894,2895,2897,2899,2901,2903,2905,2907,2909,2911,2913,2915,2917,2919],{"class":637,"line":925},[635,2896,885],{"class":884},[635,2898,1061],{"class":725},[635,2900,891],{"class":721},[635,2902,798],{"class":829},[635,2904,833],{"class":725},[635,2906,1070],{"class":721},[635,2908,751],{"class":829},[635,2910,2627],{"class":725},[635,2912,795],{"class":721},[635,2914,722],{"class":721},[635,2916,2876],{"class":725},[635,2918,870],{"class":721},[635,2920,873],{"class":725},[548,2922,2923,2924,2927,2928,2931],{"color":550,"icon":13},"Call ",[519,2925,2926],{},"drain.flush()"," on server shutdown to ensure all buffered events are sent. See the ",[557,2929,2930],{"href":477},"Pipeline docs"," for all options.",[613,2933,2935],{"id":2934},"tail-sampling","Tail Sampling",[516,2937,1684,2938,2941],{},[519,2939,2940],{},"keep"," to force-retain specific events regardless of head sampling:",[625,2943,2945],{"className":707,"code":2944,"filename":709,"language":710,"meta":631,"style":631},"const handler = withEvlog(new RPCHandler(router), {\n  drain: createAxiomDrain(),\n  keep: (ctx) => {\n    if (ctx.duration && ctx.duration > 2000) ctx.shouldKeep = true\n  },\n})\n",[519,2946,2947,2969,2981,2998,3042,3046],{"__ignoreMap":631},[635,2948,2949,2951,2953,2955,2957,2959,2961,2963,2965,2967],{"class":637,"line":638},[635,2950,885],{"class":884},[635,2952,1061],{"class":725},[635,2954,891],{"class":721},[635,2956,798],{"class":829},[635,2958,833],{"class":725},[635,2960,1070],{"class":721},[635,2962,751],{"class":829},[635,2964,2627],{"class":725},[635,2966,795],{"class":721},[635,2968,940],{"class":721},[635,2970,2971,2973,2975,2977,2979],{"class":637,"line":744},[635,2972,2636],{"class":842},[635,2974,846],{"class":721},[635,2976,2556],{"class":829},[635,2978,910],{"class":725},[635,2980,1042],{"class":721},[635,2982,2983,2986,2988,2990,2992,2994,2996],{"class":637,"line":765},[635,2984,2985],{"class":829},"  keep",[635,2987,846],{"class":721},[635,2989,2654],{"class":721},[635,2991,2657],{"class":964},[635,2993,1039],{"class":721},[635,2995,971],{"class":884},[635,2997,940],{"class":721},[635,2999,3000,3003,3005,3007,3009,3012,3015,3018,3020,3022,3025,3028,3030,3032,3034,3037,3039],{"class":637,"line":786},[635,3001,3002],{"class":717},"    if",[635,3004,2654],{"class":842},[635,3006,2657],{"class":725},[635,3008,546],{"class":721},[635,3010,3011],{"class":725},"duration",[635,3013,3014],{"class":721}," &&",[635,3016,3017],{"class":725}," ctx",[635,3019,546],{"class":721},[635,3021,3011],{"class":725},[635,3023,3024],{"class":721}," >",[635,3026,3027],{"class":1211}," 2000",[635,3029,1559],{"class":842},[635,3031,2657],{"class":725},[635,3033,546],{"class":721},[635,3035,3036],{"class":725},"shouldKeep",[635,3038,1133],{"class":721},[635,3040,3041],{"class":1026}," true\n",[635,3043,3044],{"class":637,"line":819},[635,3045,2709],{"class":721},[635,3047,3048,3050],{"class":637,"line":826},[635,3049,870],{"class":721},[635,3051,873],{"class":725},[613,3053,3055],{"id":3054},"route-filtering","Route Filtering",[516,3057,3058,2511,3061,3064],{},[519,3059,3060],{},"include",[519,3062,3063],{},"exclude"," match against the HTTP path (the request URL), not the procedure name:",[625,3066,3068],{"className":707,"code":3067,"filename":709,"language":710,"meta":631,"style":631},"const handler = withEvlog(new RPCHandler(router), {\n  include: ['\u002Frpc\u002F**'],\n  exclude: ['\u002Frpc\u002F_internal\u002F**', '\u002Fhealth'],\n  routes: {\n    '\u002Frpc\u002Fauth\u002F**': { service: 'auth-service' },\n    '\u002Frpc\u002Fpayment\u002F**': { service: 'payment-service' },\n  },\n})\n",[519,3069,3070,3092,3114,3143,3152,3179,3205,3209],{"__ignoreMap":631},[635,3071,3072,3074,3076,3078,3080,3082,3084,3086,3088,3090],{"class":637,"line":638},[635,3073,885],{"class":884},[635,3075,1061],{"class":725},[635,3077,891],{"class":721},[635,3079,798],{"class":829},[635,3081,833],{"class":725},[635,3083,1070],{"class":721},[635,3085,751],{"class":829},[635,3087,2627],{"class":725},[635,3089,795],{"class":721},[635,3091,940],{"class":721},[635,3093,3094,3097,3099,3102,3104,3107,3109,3112],{"class":637,"line":744},[635,3095,3096],{"class":842},"  include",[635,3098,846],{"class":721},[635,3100,3101],{"class":725}," [",[635,3103,861],{"class":721},[635,3105,3106],{"class":644},"\u002Frpc\u002F**",[635,3108,861],{"class":721},[635,3110,3111],{"class":725},"]",[635,3113,1042],{"class":721},[635,3115,3116,3119,3121,3123,3125,3128,3130,3132,3134,3137,3139,3141],{"class":637,"line":765},[635,3117,3118],{"class":842},"  exclude",[635,3120,846],{"class":721},[635,3122,3101],{"class":725},[635,3124,861],{"class":721},[635,3126,3127],{"class":644},"\u002Frpc\u002F_internal\u002F**",[635,3129,861],{"class":721},[635,3131,795],{"class":721},[635,3133,735],{"class":721},[635,3135,3136],{"class":644},"\u002Fhealth",[635,3138,861],{"class":721},[635,3140,3111],{"class":725},[635,3142,1042],{"class":721},[635,3144,3145,3148,3150],{"class":637,"line":786},[635,3146,3147],{"class":842},"  routes",[635,3149,846],{"class":721},[635,3151,940],{"class":721},[635,3153,3154,3157,3160,3162,3164,3166,3168,3170,3172,3175,3177],{"class":637,"line":819},[635,3155,3156],{"class":721},"    '",[635,3158,3159],{"class":842},"\u002Frpc\u002Fauth\u002F**",[635,3161,861],{"class":721},[635,3163,846],{"class":721},[635,3165,722],{"class":721},[635,3167,851],{"class":842},[635,3169,846],{"class":721},[635,3171,735],{"class":721},[635,3173,3174],{"class":644},"auth-service",[635,3176,861],{"class":721},[635,3178,864],{"class":721},[635,3180,3181,3183,3186,3188,3190,3192,3194,3196,3198,3201,3203],{"class":637,"line":826},[635,3182,3156],{"class":721},[635,3184,3185],{"class":842},"\u002Frpc\u002Fpayment\u002F**",[635,3187,861],{"class":721},[635,3189,846],{"class":721},[635,3191,722],{"class":721},[635,3193,851],{"class":842},[635,3195,846],{"class":721},[635,3197,735],{"class":721},[635,3199,3200],{"class":644},"payment-service",[635,3202,861],{"class":721},[635,3204,864],{"class":721},[635,3206,3207],{"class":637,"line":839},[635,3208,2709],{"class":721},[635,3210,3211,3213],{"class":637,"line":867},[635,3212,870],{"class":721},[635,3214,873],{"class":725},[516,3216,3217,3218,3220],{},"When a route is filtered out, the wrapper still injects a no-op ",[519,3219,541],{}," so procedures never crash on missing fields — the wide event simply isn't emitted and drain\u002Fenrich aren't called.",[613,3222,3224],{"id":3223},"run-locally","Run Locally",[625,3226,3229],{"className":627,"code":3227,"filename":3228,"language":630,"meta":631,"style":631},"git clone https:\u002F\u002Fgithub.com\u002Fhugorcd\u002Fevlog.git\ncd evlog\npnpm install\npnpm example orpc\n","Terminal",[519,3230,3231,3242,3250,3257],{"__ignoreMap":631},[635,3232,3233,3236,3239],{"class":637,"line":638},[635,3234,3235],{"class":641},"git",[635,3237,3238],{"class":644}," clone",[635,3240,3241],{"class":644}," https:\u002F\u002Fgithub.com\u002Fhugorcd\u002Fevlog.git\n",[635,3243,3244,3247],{"class":637,"line":744},[635,3245,3246],{"class":829},"cd",[635,3248,3249],{"class":644}," evlog\n",[635,3251,3252,3254],{"class":637,"line":765},[635,3253,629],{"class":641},[635,3255,3256],{"class":644}," install\n",[635,3258,3259,3261,3264],{"class":637,"line":786},[635,3260,629],{"class":641},[635,3262,3263],{"class":644}," example",[635,3265,3266],{"class":644}," orpc\n",[516,3268,3269,3270,3274],{},"Open ",[557,3271,3272],{"href":3272,"rel":3273},"http:\u002F\u002Flocalhost:3000",[561]," to explore the interactive test UI.",[3276,3277,3278],"card-group",{},[3279,3280,3284],"card",{"icon":3281,"title":3282,"to":3283},"i-simple-icons-github","Source Code","https:\u002F\u002Fgithub.com\u002Fhugorcd\u002Fevlog\u002Ftree\u002Fmain\u002Fexamples\u002Forpc","Browse the complete oRPC example source on GitHub.",[613,3286,3288],{"id":3287},"next-steps","Next Steps",[516,3290,3291,3292,3294],{},"Deepen your ",[552,3293,284],{}," integration:",[576,3296,3297,3302,3307,3312],{},[579,3298,3299,3301],{},[557,3300,46],{"href":47},": Design comprehensive events with context layering",[579,3303,3304,3306],{},[557,3305,133],{"href":138},": Send logs to Axiom, Sentry, PostHog, and more",[579,3308,3309,3311],{},[557,3310,61],{"href":62},": Control log volume with head and tail sampling",[579,3313,3314,3316,3317,530,3319,1999,3321,3323],{},[557,3315,51],{"href":52},": Throw errors with ",[519,3318,1995],{},[519,3320,1998],{},[519,3322,2002],{}," fields",[3325,3326,3327],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}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 .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 .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}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 .sfNiH, html code.shiki .sfNiH{--shiki-light:#FF5370;--shiki-default:#FF9CAC;--shiki-dark:#FF9CAC}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}",{"title":631,"searchDepth":744,"depth":744,"links":3329},[3330,3334,3335,3336,3337,3338,3341,3342,3343,3344],{"id":615,"depth":744,"text":25,"children":3331},[3332,3333],{"id":619,"depth":765,"text":620},{"id":703,"depth":765,"text":704},{"id":1260,"depth":744,"text":46},{"id":1680,"depth":744,"text":1681},{"id":1985,"depth":744,"text":1986},{"id":2521,"depth":744,"text":485},{"id":2534,"depth":744,"text":2535,"children":3339},[3340],{"id":2718,"depth":765,"text":2719},{"id":2934,"depth":744,"text":2935},{"id":3054,"depth":744,"text":3055},{"id":3223,"depth":744,"text":3224},{"id":3287,"depth":744,"text":3288},"Automatic wide events, structured errors, drain adapters, enrichers, and tail sampling in oRPC applications.","md",[3348],{"label":3282,"icon":3281,"to":3283,"color":3349,"variant":3350},"neutral","subtle",{},{"title":284,"icon":287},{"title":284,"description":3345},"gyncde24bawCNEH50sjk2x71RzNmXEaFaer2u1Zpvv4",[3356,3358],{"title":279,"path":280,"stem":281,"description":3357,"icon":282,"children":-1},"Wide events and structured errors in Astro server middleware.",{"title":289,"path":290,"stem":291,"description":3359,"icon":292,"children":-1},"Wide events and structured logging in AWS Lambda functions, including SQS consumers and event-driven handlers.",1785609202475]