Mathias Fredriksson
f1b2715555
Previously AI Bridge retention was only documented in the auto-generated CLI reference, making it difficult for administrators to discover and understand how to configure data retention for compliance requirements. This adds retention configuration to the AI Bridge setup guide with examples, documents the REST API and CLI export options in the monitoring guide, and cross-references AI Bridge from the central data retention page for discoverability. Closes #21038
2.2 KiB
Monitoring
AI Bridge records the last user prompt, token usage, and every tool invocation for each intercepted request. Each capture is tied to a single "interception" that maps back to the authenticated Coder identity, making it easy to attribute spend and behaviour.
We provide an example Grafana dashboard that you can import as a starting point for your metrics. See the Grafana dashboard README.
These logs and metrics can be used to determine usage patterns, track costs, and evaluate tooling adoption.
Exporting Data
AI Bridge interception data can be exported for external analysis, compliance reporting, or integration with log aggregation systems.
REST API
You can retrieve AI Bridge interceptions via the Coder API with filtering and pagination support.
curl -X GET "https://coder.example.com/api/v2/aibridge/interceptions?q=initiator:me" \
-H "Coder-Session-Token: $CODER_SESSION_TOKEN"
Available query filters:
initiator- Filter by user ID or usernameprovider- Filter by AI provider (e.g.,openai,anthropic)model- Filter by model namestarted_after- Filter interceptions after a timestampstarted_before- Filter interceptions before a timestamp
See the API documentation for full details.
CLI
Export interceptions as JSON using the CLI:
coder aibridge interceptions list --initiator me --limit 1000
You can filter by time range, provider, model, and user:
coder aibridge interceptions list \
--started-after "2025-01-01T00:00:00Z" \
--started-before "2025-02-01T00:00:00Z" \
--provider anthropic
See coder aibridge interceptions list --help for all options.
Data Retention
AI Bridge data is retained for 60 days by default. Configure the retention period to balance storage costs with your organization's compliance and analysis needs.
For configuration options and details, see Data Retention in the AI Bridge setup guide.