Explore session, event, and evaluation data with reusable SQL.
Queries are the flexible layer beneath dashboards, audits, and investigations. Use ad-hoc SQL to test an idea, then save the query when it becomes part of a recurring workflow.
Create and run a query
Dashboard
CLI
Go to Analyze → Queries and select new query.
Open the schema browser and choose fields from the event, session, or evaluation data.
Write SQL, add parameters when needed, and run the query.
Save it with a clear name and description, then use add to dashboard when the result should be monitored.
The query editor combines the event schema, SQL, parameters, and a result preview so you can validate the question before saving it.Saved queries then appear in the shared library, where teammates can rerun them or add their results to dashboards.Use a clear name and description so the result remains understandable without reopening its SQL.
Use fp query list to find IDs and fp query delete <query-id> to remove a saved query.
Common uses
Find sessions with repeated calls to the same tool.
Compare evaluation scores across models or environments.
Measure time between a human wait and resume.
Identify policy denials followed by a successful alternative.
Build a cohort for an audit.
Open Queries → Schema before writing against unfamiliar fields. Prefer explicit time and environment filters, and keep result limits during exploration.
A query can identify a suspicious pattern, but it does not establish the failure mode by itself. Open representative traces or run an audit before turning the result into a policy.
Was this page helpful?
{"docsConfig":{"theme":"palm","$schema":"https://mintlify.com/docs.json","name":"Failproof AI","description":"Trace agent behavior, find failures with audits, and prevent repeat failures with deployed policies.","colors":{"primary":"#c92251","light":"#e4587d","dark":"#e4587d"},"logo":{"light":"https://mintcdn.com/exosphere/63Tp--IVddVBndpp/logo/Failproof_AI_logo_light.png?fit=max\u0026auto=format\u0026n=63Tp--IVddVBndpp\u0026q=85\u0026s=5231ac600a18d7ad299834e4a880f6e0","dark":"https://mintcdn.com/exosphere/63Tp--IVddVBndpp/logo/Failproof_AI_logo.png?fit=max\u0026auto=format\u0026n=63Tp--IVddVBndpp\u0026q=85\u0026s=3f0e8fc7951c3550b7fdeabbca03daff","href":"https://befailproof.ai"},"favicon":"https://mintcdn.com/exosphere/63Tp--IVddVBndpp/favicon.ico?fit=max\u0026auto=format\u0026n=63Tp--IVddVBndpp\u0026q=85\u0026s=ef7e5e9c419deaf5a2298f5ef6d5929f","api":{"openapi":"reference/openapi.json","playground":{"display":"simple"},"examples":{"languages":["curl","python","javascript"]}},"navbar":{"links":[{"icon":"discord","href":"https://discord.befailproof.ai","label":""},{"icon":"reddit","href":"https://www.reddit.com/r/failproofai/","label":""},{"icon":"x-twitter","href":"https://x.com/failproofai","label":""},{"icon":"github","href":"https://github.com/FailproofAI/failproofai","label":"⭐ 1.5k"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.befailproof.ai"}},"footer":{"socials":{"github":"https://github.com/FailproofAI/failproofai","x":"https://x.com/failproofai"}},"search":{"prompt":"Search Failproof AI docs"},"seo":{"indexing":"navigable"},"icons":{"library":"lucide"},"contextual":{"options":["copy","view","assistant","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Support","icon":"mail","href":"mailto:support@befailproof.ai"}]},"languages":[{"language":"en","href":""},{"language":"zh","href":"zh"},{"language":"ja","href":"ja"},{"language":"ko","href":"ko"},{"language":"es","href":"es"},{"language":"pt-BR","href":"pt-br"},{"language":"de","href":"de"},{"language":"fr","href":"fr"},{"language":"ru","href":"ru"},{"language":"hi","href":"hi"},{"language":"tr","href":"tr"},{"language":"vi","href":"vi"},{"language":"it","href":"it"},{"language":"ar","href":"ar"},{"language":"he","href":"he"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"exosphere","hasAudioNarration":false,"actualSubdomain":"exosphere","customDomains":["docs.befailproof.ai"],"gitSource":{"type":"github","owner":"failproofai","repo":"failproofai","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6af7199f9a8829f8111dfce3","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"en","tag":"Integrations and reference","count":130},{"language":"en","tag":"HTTP API","count":109},{"language":"en","tag":"Trace Agents","count":18},{"language":"en","tag":"Audits","count":18},{"language":"en","tag":"Find failures","count":17},{"language":"ar","tag":"Trace Agents","count":17},{"language":"de","tag":"Trace Agents","count":17},{"language":"es","tag":"Trace Agents","count":17},{"language":"fr","tag":"Trace Agents","count":17},{"language":"he","tag":"Trace Agents","count":17},{"language":"hi","tag":"Trace Agents","count":17},{"language":"it","tag":"Trace Agents","count":17},{"language":"ja","tag":"Trace Agents","count":17},{"language":"ko","tag":"Trace Agents","count":17},{"language":"pt-BR","tag":"Trace Agents","count":17},{"language":"ru","tag":"Trace Agents","count":17},{"language":"tr","tag":"Trace Agents","count":17},{"language":"vi","tag":"Trace Agents","count":17},{"language":"zh","tag":"Trace Agents","count":17},{"language":"en","tag":"Issues","count":15},{"language":"en","tag":"Events","count":14},{"language":"ar","tag":"Find failures","count":14},{"language":"de","tag":"Find failures","count":14},{"language":"es","tag":"Find failures","count":14},{"language":"fr","tag":"Find failures","count":14},{"language":"he","tag":"Find failures","count":14},{"language":"hi","tag":"Find failures","count":14},{"language":"it","tag":"Find failures","count":14},{"language":"ja","tag":"Find failures","count":14},{"language":"ko","tag":"Find failures","count":14},{"language":"pt-BR","tag":"Find failures","count":14},{"language":"ru","tag":"Find failures","count":14},{"language":"tr","tag":"Find failures","count":14},{"language":"vi","tag":"Find failures","count":14},{"language":"zh","tag":"Find failures","count":14},{"language":"en","tag":"Start","count":13},{"language":"en","tag":"Start here","count":13},{"language":"ar","tag":"Integrations and reference","count":13},{"language":"de","tag":"Integrations and reference","count":13},{"language":"es","tag":"Integrations and reference","count":13},{"language":"fr","tag":"Integrations and reference","count":13},{"language":"he","tag":"Integrations and reference","count":13},{"language":"hi","tag":"Integrations and reference","count":13},{"language":"it","tag":"Integrations and reference","count":13},{"language":"ja","tag":"Integrations and reference","count":13},{"language":"ko","tag":"Integrations and reference","count":13},{"language":"pt-BR","tag":"Integrations and reference","count":13},{"language":"ru","tag":"Integrations and reference","count":13},{"language":"tr","tag":"Integrations and reference","count":13},{"language":"vi","tag":"Integrations and reference","count":13},{"language":"zh","tag":"Integrations and reference","count":13},{"language":"ar","tag":"Start","count":12},{"language":"ar","tag":"Start here","count":12},{"language":"de","tag":"Start","count":12},{"language":"de","tag":"Start here","count":12},{"language":"es","tag":"Start","count":12},{"language":"es","tag":"Start here","count":12},{"language":"fr","tag":"Start","count":12},{"language":"fr","tag":"Start here","count":12},{"language":"he","tag":"Start","count":12},{"language":"he","tag":"Start here","count":12},{"language":"hi","tag":"Start","count":12},{"language":"hi","tag":"Start here","count":12},{"language":"it","tag":"Start","count":12},{"language":"it","tag":"Start here","count":12},{"language":"ja","tag":"Start","count":12},{"language":"ja","tag":"Start here","count":12},{"language":"ko","tag":"Start","count":12},{"language":"ko","tag":"Start here","count":12},{"language":"pt-BR","tag":"Start","count":12},{"language":"pt-BR","tag":"Start here","count":12},{"language":"ru","tag":"Start","count":12},{"language":"ru","tag":"Start here","count":12},{"language":"tr","tag":"Start","count":12},{"language":"tr","tag":"Start here","count":12},{"language":"vi","tag":"Start","count":12},{"language":"vi","tag":"Start here","count":12},{"language":"zh","tag":"Start","count":12},{"language":"zh","tag":"Start here","count":12},{"language":"en","tag":"Understand every run","count":11},{"language":"ar","tag":"Understand every run","count":11},{"language":"de","tag":"Understand every run","count":11},{"language":"es","tag":"Understand every run","count":11},{"language":"fr","tag":"Understand every run","count":11},{"language":"he","tag":"Understand every run","count":11},{"language":"hi","tag":"Understand every run","count":11},{"language":"it","tag":"Understand every run","count":11},{"language":"ja","tag":"Understand every run","count":11},{"language":"ko","tag":"Understand every run","count":11},{"language":"pt-BR","tag":"Understand every run","count":11},{"language":"ru","tag":"Understand every run","count":11},{"language":"tr","tag":"Understand every run","count":11},{"language":"vi","tag":"Understand every run","count":11},{"language":"zh","tag":"Understand every run","count":11},{"language":"ar","tag":"Find and manage failures","count":9},{"language":"de","tag":"Find and manage failures","count":9},{"language":"es","tag":"Find and manage failures","count":9},{"language":"fr","tag":"Find and manage failures","count":9},{"language":"he","tag":"Find and manage failures","count":9},{"language":"hi","tag":"Find and manage failures","count":9},{"language":"it","tag":"Find and manage failures","count":9},{"language":"ja","tag":"Find and manage failures","count":9},{"language":"ko","tag":"Find and manage failures","count":9},{"language":"pt-BR","tag":"Find and manage failures","count":9},{"language":"ru","tag":"Find and manage failures","count":9},{"language":"tr","tag":"Find and manage failures","count":9},{"language":"vi","tag":"Find and manage failures","count":9},{"language":"zh","tag":"Find and manage failures","count":9},{"language":"ar","tag":"Prevent failures","count":8},{"language":"de","tag":"Prevent failures","count":8},{"language":"es","tag":"Prevent failures","count":8},{"language":"fr","tag":"Prevent failures","count":8},{"language":"he","tag":"Prevent failures","count":8},{"language":"hi","tag":"Prevent failures","count":8},{"language":"it","tag":"Prevent failures","count":8},{"language":"ja","tag":"Prevent failures","count":8},{"language":"ko","tag":"Prevent failures","count":8},{"language":"pt-BR","tag":"Prevent failures","count":8},{"language":"ru","tag":"Prevent failures","count":8},{"language":"tr","tag":"Prevent failures","count":8},{"language":"vi","tag":"Prevent failures","count":8},{"language":"zh","tag":"Prevent failures","count":8},{"language":"ar","tag":"Reference","count":7},{"language":"de","tag":"Reference","count":7},{"language":"es","tag":"Reference","count":7},{"language":"fr","tag":"Reference","count":7},{"language":"he","tag":"Reference","count":7},{"language":"hi","tag":"Reference","count":7},{"language":"it","tag":"Reference","count":7},{"language":"ja","tag":"Reference","count":7},{"language":"ko","tag":"Reference","count":7},{"language":"pt-BR","tag":"Reference","count":7},{"language":"ru","tag":"Reference","count":7},{"language":"tr","tag":"Reference","count":7},{"language":"vi","tag":"Reference","count":7},{"language":"zh","tag":"Reference","count":7},{"language":"ar","tag":"Connect your agents","count":6},{"language":"de","tag":"Connect your agents","count":6},{"language":"es","tag":"Connect your agents","count":6},{"language":"fr","tag":"Connect your agents","count":6},{"language":"he","tag":"Connect your agents","count":6},{"language":"hi","tag":"Connect your agents","count":6},{"language":"it","tag":"Connect your agents","count":6},{"language":"ja","tag":"Connect your agents","count":6},{"language":"ko","tag":"Connect your agents","count":6},{"language":"pt-BR","tag":"Connect your agents","count":6},{"language":"ru","tag":"Connect your agents","count":6},{"language":"tr","tag":"Connect your agents","count":6},{"language":"vi","tag":"Connect your agents","count":6},{"language":"zh","tag":"Connect your agents","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":":root{--fpai-pink: #c92251}.dark{--fpai-pink: #e4587d}h1,h2,h3{letter-spacing:-0.025em}#content blockquote{position:relative;margin:1.5rem 0;padding:1.25rem 1.5rem 1.25rem 3.75rem!important;border-left:4px solid var(--fpai-pink)!important;border-radius:0 14px 14px 0;background:#f3f4f6!important;color:inherit!important}#content blockquote::before{content:\"“\";position:absolute;top:0.35rem;left:1rem;color:var(--fpai-pink);font-size:3rem;font-weight:700;line-height:1}#content blockquote p:first-child{margin-top:0}#content blockquote p:last-child{margin-bottom:0}.dark #content blockquote{background:rgba(148, 163, 184, 0.12)!important}.navbar-link a[href=\"https://discord.befailproof.ai\"],.navbar-link a[href=\"https://www.reddit.com/r/failproofai/\"],.navbar-link a[href=\"https://x.com/failproofai\"],.navbar-link a[href=\"https://github.com/FailproofAI/failproofai\"],#topbar-cta-button a[href=\"https://app.befailproof.ai\"]{position:relative}.navbar-link a[href=\"https://discord.befailproof.ai\"]::after,.navbar-link a[href=\"https://www.reddit.com/r/failproofai/\"]::after,.navbar-link a[href=\"https://x.com/failproofai\"]::after,.navbar-link a[href=\"https://github.com/FailproofAI/failproofai\"]::after,#topbar-cta-button a[href=\"https://app.befailproof.ai\"]::after{position:absolute;top:calc(100% + 0.5rem);left:50%;z-index:50;padding:0.35rem 0.55rem;border-radius:0.4rem;background:#111827;color:#fff;font-size:0.75rem;font-weight:500;line-height:1;opacity:0;pointer-events:none;transform:translate(-50%, -0.2rem);transition:opacity 120ms ease, transform 120ms ease}.navbar-link a[href=\"https://discord.befailproof.ai\"]::after{content:\"Join the community\"}.navbar-link a[href=\"https://www.reddit.com/r/failproofai/\"]::after{content:\"Join r/failproofai\"}.navbar-link a[href=\"https://x.com/failproofai\"]::after{content:\"Follow launches\"}.navbar-link a[href=\"https://github.com/FailproofAI/failproofai\"]::after{content:\"Star us!\"}#topbar-cta-button a[href=\"https://app.befailproof.ai\"]::after{content:\"Go to Failproof\"}.navbar-link a[href=\"https://discord.befailproof.ai\"]:hover::after,.navbar-link a[href=\"https://discord.befailproof.ai\"]:focus-visible::after,.navbar-link a[href=\"https://www.reddit.com/r/failproofai/\"]:hover::after,.navbar-link a[href=\"https://www.reddit.com/r/failproofai/\"]:focus-visible::after,.navbar-link a[href=\"https://x.com/failproofai\"]:hover::after,.navbar-link a[href=\"https://x.com/failproofai\"]:focus-visible::after,.navbar-link a[href=\"https://github.com/FailproofAI/failproofai\"]:hover::after,.navbar-link a[href=\"https://github.com/FailproofAI/failproofai\"]:focus-visible::after,#topbar-cta-button a[href=\"https://app.befailproof.ai\"]:hover::after,#topbar-cta-button a[href=\"https://app.befailproof.ai\"]:focus-visible::after{opacity:1;transform:translate(-50%, 0)}img[src^=\"/images/frameworks/\"]{opacity:0.78}.dark img[src^=\"/images/frameworks/\"]{filter:invert(1);opacity:0.7}"}],"page":{"pagePath":"sessions/queries","slug":"/sessions/queries","pageMetadata":{"title":"Queries","description":"Explore session, event, and evaluation data with reusable SQL.","icon":"database","href":"/sessions/queries"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Explore session, event, and evaluation data with reusable SQL.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,OptimizedImage,Tab,Tabs,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Queries are the flexible layer beneath dashboards, audits, and investigations. Use ad-hoc SQL to test an idea, then save the query when it becomes part of a recurring workflow.`}),`\n`,_jsx(Heading,{level:`2`,id:`create-and-run-a-query`,children:`Create and run a query`}),`\n`,_jsxs(Tabs,{children:[_jsxs(Tab,{title:`Dashboard`,id:`dashboard`,children:[_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Go to `,_jsx(_components.strong,{children:`Analyze → Queries`}),` and select `,_jsx(_components.strong,{children:`new query`}),`.`]}),`\n`,_jsx(_components.li,{children:`Open the schema browser and choose fields from the event, session, or evaluation data.`}),`\n`,_jsx(_components.li,{children:`Write SQL, add parameters when needed, and run the query.`}),`\n`,_jsxs(_components.li,{children:[`Save it with a clear name and description, then use `,_jsx(_components.strong,{children:`add to dashboard`}),` when the result should be monitored.`]}),`\n`]}),_jsx(_components.p,{children:`The query editor combines the event schema, SQL, parameters, and a result preview so you can validate the question before saving it.`}),_jsx(OptimizedImage,{src:`https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/query-lab.png?fit=max\u0026auto=format\u0026n=WgPwQzedeDNwJBTy\u0026q=85\u0026s=78f7043cd9c3f851aa821a1128801728`,alt:`The SQL query editor with a schema browser and live result grid.`,\"data-og-width\":`3200`,width:`3200`,\"data-og-height\":`2000`,height:`2000`,\"data-path\":`images/dashboard/query-lab.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/query-lab.png?w=280\u0026fit=max\u0026auto=format\u0026n=WgPwQzedeDNwJBTy\u0026q=85\u0026s=cadcd202412095cc62d1843b4f5ef22e 280w, https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/query-lab.png?w=560\u0026fit=max\u0026auto=format\u0026n=WgPwQzedeDNwJBTy\u0026q=85\u0026s=f4b39247486fde88927cbcf981d53c88 560w, https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/query-lab.png?w=840\u0026fit=max\u0026auto=format\u0026n=WgPwQzedeDNwJBTy\u0026q=85\u0026s=c107b91d592f2199ca8767f3c196511d 840w, https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/query-lab.png?w=1100\u0026fit=max\u0026auto=format\u0026n=WgPwQzedeDNwJBTy\u0026q=85\u0026s=ad729643e431af1539fec22af38b5ebb 1100w, https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/query-lab.png?w=1650\u0026fit=max\u0026auto=format\u0026n=WgPwQzedeDNwJBTy\u0026q=85\u0026s=ea7342f2022525620330673d252997f7 1650w, https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/query-lab.png?w=2500\u0026fit=max\u0026auto=format\u0026n=WgPwQzedeDNwJBTy\u0026q=85\u0026s=3d4732a293831751a7961c9b8d7a7141 2500w`}),_jsx(_components.p,{children:`Saved queries then appear in the shared library, where teammates can rerun them or add their results to dashboards.`}),_jsx(OptimizedImage,{src:`https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/queries.png?fit=max\u0026auto=format\u0026n=WgPwQzedeDNwJBTy\u0026q=85\u0026s=425798528473f808cdbebb4910ec57a3`,alt:`The saved Queries library containing reusable built-in and custom queries.`,\"data-og-width\":`3200`,width:`3200`,\"data-og-height\":`2000`,height:`2000`,\"data-path\":`images/dashboard/queries.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/queries.png?w=280\u0026fit=max\u0026auto=format\u0026n=WgPwQzedeDNwJBTy\u0026q=85\u0026s=c9799484fbd3b1b091de5f1bc8fb4bd6 280w, https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/queries.png?w=560\u0026fit=max\u0026auto=format\u0026n=WgPwQzedeDNwJBTy\u0026q=85\u0026s=d63b8b96a5662f71ebdb04f4dba29765 560w, https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/queries.png?w=840\u0026fit=max\u0026auto=format\u0026n=WgPwQzedeDNwJBTy\u0026q=85\u0026s=7a36831037f80a89f2029cca2b8ae6de 840w, https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/queries.png?w=1100\u0026fit=max\u0026auto=format\u0026n=WgPwQzedeDNwJBTy\u0026q=85\u0026s=7373a8111001d316deb82e3c7c5a50d4 1100w, https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/queries.png?w=1650\u0026fit=max\u0026auto=format\u0026n=WgPwQzedeDNwJBTy\u0026q=85\u0026s=5e7958a6bc3bd150847c26e0121f9302 1650w, https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/queries.png?w=2500\u0026fit=max\u0026auto=format\u0026n=WgPwQzedeDNwJBTy\u0026q=85\u0026s=ef015b0c2dda076aeddfabf6d6381835 2500w`}),_jsx(_components.p,{children:`Use a clear name and description so the result remains understandable without reopening its SQL.`})]}),_jsxs(Tab,{title:`CLI`,id:`cli`,children:[_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`5`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`fp`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` query`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` schema`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`fp`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` query`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` create`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"retry loops\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --sql`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"SELECT ...\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`fp`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` query`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` run`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`query-i`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`d`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`fp`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` query`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` show`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`query-i`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`d`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`fp`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` query`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` update`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`query-i`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`d`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --sql`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"SELECT ...\"`})]}),`\n`]})})}),_jsxs(_components.p,{children:[`Use `,_jsx(_components.code,{children:`fp query list`}),` to find IDs and `,_jsx(_components.code,{children:`fp query delete \u003cquery-id>`}),` to remove a saved query.`]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`common-uses`,children:`Common uses`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Find sessions with repeated calls to the same tool.`}),`\n`,_jsx(_components.li,{children:`Compare evaluation scores across models or environments.`}),`\n`,_jsx(_components.li,{children:`Measure time between a human wait and resume.`}),`\n`,_jsx(_components.li,{children:`Identify policy denials followed by a successful alternative.`}),`\n`,_jsx(_components.li,{children:`Build a cohort for an audit.`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Open `,_jsx(_components.strong,{children:`Queries → Schema`}),` before writing against unfamiliar fields. Prefer explicit time and environment filters, and keep result limits during exploration.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`A query can identify a suspicious pattern, but it does not establish the failure mode by itself. Open representative traces or run an audit before turning the result into a policy.`})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Queries","description":"Explore session, event, and evaluation data with reusable SQL.","icon":"database","href":"/sessions/queries"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Create and run a query","slug":"create-and-run-a-query","depth":2,"children":[]},{"title":"Common uses","slug":"common-uses","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/exosphere/86fd84cc0563b6f3/stars.js","/_mintlify/custom/exosphere/3e9809a158d7fc0b/reo.js"],"subdomain":"exosphere","siteName":"Failproof AI","title":"Queries - Failproof AI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/sessions/queries","matchLevel":0},"zh":{"href":"/zh/sessions/queries","matchLevel":1},"ja":{"href":"/ja/sessions/queries","matchLevel":1},"ko":{"href":"/ko/sessions/queries","matchLevel":1},"es":{"href":"/es/sessions/queries","matchLevel":1},"pt-BR":{"href":"/pt-br/sessions/queries","matchLevel":1},"de":{"href":"/de/sessions/queries","matchLevel":1},"fr":{"href":"/fr/sessions/queries","matchLevel":1},"ru":{"href":"/ru/sessions/queries","matchLevel":1},"hi":{"href":"/hi/sessions/queries","matchLevel":1},"tr":{"href":"/tr/sessions/queries","matchLevel":1},"vi":{"href":"/vi/sessions/queries","matchLevel":1},"it":{"href":"/it/sessions/queries","matchLevel":1},"ar":{"href":"/ar/sessions/queries","matchLevel":1},"he":{"href":"/he/sessions/queries","matchLevel":1}}},"lastModified":"2026-09-07T14:12:44.948Z","originalFileLocation":"sessions/queries.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Explore session, event, and evaluation data with reusable SQL.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Failproof AI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/exosphere/jZWjNNy57lpILUrG/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/exosphere/jZWjNNy57lpILUrG/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/exosphere/jZWjNNy57lpILUrG/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/exosphere/jZWjNNy57lpILUrG/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/exosphere/jZWjNNy57lpILUrG/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/exosphere/jZWjNNy57lpILUrG/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/exosphere/jZWjNNy57lpILUrG/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/exosphere/jZWjNNy57lpILUrG/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/exosphere/jZWjNNy57lpILUrG/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Queries - Failproof AI\">\u003cmeta data-mint-head property=\"og:description\" content=\"Explore session, event, and evaluation data with reusable SQL.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Failproof AI\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.befailproof.ai/sessions/queries\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://exosphere.mintlify.site/_mintlify/api/og/v2?division=Understand+every+run\u0026amp;title=Queries\u0026amp;description=Explore+session%2C+event%2C+and+evaluation+data+with+reusable+SQL.\u0026amp;theme=cebdc1f0592da2cd408854e5\u0026amp;signature=77726471917b07df52618f3a750614f151d930a051dd1dbf7c57b3da2686471f\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Queries - Failproof AI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Explore session, event, and evaluation data with reusable SQL.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://exosphere.mintlify.site/_mintlify/api/og/v2?division=Understand+every+run\u0026amp;title=Queries\u0026amp;description=Explore+session%2C+event%2C+and+evaluation+data+with+reusable+SQL.\u0026amp;theme=cebdc1f0592da2cd408854e5\u0026amp;signature=77726471917b07df52618f3a750614f151d930a051dd1dbf7c57b3da2686471f\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/exosphere/jZWjNNy57lpILUrG/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Failproof AI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#c92251\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.befailproof.ai/sessions/queries\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/sessions/queries.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.befailproof.ai/sessions/queries\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.befailproof.ai/zh/sessions/queries\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ja\" href=\"https://docs.befailproof.ai/ja/sessions/queries\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.befailproof.ai/ko/sessions/queries\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.befailproof.ai/es/sessions/queries\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt-BR\" href=\"https://docs.befailproof.ai/pt-br/sessions/queries\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"de\" href=\"https://docs.befailproof.ai/de/sessions/queries\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://docs.befailproof.ai/fr/sessions/queries\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ru\" href=\"https://docs.befailproof.ai/ru/sessions/queries\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"hi\" href=\"https://docs.befailproof.ai/hi/sessions/queries\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"tr\" href=\"https://docs.befailproof.ai/tr/sessions/queries\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"vi\" href=\"https://docs.befailproof.ai/vi/sessions/queries\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"it\" href=\"https://docs.befailproof.ai/it/sessions/queries\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ar\" href=\"https://docs.befailproof.ai/ar/sessions/queries\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"he\" href=\"https://docs.befailproof.ai/he/sessions/queries\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.befailproof.ai/sessions/queries\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.befailproof.ai/#organization\",\"name\":\"Failproof AI\",\"url\":\"https://docs.befailproof.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/exosphere/63Tp--IVddVBndpp/logo/Failproof_AI_logo_light.png?fit=max\u0026auto=format\u0026n=63Tp--IVddVBndpp\u0026q=85\u0026s=5231ac600a18d7ad299834e4a880f6e0\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.befailproof.ai#website\",\"name\":\"Failproof AI\",\"url\":\"https://docs.befailproof.ai\",\"publisher\":{\"@id\":\"https://docs.befailproof.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.befailproof.ai/sessions/queries#webpage\",\"url\":\"https://docs.befailproof.ai/sessions/queries\",\"name\":\"Queries\",\"description\":\"Explore session, event, and evaluation data with reusable SQL.\",\"dateModified\":\"2026-09-07T14:12:44.948Z\",\"isPartOf\":{\"@id\":\"https://docs.befailproof.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.befailproof.ai/sessions/queries#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.befailproof.ai/sessions/queries#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Understand every run\",\"item\":\"https://docs.befailproof.ai/sessions/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Queries\",\"item\":\"https://docs.befailproof.ai/sessions/queries\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.befailproof.ai/sessions/queries#article\",\"headline\":\"Queries\",\"name\":\"Queries\",\"description\":\"Explore session, event, and evaluation data with reusable SQL.\",\"url\":\"https://docs.befailproof.ai/sessions/queries\",\"mainEntityOfPage\":{\"@id\":\"https://docs.befailproof.ai/sessions/queries#webpage\"},\"dateModified\":\"2026-09-07T14:12:44.948Z\",\"publisher\":{\"@id\":\"https://docs.befailproof.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.befailproof.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Failproof AI\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Failproof AI\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/sessions/queries.md","siteName":"Failproof AI","nav":{"global":{"anchors":[{"anchor":"Support","icon":"mail","href":"mailto:support@befailproof.ai"}]},"languages":[{"language":"en","tabs":[{"tab":"Start","icon":"rocket","pages":[{"title":"Start","href":""}]},{"tab":"Trace Agents","icon":"route","groups":[{"group":"Understand every run","pages":[{"title":"Sessions","icon":"workflow","href":"/sessions/overview"},{"title":"Live events","icon":"radio","href":"/sessions/live-events"},{"title":"Read a trace","icon":"route","href":"/sessions/read-a-trace"},{"title":"Models","icon":"cpu","href":"/sessions/models"},{"title":"Hooks","icon":"webhook","href":"/sessions/hooks"},{"title":"Policy decisions","icon":"shield-check","href":"/sessions/policy-decisions"},{"title":"Tools","icon":"wrench","href":"/sessions/tools"},{"title":"Errors","icon":"circle-alert","href":"/sessions/errors"},{"title":"Metrics","icon":"ruler","href":"/sessions/metrics"},{"title":"Dashboards","description":"Track the reliability signals that matter to an agent or workflow.","icon":"layout-dashboard","href":"/sessions/dashboards"},{"title":"Queries","icon":"database","href":"/sessions/queries"}]},{"group":"Plug in your agent","pages":[{"title":"Instrument your agent","sidebarTitle":"Frameworks","description":"Connect any supported agent framework to Failproof AI with one call.","icon":"plug","href":"/start/integrations"},{"title":"OpenTelemetry","icon":"radio","href":"/agenteye/opentelemetry"},{"title":"Custom agents","sidebarTitle":"Custom agents","icon":"code","href":"/start/integrations/custom-agents"},{"title":"LangChain and LangGraph","sidebarTitle":"LangChain and LangGraph","icon":"https://mintlify.s3.us-west-1.amazonaws.com/exosphere/images/frameworks/langchain.svg","href":"/start/integrations/langchain"},{"title":"CrewAI","sidebarTitle":"CrewAI","icon":"https://mintlify.s3.us-west-1.amazonaws.com/exosphere/images/frameworks/crewai.svg","href":"/start/integrations/crewai"},{"title":"LlamaIndex","sidebarTitle":"LlamaIndex","icon":"https://mintlify.s3.us-west-1.amazonaws.com/exosphere/images/frameworks/llamaindex.svg","href":"/start/integrations/llamaindex"},{"title":"Pydantic AI","sidebarTitle":"Pydantic AI","icon":"https://mintlify.s3.us-west-1.amazonaws.com/exosphere/images/frameworks/pydantic-ai.svg","href":"/start/integrations/pydantic-ai"}]}]},{"tab":"Find failures","icon":"scan-search","pages":[{"title":"Find failures","href":"/evaluations/overview"}]},{"tab":"Prevent failures","icon":"shield-check","pages":[{"title":"Prevent failures","href":"/policies/overview"}]},{"tab":"Admin","icon":"settings-2","pages":[{"title":"Admin","href":"/admin/overview"}]},{"tab":"Integrations and reference","icon":"braces","pages":[{"title":"Integrations and reference","href":"/reference/overview"}]}]},{"language":"zh","pages":[{"title":"zh","href":"/zh/sessions/queries"}]},{"language":"ja","pages":[{"title":"ja","href":"/ja/sessions/queries"}]},{"language":"ko","pages":[{"title":"ko","href":"/ko/sessions/queries"}]},{"language":"es","pages":[{"title":"es","href":"/es/sessions/queries"}]},{"language":"pt-BR","pages":[{"title":"pt-BR","href":"/pt-br/sessions/queries"}]},{"language":"de","pages":[{"title":"de","href":"/de/sessions/queries"}]},{"language":"fr","pages":[{"title":"fr","href":"/fr/sessions/queries"}]},{"language":"ru","pages":[{"title":"ru","href":"/ru/sessions/queries"}]},{"language":"hi","pages":[{"title":"hi","href":"/hi/sessions/queries"}]},{"language":"tr","pages":[{"title":"tr","href":"/tr/sessions/queries"}]},{"language":"vi","pages":[{"title":"vi","href":"/vi/sessions/queries"}]},{"language":"it","pages":[{"title":"it","href":"/it/sessions/queries"}]},{"language":"ar","pages":[{"title":"ar","href":"/ar/sessions/queries"}]},{"language":"he","pages":[{"title":"he","href":"/he/sessions/queries"}]}]},"basePath":"","title":"Queries - Failproof AI","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":["a74be98ba7"],"chunks":["zoom-image-lightbox-CkI5al_8.js","lightbox-handle-r17bVUz3.js"]}