[{"data":1,"prerenderedAt":1416},["ShallowReactive",2],{"navigation":3,"examples-nav":445,"-examples-tracing":552,"-examples-tracing-surround":1413},[4,123,260,266,430,442],{"title":5,"path":6,"stem":7,"children":8,"icon":122},"","\u002Fdocs","1.docs\u002F1.index",[9,12,17,22,27,32,37,42,47,52,57,62,67,72,77,82,87,92,97,102,107,112,117],{"title":10,"path":6,"stem":7,"icon":11},"Introduction","i-lucide-compass",{"title":13,"path":14,"stem":15,"icon":16},"Quick Start","\u002Fdocs\u002Fquick-start","1.docs\u002F2.quick-start","i-lucide-zap",{"title":18,"path":19,"stem":20,"icon":21},"Renderer","\u002Fdocs\u002Frenderer","1.docs\u002F4.renderer","ri:layout-masonry-line",{"title":23,"path":24,"stem":25,"icon":26},"Routing","\u002Fdocs\u002Frouting","1.docs\u002F5.routing","ri:direction-line",{"title":28,"path":29,"stem":30,"icon":31},"Assets","\u002Fdocs\u002Fassets","1.docs\u002F50.assets","ri:image-2-line",{"title":33,"path":34,"stem":35,"icon":36},"Configuration","\u002Fdocs\u002Fconfiguration","1.docs\u002F50.configuration","ri:settings-3-line",{"title":38,"path":39,"stem":40,"icon":41},"Database","\u002Fdocs\u002Fdatabase","1.docs\u002F50.database","ri:database-2-line",{"title":43,"path":44,"stem":45,"icon":46},"Lifecycle","\u002Fdocs\u002Flifecycle","1.docs\u002F50.lifecycle","i-lucide-layers",{"title":48,"path":49,"stem":50,"icon":51},"OpenAPI","\u002Fdocs\u002Fopenapi","1.docs\u002F50.openapi","ri:contract-line",{"title":53,"path":54,"stem":55,"icon":56},"Plugins","\u002Fdocs\u002Fplugins","1.docs\u002F50.plugins","ri:plug-line",{"title":58,"path":59,"stem":60,"icon":61},"Prerendering","\u002Fdocs\u002Fprerendering","1.docs\u002F50.prerendering","ri:file-copy-2-line",{"title":63,"path":64,"stem":65,"icon":66},"Tasks","\u002Fdocs\u002Ftasks","1.docs\u002F50.tasks","codicon:run-all",{"title":68,"path":69,"stem":70,"icon":71},"WebSocket","\u002Fdocs\u002Fwebsocket","1.docs\u002F50.websocket","ri:broadcast-fill",{"title":73,"path":74,"stem":75,"icon":76},"Modules","\u002Fdocs\u002Fmodules","1.docs\u002F55.modules","i-lucide-puzzle",{"title":78,"path":79,"stem":80,"icon":81},"Server Entry","\u002Fdocs\u002Fserver-entry","1.docs\u002F6.server-entry","ri:server-line",{"title":83,"path":84,"stem":85,"icon":86},"CLI","\u002Fdocs\u002Fcli","1.docs\u002F60.cli","i-lucide-terminal",{"title":88,"path":89,"stem":90,"icon":91},"Vite","\u002Fdocs\u002Fvite","1.docs\u002F61.vite","i-logos-vitejs",{"title":93,"path":94,"stem":95,"icon":96},"Utils","\u002Fdocs\u002Futils","1.docs\u002F62.utils","i-lucide-braces",{"title":98,"path":99,"stem":100,"icon":101},"TypeScript","\u002Fdocs\u002Ftypescript","1.docs\u002F63.typescript","i-logos-typescript-icon",{"title":103,"path":104,"stem":105,"icon":106},"Cache","\u002Fdocs\u002Fcache","1.docs\u002F7.cache","ri:speed-line",{"title":108,"path":109,"stem":110,"icon":111},"KV Storage","\u002Fdocs\u002Fstorage","1.docs\u002F8.storage","carbon:datastore",{"title":113,"path":114,"stem":115,"icon":116},"Migration Guide","\u002Fdocs\u002Fmigration","1.docs\u002F99.migration","ri:arrow-right-up-line",{"title":118,"path":119,"stem":120,"icon":121},"Nightly Channel","\u002Fdocs\u002Fnightly","1.docs\u002F99.nightly","ri:moon-fill","i-lucide-book-open",{"title":124,"path":125,"stem":126,"children":127,"icon":129},"Deploy","\u002Fdeploy","2.deploy\u002F0.index",[128,130,155],{"title":124,"path":125,"stem":126,"icon":129},"ri:upload-cloud-2-line",{"title":131,"path":132,"stem":133,"children":134,"page":154},"Runtimes","\u002Fdeploy\u002Fruntimes","2.deploy\u002F10.runtimes",[135,140,145,150],{"title":136,"path":137,"stem":138,"icon":139},"Node.js","\u002Fdeploy\u002Fruntimes\u002Fnode","2.deploy\u002F10.runtimes\u002F1.node","akar-icons:node-fill",{"title":141,"path":142,"stem":143,"icon":144},"Bun","\u002Fdeploy\u002Fruntimes\u002Fbun","2.deploy\u002F10.runtimes\u002Fbun","simple-icons:bun",{"title":146,"path":147,"stem":148,"icon":149},"Deno","\u002Fdeploy\u002Fruntimes\u002Fdeno","2.deploy\u002F10.runtimes\u002Fdeno","simple-icons:deno",{"title":151,"path":152,"stem":153},"Standard","\u002Fdeploy\u002Fruntimes\u002Fstandard","2.deploy\u002F10.runtimes\u002Fstandard",false,{"title":156,"path":157,"stem":158,"children":159,"page":154},"Providers","\u002Fdeploy\u002Fproviders","2.deploy\u002F20.providers",[160,164,168,172,176,180,184,188,192,196,200,204,208,212,216,220,224,228,232,236,240,244,248,252,256],{"title":161,"path":162,"stem":163},"Alwaysdata","\u002Fdeploy\u002Fproviders\u002Falwaysdata","2.deploy\u002F20.providers\u002Falwaysdata",{"title":165,"path":166,"stem":167},"AWS Lambda","\u002Fdeploy\u002Fproviders\u002Faws","2.deploy\u002F20.providers\u002Faws",{"title":169,"path":170,"stem":171},"AWS Amplify","\u002Fdeploy\u002Fproviders\u002Faws-amplify","2.deploy\u002F20.providers\u002Faws-amplify",{"title":173,"path":174,"stem":175},"Azure","\u002Fdeploy\u002Fproviders\u002Fazure","2.deploy\u002F20.providers\u002Fazure",{"title":177,"path":178,"stem":179},"Cleavr","\u002Fdeploy\u002Fproviders\u002Fcleavr","2.deploy\u002F20.providers\u002Fcleavr",{"title":181,"path":182,"stem":183},"Cloudflare","\u002Fdeploy\u002Fproviders\u002Fcloudflare","2.deploy\u002F20.providers\u002Fcloudflare",{"title":185,"path":186,"stem":187},"Deno Deploy","\u002Fdeploy\u002Fproviders\u002Fdeno-deploy","2.deploy\u002F20.providers\u002Fdeno-deploy",{"title":189,"path":190,"stem":191},"DigitalOcean","\u002Fdeploy\u002Fproviders\u002Fdigitalocean","2.deploy\u002F20.providers\u002Fdigitalocean",{"title":193,"path":194,"stem":195},"EdgeOne Pages","\u002Fdeploy\u002Fproviders\u002Fedgeone","2.deploy\u002F20.providers\u002Fedgeone",{"title":197,"path":198,"stem":199},"Firebase","\u002Fdeploy\u002Fproviders\u002Ffirebase","2.deploy\u002F20.providers\u002Ffirebase",{"title":201,"path":202,"stem":203},"Flightcontrol","\u002Fdeploy\u002Fproviders\u002Fflightcontrol","2.deploy\u002F20.providers\u002Fflightcontrol",{"title":205,"path":206,"stem":207},"Genezio","\u002Fdeploy\u002Fproviders\u002Fgenezio","2.deploy\u002F20.providers\u002Fgenezio",{"title":209,"path":210,"stem":211},"GitHub Pages","\u002Fdeploy\u002Fproviders\u002Fgithub-pages","2.deploy\u002F20.providers\u002Fgithub-pages",{"title":213,"path":214,"stem":215},"GitLab Pages","\u002Fdeploy\u002Fproviders\u002Fgitlab-pages","2.deploy\u002F20.providers\u002Fgitlab-pages",{"title":217,"path":218,"stem":219},"Heroku","\u002Fdeploy\u002Fproviders\u002Fheroku","2.deploy\u002F20.providers\u002Fheroku",{"title":221,"path":222,"stem":223},"IIS","\u002Fdeploy\u002Fproviders\u002Fiis","2.deploy\u002F20.providers\u002Fiis",{"title":225,"path":226,"stem":227},"Koyeb","\u002Fdeploy\u002Fproviders\u002Fkoyeb","2.deploy\u002F20.providers\u002Fkoyeb",{"title":229,"path":230,"stem":231},"Netlify","\u002Fdeploy\u002Fproviders\u002Fnetlify","2.deploy\u002F20.providers\u002Fnetlify",{"title":233,"path":234,"stem":235},"Platform.sh","\u002Fdeploy\u002Fproviders\u002Fplatform-sh","2.deploy\u002F20.providers\u002Fplatform-sh",{"title":237,"path":238,"stem":239},"Render.com","\u002Fdeploy\u002Fproviders\u002Frender","2.deploy\u002F20.providers\u002Frender",{"title":241,"path":242,"stem":243},"Stormkit","\u002Fdeploy\u002Fproviders\u002Fstormkit","2.deploy\u002F20.providers\u002Fstormkit",{"title":245,"path":246,"stem":247},"Vercel","\u002Fdeploy\u002Fproviders\u002Fvercel","2.deploy\u002F20.providers\u002Fvercel",{"title":249,"path":250,"stem":251},"Zeabur","\u002Fdeploy\u002Fproviders\u002Fzeabur","2.deploy\u002F20.providers\u002Fzeabur",{"title":253,"path":254,"stem":255},"Zephyr Cloud","\u002Fdeploy\u002Fproviders\u002Fzephyr","2.deploy\u002F20.providers\u002Fzephyr",{"title":257,"path":258,"stem":259},"Zerops","\u002Fdeploy\u002Fproviders\u002Fzerops","2.deploy\u002F20.providers\u002Fzerops",{"title":261,"path":262,"stem":263,"children":264,"icon":36},"Config","\u002Fconfig","3.config\u002F0.index",[265],{"title":261,"path":262,"stem":263,"icon":36},{"title":267,"path":268,"stem":269,"children":270,"icon":272},"Examples","\u002Fexamples","4.examples\u002F0.index",[271,273,278,283,288,293,297,302,307,312,317,322,327,331,336,340,344,349,354,359,364,369,374,379,383,388,393,398,402,407,412,416,421,426],{"title":267,"path":268,"stem":269,"icon":272},"i-lucide-folder-code",{"title":274,"path":275,"stem":276,"icon":277},"API Routes","\u002Fexamples\u002Fapi-routes","4.examples\u002Fapi-routes","i-lucide-route",{"title":279,"path":280,"stem":281,"icon":282},"Auto Imports","\u002Fexamples\u002Fauto-imports","4.examples\u002Fauto-imports","i-lucide-import",{"title":284,"path":285,"stem":286,"icon":287},"Cached Handler","\u002Fexamples\u002Fcached-handler","4.examples\u002Fcached-handler","i-lucide-clock",{"title":289,"path":290,"stem":291,"icon":292},"Custom Error Handler","\u002Fexamples\u002Fcustom-error-handler","4.examples\u002Fcustom-error-handler","i-lucide-alert-circle",{"title":38,"path":294,"stem":295,"icon":296},"\u002Fexamples\u002Fdatabase","4.examples\u002Fdatabase","i-lucide-database",{"title":298,"path":299,"stem":300,"icon":301},"Elysia","\u002Fexamples\u002Felysia","4.examples\u002Felysia","i-skill-icons-elysia-dark",{"title":303,"path":304,"stem":305,"icon":306},"Express","\u002Fexamples\u002Fexpress","4.examples\u002Fexpress","i-simple-icons-express",{"title":308,"path":309,"stem":310,"icon":311},"Fastify","\u002Fexamples\u002Ffastify","4.examples\u002Ffastify","i-simple-icons-fastify",{"title":313,"path":314,"stem":315,"icon":316},"Hello World","\u002Fexamples\u002Fhello-world","4.examples\u002Fhello-world","i-lucide-sparkles",{"title":318,"path":319,"stem":320,"icon":321},"Hono","\u002Fexamples\u002Fhono","4.examples\u002Fhono","i-logos-hono",{"title":323,"path":324,"stem":325,"icon":326},"Import Alias","\u002Fexamples\u002Fimport-alias","4.examples\u002Fimport-alias","i-lucide-at-sign",{"title":328,"path":329,"stem":330,"icon":46},"Middleware","\u002Fexamples\u002Fmiddleware","4.examples\u002Fmiddleware",{"title":332,"path":333,"stem":334,"icon":335},"Mono JSX","\u002Fexamples\u002Fmono-jsx","4.examples\u002Fmono-jsx","i-lucide-brackets",{"title":337,"path":338,"stem":339,"icon":335},"Nano JSX","\u002Fexamples\u002Fnano-jsx","4.examples\u002Fnano-jsx",{"title":53,"path":341,"stem":342,"icon":343},"\u002Fexamples\u002Fplugins","4.examples\u002Fplugins","i-lucide-plug",{"title":345,"path":346,"stem":347,"icon":348},"Custom Renderer","\u002Fexamples\u002Frenderer","4.examples\u002Frenderer","i-lucide-code",{"title":350,"path":351,"stem":352,"icon":353},"Runtime Config","\u002Fexamples\u002Fruntime-config","4.examples\u002Fruntime-config","i-lucide-settings",{"title":355,"path":356,"stem":357,"icon":358},"Server Fetch","\u002Fexamples\u002Fserver-fetch","4.examples\u002Fserver-fetch","i-lucide-arrow-right-left",{"title":360,"path":361,"stem":362,"icon":363},"Shiki","\u002Fexamples\u002Fshiki","4.examples\u002Fshiki","i-lucide-highlighter",{"title":365,"path":366,"stem":367,"icon":368},"Takumi","\u002Fexamples\u002Ftakumi","4.examples\u002Ftakumi","i-lucide-image",{"title":370,"path":371,"stem":372,"icon":373},"Tracing","\u002Fexamples\u002Ftracing","4.examples\u002Ftracing","i-lucide-activity",{"title":375,"path":376,"stem":377,"icon":378},"Virtual Routes","\u002Fexamples\u002Fvirtual-routes","4.examples\u002Fvirtual-routes","i-lucide-box",{"title":380,"path":381,"stem":382,"icon":91},"Vite Nitro Plugin","\u002Fexamples\u002Fvite-nitro-plugin","4.examples\u002Fvite-nitro-plugin",{"title":384,"path":385,"stem":386,"icon":387},"Vite RSC","\u002Fexamples\u002Fvite-rsc","4.examples\u002Fvite-rsc","i-logos-react",{"title":389,"path":390,"stem":391,"icon":392},"Vite SSR HTML","\u002Fexamples\u002Fvite-ssr-html","4.examples\u002Fvite-ssr-html","i-logos-html-5",{"title":394,"path":395,"stem":396,"icon":397},"SSR with Preact","\u002Fexamples\u002Fvite-ssr-preact","4.examples\u002Fvite-ssr-preact","i-logos-preact",{"title":399,"path":400,"stem":401,"icon":387},"SSR with React","\u002Fexamples\u002Fvite-ssr-react","4.examples\u002Fvite-ssr-react",{"title":403,"path":404,"stem":405,"icon":406},"SSR with SolidJS","\u002Fexamples\u002Fvite-ssr-solid","4.examples\u002Fvite-ssr-solid","i-logos-solidjs-icon",{"title":408,"path":409,"stem":410,"icon":411},"SSR with TanStack Router","\u002Fexamples\u002Fvite-ssr-tsr-react","4.examples\u002Fvite-ssr-tsr-react","i-simple-icons-tanstack",{"title":413,"path":414,"stem":415,"icon":411},"SSR with TanStack Start","\u002Fexamples\u002Fvite-ssr-tss-react","4.examples\u002Fvite-ssr-tss-react",{"title":417,"path":418,"stem":419,"icon":420},"SSR with Vue Router","\u002Fexamples\u002Fvite-ssr-vue-router","4.examples\u002Fvite-ssr-vue-router","i-logos-vue",{"title":422,"path":423,"stem":424,"icon":425},"Vite + tRPC","\u002Fexamples\u002Fvite-trpc","4.examples\u002Fvite-trpc","i-simple-icons-trpc",{"title":68,"path":427,"stem":428,"icon":429},"\u002Fexamples\u002Fwebsocket","4.examples\u002Fwebsocket","i-lucide-radio",{"title":431,"path":432,"stem":433,"children":434},"Blog","\u002Fblog","9.blog",[435,438],{"title":431,"path":432,"stem":436,"icon":437},"9.blog\u002Findex","i-lucide-file-text",{"title":439,"path":440,"stem":441,"icon":437},"Nitro v3 Beta is here!","\u002Fblog\u002Fv3-beta","9.blog\u002F1.v3-beta",{"title":5,"path":443,"stem":444},"\u002F","index",[446,451,455,458,461,464,468,471,474,477,480,483,486,490,493,496,499,502,505,509,512,515,518,522,525,528,531,534,537,540,543,546,549],{"title":274,"description":447,"meta":448,"path":275},"File-based API routing with HTTP method support and dynamic parameters.",{"automd":449,"category":450,"icon":277},true,"features",{"title":279,"description":452,"meta":453,"path":280},"Automatic imports for utilities and composables.",{"automd":449,"category":454,"icon":282},"config",{"title":284,"description":456,"meta":457,"path":285},"Cache route responses with configurable bypass logic.",{"automd":449,"category":450,"icon":287},{"title":289,"description":459,"meta":460,"path":290},"Customize error responses with a global error handler.",{"automd":449,"category":450,"icon":292},{"title":38,"description":462,"meta":463,"path":294},"Built-in database support with SQL template literals.",{"automd":449,"category":450,"icon":296},{"title":298,"description":465,"meta":466,"path":299},"Integrate Elysia with Nitro using the server entry.",{"automd":449,"category":467,"icon":301},"backend frameworks",{"title":303,"description":469,"meta":470,"path":304},"Integrate Express with Nitro using the server entry.",{"automd":449,"category":467,"icon":306},{"title":308,"description":472,"meta":473,"path":309},"Integrate Fastify with Nitro using the server entry.",{"automd":449,"category":467,"icon":311},{"title":313,"description":475,"meta":476,"path":314},"Minimal Nitro server using the web standard fetch handler.",{"automd":449,"category":450,"icon":316},{"title":318,"description":478,"meta":479,"path":319},"Integrate Hono with Nitro using the server entry.",{"automd":449,"category":467,"icon":321},{"title":323,"description":481,"meta":482,"path":324},"Custom import aliases for cleaner module paths.",{"automd":449,"category":454,"icon":326},{"title":328,"description":484,"meta":485,"path":329},"Request middleware for authentication, logging, and request modification.",{"automd":449,"category":450,"icon":46},{"title":332,"description":487,"meta":488,"path":333},"Server-side JSX rendering in Nitro with mono-jsx.",{"automd":449,"category":489,"icon":335},"server side rendering",{"title":337,"description":491,"meta":492,"path":338},"Server-side JSX rendering in Nitro with nano-jsx.",{"automd":449,"category":489,"icon":335},{"title":53,"description":494,"meta":495,"path":341},"Extend Nitro with custom plugins for hooks and lifecycle events.",{"automd":449,"category":450,"icon":343},{"title":345,"description":497,"meta":498,"path":346},"Build a custom HTML renderer in Nitro with server-side data fetching.",{"automd":449,"category":489,"icon":348},{"title":350,"description":500,"meta":501,"path":351},"Environment-aware configuration with runtime access.",{"automd":449,"category":454,"icon":353},{"title":355,"description":503,"meta":504,"path":356},"Internal server-to-server requests without network overhead.",{"automd":449,"category":450,"icon":358},{"title":360,"description":506,"meta":507,"path":361},"Server-side syntax highlighting in Nitro with Shiki.",{"automd":449,"category":508,"icon":363},"integrations",{"title":365,"description":510,"meta":511,"path":366},"Generate dynamic Open Graph images from a Nitro route using Takumi.",{"automd":449,"category":508,"icon":368},{"title":370,"description":513,"meta":514,"path":371},"Instrument the request lifecycle with diagnostics channels and the built-in tracing logger.",{"automd":449,"category":450,"icon":373},{"title":375,"description":516,"meta":517,"path":376},"Define routes programmatically using Nitro's virtual module system.",{"automd":449,"category":450,"icon":378},{"title":380,"description":519,"meta":520,"path":381},"Use Nitro as a Vite plugin for programmatic configuration.",{"automd":449,"category":521,"icon":91},"vite",{"title":384,"description":523,"meta":524,"path":385},"React Server Components with Vite and Nitro.",{"automd":449,"category":521,"icon":387},{"title":389,"description":526,"meta":527,"path":390},"Server-side rendering with vanilla HTML, Vite, and Nitro.",{"automd":449,"category":489,"icon":392},{"title":394,"description":529,"meta":530,"path":395},"Server-side rendering with Preact in Nitro using Vite.",{"automd":449,"category":489,"icon":397},{"title":399,"description":532,"meta":533,"path":400},"Server-side rendering with React in Nitro using Vite.",{"automd":449,"category":489,"icon":387},{"title":403,"description":535,"meta":536,"path":404},"Server-side rendering with SolidJS in Nitro using Vite.",{"automd":449,"category":489,"icon":406},{"title":408,"description":538,"meta":539,"path":409},"Client-side routing with TanStack Router in Nitro using Vite.",{"automd":449,"category":489,"icon":411},{"title":413,"description":541,"meta":542,"path":414},"Full-stack React with TanStack Start in Nitro using Vite.",{"automd":449,"category":489,"icon":411},{"title":417,"description":544,"meta":545,"path":418},"Server-side rendering with Vue Router in Nitro using Vite.",{"automd":449,"category":489,"icon":420},{"title":422,"description":547,"meta":548,"path":423},"End-to-end typesafe APIs with tRPC in Nitro using Vite.",{"automd":449,"category":521,"icon":425},{"title":68,"description":550,"meta":551,"path":427},"Real-time bidirectional communication with WebSocket support.",{"automd":449,"category":450,"icon":429},{"id":553,"title":370,"body":554,"description":513,"extension":1408,"meta":1409,"navigation":1410,"path":371,"seo":1411,"stem":372,"__hash__":1412},"content\u002F4.examples\u002Ftracing.md",{"type":555,"value":556,"toc":1403,"icon":373},"minimark",[557,1125,1137,1142,1213,1231,1235,1273,1276,1284,1299,1317,1321,1399],[558,559,562,689,788,812,886,1058],"code-tree",{":expand-all":560,"default-value":561},"true","nitro.config.ts",[563,564,568],"pre",{"className":565,"code":566,"filename":561,"language":567,"meta":5,"style":5},"language-ts shiki shiki-themes github-light github-dark github-dark","import { defineConfig } from \"nitro\";\n\nexport default defineConfig({\n  serverDir: true,\n\n  \u002F\u002F Instrument the h3, srvx and unstorage tracing channels.\n  tracingChannel: true,\n\n  experimental: {\n    \u002F\u002F Log every completed span to the console (built-in, dependency-free sink).\n    tracingLogger: true,\n  },\n});\n","ts",[569,570,571,594,600,616,628,633,640,650,655,661,667,677,683],"code",{"__ignoreMap":5},[572,573,576,580,584,587,591],"span",{"class":574,"line":575},"line",1,[572,577,579],{"class":578},"so5gQ","import",[572,581,583],{"class":582},"slsVL"," { defineConfig } ",[572,585,586],{"class":578},"from",[572,588,590],{"class":589},"sfrk1"," \"nitro\"",[572,592,593],{"class":582},";\n",[572,595,597],{"class":574,"line":596},2,[572,598,599],{"emptyLinePlaceholder":449},"\n",[572,601,603,606,609,613],{"class":574,"line":602},3,[572,604,605],{"class":578},"export",[572,607,608],{"class":578}," default",[572,610,612],{"class":611},"shcOC"," defineConfig",[572,614,615],{"class":582},"({\n",[572,617,619,622,625],{"class":574,"line":618},4,[572,620,621],{"class":582},"  serverDir: ",[572,623,560],{"class":624},"suiK_",[572,626,627],{"class":582},",\n",[572,629,631],{"class":574,"line":630},5,[572,632,599],{"emptyLinePlaceholder":449},[572,634,636],{"class":574,"line":635},6,[572,637,639],{"class":638},"sCsY4","  \u002F\u002F Instrument the h3, srvx and unstorage tracing channels.\n",[572,641,643,646,648],{"class":574,"line":642},7,[572,644,645],{"class":582},"  tracingChannel: ",[572,647,560],{"class":624},[572,649,627],{"class":582},[572,651,653],{"class":574,"line":652},8,[572,654,599],{"emptyLinePlaceholder":449},[572,656,658],{"class":574,"line":657},9,[572,659,660],{"class":582},"  experimental: {\n",[572,662,664],{"class":574,"line":663},10,[572,665,666],{"class":638},"    \u002F\u002F Log every completed span to the console (built-in, dependency-free sink).\n",[572,668,670,673,675],{"class":574,"line":669},11,[572,671,672],{"class":582},"    tracingLogger: ",[572,674,560],{"class":624},[572,676,627],{"class":582},[572,678,680],{"class":574,"line":679},12,[572,681,682],{"class":582},"  },\n",[572,684,686],{"class":574,"line":685},13,[572,687,688],{"class":582},"});\n",[563,690,695],{"className":691,"code":692,"filename":693,"language":694,"meta":5,"style":5},"language-json shiki shiki-themes github-light github-dark github-dark","{\n  \"type\": \"module\",\n  \"scripts\": {\n    \"build\": \"nitro build\",\n    \"dev\": \"nitro dev\",\n    \"preview\": \"node .output\u002Fserver\u002Findex.mjs\"\n  },\n  \"devDependencies\": {\n    \"nitro\": \"latest\"\n  }\n}\n","package.json","json",[569,696,697,702,715,723,735,747,757,761,768,778,783],{"__ignoreMap":5},[572,698,699],{"class":574,"line":575},[572,700,701],{"class":582},"{\n",[572,703,704,707,710,713],{"class":574,"line":596},[572,705,706],{"class":624},"  \"type\"",[572,708,709],{"class":582},": ",[572,711,712],{"class":589},"\"module\"",[572,714,627],{"class":582},[572,716,717,720],{"class":574,"line":602},[572,718,719],{"class":624},"  \"scripts\"",[572,721,722],{"class":582},": {\n",[572,724,725,728,730,733],{"class":574,"line":618},[572,726,727],{"class":624},"    \"build\"",[572,729,709],{"class":582},[572,731,732],{"class":589},"\"nitro build\"",[572,734,627],{"class":582},[572,736,737,740,742,745],{"class":574,"line":630},[572,738,739],{"class":624},"    \"dev\"",[572,741,709],{"class":582},[572,743,744],{"class":589},"\"nitro dev\"",[572,746,627],{"class":582},[572,748,749,752,754],{"class":574,"line":635},[572,750,751],{"class":624},"    \"preview\"",[572,753,709],{"class":582},[572,755,756],{"class":589},"\"node .output\u002Fserver\u002Findex.mjs\"\n",[572,758,759],{"class":574,"line":642},[572,760,682],{"class":582},[572,762,763,766],{"class":574,"line":652},[572,764,765],{"class":624},"  \"devDependencies\"",[572,767,722],{"class":582},[572,769,770,773,775],{"class":574,"line":657},[572,771,772],{"class":624},"    \"nitro\"",[572,774,709],{"class":582},[572,776,777],{"class":589},"\"latest\"\n",[572,779,780],{"class":574,"line":663},[572,781,782],{"class":582},"  }\n",[572,784,785],{"class":574,"line":669},[572,786,787],{"class":582},"}\n",[563,789,792],{"className":691,"code":790,"filename":791,"language":694,"meta":5,"style":5},"{\n  \"extends\": \"nitro\u002Ftsconfig\"\n}\n","tsconfig.json",[569,793,794,798,808],{"__ignoreMap":5},[572,795,796],{"class":574,"line":575},[572,797,701],{"class":582},[572,799,800,803,805],{"class":574,"line":596},[572,801,802],{"class":624},"  \"extends\"",[572,804,709],{"class":582},[572,806,807],{"class":589},"\"nitro\u002Ftsconfig\"\n",[572,809,810],{"class":574,"line":602},[572,811,787],{"class":582},[563,813,816],{"className":565,"code":814,"filename":815,"language":567,"meta":5,"style":5},"import { defineMiddleware } from \"nitro\";\n\n\u002F\u002F A trivial middleware — each request produces its own `middleware` span.\nexport default defineMiddleware((event) => {\n  event.context.requestedAt = Date.now();\n});\n","server\u002Fmiddleware\u002Ftiming.ts",[569,817,818,831,835,840,865,882],{"__ignoreMap":5},[572,819,820,822,825,827,829],{"class":574,"line":575},[572,821,579],{"class":578},[572,823,824],{"class":582}," { defineMiddleware } ",[572,826,586],{"class":578},[572,828,590],{"class":589},[572,830,593],{"class":582},[572,832,833],{"class":574,"line":596},[572,834,599],{"emptyLinePlaceholder":449},[572,836,837],{"class":574,"line":602},[572,838,839],{"class":638},"\u002F\u002F A trivial middleware — each request produces its own `middleware` span.\n",[572,841,842,844,846,849,852,856,859,862],{"class":574,"line":618},[572,843,605],{"class":578},[572,845,608],{"class":578},[572,847,848],{"class":611}," defineMiddleware",[572,850,851],{"class":582},"((",[572,853,855],{"class":854},"sQHwn","event",[572,857,858],{"class":582},") ",[572,860,861],{"class":578},"=>",[572,863,864],{"class":582}," {\n",[572,866,867,870,873,876,879],{"class":574,"line":630},[572,868,869],{"class":582},"  event.context.requestedAt ",[572,871,872],{"class":578},"=",[572,874,875],{"class":582}," Date.",[572,877,878],{"class":611},"now",[572,880,881],{"class":582},"();\n",[572,883,884],{"class":574,"line":635},[572,885,688],{"class":582},[563,887,890],{"className":565,"code":888,"filename":889,"language":567,"meta":5,"style":5},"import { defineHandler } from \"nitro\";\nimport { useStorage } from \"nitro\u002Fstorage\";\n\n\u002F\u002F Reads and writes storage so the request emits `unstorage.*` spans (CLIENT)\n\u002F\u002F alongside the `srvx.request`, `middleware` and route (`h3.request`) spans.\nexport default defineHandler(async () => {\n  const storage = useStorage();\n  const hits = ((await storage.getItem\u003Cnumber>(\"hits\")) ?? 0) + 1;\n  await storage.setItem(\"hits\", hits);\n  return { message: \"Hello from the Nitro tracing demo\", hits };\n});\n","server\u002Froutes\u002Findex.ts",[569,891,892,905,919,923,928,933,955,971,1023,1040,1054],{"__ignoreMap":5},[572,893,894,896,899,901,903],{"class":574,"line":575},[572,895,579],{"class":578},[572,897,898],{"class":582}," { defineHandler } ",[572,900,586],{"class":578},[572,902,590],{"class":589},[572,904,593],{"class":582},[572,906,907,909,912,914,917],{"class":574,"line":596},[572,908,579],{"class":578},[572,910,911],{"class":582}," { useStorage } ",[572,913,586],{"class":578},[572,915,916],{"class":589}," \"nitro\u002Fstorage\"",[572,918,593],{"class":582},[572,920,921],{"class":574,"line":602},[572,922,599],{"emptyLinePlaceholder":449},[572,924,925],{"class":574,"line":618},[572,926,927],{"class":638},"\u002F\u002F Reads and writes storage so the request emits `unstorage.*` spans (CLIENT)\n",[572,929,930],{"class":574,"line":630},[572,931,932],{"class":638},"\u002F\u002F alongside the `srvx.request`, `middleware` and route (`h3.request`) spans.\n",[572,934,935,937,939,942,945,948,951,953],{"class":574,"line":635},[572,936,605],{"class":578},[572,938,608],{"class":578},[572,940,941],{"class":611}," defineHandler",[572,943,944],{"class":582},"(",[572,946,947],{"class":578},"async",[572,949,950],{"class":582}," () ",[572,952,861],{"class":578},[572,954,864],{"class":582},[572,956,957,960,963,966,969],{"class":574,"line":642},[572,958,959],{"class":578},"  const",[572,961,962],{"class":624}," storage",[572,964,965],{"class":578}," =",[572,967,968],{"class":611}," useStorage",[572,970,881],{"class":582},[572,972,973,975,978,980,983,986,989,992,995,998,1001,1004,1007,1010,1013,1015,1018,1021],{"class":574,"line":652},[572,974,959],{"class":578},[572,976,977],{"class":624}," hits",[572,979,965],{"class":578},[572,981,982],{"class":582}," ((",[572,984,985],{"class":578},"await",[572,987,988],{"class":582}," storage.",[572,990,991],{"class":611},"getItem",[572,993,994],{"class":582},"\u003C",[572,996,997],{"class":624},"number",[572,999,1000],{"class":582},">(",[572,1002,1003],{"class":589},"\"hits\"",[572,1005,1006],{"class":582},")) ",[572,1008,1009],{"class":578},"??",[572,1011,1012],{"class":624}," 0",[572,1014,858],{"class":582},[572,1016,1017],{"class":578},"+",[572,1019,1020],{"class":624}," 1",[572,1022,593],{"class":582},[572,1024,1025,1028,1030,1033,1035,1037],{"class":574,"line":657},[572,1026,1027],{"class":578},"  await",[572,1029,988],{"class":582},[572,1031,1032],{"class":611},"setItem",[572,1034,944],{"class":582},[572,1036,1003],{"class":589},[572,1038,1039],{"class":582},", hits);\n",[572,1041,1042,1045,1048,1051],{"class":574,"line":663},[572,1043,1044],{"class":578},"  return",[572,1046,1047],{"class":582}," { message: ",[572,1049,1050],{"class":589},"\"Hello from the Nitro tracing demo\"",[572,1052,1053],{"class":582},", hits };\n",[572,1055,1056],{"class":574,"line":669},[572,1057,688],{"class":582},[563,1059,1062],{"className":565,"code":1060,"filename":1061,"language":567,"meta":5,"style":5},"import { defineHandler } from \"nitro\";\n\n\u002F\u002F A dynamic route — spans are named by the matched route template\n\u002F\u002F (`GET \u002Fusers\u002F:id`), not the concrete path, to keep cardinality low.\nexport default defineHandler((event) => ({\n  user: { id: event.context.params!.id },\n}));\n","server\u002Froutes\u002Fusers\u002F[id].ts",[569,1063,1064,1076,1080,1085,1090,1109,1120],{"__ignoreMap":5},[572,1065,1066,1068,1070,1072,1074],{"class":574,"line":575},[572,1067,579],{"class":578},[572,1069,898],{"class":582},[572,1071,586],{"class":578},[572,1073,590],{"class":589},[572,1075,593],{"class":582},[572,1077,1078],{"class":574,"line":596},[572,1079,599],{"emptyLinePlaceholder":449},[572,1081,1082],{"class":574,"line":602},[572,1083,1084],{"class":638},"\u002F\u002F A dynamic route — spans are named by the matched route template\n",[572,1086,1087],{"class":574,"line":618},[572,1088,1089],{"class":638},"\u002F\u002F (`GET \u002Fusers\u002F:id`), not the concrete path, to keep cardinality low.\n",[572,1091,1092,1094,1096,1098,1100,1102,1104,1106],{"class":574,"line":630},[572,1093,605],{"class":578},[572,1095,608],{"class":578},[572,1097,941],{"class":611},[572,1099,851],{"class":582},[572,1101,855],{"class":854},[572,1103,858],{"class":582},[572,1105,861],{"class":578},[572,1107,1108],{"class":582}," ({\n",[572,1110,1111,1114,1117],{"class":574,"line":635},[572,1112,1113],{"class":582},"  user: { id: event.context.params",[572,1115,1116],{"class":578},"!",[572,1118,1119],{"class":582},".id },\n",[572,1121,1122],{"class":574,"line":642},[572,1123,1124],{"class":582},"}));\n",[1126,1127,1128,1129,1136],"p",{},"Nitro can instrument its request lifecycle through Node ",[1130,1131,1135],"a",{"href":1132,"rel":1133},"https:\u002F\u002Fnodejs.org\u002Fapi\u002Fdiagnostics_channel.html",[1134],"nofollow","diagnostics channels"," — no OpenTelemetry SDK required. This example turns instrumentation on and enables the built-in console logger, which groups every h3, srvx and unstorage span into a per-request timeline (waterfall).",[1138,1139,1141],"h2",{"id":1140},"enabling-tracing","Enabling tracing",[563,1143,1145],{"className":565,"code":1144,"filename":561,"language":567,"meta":5,"style":5},"import { defineConfig } from \"nitro\";\n\nexport default defineConfig({\n  \u002F\u002F Instrument the h3, srvx and unstorage tracing channels.\n  tracingChannel: true,\n\n  experimental: {\n    \u002F\u002F Log every completed span to the console (built-in, dependency-free sink).\n    tracingLogger: true,\n  },\n});\n",[569,1146,1147,1159,1163,1173,1177,1185,1189,1193,1197,1205,1209],{"__ignoreMap":5},[572,1148,1149,1151,1153,1155,1157],{"class":574,"line":575},[572,1150,579],{"class":578},[572,1152,583],{"class":582},[572,1154,586],{"class":578},[572,1156,590],{"class":589},[572,1158,593],{"class":582},[572,1160,1161],{"class":574,"line":596},[572,1162,599],{"emptyLinePlaceholder":449},[572,1164,1165,1167,1169,1171],{"class":574,"line":602},[572,1166,605],{"class":578},[572,1168,608],{"class":578},[572,1170,612],{"class":611},[572,1172,615],{"class":582},[572,1174,1175],{"class":574,"line":618},[572,1176,639],{"class":638},[572,1178,1179,1181,1183],{"class":574,"line":630},[572,1180,645],{"class":582},[572,1182,560],{"class":624},[572,1184,627],{"class":582},[572,1186,1187],{"class":574,"line":635},[572,1188,599],{"emptyLinePlaceholder":449},[572,1190,1191],{"class":574,"line":642},[572,1192,660],{"class":582},[572,1194,1195],{"class":574,"line":652},[572,1196,666],{"class":638},[572,1198,1199,1201,1203],{"class":574,"line":657},[572,1200,672],{"class":582},[572,1202,560],{"class":624},[572,1204,627],{"class":582},[572,1206,1207],{"class":574,"line":663},[572,1208,682],{"class":582},[572,1210,1211],{"class":574,"line":669},[572,1212,688],{"class":582},[1126,1214,1215,1218,1219,1222,1223,1226,1227,1230],{},[569,1216,1217],{},"tracingChannel: true"," wires up the producers (it accepts ",[569,1220,1221],{},"{ h3, srvx, unstorage }"," to trace a subset). ",[569,1224,1225],{},"experimental.tracingLogger"," adds a built-in sink that ",[569,1228,1229],{},"console.log","s each completed span — a dependency-free alternative to a vendor exporter, handy for local development.",[1138,1232,1234],{"id":1233},"try-it","Try it",[563,1236,1240],{"className":1237,"code":1238,"language":1239,"meta":5,"style":5},"language-sh shiki shiki-themes github-light github-dark github-dark","npm run dev\n# then, in another terminal:\ncurl http:\u002F\u002Flocalhost:3000\u002F\ncurl http:\u002F\u002Flocalhost:3000\u002Fusers\u002F42\n","sh",[569,1241,1242,1253,1258,1266],{"__ignoreMap":5},[572,1243,1244,1247,1250],{"class":574,"line":575},[572,1245,1246],{"class":611},"npm",[572,1248,1249],{"class":589}," run",[572,1251,1252],{"class":589}," dev\n",[572,1254,1255],{"class":574,"line":596},[572,1256,1257],{"class":638},"# then, in another terminal:\n",[572,1259,1260,1263],{"class":574,"line":602},[572,1261,1262],{"class":611},"curl",[572,1264,1265],{"class":589}," http:\u002F\u002Flocalhost:3000\u002F\n",[572,1267,1268,1270],{"class":574,"line":618},[572,1269,1262],{"class":611},[572,1271,1272],{"class":589}," http:\u002F\u002Flocalhost:3000\u002Fusers\u002F42\n",[1126,1274,1275],{},"Each request prints a timeline of its spans to the console — the middleware, the matched route, and every storage operation, positioned and sized by when they ran and how long they took:",[563,1277,1282],{"className":1278,"code":1280,"language":1281},[1279],"language-text","▶ GET \u002F  4.10ms  (4 spans)\n  middleware GET \u002F             █·······················   0.12ms h3.handler_type=middleware http.route=\u002F\n  GET \u002F                        ·███████████████████·····   2.49ms h3.handler_type=route http.route=\u002F\n  getItem                      ···██····················   0.18ms db.operation=getItem db.system=memory unstorage.keys_count=1\n  setItem                      ·····██··················   0.16ms db.operation=setItem db.system=memory unstorage.keys_count=1\n","text",[569,1283,1280],{"__ignoreMap":5},[1126,1285,1286,1287,1290,1291,1294,1295,1298],{},"The header line (",[569,1288,1289],{},"▶",") is the request itself — its method, path and total time; the rows below are the spans that ran within it. Note the dynamic route is named by its matched template — ",[569,1292,1293],{},"GET \u002Fusers\u002F:id",", not ",[569,1296,1297],{},"\u002Fusers\u002F42"," — keeping span names low-cardinality per the OpenTelemetry HTTP conventions.",[1126,1300,1301,1302,443,1305,1308,1309,1312,1313,1316],{},"The request boundary comes from Nitro's ",[569,1303,1304],{},"request",[569,1306,1307],{},"response"," runtime hooks, so grouping works identically in ",[569,1310,1311],{},"vite dev"," and in a production build. Spans are grouped per request via async context, so timelines for concurrent requests stay separate, and a failed span is marked ",[569,1314,1315],{},"✖"," with its error message.",[1138,1318,1320],{"id":1319},"what-gets-traced","What gets traced",[1322,1323,1324,1340],"table",{},[1325,1326,1327],"thead",{},[1328,1329,1330,1334,1337],"tr",{},[1331,1332,1333],"th",{},"Channel",[1331,1335,1336],{},"Span",[1331,1338,1339],{},"Emitted by",[1341,1342,1343,1363,1386],"tbody",{},[1328,1344,1345,1351,1354],{},[1346,1347,1348],"td",{},[569,1349,1350],{},"h3.request",[1346,1352,1353],{},"each matched route and middleware",[1346,1355,1356,1359,1360],{},[569,1357,1358],{},"server\u002Froutes\u002F*",", ",[569,1361,1362],{},"server\u002Fmiddleware\u002F*",[1328,1364,1365,1370,1378],{},[1346,1366,1367],{},[569,1368,1369],{},"unstorage.*",[1346,1371,1372,1373,1359,1375,1377],{},"each storage operation (",[569,1374,991],{},[569,1376,1032],{},", …)",[1346,1379,1380,1383,1384],{},[569,1381,1382],{},"useStorage()"," in ",[569,1385,889],{},[1328,1387,1388,1393,1396],{},[1346,1389,1390],{},[569,1391,1392],{},"srvx.request",[1346,1394,1395],{},"the whole request, with response status (production server)",[1346,1397,1398],{},"the srvx server layer",[1400,1401,1402],"style",{},"html pre.shiki code .so5gQ, html code.shiki .so5gQ{--shiki-light:#D73A49;--shiki-default:#F97583;--shiki-dark:#F97583}html pre.shiki code .slsVL, html code.shiki .slsVL{--shiki-light:#24292E;--shiki-default:#E1E4E8;--shiki-dark:#E1E4E8}html pre.shiki code .sfrk1, html code.shiki .sfrk1{--shiki-light:#032F62;--shiki-default:#9ECBFF;--shiki-dark:#9ECBFF}html pre.shiki code .shcOC, html code.shiki .shcOC{--shiki-light:#6F42C1;--shiki-default:#B392F0;--shiki-dark:#B392F0}html pre.shiki code .suiK_, html code.shiki .suiK_{--shiki-light:#005CC5;--shiki-default:#79B8FF;--shiki-dark:#79B8FF}html pre.shiki code .sCsY4, html code.shiki .sCsY4{--shiki-light:#6A737D;--shiki-default:#6A737D;--shiki-dark:#6A737D}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 .sQHwn, html code.shiki .sQHwn{--shiki-light:#E36209;--shiki-default:#FFAB70;--shiki-dark:#FFAB70}",{"title":5,"searchDepth":596,"depth":596,"links":1404},[1405,1406,1407],{"id":1140,"depth":596,"text":1141},{"id":1233,"depth":596,"text":1234},{"id":1319,"depth":596,"text":1320},"md",{"automd":449,"category":450,"icon":373},{"icon":373},{"title":370,"description":513},"ezuMQGTbSeq6TEV8Q3r48xLKW4axYcxqAn0If4xqdeU",[1414,1415],{"title":365,"path":366,"stem":367,"description":510,"icon":368,"children":-1},{"title":375,"path":376,"stem":377,"description":516,"icon":378,"children":-1},1784019075794]