Bonnard records each tool call that an agent makes. The Activity page in the console at
app.bonnard.ai shows the records, so you can find a failed call or count usage for each customer.
Requirements
Membership in your Bonnard workspace. Any role can open Activity.
The Admin role, to change Call intent.
What Bonnard records
Each row on Activity is one record, for:
Each tool call, for example sql_query or render_chart.
Each refused connection, for example from a person with no access. It has the action
connect, the status denied and no tool.
Each protocol request from the AI client, for example tools/list.
Some actions outside AI clients, for example a console chart view.
The status is ok, denied or error. denied means that Bonnard or the database refused the call, for example a
query that is not read-only.
Read the overview
Select Activity. The Overview tab shows the last 7 days for all data sources.
AcmeOverviewOverviewCONFIGUREDataDataContextContextActivityActivityCustomersCustomersCONTENTChartsChartsDashboardsDashboardsSettingsSettingsConnected to ClaudeConnected to ClaudeAMAlex Morganalex@acme.exampleActivityOverviewLogsUsageAll data sourcesEveryoneAll customers24h7d30dCALLS64ERROR RATE1.6%LATENCY P50 / P95223 / 561 msROWS RETURNED151Calls over timeokdeniederror020406080Sep 7Sep 8Sep 9Sep 10Sep 11Sep 12Sep 13Sep 14Top data sourcesAcme production1 err61Acme warehouse2No data source1Top peopleAlex Morgan1 err64Top customersNo data.Top AI clientsClaude1 err64
The All data sources, Everyone and All customers menus filter each tab. The range is 24h, 7d or 30d, back from now.
Error rate counts denied and error records. Top data sources, Top people, Top customers and Top AI
clients show the 8 with the most records.
Find a call
In the console, select Activity, then Logs.
Optional: select a tool, a status or a sign-in method. The tool filter offers explore_schema, describe_table
and sql_query.
Select the row of the call.
AcmeOverviewOverviewCONFIGUREDataDataContextContextActivityActivityCustomersCustomersCONTENTChartsChartsDashboardsDashboardsSettingsSettingsConnected to ClaudeConnected to ClaudeAMAlex Morganalex@acme.exampleActivityOverviewLogsUsageAll data sourcesEveryoneAll customers24h7d30dAll toolsAll statusesAll sign-in methodsExport CSVTimePersonCustomerData sourceAI clientToolStatusLatencyRowsjust nowAlex Morgan—Acme warehouseClaudesql_queryok287ms5just nowAlex Morgan—Acme warehouseClaudeexplore_schemaok131ms—just nowAlex Morgan——Claudeexplore_schemaok104ms—just nowAlex Morgan—Acme productionClaudesave_chartok186ms—just nowAlex Morgan—Acme productionClauderender_chartok391ms4just nowAlex Morgan—Acme productionClaudesave_chartok229ms—just nowAlex Morgan—Acme productionClauderender_chartok604ms8just nowAlex Morgan—Acme productionClaudeexplore_chartsok118ms—8m agoAlex Morgan—Acme productionClaudesave_dashboardok231ms—11m agoAlex Morgan—Acme productionClauderender_dashboardok377ms415m agoAlex Morgan—Acme productionClaudesave_chartok194ms—18m agoAlex Morgan—Acme productionClauderender_dashboardok1126ms1518m agoAlex Morgan—Acme productionClaudeexplore_dashboardsok133ms—25m agoAlex Morgan—Acme productionClaudesave_chartok176ms—30m agoAlex Morgan—Acme productionClaudesave_chartok195ms—40m agoAlex Morgan—Acme productionClaudesave_chartok222ms—45m agoAlex Morgan—Acme productionClaudesave_chartok155ms—48m agoAlex Morgan—Acme productionClaudesave_chartok208ms—52m agoAlex Morgan—Acme productionClaudesave_dashboardok217ms—52m agoAlex Morgan—Acme productionClaudeexplore_dashboardsok142ms—53m agoAlex Morgan—Acme productionClaudesave_dashboarddenied61ms—No tool calls in this range.Load moresql_queryok9/14/2026, 8:31:09 AMActionqueryPersonAlex MorganCustomer—Tenant_singleData sourceAcme productionConnectionWorkspace connectionRoleviewerAI clientClaudeSign-in methodOAuthLatency412 msRows4Request idbnreq_k3v9t2m8x4q7w1z5r6p0aSQLSELECT p.name AS product, SUM(oi.quantity) AS unitsFROM order_items oi JOIN products p ON p.id =oi.product_id JOIN orders o ON o.id = oi.order_idWHERE o.ordered_at >= date '2026-08-01' ANDo.ordered_at < date '2026-09-01'GROUP BY 1 ORDER BY units DESCAcmeOverviewOverviewCONFIGUREDataDataContextContextActivityActivityCustomersCustomersCONTENTChartsChartsDashboardsDashboardsSettingsSettingsConnected to ClaudeConnected to ClaudeAMAlex Morganalex@acme.exampleActivityOverviewLogsUsageAll data sourcesEveryoneAll customers24h7d30dAll toolsAll statusesAll sign-in methodsExport CSVTimePersonCustomerData sourceAI clientToolStatusLatencyRowsjust nowAlex Morgan—Acme warehouseClaudesql_queryok287ms5just nowAlex Morgan—Acme warehouseClaudeexplore_schemaok131ms—just nowAlex Morgan——Claudeexplore_schemaok104ms—just nowAlex Morgan—Acme productionClaudesave_chartok186ms—just nowAlex Morgan—Acme productionClauderender_chartok391ms4just nowAlex Morgan—Acme productionClaudesave_chartok229ms—just nowAlex Morgan—Acme productionClauderender_chartok604ms8just nowAlex Morgan—Acme productionClaudeexplore_chartsok118ms—8m agoAlex Morgan—Acme productionClaudesave_dashboardok231ms—11m agoAlex Morgan—Acme productionClauderender_dashboardok377ms415m agoAlex Morgan—Acme productionClaudesave_chartok194ms—18m agoAlex Morgan—Acme productionClauderender_dashboardok1126ms1518m agoAlex Morgan—Acme productionClaudeexplore_dashboardsok133ms—25m agoAlex Morgan—Acme productionClaudesave_chartok176ms—30m agoAlex Morgan—Acme productionClaudesave_chartok195ms—40m agoAlex Morgan—Acme productionClaudesave_chartok222ms—45m agoAlex Morgan—Acme productionClaudesave_chartok155ms—48m agoAlex Morgan—Acme productionClaudesave_chartok208ms—52m agoAlex Morgan—Acme productionClaudesave_dashboardok217ms—52m agoAlex Morgan—Acme productionClaudeexplore_dashboardsok142ms—53m agoAlex Morgan—Acme productionClaudesave_dashboarddenied61ms—No tool calls in this range.Load moresql_queryok9/14/2026, 8:31:09 AMActionqueryPersonAlex MorganCustomer—Tenant_singleData sourceAcme productionConnectionWorkspace connectionRoleviewerAI clientClaudeSign-in methodOAuthLatency412 msRows4Request idbnreq_k3v9t2m8x4q7w1z5r6p0aSQLSELECT p.name AS product, SUM(oi.quantity) AS unitsFROM order_items oi JOIN products p ON p.id =oi.product_id JOIN orders o ON o.id = oi.order_idWHERE o.ordered_at >= date '2026-08-01' ANDo.ordered_at < date '2026-09-01'GROUP BY 1 ORDER BY units DESC
Logs shows the newest records first, 100 at a time. To get older records, select Load more. Column headings sort the rows, and a badge marks a call under Preview as.
Read a call
The fields include the tenant, the value that marks a customer’s data.
The fields of a call
Field
Shows
Action
The kind of call, for example query for sql_query
Tenant
The tenant that the call ran as. _single on a database with No tenancy
Person
The person, or the API key and its owner
Role
The caller’s role. Always viewer for a personal API key
AI client
The AI client’s name, API key, or Unknown
Sign-in method
OAuth, API key, federated, or a trusted issuer’s name
Customer
The caller’s customer
Data source
The data source that the call read
Connection
Workspace connection, or an old app address
Latency
Milliseconds to answer
Rows
The number of rows that the call returned
Request id
The AI client’s ID for the request
SQL
The query, if the call ran one
Reason
The cause of a denied or error status
Export the log
On Logs, select Export CSV. The file audit-log.csv holds up to 10,000 of the filtered records, newest
first, with IDs in place of names. Its header is:
Select Usage, then By customer, By data source or By person. Cards show the row count, Total calls and Rows scanned. Each row shows Calls, Rows scanned, Active users (not on By person) and Errors. By customer also shows Tenant ID, and does not count calls under Preview as or records with no tenant, for example refused connections.
Calls counts all records, for example protocol requests.
Rows scanned is the same sum as Rows returned on Overview.
Usage shows a maximum of 100 rows, the most calls first.
Some records are free for billing, for example tools/list. See Billing and usage.
Call intent
Under Settings, then AI tools, Call intent is on by default, so each tool asks the agent why it makes the
call. Bonnard stores the answer. The console and the CSV export do not show it.
How long Bonnard keeps records
Bonnard deletes the SQL and the reason of a record after 90 days, and the rest of the record after 13 months. The
console shows the last 30 days at most.