[{"data":1,"prerenderedAt":1544},["ShallowReactive",2],{"docs-navigation:en":3,"content-page:docs:FgzBwh0FCLOPxT9gG2W4vpQGp-twC_s_iZFw_GTpLMw":842,"content-page-surround:docs:FgzBwh0FCLOPxT9gG2W4vpQGp-twC_s_iZFw_GTpLMw":1539},[4,41,110,540,643,708,772,837],{"title":5,"page":6,"canonicalKey":7,"locale":8,"id":9,"draft":6,"icon":10,"sidebar":11,"children":12},"Learn",false,"1","en","content:docs:1.overview:.navigation.yml","i-lucide-book-open","section",[13,20,27,34],{"title":14,"id":15,"canonicalKey":16,"locale":8,"draft":6,"navigation":17,"icon":18,"path":19},"Better Convex Nuxt","content:docs:1.overview:1.introduction.md","1\u002F1",{"icon":18},"i-lucide-orbit","\u002Fdocs\u002Foverview\u002Fintroduction",{"title":21,"id":22,"canonicalKey":23,"locale":8,"draft":6,"navigation":24,"icon":25,"path":26},"Who it is for","content:docs:1.overview:2.who-it-is-for.md","1\u002F2",{"icon":25},"i-lucide-users","\u002Fdocs\u002Foverview\u002Fwho-it-is-for",{"title":28,"id":29,"canonicalKey":30,"locale":8,"draft":6,"navigation":31,"icon":32,"path":33},"Limitations and trade-offs","content:docs:1.overview:3.limitations.md","1\u002F3",{"icon":32},"i-lucide-triangle-alert","\u002Fdocs\u002Foverview\u002Flimitations",{"title":35,"id":36,"canonicalKey":37,"locale":8,"draft":6,"navigation":38,"icon":39,"path":40},"Compare Nuxt integrations","content:docs:1.overview:4.comparison.md","1\u002F4",{"icon":39},"i-lucide-scale","\u002Fdocs\u002Foverview\u002Fcomparison",{"title":42,"page":6,"canonicalKey":43,"locale":8,"id":44,"draft":6,"icon":45,"children":46},"Get started","2","content:docs:2.get-started:.navigation.yml","i-lucide-rocket",[47,54,61,68,75,82,89,96,103],{"title":48,"id":49,"canonicalKey":50,"locale":8,"draft":6,"navigation":51,"icon":52,"path":53},"Choose your path","content:docs:2.get-started:1.choose-your-path.md","2\u002F1",{"icon":52},"i-lucide-signpost","\u002Fdocs\u002Fget-started\u002Fchoose-your-path",{"title":55,"id":56,"canonicalKey":57,"locale":8,"draft":6,"navigation":58,"icon":59,"path":60},"Installation","content:docs:2.get-started:2.installation.md","2\u002F2",{"icon":59},"i-lucide-download","\u002Fdocs\u002Fget-started\u002Finstallation",{"title":62,"id":63,"canonicalKey":64,"locale":8,"draft":6,"navigation":65,"icon":66,"path":67},"First real-time page","content:docs:2.get-started:3.first-realtime-page.md","2\u002F3",{"icon":66},"i-lucide-radio","\u002Fdocs\u002Fget-started\u002Ffirst-realtime-page",{"title":69,"id":70,"canonicalKey":71,"locale":8,"draft":6,"navigation":72,"icon":73,"path":74},"Complete and delete","content:docs:2.get-started:4.complete-and-delete.md","2\u002F4",{"icon":73},"i-lucide-square-check","\u002Fdocs\u002Fget-started\u002Fcomplete-and-delete",{"title":76,"id":77,"canonicalKey":78,"locale":8,"draft":6,"navigation":79,"icon":80,"path":81},"Add authentication","content:docs:2.get-started:5.add-authentication.md","2\u002F5",{"icon":80},"i-lucide-log-in","\u002Fdocs\u002Fget-started\u002Fadd-authentication",{"title":83,"id":84,"canonicalKey":85,"locale":8,"draft":6,"navigation":86,"icon":87,"path":88},"Protect data","content:docs:2.get-started:6.protect-data.md","2\u002F6",{"icon":87},"i-lucide-shield-check","\u002Fdocs\u002Fget-started\u002Fprotect-data",{"title":90,"id":91,"canonicalKey":92,"locale":8,"draft":6,"navigation":93,"icon":94,"path":95},"Project structure","content:docs:2.get-started:7.project-structure.md","2\u002F7",{"icon":94},"i-lucide-folder-tree","\u002Fdocs\u002Fget-started\u002Fproject-structure",{"title":97,"id":98,"canonicalKey":99,"locale":8,"draft":6,"navigation":100,"icon":101,"path":102},"Next steps","content:docs:2.get-started:8.next-steps.md","2\u002F8",{"icon":101},"i-lucide-arrow-right","\u002Fdocs\u002Fget-started\u002Fnext-steps",{"title":104,"id":105,"canonicalKey":106,"locale":8,"draft":6,"navigation":107,"icon":108,"path":109},"Plain Vue and Vite","content:docs:2.get-started:9.plain-vue.md","2\u002F9",{"icon":108},"i-lucide-panels-top-left","\u002Fdocs\u002Fget-started\u002Fplain-vue",{"title":111,"page":6,"canonicalKey":112,"locale":8,"id":113,"draft":6,"icon":114,"sidebar":11,"children":115},"Build","3","content:docs:3.build:.navigation.yml","i-lucide-blocks",[116,154,200,321,353,385,431,481],{"title":117,"page":6,"canonicalKey":118,"locale":8,"children":119},"Queries","3\u002F1",[120,126,133,140,147],{"title":117,"id":121,"canonicalKey":122,"locale":8,"draft":6,"navigation":123,"icon":124,"path":125},"content:docs:3.build:1.queries:1.queries.md","3\u002F1\u002F1",{"icon":124},"i-lucide-database","\u002Fdocs\u002Fbuild\u002Fqueries\u002Fqueries",{"title":127,"id":128,"canonicalKey":129,"locale":8,"draft":6,"navigation":130,"icon":131,"path":132},"Reactive arguments","content:docs:3.build:1.queries:2.reactive-arguments.md","3\u002F1\u002F2",{"icon":131},"i-lucide-sliders-horizontal","\u002Fdocs\u002Fbuild\u002Fqueries\u002Freactive-arguments",{"title":134,"id":135,"canonicalKey":136,"locale":8,"draft":6,"navigation":137,"icon":138,"path":139},"Loading and stale data","content:docs:3.build:1.queries:3.loading-and-stale-data.md","3\u002F1\u002F3",{"icon":138},"i-lucide-loader-circle","\u002Fdocs\u002Fbuild\u002Fqueries\u002Floading-and-stale-data",{"title":141,"id":142,"canonicalKey":143,"locale":8,"draft":6,"navigation":144,"icon":145,"path":146},"Query execution options","content:docs:3.build:1.queries:4.ssr-options.md","3\u002F1\u002F4",{"icon":145},"i-lucide-server-cog","\u002Fdocs\u002Fbuild\u002Fqueries\u002Fssr-options",{"title":148,"id":149,"canonicalKey":150,"locale":8,"draft":6,"navigation":151,"icon":152,"path":153},"Pagination","content:docs:3.build:1.queries:6.pagination.md","3\u002F1\u002F6",{"icon":152},"i-lucide-list-plus","\u002Fdocs\u002Fbuild\u002Fqueries\u002Fpagination",{"title":155,"page":6,"canonicalKey":156,"locale":8,"children":157},"Write Data","3\u002F2",[158,165,172,179,186,193],{"title":159,"id":160,"canonicalKey":161,"locale":8,"draft":6,"navigation":162,"icon":163,"path":164},"Mutations","content:docs:3.build:2.write-data:1.mutations.md","3\u002F2\u002F1",{"icon":163},"i-lucide-square-pen","\u002Fdocs\u002Fbuild\u002Fwrite-data\u002Fmutations",{"title":166,"id":167,"canonicalKey":168,"locale":8,"draft":6,"navigation":169,"icon":170,"path":171},"Actions","content:docs:3.build:2.write-data:2.actions.md","3\u002F2\u002F2",{"icon":170},"i-lucide-zap","\u002Fdocs\u002Fbuild\u002Fwrite-data\u002Factions",{"title":173,"id":174,"canonicalKey":175,"locale":8,"draft":6,"navigation":176,"icon":177,"path":178},"Optimistic updates","content:docs:3.build:2.write-data:3.optimistic-updates.md","3\u002F2\u002F3",{"icon":177},"i-lucide-gauge","\u002Fdocs\u002Fbuild\u002Fwrite-data\u002Foptimistic-updates",{"title":180,"id":181,"canonicalKey":182,"locale":8,"draft":6,"navigation":183,"icon":184,"path":185},"Concurrent operations","content:docs:3.build:2.write-data:4.concurrent-operations.md","3\u002F2\u002F4",{"icon":184},"i-lucide-git-fork","\u002Fdocs\u002Fbuild\u002Fwrite-data\u002Fconcurrent-operations",{"title":187,"id":188,"canonicalKey":189,"locale":8,"draft":6,"navigation":190,"icon":191,"path":192},"Form submissions","content:docs:3.build:2.write-data:5.forms.md","3\u002F2\u002F5",{"icon":191},"i-lucide-list-checks","\u002Fdocs\u002Fbuild\u002Fwrite-data\u002Fforms",{"title":194,"id":195,"canonicalKey":196,"locale":8,"draft":6,"navigation":197,"icon":198,"path":199},"Multi-step operations","content:docs:3.build:2.write-data:6.multi-step-operations.md","3\u002F2\u002F6",{"icon":198},"i-lucide-list-ordered","\u002Fdocs\u002Fbuild\u002Fwrite-data\u002Fmulti-step-operations",{"title":201,"page":6,"canonicalKey":202,"locale":8,"children":203},"Authentication","3\u002F3",[204,210,217,224,230,237,244,251,258,265,272,279,286,293,300,307,314],{"title":201,"id":205,"canonicalKey":206,"locale":8,"draft":6,"navigation":207,"icon":208,"path":209},"content:docs:3.build:3.authentication:1.overview.md","3\u002F3\u002F1",{"icon":208},"i-lucide-shield","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Foverview",{"title":211,"id":212,"canonicalKey":213,"locale":8,"draft":6,"navigation":214,"icon":215,"path":216},"Better Auth setup","content:docs:3.build:3.authentication:2.better-auth-setup.md","3\u002F3\u002F2",{"icon":215},"i-lucide-settings-2","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fbetter-auth-setup",{"title":218,"id":219,"canonicalKey":220,"locale":8,"draft":6,"navigation":221,"icon":222,"path":223},"Auth state and user data","content:docs:3.build:3.authentication:3.auth-state-and-user.md","3\u002F3\u002F3",{"icon":222},"i-lucide-user-round","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fauth-state-and-user",{"title":225,"id":226,"canonicalKey":227,"locale":8,"draft":6,"navigation":228,"icon":80,"path":229},"Sign in and sign out","content:docs:3.build:3.authentication:4.sign-in-and-sign-out.md","3\u002F3\u002F4",{"icon":80},"\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fsign-in-and-sign-out",{"title":231,"id":232,"canonicalKey":233,"locale":8,"draft":6,"navigation":234,"icon":235,"path":236},"Route protection","content:docs:3.build:3.authentication:5.route-protection.md","3\u002F3\u002F5",{"icon":235},"i-lucide-route","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Froute-protection",{"title":238,"id":239,"canonicalKey":240,"locale":8,"draft":6,"navigation":241,"icon":242,"path":243},"Backend authorization","content:docs:3.build:3.authentication:6.backend-authorization.md","3\u002F3\u002F6",{"icon":242},"i-lucide-lock-keyhole","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fbackend-authorization",{"title":245,"id":246,"canonicalKey":247,"locale":8,"draft":6,"navigation":248,"icon":249,"path":250},"Better Auth plugins","content:docs:3.build:3.authentication:7.better-auth-plugins.md","3\u002F3\u002F7",{"icon":249},"i-lucide-plug","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fbetter-auth-plugins",{"title":252,"id":253,"canonicalKey":254,"locale":8,"draft":6,"navigation":255,"icon":256,"path":257},"Custom user fields","content:docs:3.build:3.authentication:8.custom-user-fields.md","3\u002F3\u002F8",{"icon":256},"i-lucide-user-cog","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fcustom-user-fields",{"title":259,"id":260,"canonicalKey":261,"locale":8,"draft":6,"navigation":262,"icon":263,"path":264},"User synchronization","content:docs:3.build:3.authentication:9.user-synchronization.md","3\u002F3\u002F9",{"icon":263},"i-lucide-refresh-ccw","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fuser-synchronization",{"title":266,"id":267,"canonicalKey":268,"locale":8,"draft":6,"navigation":269,"icon":270,"path":271},"Delegated OAuth and MCP","content:docs:3.build:3.authentication:10.delegated-oauth-and-mcp.md","3\u002F3\u002F10",{"icon":270},"i-lucide-bot","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fdelegated-oauth-and-mcp",{"title":273,"id":274,"canonicalKey":275,"locale":8,"draft":6,"navigation":276,"icon":277,"path":278},"Transactional auth email","content:docs:3.build:3.authentication:11.transactional-email.md","3\u002F3\u002F11",{"icon":277},"i-lucide-mail","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Ftransactional-email",{"title":280,"id":281,"canonicalKey":282,"locale":8,"draft":6,"navigation":283,"icon":284,"path":285},"Social sign-in","content:docs:3.build:3.authentication:12.social-sign-in.md","3\u002F3\u002F12",{"icon":284},"i-lucide-github","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fsocial-sign-in",{"title":287,"id":288,"canonicalKey":289,"locale":8,"draft":6,"navigation":290,"icon":291,"path":292},"Better Auth plugin support","content:docs:3.build:3.authentication:13.better-auth-plugin-support.md","3\u002F3\u002F13",{"icon":291},"i-lucide-puzzle","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fbetter-auth-plugin-support",{"title":294,"id":295,"canonicalKey":296,"locale":8,"draft":6,"navigation":297,"icon":298,"path":299},"Cacheable public pages","content:docs:3.build:3.authentication:14.cacheable-public-pages.md","3\u002F3\u002F14",{"icon":298},"i-lucide-globe","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fcacheable-public-pages",{"title":301,"id":302,"canonicalKey":303,"locale":8,"draft":6,"navigation":304,"icon":305,"path":306},"Several sites on one deployment","content:docs:3.build:3.authentication:15.multiple-site-origins.md","3\u002F3\u002F15",{"icon":305},"i-lucide-network","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fmultiple-site-origins",{"title":308,"id":309,"canonicalKey":310,"locale":8,"draft":6,"navigation":311,"icon":312,"path":313},"Account deletion","content:docs:3.build:3.authentication:16.account-deletion.md","3\u002F3\u002F16",{"icon":312},"i-lucide-user-x","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Faccount-deletion",{"title":315,"id":316,"canonicalKey":317,"locale":8,"draft":6,"navigation":318,"icon":319,"path":320},"Company sign-in (OIDC)","content:docs:3.build:3.authentication:17.company-sign-in.md","3\u002F3\u002F17",{"icon":319},"i-lucide-building-2","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fcompany-sign-in",{"title":322,"page":6,"canonicalKey":323,"locale":8,"children":324},"Server","3\u002F4",[325,332,339,346],{"title":326,"id":327,"canonicalKey":328,"locale":8,"draft":6,"navigation":329,"icon":330,"path":331},"serverConvex","content:docs:3.build:4.server:1.server-convex.md","3\u002F4\u002F1",{"icon":330},"i-lucide-server","\u002Fdocs\u002Fbuild\u002Fserver\u002Fserver-convex",{"title":333,"id":334,"canonicalKey":335,"locale":8,"draft":6,"navigation":336,"icon":337,"path":338},"Server routes","content:docs:3.build:4.server:2.server-routes.md","3\u002F4\u002F2",{"icon":337},"i-lucide-waypoints","\u002Fdocs\u002Fbuild\u002Fserver\u002Fserver-routes",{"title":340,"id":341,"canonicalKey":342,"locale":8,"draft":6,"navigation":343,"icon":344,"path":345},"Webhooks and jobs","content:docs:3.build:4.server:3.webhooks-and-jobs.md","3\u002F4\u002F3",{"icon":344},"i-lucide-webhook","\u002Fdocs\u002Fbuild\u002Fserver\u002Fwebhooks-and-jobs",{"title":347,"id":348,"canonicalKey":349,"locale":8,"draft":6,"navigation":350,"icon":351,"path":352},"Credentials and server security","content:docs:3.build:4.server:4.credentials-and-security.md","3\u002F4\u002F4",{"icon":351},"i-lucide-key-round","\u002Fdocs\u002Fbuild\u002Fserver\u002Fcredentials-and-security",{"title":354,"page":6,"canonicalKey":355,"locale":8,"children":356},"Files","3\u002F5",[357,364,371,378],{"title":358,"id":359,"canonicalKey":360,"locale":8,"draft":6,"navigation":361,"icon":362,"path":363},"Upload files","content:docs:3.build:5.files:1.upload-files.md","3\u002F5\u002F1",{"icon":362},"i-lucide-upload","\u002Fdocs\u002Fbuild\u002Ffiles\u002Fupload-files",{"title":365,"id":366,"canonicalKey":367,"locale":8,"draft":6,"navigation":368,"icon":369,"path":370},"Storage URLs","content:docs:3.build:5.files:3.storage-urls.md","3\u002F5\u002F3",{"icon":369},"i-lucide-link","\u002Fdocs\u002Fbuild\u002Ffiles\u002Fstorage-urls",{"title":372,"id":373,"canonicalKey":374,"locale":8,"draft":6,"navigation":375,"icon":376,"path":377},"File validation and deletion","content:docs:3.build:5.files:4.validation-and-deletion.md","3\u002F5\u002F4",{"icon":376},"i-lucide-file-x","\u002Fdocs\u002Fbuild\u002Ffiles\u002Fvalidation-and-deletion",{"title":379,"id":380,"canonicalKey":381,"locale":8,"draft":6,"navigation":382,"icon":383,"path":384},"Private downloads","content:docs:3.build:5.files:5.private-downloads.md","3\u002F5\u002F5",{"icon":383},"i-lucide-file-lock","\u002Fdocs\u002Fbuild\u002Ffiles\u002Fprivate-downloads",{"title":386,"page":6,"canonicalKey":387,"locale":8,"children":388},"Application Behavior","3\u002F6",[389,396,403,410,417,424],{"title":390,"id":391,"canonicalKey":392,"locale":8,"draft":6,"navigation":393,"icon":394,"path":395},"Connection state","content:docs:3.build:6.application-behavior:1.connection-state.md","3\u002F6\u002F1",{"icon":394},"i-lucide-wifi","\u002Fdocs\u002Fbuild\u002Fapplication-behavior\u002Fconnection-state",{"title":397,"id":398,"canonicalKey":399,"locale":8,"draft":6,"navigation":400,"icon":401,"path":402},"Error handling","content:docs:3.build:6.application-behavior:2.error-handling.md","3\u002F6\u002F2",{"icon":401},"i-lucide-circle-alert","\u002Fdocs\u002Fbuild\u002Fapplication-behavior\u002Ferror-handling",{"title":404,"id":405,"canonicalKey":406,"locale":8,"draft":6,"navigation":407,"icon":408,"path":409},"Logging","content:docs:3.build:6.application-behavior:3.logging.md","3\u002F6\u002F3",{"icon":408},"i-lucide-scroll-text","\u002Fdocs\u002Fbuild\u002Fapplication-behavior\u002Flogging",{"title":411,"id":412,"canonicalKey":413,"locale":8,"draft":6,"navigation":414,"icon":415,"path":416},"DevTools","content:docs:3.build:6.application-behavior:4.devtools.md","3\u002F6\u002F4",{"icon":415},"i-lucide-wrench","\u002Fdocs\u002Fbuild\u002Fapplication-behavior\u002Fdevtools",{"title":418,"id":419,"canonicalKey":420,"locale":8,"draft":6,"navigation":421,"icon":422,"path":423},"Performance","content:docs:3.build:6.application-behavior:5.performance.md","3\u002F6\u002F5",{"icon":422},"i-lucide-chart-no-axes-combined","\u002Fdocs\u002Fbuild\u002Fapplication-behavior\u002Fperformance",{"title":425,"id":426,"canonicalKey":427,"locale":8,"draft":6,"navigation":428,"icon":429,"path":430},"Start the client on demand","content:docs:3.build:6.application-behavior:6.on-demand-client.md","3\u002F6\u002F6",{"icon":429},"i-lucide-power","\u002Fdocs\u002Fbuild\u002Fapplication-behavior\u002Fon-demand-client",{"title":432,"page":6,"canonicalKey":433,"locale":8,"id":434,"draft":6,"icon":270,"children":435},"Agents and MCP","3\u002F7","content:docs:3.build:7.agents:.navigation.yml",[436,442,449,456,463,469,475],{"title":437,"id":438,"canonicalKey":439,"locale":8,"draft":6,"navigation":440,"icon":415,"path":441},"Tools and approvals","content:docs:3.build:7.agents:1.tools-and-approvals.md","3\u002F7\u002F1",{"icon":415},"\u002Fdocs\u002Fbuild\u002Fagents\u002Ftools-and-approvals",{"title":443,"id":444,"canonicalKey":445,"locale":8,"draft":6,"navigation":446,"icon":447,"path":448},"The MCP door","content:docs:3.build:7.agents:2.mcp-door.md","3\u002F7\u002F2",{"icon":447},"i-lucide-door-open","\u002Fdocs\u002Fbuild\u002Fagents\u002Fmcp-door",{"title":450,"id":451,"canonicalKey":452,"locale":8,"draft":6,"navigation":453,"icon":454,"path":455},"Limits","content:docs:3.build:7.agents:3.limits.md","3\u002F7\u002F3",{"icon":454},"i-lucide-traffic-cone","\u002Fdocs\u002Fbuild\u002Fagents\u002Flimits",{"title":457,"id":458,"canonicalKey":459,"locale":8,"draft":6,"navigation":460,"icon":461,"path":462},"MCP on Convex","content:docs:3.build:7.agents:4.mcp.md","3\u002F7\u002F4",{"icon":461},"i-lucide-plug-zap","\u002Fdocs\u002Fbuild\u002Fagents\u002Fmcp",{"title":464,"id":465,"canonicalKey":466,"locale":8,"draft":6,"navigation":467,"icon":249,"path":468},"Add MCP to your application","content:docs:3.build:7.agents:5.mcp-application.md","3\u002F7\u002F5",{"icon":249},"\u002Fdocs\u002Fbuild\u002Fagents\u002Fmcp-application",{"title":470,"id":471,"canonicalKey":472,"locale":8,"draft":6,"navigation":473,"icon":369,"path":474},"Connect ChatGPT and Claude","content:docs:3.build:7.agents:6.connect-chatgpt-and-claude.md","3\u002F7\u002F6",{"icon":369},"\u002Fdocs\u002Fbuild\u002Fagents\u002Fconnect-chatgpt-and-claude",{"title":476,"id":477,"canonicalKey":478,"locale":8,"draft":6,"navigation":479,"icon":108,"path":480},"MCP Apps","content:docs:3.build:7.agents:7.mcp-apps.md","3\u002F7\u002F7",{"icon":108},"\u002Fdocs\u002Fbuild\u002Fagents\u002Fmcp-apps",{"title":482,"page":6,"canonicalKey":483,"locale":8,"id":484,"draft":6,"icon":485,"children":486},"Operations and policy","3\u002F8","content:docs:3.build:8.functions:.navigation.yml","i-lucide-shield-half",[487,494,500,507,514,521,527,534],{"title":488,"id":489,"canonicalKey":490,"locale":8,"draft":6,"navigation":491,"icon":492,"path":493},"Start here","content:docs:3.build:8.functions:1.start-here.md","3\u002F8\u002F1",{"icon":492},"i-lucide-flag","\u002Fdocs\u002Fbuild\u002Ffunctions\u002Fstart-here",{"title":495,"id":496,"canonicalKey":497,"locale":8,"draft":6,"navigation":498,"icon":39,"path":499},"Policy and roles","content:docs:3.build:8.functions:2.policy-and-roles.md","3\u002F8\u002F2",{"icon":39},"\u002Fdocs\u002Fbuild\u002Ffunctions\u002Fpolicy-and-roles",{"title":501,"id":502,"canonicalKey":503,"locale":8,"draft":6,"navigation":504,"icon":505,"path":506},"Row rules","content:docs:3.build:8.functions:3.row-rules.md","3\u002F8\u002F3",{"icon":505},"i-lucide-rows-3","\u002Fdocs\u002Fbuild\u002Ffunctions\u002Frow-rules",{"title":508,"id":509,"canonicalKey":510,"locale":8,"draft":6,"navigation":511,"icon":512,"path":513},"Internal operations","content:docs:3.build:8.functions:4.internal-operations.md","3\u002F8\u002F4",{"icon":512},"i-lucide-workflow","\u002Fdocs\u002Fbuild\u002Ffunctions\u002Finternal-operations",{"title":515,"id":516,"canonicalKey":517,"locale":8,"draft":6,"navigation":518,"icon":519,"path":520},"Test your app","content:docs:3.build:8.functions:5.testing.md","3\u002F8\u002F5",{"icon":519},"i-lucide-flask-conical","\u002Fdocs\u002Fbuild\u002Ffunctions\u002Ftesting",{"title":522,"id":523,"canonicalKey":524,"locale":8,"draft":6,"navigation":525,"icon":177,"path":526},"Cost","content:docs:3.build:8.functions:6.cost.md","3\u002F8\u002F6",{"icon":177},"\u002Fdocs\u002Fbuild\u002Ffunctions\u002Fcost",{"title":528,"id":529,"canonicalKey":530,"locale":8,"draft":6,"navigation":531,"icon":532,"path":533},"Threat model","content:docs:3.build:8.functions:7.threat-model.md","3\u002F8\u002F7",{"icon":532},"i-lucide-shield-alert","\u002Fdocs\u002Fbuild\u002Ffunctions\u002Fthreat-model",{"title":535,"id":536,"canonicalKey":537,"locale":8,"draft":6,"navigation":538,"icon":408,"path":539},"Rate limits, audit log and call events","content:docs:3.build:8.functions:8.limits-and-audit.md","3\u002F8\u002F8",{"icon":408},"\u002Fdocs\u002Fbuild\u002Ffunctions\u002Flimits-and-audit",{"title":541,"page":6,"canonicalKey":542,"locale":8,"id":543,"draft":6,"icon":544,"children":545},"Recipes","4","content:docs:4.recipes:.navigation.yml","i-lucide-cooking-pot",[546,553,560,567,574,581,587,593,599,605,612,619,626,633,638],{"title":547,"id":548,"canonicalKey":549,"locale":8,"draft":6,"navigation":550,"icon":551,"path":552},"Protected dashboard","content:docs:4.recipes:1.protected-dashboard.md","4\u002F1",{"icon":551},"i-lucide-layout-dashboard","\u002Fdocs\u002Frecipes\u002Fprotected-dashboard",{"title":554,"id":555,"canonicalKey":556,"locale":8,"draft":6,"navigation":557,"icon":558,"path":559},"Real-time feed","content:docs:4.recipes:2.realtime-feed.md","4\u002F2",{"icon":558},"i-lucide-messages-square","\u002Fdocs\u002Frecipes\u002Frealtime-feed",{"title":561,"id":562,"canonicalKey":563,"locale":8,"draft":6,"navigation":564,"icon":565,"path":566},"Optimistic todo list","content:docs:4.recipes:3.optimistic-todo-list.md","4\u002F3",{"icon":565},"i-lucide-list-todo","\u002Fdocs\u002Frecipes\u002Foptimistic-todo-list",{"title":568,"id":569,"canonicalKey":570,"locale":8,"draft":6,"navigation":571,"icon":572,"path":573},"Infinite scroll","content:docs:4.recipes:4.infinite-scroll.md","4\u002F4",{"icon":572},"i-lucide-mouse","\u002Fdocs\u002Frecipes\u002Finfinite-scroll",{"title":575,"id":576,"canonicalKey":577,"locale":8,"draft":6,"navigation":578,"icon":579,"path":580},"File upload form","content:docs:4.recipes:5.file-upload-form.md","4\u002F5",{"icon":579},"i-lucide-file-up","\u002Fdocs\u002Frecipes\u002Ffile-upload-form",{"title":582,"id":583,"canonicalKey":584,"locale":8,"draft":6,"navigation":585,"icon":319,"path":586},"Organization permissions","content:docs:4.recipes:6.organization-permissions.md","4\u002F6",{"icon":319},"\u002Fdocs\u002Frecipes\u002Forganization-permissions",{"title":588,"id":589,"canonicalKey":590,"locale":8,"draft":6,"navigation":591,"icon":330,"path":592},"Authenticated server route","content:docs:4.recipes:7.authenticated-server-route.md","4\u002F7",{"icon":330},"\u002Fdocs\u002Frecipes\u002Fauthenticated-server-route",{"title":594,"id":595,"canonicalKey":596,"locale":8,"draft":6,"navigation":597,"icon":108,"path":598},"Public and private data","content:docs:4.recipes:8.public-and-private-data.md","4\u002F8",{"icon":108},"\u002Fdocs\u002Frecipes\u002Fpublic-and-private-data",{"title":600,"id":601,"canonicalKey":602,"locale":8,"draft":6,"navigation":603,"icon":519,"path":604},"Test signed-in screens","content:docs:4.recipes:9.component-testing.md","4\u002F9",{"icon":519},"\u002Fdocs\u002Frecipes\u002Fcomponent-testing",{"title":606,"id":607,"canonicalKey":608,"locale":8,"draft":6,"navigation":609,"icon":610,"path":611},"Time-based data","content:docs:4.recipes:10.time-based-data.md","4\u002F10",{"icon":610},"i-lucide-clock","\u002Fdocs\u002Frecipes\u002Ftime-based-data",{"title":613,"id":614,"canonicalKey":615,"locale":8,"draft":6,"navigation":616,"icon":617,"path":618},"A list of queries","content:docs:4.recipes:11.dynamic-query-list.md","4\u002F11",{"icon":617},"i-lucide-list-tree","\u002Fdocs\u002Frecipes\u002Fdynamic-query-list",{"title":620,"id":621,"canonicalKey":622,"locale":8,"draft":6,"navigation":623,"icon":624,"path":625},"Error messages","content:docs:4.recipes:12.error-messages.md","4\u002F12",{"icon":624},"i-lucide-message-circle-warning","\u002Fdocs\u002Frecipes\u002Ferror-messages",{"title":627,"id":628,"canonicalKey":629,"locale":8,"draft":6,"navigation":630,"icon":631,"path":632},"Several file uploads","content:docs:4.recipes:13.multiple-file-uploads.md","4\u002F13",{"icon":631},"i-lucide-files","\u002Fdocs\u002Frecipes\u002Fmultiple-file-uploads",{"title":634,"id":635,"canonicalKey":636,"locale":8,"draft":6,"path":637},"Guest users","content:docs:4.recipes:15.guest-users.md","4\u002F15","\u002Fdocs\u002Frecipes\u002Fguest-users",{"title":639,"id":640,"canonicalKey":641,"locale":8,"draft":6,"path":642},"Sign-in link","content:docs:4.recipes:16.sign-in-link.md","4\u002F16","\u002Fdocs\u002Frecipes\u002Fsign-in-link",{"title":644,"page":6,"canonicalKey":645,"locale":8,"id":646,"draft":6,"icon":647,"children":648},"Concepts","5","content:docs:5.concepts:.navigation.yml","i-lucide-brain",[649,655,661,668,674,681,687,694,701],{"title":650,"id":651,"canonicalKey":652,"locale":8,"draft":6,"navigation":653,"icon":647,"path":654},"Mental model","content:docs:5.concepts:1.mental-model.md","5\u002F1",{"icon":647},"\u002Fdocs\u002Fconcepts\u002Fmental-model",{"title":656,"id":657,"canonicalKey":658,"locale":8,"draft":6,"navigation":659,"icon":235,"path":660},"Request lifecycle","content:docs:5.concepts:2.request-lifecycle.md","5\u002F2",{"icon":235},"\u002Fdocs\u002Fconcepts\u002Frequest-lifecycle",{"title":662,"id":663,"canonicalKey":664,"locale":8,"draft":6,"navigation":665,"icon":666,"path":667},"SSR, hydration, and real-time","content:docs:5.concepts:3.ssr-hydration-realtime.md","5\u002F3",{"icon":666},"i-lucide-refresh-cw","\u002Fdocs\u002Fconcepts\u002Fssr-hydration-realtime",{"title":669,"id":670,"canonicalKey":671,"locale":8,"draft":6,"navigation":672,"icon":124,"path":673},"Query state and caching","content:docs:5.concepts:4.query-ownership-and-caching.md","5\u002F4",{"icon":124},"\u002Fdocs\u002Fconcepts\u002Fquery-ownership-and-caching",{"title":675,"id":676,"canonicalKey":677,"locale":8,"draft":6,"navigation":678,"icon":679,"path":680},"Authentication and identity","content:docs:5.concepts:5.authentication-and-identity.md","5\u002F5",{"icon":679},"i-lucide-fingerprint","\u002Fdocs\u002Fconcepts\u002Fauthentication-and-identity",{"title":682,"id":683,"canonicalKey":684,"locale":8,"draft":6,"navigation":685,"icon":108,"path":686},"Server and client boundaries","content:docs:5.concepts:6.server-and-client-boundaries.md","5\u002F6",{"icon":108},"\u002Fdocs\u002Fconcepts\u002Fserver-and-client-boundaries",{"title":688,"id":689,"canonicalKey":690,"locale":8,"draft":6,"navigation":691,"icon":692,"path":693},"Errors and failures","content:docs:5.concepts:7.errors-and-failures.md","5\u002F7",{"icon":692},"i-lucide-circle-x","\u002Fdocs\u002Fconcepts\u002Ferrors-and-failures",{"title":695,"id":696,"canonicalKey":697,"locale":8,"draft":6,"navigation":698,"icon":699,"path":700},"Design decisions","content:docs:5.concepts:8.design-decisions.md","5\u002F8",{"icon":699},"i-lucide-git-branch","\u002Fdocs\u002Fconcepts\u002Fdesign-decisions",{"title":702,"id":703,"canonicalKey":704,"locale":8,"draft":6,"navigation":705,"icon":706,"path":707},"Glossary","content:docs:5.concepts:9.glossary.md","5\u002F9",{"icon":706},"i-lucide-book-a","\u002Fdocs\u002Fconcepts\u002Fglossary",{"title":709,"page":6,"canonicalKey":710,"locale":8,"id":711,"draft":6,"icon":215,"children":712},"Operations","6","content:docs:6.operations:.navigation.yml",[713,719,726,733,739,746,752,759,765],{"title":714,"id":715,"canonicalKey":716,"locale":8,"draft":6,"navigation":717,"icon":45,"path":718},"Deployment","content:docs:6.operations:1.deployment.md","6\u002F1",{"icon":45},"\u002Fdocs\u002Foperations\u002Fdeployment",{"title":720,"id":721,"canonicalKey":722,"locale":8,"draft":6,"navigation":723,"icon":724,"path":725},"Environment variables","content:docs:6.operations:2.environment-variables.md","6\u002F2",{"icon":724},"i-lucide-variable","\u002Fdocs\u002Foperations\u002Fenvironment-variables",{"title":727,"id":728,"canonicalKey":729,"locale":8,"draft":6,"navigation":730,"icon":731,"path":732},"Deploy to Vercel","content:docs:6.operations:3.deploy-to-vercel.md","6\u002F3",{"icon":731},"i-lucide-triangle","\u002Fdocs\u002Foperations\u002Fdeploy-to-vercel",{"title":734,"id":735,"canonicalKey":736,"locale":8,"draft":6,"navigation":737,"icon":415,"path":738},"Troubleshooting","content:docs:6.operations:4.troubleshooting.md","6\u002F4",{"icon":415},"\u002Fdocs\u002Foperations\u002Ftroubleshooting",{"title":740,"id":741,"canonicalKey":742,"locale":8,"draft":6,"navigation":743,"icon":744,"path":745},"Release compatibility","content:docs:6.operations:5.release-compatibility.md","6\u002F5",{"icon":744},"i-lucide-badge-check","\u002Fdocs\u002Foperations\u002Frelease-compatibility",{"title":747,"id":748,"canonicalKey":749,"locale":8,"draft":6,"navigation":750,"icon":87,"path":751},"Security model","content:docs:6.operations:6.security-model.md","6\u002F6",{"icon":87},"\u002Fdocs\u002Foperations\u002Fsecurity-model",{"title":753,"id":754,"canonicalKey":755,"locale":8,"draft":6,"navigation":756,"icon":757,"path":758},"Upgrade to 1.0","content:docs:6.operations:7.upgrade-to-1-0.md","6\u002F7",{"icon":757},"i-lucide-arrow-up-circle","\u002Fdocs\u002Foperations\u002Fupgrade-to-1-0",{"title":760,"id":761,"canonicalKey":762,"locale":8,"draft":6,"navigation":763,"icon":45,"path":764},"Before your app goes live","content:docs:6.operations:8.before-launch.md","6\u002F8",{"icon":45},"\u002Fdocs\u002Foperations\u002Fbefore-launch",{"title":766,"id":767,"canonicalKey":768,"locale":8,"draft":6,"navigation":769,"icon":770,"path":771},"Log streams and PostHog","content:docs:6.operations:9.log-streams.md","6\u002F9",{"icon":770},"i-lucide-activity","\u002Fdocs\u002Foperations\u002Flog-streams",{"title":773,"page":6,"canonicalKey":774,"locale":8,"id":775,"draft":6,"icon":776,"children":777},"Reference","7","content:docs:7.reference:.navigation.yml","i-lucide-braces",[778,784,790,796,803,810,817,823,830],{"title":779,"id":780,"canonicalKey":781,"locale":8,"draft":6,"navigation":782,"icon":776,"path":783},"Composables","content:docs:7.reference:1.composables.md","7\u002F1",{"icon":776},"\u002Fdocs\u002Freference\u002Fcomposables",{"title":785,"id":786,"canonicalKey":787,"locale":8,"draft":6,"navigation":788,"icon":330,"path":789},"Server API","content:docs:7.reference:3.server-api.md","7\u002F3",{"icon":330},"\u002Fdocs\u002Freference\u002Fserver-api",{"title":791,"id":792,"canonicalKey":793,"locale":8,"draft":6,"navigation":794,"icon":692,"path":795},"Error types","content:docs:7.reference:4.error-types.md","7\u002F4",{"icon":692},"\u002Fdocs\u002Freference\u002Ferror-types",{"title":797,"id":798,"canonicalKey":799,"locale":8,"draft":6,"navigation":800,"icon":801,"path":802},"Module configuration","content:docs:7.reference:5.module-configuration.md","7\u002F5",{"icon":801},"i-lucide-settings","\u002Fdocs\u002Freference\u002Fmodule-configuration",{"title":804,"id":805,"canonicalKey":806,"locale":8,"draft":6,"navigation":807,"icon":808,"path":809},"Package exports","content:docs:7.reference:6.package-exports.md","7\u002F6",{"icon":808},"i-lucide-package-open","\u002Fdocs\u002Freference\u002Fpackage-exports",{"title":811,"id":812,"canonicalKey":813,"locale":8,"draft":6,"navigation":814,"icon":815,"path":816},"API reference","content:docs:7.reference:7.api-surface.md","7\u002F7",{"icon":815},"i-lucide-list","\u002Fdocs\u002Freference\u002Fapi-surface",{"title":818,"id":819,"canonicalKey":820,"locale":8,"draft":6,"navigation":821,"icon":519,"path":822},"Experimental APIs","content:docs:7.reference:8.experimental.md","7\u002F8",{"icon":519},"\u002Fdocs\u002Freference\u002Fexperimental",{"title":824,"id":825,"canonicalKey":826,"locale":8,"draft":6,"navigation":827,"icon":828,"path":829},"Command line","content:docs:7.reference:9.cli.md","7\u002F9",{"icon":828},"i-lucide-terminal","\u002Fdocs\u002Freference\u002Fcli",{"title":831,"id":832,"canonicalKey":833,"locale":8,"draft":6,"navigation":834,"icon":835,"path":836},"Operation error codes","content:docs:7.reference:10.operation-error-codes.md","7\u002F10",{"icon":835},"i-lucide-octagon-alert","\u002Fdocs\u002Freference\u002Foperation-error-codes",{"title":838,"id":839,"canonicalKey":840,"locale":8,"draft":6,"path":841},"Better Convex documentation","content:docs:index.md","\u002F","\u002Fdocs",{"title":766,"description":843,"navigation":844,"body":845,"type":1526,"id":767,"canonicalKey":768,"draft":6,"partial":6,"locale":8,"collection":1527,"navigationFile":6,"file":1528,"route":1534,"resolution":1536},"Send call events and Convex logs to PostHog, find a failed call by its request ID, and follow work across scheduled jobs.",{"icon":770},{"type":846,"children":847,"toc":1515},"root",[848,865,872,961,966,972,999,1032,1038,1154,1166,1172,1205,1346,1351,1369,1386,1404,1416,1433,1439,1468,1474,1479,1502],{"type":849,"tag":850,"props":851,"children":852},"element","p",{},[853,856,863],{"type":854,"value":855},"text","A Convex log stream sends every log record of a deployment to a log service.\nWith ",{"type":849,"tag":857,"props":858,"children":860},"a",{"href":859},"\u002Fdocs\u002Fbuild\u002Ffunctions\u002Flimits-and-audit#call-events",[861],{"type":854,"value":862},"call events",{"type":854,"value":864}," turned\non, you can then answer, after the fact, who ran which action in which tenant,\nand why it failed. This page uses PostHog Logs. Other log services work the\nsame way, but their search differs.",{"type":849,"tag":866,"props":867,"children":869},"h2",{"id":868},"what-the-stream-sends",[870],{"type":854,"value":871},"What the stream sends",{"type":849,"tag":873,"props":874,"children":875},"table",{},[876,895],{"type":849,"tag":877,"props":878,"children":879},"thead",{},[880],{"type":849,"tag":881,"props":882,"children":883},"tr",{},[884,890],{"type":849,"tag":885,"props":886,"children":887},"th",{},[888],{"type":854,"value":889},"Record",{"type":849,"tag":885,"props":891,"children":892},{},[893],{"type":854,"value":894},"Content",{"type":849,"tag":896,"props":897,"children":898},"tbody",{},[899,928,941],{"type":849,"tag":881,"props":900,"children":901},{},[902,916],{"type":849,"tag":903,"props":904,"children":905},"td",{},[906,908,914],{"type":854,"value":907},"Call event (",{"type":849,"tag":909,"props":910,"children":911},"code",{},[912],{"type":854,"value":913},"console",{"type":854,"value":915}," topic)",{"type":849,"tag":903,"props":917,"children":918},{},[919,921,926],{"type":854,"value":920},"One line for each call with ",{"type":849,"tag":909,"props":922,"children":923},{},[924],{"type":854,"value":925},"observe: true",{"type":854,"value":927}," (a query only when it fails): action, actor, tenant, outcome, code and trace.",{"type":849,"tag":881,"props":929,"children":930},{},[931,936],{"type":849,"tag":903,"props":932,"children":933},{},[934],{"type":854,"value":935},"Function execution",{"type":849,"tag":903,"props":937,"children":938},{},[939],{"type":854,"value":940},"Convex's own record for each call: function path, duration, status, request ID, and the error text with its stack trace.",{"type":849,"tag":881,"props":942,"children":943},{},[944,949],{"type":849,"tag":903,"props":945,"children":946},{},[947],{"type":854,"value":948},"Console lines",{"type":849,"tag":903,"props":950,"children":951},{},[952,954,959],{"type":854,"value":953},"Every ",{"type":849,"tag":909,"props":955,"children":956},{},[957],{"type":854,"value":958},"console.log",{"type":854,"value":960}," of your Convex functions, as it was written.",{"type":849,"tag":850,"props":962,"children":963},{},[964],{"type":854,"value":965},"The call event and Convex's record of the same call have the same request ID.",{"type":849,"tag":866,"props":967,"children":969},{"id":968},"before-you-start",[970],{"type":854,"value":971},"Before you start",{"type":849,"tag":973,"props":974,"children":975},"ul",{},[976,982,994],{"type":849,"tag":977,"props":978,"children":979},"li",{},[980],{"type":854,"value":981},"Use the Convex Pro plan. Log streams are not available on the free plan.",{"type":849,"tag":977,"props":983,"children":984},{},[985,987,992],{"type":854,"value":986},"Turn on call events: ",{"type":849,"tag":909,"props":988,"children":989},{},[990],{"type":854,"value":991},"defineFunctions({ …, observe: true })",{"type":854,"value":993},".",{"type":849,"tag":977,"props":995,"children":996},{},[997],{"type":854,"value":998},"Create a PostHog project in the region of your users' data, for example\nPostHog EU Cloud for users in the EU.",{"type":849,"tag":1000,"props":1001,"children":1002},"warning",{},[1003,1005,1009,1011,1016,1018,1023,1025,1030],{"type":854,"value":1004},"The stream copies error texts and console lines to PostHog as they are. Before\nyou connect it, check that your error messages and ",{"type":849,"tag":909,"props":1006,"children":1007},{},[1008],{"type":854,"value":958},{"type":854,"value":1010}," calls do not\ncontain values that a person typed, such as names, amounts or email addresses.\nPut such values in neither ",{"type":849,"tag":909,"props":1012,"children":1013},{},[1014],{"type":854,"value":1015},"fail()",{"type":854,"value":1017}," messages nor ",{"type":849,"tag":909,"props":1019,"children":1020},{},[1021],{"type":854,"value":1022},"why",{"type":854,"value":1024}," and ",{"type":849,"tag":909,"props":1026,"children":1027},{},[1028],{"type":854,"value":1029},"fix",{"type":854,"value":1031},". Write IDs.",{"type":849,"tag":866,"props":1033,"children":1035},{"id":1034},"connect-posthog-logs",[1036],{"type":854,"value":1037},"Connect PostHog Logs",{"type":849,"tag":1039,"props":1040,"children":1041},"ol",{},[1042,1061,1072,1083,1088,1107,1125,1149],{"type":849,"tag":977,"props":1043,"children":1044},{},[1045,1047,1053,1055,1060],{"type":854,"value":1046},"In PostHog, open ",{"type":849,"tag":1048,"props":1049,"children":1050},"strong",{},[1051],{"type":854,"value":1052},"Settings > Project > General",{"type":854,"value":1054}," and copy the project\ntoken. It starts with ",{"type":849,"tag":909,"props":1056,"children":1057},{},[1058],{"type":854,"value":1059},"phc_",{"type":854,"value":993},{"type":849,"tag":977,"props":1062,"children":1063},{},[1064,1066,1071],{"type":854,"value":1065},"In the Convex dashboard, open the deployment, then ",{"type":849,"tag":1048,"props":1067,"children":1068},{},[1069],{"type":854,"value":1070},"Settings >\nIntegrations",{"type":854,"value":993},{"type":849,"tag":977,"props":1073,"children":1074},{},[1075,1077,1082],{"type":854,"value":1076},"Add ",{"type":849,"tag":1048,"props":1078,"children":1079},{},[1080],{"type":854,"value":1081},"PostHog Logs",{"type":854,"value":993},{"type":849,"tag":977,"props":1084,"children":1085},{},[1086],{"type":854,"value":1087},"Paste the project token.",{"type":849,"tag":977,"props":1089,"children":1090},{},[1091,1093,1098,1100,1105],{"type":854,"value":1092},"Set ",{"type":849,"tag":1048,"props":1094,"children":1095},{},[1096],{"type":854,"value":1097},"Host",{"type":854,"value":1099}," to the host of your PostHog region, for example\n",{"type":849,"tag":909,"props":1101,"children":1102},{},[1103],{"type":854,"value":1104},"https:\u002F\u002Feu.i.posthog.com",{"type":854,"value":1106},". Without a host, Convex sends to the US region.",{"type":849,"tag":977,"props":1108,"children":1109},{},[1110,1111,1116,1118,1123],{"type":854,"value":1092},{"type":849,"tag":1048,"props":1112,"children":1113},{},[1114],{"type":854,"value":1115},"Service name",{"type":854,"value":1117}," to a name for this deployment, for example ",{"type":849,"tag":909,"props":1119,"children":1120},{},[1121],{"type":854,"value":1122},"myapp-prod",{"type":854,"value":1124},".\nUse a different name for each deployment.",{"type":849,"tag":977,"props":1126,"children":1127},{},[1128,1130,1135,1137,1141,1142,1147],{"type":854,"value":1129},"Under ",{"type":849,"tag":1048,"props":1131,"children":1132},{},[1133],{"type":854,"value":1134},"Topics",{"type":854,"value":1136},", select ",{"type":849,"tag":909,"props":1138,"children":1139},{},[1140],{"type":854,"value":913},{"type":854,"value":1024},{"type":849,"tag":909,"props":1143,"children":1144},{},[1145],{"type":854,"value":1146},"function_execution",{"type":854,"value":1148},". Leave the\nother topics off until you need them.",{"type":849,"tag":977,"props":1150,"children":1151},{},[1152],{"type":854,"value":1153},"Save. Convex sends a verification record to PostHog.",{"type":849,"tag":850,"props":1155,"children":1156},{},[1157,1159,1164],{"type":854,"value":1158},"The ",{"type":849,"tag":1048,"props":1160,"children":1161},{},[1162],{"type":854,"value":1163},"PostHog Error Tracking",{"type":854,"value":1165}," integration is a separate integration. It sends\neach failed call as an exception, with the full error text. Add it if you want\nfailures grouped as issues.",{"type":849,"tag":866,"props":1167,"children":1169},{"id":1168},"find-a-call",[1170],{"type":854,"value":1171},"Find a call",{"type":849,"tag":850,"props":1173,"children":1174},{},[1175,1177,1182,1184,1189,1191,1196,1198,1203],{"type":854,"value":1176},"Open ",{"type":849,"tag":1048,"props":1178,"children":1179},{},[1180],{"type":854,"value":1181},"Logs",{"type":854,"value":1183}," in PostHog. Filter on the ",{"type":849,"tag":909,"props":1185,"children":1186},{},[1187],{"type":854,"value":1188},"service.name",{"type":854,"value":1190}," resource attribute to\nsee one deployment. Then use the ",{"type":849,"tag":1048,"props":1192,"children":1193},{},[1194],{"type":854,"value":1195},"Message",{"type":854,"value":1197}," filter with ",{"type":849,"tag":909,"props":1199,"children":1200},{},[1201],{"type":854,"value":1202},"contains",{"type":854,"value":1204},":",{"type":849,"tag":873,"props":1206,"children":1207},{},[1208,1224],{"type":849,"tag":877,"props":1209,"children":1210},{},[1211],{"type":849,"tag":881,"props":1212,"children":1213},{},[1214,1219],{"type":849,"tag":885,"props":1215,"children":1216},{},[1217],{"type":854,"value":1218},"To find",{"type":849,"tag":885,"props":1220,"children":1221},{},[1222],{"type":854,"value":1223},"Message contains",{"type":849,"tag":896,"props":1225,"children":1226},{},[1227,1245,1261,1283,1307,1325],{"type":849,"tag":881,"props":1228,"children":1229},{},[1230,1235],{"type":849,"tag":903,"props":1231,"children":1232},{},[1233],{"type":854,"value":1234},"One call that a user reported",{"type":849,"tag":903,"props":1236,"children":1237},{},[1238,1240],{"type":854,"value":1239},"The request ID that the user quoted, for example ",{"type":849,"tag":909,"props":1241,"children":1242},{},[1243],{"type":854,"value":1244},"c80d6e0f0e0198a1",{"type":849,"tag":881,"props":1246,"children":1247},{},[1248,1253],{"type":849,"tag":903,"props":1249,"children":1250},{},[1251],{"type":854,"value":1252},"All call events",{"type":849,"tag":903,"props":1254,"children":1255},{},[1256],{"type":849,"tag":909,"props":1257,"children":1258},{},[1259],{"type":854,"value":1260},"better-convex.call",{"type":849,"tag":881,"props":1262,"children":1263},{},[1264,1269],{"type":849,"tag":903,"props":1265,"children":1266},{},[1267],{"type":854,"value":1268},"Refused calls",{"type":849,"tag":903,"props":1270,"children":1271},{},[1272,1276,1278],{"type":849,"tag":909,"props":1273,"children":1274},{},[1275],{"type":854,"value":1260},{"type":854,"value":1277},", and in a second filter ",{"type":849,"tag":909,"props":1279,"children":1280},{},[1281],{"type":854,"value":1282},"FORBIDDEN",{"type":849,"tag":881,"props":1284,"children":1285},{},[1286,1291],{"type":849,"tag":903,"props":1287,"children":1288},{},[1289],{"type":854,"value":1290},"Everything one call started",{"type":849,"tag":903,"props":1292,"children":1293},{},[1294,1295,1300,1302],{"type":854,"value":1158},{"type":849,"tag":909,"props":1296,"children":1297},{},[1298],{"type":854,"value":1299},"trace",{"type":854,"value":1301}," of its event, for example ",{"type":849,"tag":909,"props":1303,"children":1304},{},[1305],{"type":854,"value":1306},"5123956460443c3b",{"type":849,"tag":881,"props":1308,"children":1309},{},[1310,1315],{"type":849,"tag":903,"props":1311,"children":1312},{},[1313],{"type":854,"value":1314},"Everything one agent did",{"type":849,"tag":903,"props":1316,"children":1317},{},[1318,1320],{"type":854,"value":1319},"The agent's key, for example ",{"type":849,"tag":909,"props":1321,"children":1322},{},[1323],{"type":854,"value":1324},"mcp:k57…:claude-desktop",{"type":849,"tag":881,"props":1326,"children":1327},{},[1328,1333],{"type":849,"tag":903,"props":1329,"children":1330},{},[1331],{"type":854,"value":1332},"Calls of revoked agents",{"type":849,"tag":903,"props":1334,"children":1335},{},[1336,1340,1341],{"type":849,"tag":909,"props":1337,"children":1338},{},[1339],{"type":854,"value":1260},{"type":854,"value":1277},{"type":849,"tag":909,"props":1342,"children":1343},{},[1344],{"type":854,"value":1345},"AGENT_DISABLED",{"type":849,"tag":850,"props":1347,"children":1348},{},[1349],{"type":854,"value":1350},"A search for a request ID shows the call event and Convex's record of the same\ncall. The call event says who acted and with which code. Convex's record has\nthe duration, the final status and the error text.",{"type":849,"tag":850,"props":1352,"children":1353},{},[1354,1356,1361,1363,1368],{"type":854,"value":1355},"A search for an agent's key finds its tool calls, where it is the ",{"type":849,"tag":909,"props":1357,"children":1358},{},[1359],{"type":854,"value":1360},"actor",{"type":854,"value":1362},",\nand the decisions of people on its requests, where it is the ",{"type":849,"tag":909,"props":1364,"children":1365},{},[1366],{"type":854,"value":1367},"agent",{"type":854,"value":993},{"type":849,"tag":850,"props":1370,"children":1371},{},[1372,1374,1378,1380,1384],{"type":854,"value":1373},"A search for a ",{"type":849,"tag":909,"props":1375,"children":1376},{},[1377],{"type":854,"value":1299},{"type":854,"value":1379}," shows the events of each call in the chain: the call\nitself and the internal operations, internal actions and jobs it scheduled or\nran, also those that ran hours later. Convex gives each scheduled call a new\nrequest ID, so only the ",{"type":849,"tag":909,"props":1381,"children":1382},{},[1383],{"type":854,"value":1299},{"type":854,"value":1385}," connects them.",{"type":849,"tag":850,"props":1387,"children":1388},{},[1389,1391,1396,1398,1403],{"type":854,"value":1390},"To see the calls of one function, filter on the ",{"type":849,"tag":909,"props":1392,"children":1393},{},[1394],{"type":854,"value":1395},"convex.function.path",{"type":854,"value":1397},"\nattribute, for example ",{"type":849,"tag":909,"props":1399,"children":1400},{},[1401],{"type":854,"value":1402},"clients:create",{"type":854,"value":993},{"type":849,"tag":850,"props":1405,"children":1406},{},[1407,1409,1414],{"type":854,"value":1408},"Search for a word, a code or an ID, not for a part of the JSON line such as\n",{"type":849,"tag":909,"props":1410,"children":1411},{},[1412],{"type":854,"value":1413},"\"code\":\"FORBIDDEN\"",{"type":854,"value":1415},". PostHog stores Convex's record as the message, and the\ncall event is a quoted string inside it, so each quotation mark of the call\nevent has a backslash before it.",{"type":849,"tag":850,"props":1417,"children":1418},{},[1419,1421,1425,1427,1431],{"type":854,"value":1420},"Each field of a call event is text in the message, not an attribute of its\nown. You can filter by words and IDs, but you cannot group or count by ",{"type":849,"tag":909,"props":1422,"children":1423},{},[1424],{"type":854,"value":1360},{"type":854,"value":1426},"\nor ",{"type":849,"tag":909,"props":1428,"children":1429},{},[1430],{"type":854,"value":909},{"type":854,"value":1432}," in the filter bar.",{"type":849,"tag":866,"props":1434,"children":1436},{"id":1435},"get-an-alert",[1437],{"type":854,"value":1438},"Get an alert",{"type":849,"tag":850,"props":1440,"children":1441},{},[1442,1444,1448,1449,1453,1455,1459,1461,1466],{"type":854,"value":1443},"Save a filter as a view, for example ",{"type":849,"tag":909,"props":1445,"children":1446},{},[1447],{"type":854,"value":1260},{"type":854,"value":1024},{"type":849,"tag":909,"props":1450,"children":1451},{},[1452],{"type":854,"value":1282},{"type":854,"value":1454},". Add\na PostHog alert on that view to get a message when the number of matching\nlines goes over a limit. A sudden rise in refused calls can show a broken\nclient or someone who tries to read data of other tenants. A rise in\n",{"type":849,"tag":909,"props":1456,"children":1457},{},[1458],{"type":854,"value":1345},{"type":854,"value":1460}," or ",{"type":849,"tag":909,"props":1462,"children":1463},{},[1464],{"type":854,"value":1465},"RATE_LIMITED",{"type":854,"value":1467}," can show a stolen agent token that is still\nin use.",{"type":849,"tag":866,"props":1469,"children":1471},{"id":1470},"protect-the-logs",[1472],{"type":854,"value":1473},"Protect the logs",{"type":849,"tag":850,"props":1475,"children":1476},{},[1477],{"type":854,"value":1478},"Call events contain user IDs and tenant IDs. Under the GDPR, these are personal\ndata, even without a name.",{"type":849,"tag":973,"props":1480,"children":1481},{},[1482,1487,1492,1497],{"type":849,"tag":977,"props":1483,"children":1484},{},[1485],{"type":854,"value":1486},"Sign a data processing agreement with PostHog.",{"type":849,"tag":977,"props":1488,"children":1489},{},[1490],{"type":854,"value":1491},"Check how long your PostHog plan keeps logs, and keep them no longer than you need.",{"type":849,"tag":977,"props":1493,"children":1494},{},[1495],{"type":854,"value":1496},"Give access to the PostHog project only to the people who need it. They see\nthe activity of every user in every tenant.",{"type":849,"tag":977,"props":1498,"children":1499},{},[1500],{"type":854,"value":1501},"Set a volume limit or a billing limit in PostHog. Anyone can make queries\nfail, and failed queries write call events without a rate limit.",{"type":849,"tag":850,"props":1503,"children":1504},{},[1505,1507,1513],{"type":854,"value":1506},"The project token can only send data, but anyone who has it can send false\nrecords. Use the logs to find problems. Use the\n",{"type":849,"tag":857,"props":1508,"children":1510},{"href":1509},"\u002Fdocs\u002Fbuild\u002Ffunctions\u002Flimits-and-audit#audit-log",[1511],{"type":854,"value":1512},"audit log",{"type":854,"value":1514}," in your own\ndatabase as the record of who changed which rows.",{"title":1516,"searchDepth":1517,"depth":1517,"links":1518},"",4,[1519,1521,1522,1523,1524,1525],{"id":868,"depth":1520,"text":871},2,{"id":968,"depth":1520,"text":971},{"id":1034,"depth":1520,"text":1037},{"id":1168,"depth":1520,"text":1171},{"id":1435,"depth":1520,"text":1438},{"id":1470,"depth":1520,"text":1473},"markdown","docs",{"source":1529,"path":1530,"stem":1531,"dir":1532,"extension":1533},"content","docs\u002F6.operations\u002F9.log-streams.md","docs\u002F6.operations\u002F9.log-streams","operations","md",{"requestedPath":771,"resolvedPath":771,"alternates":1535},[],{"requested":1537,"resolved":1538,"usedFallback":6},{},{"locale":8},{"previous":1540,"next":1542},{"title":760,"id":761,"canonicalKey":762,"locale":8,"draft":6,"navigation":1541,"icon":45,"path":764},{"icon":45},{"title":779,"id":780,"canonicalKey":781,"locale":8,"draft":6,"navigation":1543,"icon":776,"path":783},{"icon":776},1794905531799]