Bonnard

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.

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

  1. In the console, select Activity, then Logs.
  2. Optional: select a tool, a status or a sign-in method. The tool filter offers explore_schema, describe_table and sql_query.
  3. Select the row of the call.

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
FieldShows
ActionThe kind of call, for example query for sql_query
TenantThe tenant that the call ran as. _single on a database with No tenancy
PersonThe person, or the API key and its owner
RoleThe caller’s role. Always viewer for a personal API key
AI clientThe AI client’s name, API key, or Unknown
Sign-in methodOAuth, API key, federated, or a trusted issuer’s name
CustomerThe caller’s customer
Data sourceThe data source that the call read
ConnectionWorkspace connection, or an old app address
LatencyMilliseconds to answer
RowsThe number of rows that the call returned
Request idThe AI client’s ID for the request
SQLThe query, if the call ran one
ReasonThe 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:

createdAt,serverId,env,sourceId,tenantId,customerOrgId,apiKeyId,previewCustomerOrgId,previewCustomerName,userId,role,clientId,authSource,tool,action,status,rows,latencyMs,requestId,sql,error

Read usage

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.