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