Overview

The Bitmovin Observability Assistant provides natural-language exploration of video playback metrics, license usage, and viewer experience insights within the dashboard through an intuitive chat-based interaction.

How it works

The Observability Assistant operates as a conversational agent that bridges natural language and structured analytics data:

Architecture Overview

1. Your Query – You submit a question through the chat interface in the Bitmovin Dashboard
2. Language Understanding & Tool Selection – A large language model, Gemini 3.1 Pro (gemini-3.1-pro-preview), interprets your question and determines what observability data you need and which observability tools from our Observability MCP Server best serve to answer your question.
3. Data Retrieval – Selected tools query your actual observability data via the Bitmovin Observability API.
4. Response Generation – Results are synthesized into a natural language response and streamed back to you in real-time.

Supported Analytics Operations

The Assistant can analyze these core metrics:

• Plays – Successful video playback sessions, play attempts and total hours watched
• User Experience – Video startup time, buffering percentage, average video bitrate
• Error Analysis – Error percentage and error ratio
• Unique Users – Distinct viewer counts

You can query these metrics by:

• Trends over time – See how metrics change across hours, days, or longer periods
• Categorical breakdowns – Group metrics by browser, country, platform, stream format, or any other dimension
• Individual Session Analysis – Inspect individual playback sessions for detailed troubleshooting
• Custom filtering – Combine multiple filter dimensions (country, platform, browser, etc.) to isolate specific user segments

Example Questions

• Based on data from the last week, what do I need to improve this week?
• Compare average bitrate by country over the last 7 days?
• What was the error percentage for iOS devices for the last 3 days?
• Break down plays by country for the last 7 days.
• Which browser has the highest buffering percentage?
• Which countries have the slowest startup times?
• On which devices did video quality improve yesterday compared to the day before?
• Compare plays between last week and this week.
• Show me a summary of impression abc123.

Limitations

• The Assistant will not answer questions that are out of the scope of video playback metrics and Quality of Experience analysis.
• The Assistant maintains context within a conversation, so you can ask follow-up questions. However, once you leave the chat, the chat history will be lost. Use the Download Chat functionality to save your chat history before leaving.

Security

• The Assistant operates with your account's permission level – it can only access metrics you have access to.