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 2.5 Flash) 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.