# Brizz Documentation

> Brizz is the product analytics layer for AI agents — trace every conversation, measure response quality, surface failure patterns, and tie agent behavior to product outcomes.

## Introduction
- [Welcome to Brizz](https://docs.brizz.ai/docs/introduction.md): Brizz is the analytics layer for AI agents. Capture every interaction, measure quality, and connect agent behavior to product outcomes.
- [Core concepts](https://docs.brizz.ai/docs/introduction/concepts.md): A short mental model for Brizz: trace, span, session, event, user, issue, intent, journey.

## Get started
- [Install the SDK](https://docs.brizz.ai/docs/get-started/install.md): Install the Brizz SDK in your Python or Node.js project.
- [Send your first session](https://docs.brizz.ai/docs/get-started/first-session.md): Initialize the Brizz SDK and capture your first session.
- [Verify it landed](https://docs.brizz.ai/docs/get-started/verify.md): Confirm your first session arrived in the Brizz dashboard, and what to do if it didn't.
- [Next steps](https://docs.brizz.ai/docs/get-started/next-steps.md): Where to go after your first session lands — identify users, send events, plug in a framework, explore the dashboard.

## SDKs
- [Choose your SDK](https://docs.brizz.ai/docs/sdks.md): Pick your runtime, then check whether the framework you're using needs explicit wiring.
- [Python SDK](https://docs.brizz.ai/docs/sdks/python.md): Install, initialize, and add sessions/events in Python.
- [TypeScript/Node.js SDK](https://docs.brizz.ai/docs/sdks/typescript.md): Instrument AI libraries in Node.js and emit sessions/events.
- [Browser](https://docs.brizz.ai/docs/sdks/browser.md): Capture product events from a web frontend with @brizz/browser and correlate them with the same backend agent session.
- [LangChain (JavaScript)](https://docs.brizz.ai/docs/sdks/langchain-js.md): Install Brizz alongside LangChain JS and add session tracking.
- [Vercel AI SDK](https://docs.brizz.ai/docs/sdks/vercel-ai.md): Install Brizz alongside the Vercel AI SDK and tag sessions.
- [Vercel eve](https://docs.brizz.ai/docs/sdks/vercel-eve.md): Install Brizz alongside Vercel's eve framework and wire up your DSN.
- [Google GenAI (Gemini)](https://docs.brizz.ai/docs/sdks/google-genai.md): Install Brizz alongside Google's @google/genai SDK — Gemini on Vertex AI or the Gemini Developer API.
- [Agno](https://docs.brizz.ai/docs/sdks/agno.md): Install Brizz with the Agno agent framework.
- [Strands Agents](https://docs.brizz.ai/docs/sdks/strands-agents.md): Install Brizz with the Strands Agents framework.
- [LiveKit Agents](https://docs.brizz.ai/docs/sdks/livekit-agents.md): Install Brizz with the LiveKit Agents voice framework.
- [MCP (auto-instrument your server)](https://docs.brizz.ai/docs/sdks/mcp.md): Add Brizz observability to an MCP server you operate, in Python (FastMCP) or TypeScript.
- [Langfuse SDK](https://docs.brizz.ai/docs/sdks/langfuse.md): Instrument your assistant with Langfuse and let Brizz ingest the OTel spans.

## Instrument
- [Identify users](https://docs.brizz.ai/docs/instrument/identify-users.md): Attach a user identity to your telemetry to unlock user-level analytics and insights.
- [Identify organizations](https://docs.brizz.ai/docs/instrument/identify-organizations.md): Attach the account, workspace, or tenant a user belongs to for org-level analytics.
- [Message IDs](https://docs.brizz.ai/docs/instrument/message-ids.md): Tag individual replies with your own id so you can reference them later — for example, to attach feedback.
- [Custom events](https://docs.brizz.ai/docs/instrument/custom-events.md): Emit custom events to track product actions, business outcomes, and feedback signals.
- [Sessions](https://docs.brizz.ai/docs/instrument/sessions.md): Capture sessions from your code — the primary unit of analysis in Brizz.
- [External links](https://docs.brizz.ai/docs/instrument/external-links.md): Attach an external URL — a Datadog trace, Sentry issue, or internal dashboard — to a Brizz session.
- [User Feedback](https://docs.brizz.ai/docs/instrument/user-feedback.md): Collect user feedback on AI responses, map it to system events, and filter sessions by sentiment.
- [Record feedback](https://docs.brizz.ai/docs/instrument/record-feedback.md): Capture an end-user reaction to a specific reply — a thumbs-up/down, a rating, a reason — as a structured brizz.feedback event. Note: it emits telemetry only, and does not yet drive the session feedback badges, Positive/Negative filters, or the Overview feedback chart — those need the system-event mapping on the User feedback page.
- [Record metrics](https://docs.brizz.ai/docs/instrument/record-metric.md): Report a numeric measurement your own system produced about an interaction — an eval score, a rating, a latency — as a first-class metric.
- [PII & Privacy](https://docs.brizz.ai/docs/instrument/pii-and-privacy.md): Protect sensitive data with masking and safe integration patterns.
- [Mute messages](https://docs.brizz.ai/docs/instrument/mute.md): Keep internal or unrelated LLM calls out of the captured conversation, so Brizz shows exactly what your users saw.

## Platform
- [Where to start in the dashboard](https://docs.brizz.ai/docs/platform.md): A short tour of the Brizz dashboard, in the order most teams find useful.
- [Sessions](https://docs.brizz.ai/docs/platform/sessions.md): Read the sessions you've captured — timeline, filters, replays, and conversation context.
- [External metrics](https://docs.brizz.ai/docs/platform/external-metrics.md): Bring your own scores into Brizz — eval results, ratings, latencies — and filter and slice sessions by them.
- [Issues](https://docs.brizz.ai/docs/platform/issues.md): Deduplicated problems detected across your agent's traffic — technical failures, capability gaps, behavioral problems — each with a status (open/tracked/ignored/resolved) and a priority (critical/high/medium/low).
- [User intents](https://docs.brizz.ai/docs/platform/user-intents.md): Semantic clusters of user prompts — what your users are actually asking for, grouped automatically.
- [Traces](https://docs.brizz.ai/docs/platform/traces.md): A paginated, low-level list of per-trace summaries with duration, cost, and models — for looking up a specific trace.
- [User journeys](https://docs.brizz.ai/docs/platform/user-journeys.md): Common paths users take through your agent — aggregated flow patterns, not single sessions.
- [Events](https://docs.brizz.ai/docs/platform/events.md): Browse and search the events your agent emitted — custom events and log records, with their body and attributes, and a link to the session where present.
- [Tools](https://docs.brizz.ai/docs/platform/tools.md): Per-tool dashboard — call volume, run time, error rate, and the issues, satisfaction, and estimated token volume of the sessions that use each tool.
- [Cost & usage](https://docs.brizz.ai/docs/platform/cost.md): The Cost dashboard — LLM spend over time, broken down by model, user, organization, and billing component, plus the most expensive sessions and per-tool token volume.
- [Cost calculation](https://docs.brizz.ai/docs/platform/cost-calculation.md): How Brizz computes and displays the cost of each session.
- [Custom dashboards](https://docs.brizz.ai/docs/platform/custom-dashboards.md): Build your own dashboards — named boards of custom charts, scoped to a trace service and shared with your team.
- [Custom charts](https://docs.brizz.ai/docs/platform/custom-charts.md): Build charts over your telemetry — pick a dataset, a metric, a chart type, and how to group and filter it.
- [Overview](https://docs.brizz.ai/docs/platform/overview.md): Your tenant's home page — a single-screen read on agent health, top problems, and emerging behavior.
- [Users](https://docs.brizz.ai/docs/platform/users.md): Per-user analytics — one row per identified end user, with activity, cost, and session metrics.
- [Organizations](https://docs.brizz.ai/docs/platform/organizations.md): Per-organization analytics for B2B agents — engagement, retention, and cost rolled up per account.
- [System performance](https://docs.brizz.ai/docs/platform/performance.md): A system-health view of your agent — session volumes, error rates, and cost over time.
- [Latency & performance](https://docs.brizz.ai/docs/platform/latency.md): Where the time goes in a turn — response times, time-to-first-response, and turns per session.
- [Leaderboard](https://docs.brizz.ai/docs/platform/leaderboard.md): Rank users, organizations, and segments by activity, cost, satisfaction, outcomes, and more.
- [Insights](https://docs.brizz.ai/docs/platform/insights.md): AI-generated insight cards over your own data, with a quality-trend list per service.
- [AI assistant](https://docs.brizz.ai/docs/platform/ai-assistant.md): Ask Brizz in plain language — about your own telemetry and about the product itself — and get answers with inline charts, clickable entity cards, and downloadable CSV or JSON reports.
- [Labels](https://docs.brizz.ai/docs/platform/labels.md): Categorize sessions and other entities — manually, by rule, or with AI — then filter and group your analytics by them.
- [Notifications](https://docs.brizz.ai/docs/platform/notifications.md): Deliver digests, alerts, and AI summaries to Slack or Email — built through a wizard, delivered on a schedule.
- [Session review](https://docs.brizz.ai/docs/platform/session-review.md): A human-review queue for sessions: rules flag the sessions worth a look, and your team works through them as open, ignored, or done.

## Integrations
- [Slack Integration](https://docs.brizz.ai/docs/integrations/slack.md): Connect Brizz to Slack for real-time alerts and notifications
- [Issue trackers](https://docs.brizz.ai/docs/integrations/issue-trackers.md): Connect Jira, Linear, or Monday so a Brizz issue becomes a ticket in the tracker your team already works from.
- [Jira Integration](https://docs.brizz.ai/docs/integrations/jira.md): Connect Brizz to Jira to create and track issues found by Brizz directly from your Jira workspace.
- [Segment Integration](https://docs.brizz.ai/docs/integrations/segment.md): Send Segment events to Brizz for observability alongside your AI agent traces
- [MCP server (connect Brizz to your AI tools)](https://docs.brizz.ai/docs/integrations/mcp-server/overview.md): Expose Brizz as an MCP server so Claude Code, Claude Desktop, Cursor, Codex, and other AI agents can query your data.
- [MCP server tools](https://docs.brizz.ai/docs/integrations/mcp-server/tools.md): Every tool the Brizz MCP server exposes — name, what it does, required scope, and full arguments — in one page.

## CLI
- [Brizz CLI](https://docs.brizz.ai/docs/cli.md): Install and authenticate the brizz CLI — read sessions, issues, intents, and metrics from the terminal, and hand structured investigations to an AI coding agent.

## Admin
- [Server DSN](https://docs.brizz.ai/docs/admin/server-dsn.md): Authenticate an SDK with a single connection string that carries the credential, the ingestion endpoint, and the service name.
- [API keys](https://docs.brizz.ai/docs/admin/api-keys.md): Create, store, and rotate the API keys your SDKs and integrations use to authenticate to Brizz.
- [JumpCloud SSO (SAML)](https://docs.brizz.ai/docs/admin/sso-jumpcloud.md): Configure JumpCloud as a SAML 2.0 identity provider for Brizz
- [Organization & members](https://docs.brizz.ai/docs/admin/organization-and-members.md): Your organization's identity, the people in it, and the role each person holds.
- [Plan & billing](https://docs.brizz.ai/docs/admin/plan-and-billing.md): Your subscription plan and tier, and how plan limits surface across the product.
- [Audit logs](https://docs.brizz.ai/docs/admin/audit-logs.md): The audit trail of administrative and security-relevant actions taken in your tenant.
- [Data controls](https://docs.brizz.ai/docs/admin/data-controls.md): Tenant-level controls over what enters your analytics — a blocklist to exclude activity, and bulk import.
- [Services & configuration](https://docs.brizz.ai/docs/admin/services-and-configuration.md): The AI services configured for your tenant, and the per-service settings that control each one.
- [Labeler instances](https://docs.brizz.ai/docs/admin/labeler-instances.md): Configure the automatic labelers that classify your telemetry — which labeler runs, on what scope, and which label it writes into.
- [Projects](https://docs.brizz.ai/docs/admin/projects.md): Group services into projects and restrict which people see them on the project-aware, service-scoped pages.

## API reference
- [API Overview](https://docs.brizz.ai/docs/api/overview.md): Overview of the Brizz REST API
- [Telemetry ingestion](https://docs.brizz.ai/docs/api/telemetry.md): Low-level HTTP endpoints for sending traces and events to Brizz.
- [Reading data](https://docs.brizz.ai/docs/api/reading-data.md): Fetch sessions, transcripts, traces, spans, and analysis results back out of Brizz over HTTP.
- [Outbound webhooks](https://docs.brizz.ai/docs/api/webhooks.md): Receive an HTTP callback when a session or trace matures, signed with the Standard Webhooks spec.

## Help
- [Troubleshooting](https://docs.brizz.ai/docs/help/troubleshooting.md): Fix common setup and ingestion issues quickly.
- [Glossary](https://docs.brizz.ai/docs/help/glossary.md): Alphabetical reference for terms used throughout the Brizz docs.

## Optional
- [Full documentation (single file)](https://docs.brizz.ai/llms-full.txt): Every page concatenated into one file — fetch when you want the entire corpus at once.