Skip to main content

View analytics

Click Analytics in the top navigation bar, then choose your Project and date range using From and To. Use the Assistant, Search, and MCP tabs to switch views. Download report opens the browser's print dialog, where you can save a PDF.

View analytics

The Analytics view tracks project activity for a selected period, organized into Assistant, MCP, and Search tabs:

important

Only Administrator, Maintainer, or Editor roles can view analytics. See Manage roles.

Assistant analytics​

  • Chats: Total number of chat sessions.
  • Messages: Total number of messages exchanged.
  • Unique users: Distinct saved IP addresses, plus one user for each chat without a saved IP address.
  • Helpful and Not helpful: Positive and negative feedback counts.
  • Satisfaction: Percentage calculated from feedback, treating answers without feedback as positive.
  • Daily chat activity: Graph showing chat activity over time.
  • Key pages driving conversations: URLs where assistant conversations originated, with occurrence counts.
  • Top countries driving conversations: Geographic distribution showing which countries users are chatting from.
  • Frequently asked questions (Professional, Business, and Enterprise plans): Most common questions asked to your assistant, grouped by semantic similarity. Analyzed daily.
  • Content gaps (Professional, Business, and Enterprise plans): Questions the assistant couldn't answer, grouped by semantic similarity. Analyzed daily.

MCP analytics​

Use this tab to understand how people use your documentation through connected MCP clients.

  • Chats via MCP: Conversations created through Ask. Find docs and Get docs calls do not create chat sessions.
  • Messages via MCP: Total Ask, Find docs, and Get docs calls. Each call counts once, including separate document pagination calls.
  • Unique users: Users of Ask conversations, estimated from IP addresses. Retrieval calls do not contribute to this count.
  • Daily MCP activity: Calls over time, separated by action.
  • Top MCP clients: Editors and agents making MCP calls, with message counts and percentage shares. Client names are supplied by the clients themselves.
  • MCP actions: Counts and shares for Ask (biel_ai), Find docs (biel_search), and Get docs (biel_get_document).

Search analytics​

  • Unique users: Number of distinct users who performed searches.
  • Searches: Total number of search queries.
  • Searches clicked: Percentage of searches where users clicked on a result.
  • Click position: Average rank of clicked results. Lower positions indicate that people find useful results nearer the top; it remains unavailable until clicks include a result rank.
  • Daily search activity: Graph showing search activity over time.
  • Top search terms: Most frequently searched terms with occurrence counts.
  • Searches without results: Queries that returned no results. Use these to identify missing content or indexing gaps.
  • Searches without clicks: Queries for which no result was opened. This list stays empty until every recorded click in the selected period includes its originating query, so Biel.ai does not report an incomplete list as a content issue.

Troubleshooting​

FAQs or content gaps not showing​

  • Plan requirement: These features require a Professional, Business, or Enterprise plan.
  • Recently upgraded: Wait 24 hours — the analysis runs daily.
  • No historical data: Biel.ai only processes conversations that occur after your upgrade.
  • No conversations: There were no assistant conversations to analyze from the previous day.