Update analytics docs

guides/analytics.mdx

@@ -0,0 +1,284 @@
+---
+title: 'Analytics'
+description: 'Learn how to analyze the usage of your Guru.'
+---
+
+Gurubase provides a comprehensive usage analytics dashboard to help you understand how your Guru is being used. Track what questions are being asked, how your Guru is performing, and gain insights into user behavior and engagement patterns.
+
+## Accessing the Usage Analytics
+
+To access the usage analytics, go to the Guru's detail page and click on the "Analytics" tab.
+
+<Frame>
+  <img src="/images/guides/analytics/analytics-tab.png" alt="Usage Analytics" />
+</Frame>
+
+## Usage Analytics Dashboard
+
+The usage analytics dashboard provides a detailed overview of your Guru's usage with comprehensive metrics and visualizations. All sections are synchronized and respond to the filters and date range you select.
+
+### Date Range and Filters
+
+At the top of the dashboard, you can select a date range using predefined options (Today, Yesterday, 7D, 30D, 3M, 6M, 12M) or choose a custom date range.
+
+<Frame>
+  <img src="/images/guides/analytics/custom-date.png" alt="Custom Date Selection" />
+</Frame>
+
+The dashboard also includes page-wide filters that apply to all sections:
+
+<Frame>
+  <img src="/images/guides/analytics/filters.png" alt="Page-wide Filters" />
+</Frame>
+
+- **User**: Filter by specific users
+- **Intent**: Filter by user intent. The following intent types are available:
+  - **Short Answer**: User wants a brief, concise answer
+  - **Explanation**: User wants detailed explanation of a concept
+  - **How To**: User wants step-by-step instructions
+  - **Why**: User wants to understand reasons or causes
+  - **Comparison**: User wants to compare different options
+  - **Clarification**: User needs clarification on something unclear
+  - **Greeting**: User is greeting or starting conversation
+  - **Thanks**: User is expressing gratitude
+  - **Troubleshooting**: User is trying to solve a problem
+  - **Information Request**: User wants specific information
+  - **Other**: Any other intent not covered above
+- **Sentiment**: Filter by sentiment. The following sentiment types are available:
+  - **Positive**
+  - **Neutral**
+  - **Negative**
+- **Topics**: Filter by topic tags
+- **Vote**: Filter by vote status (Upvote, Downvote, No Vote)
+- **Edit Answer**: Filter by edited answers
+- **Source**: Filter by source type (Slack, Discord, GitHub, Widget, API, Gurubase UI, Zendesk, etc.)
+- **Country**: Filter by country
+
+All filters work together to provide a comprehensive view of your Guru's performance across different dimensions.
+
+### Key Metrics
+
+<Frame>
+  <img src="/images/guides/analytics/stat-cards.png" alt="Key Metrics Cards" />
+</Frame>
+
+The dashboard stat cards display six key metrics at a glance:
+- **Total Questions**: Total number of questions asked
+- **Out of Context Questions**: Questions that couldn't be answered
+- **Referenced Data Sources**: Number of unique data sources used
+- **Average Response Time**: Average time taken to generate answers
+- **Answer Ratio**: Percentage of questions that received answers
+- **Average Binge Length**: Average number of questions per user session
+
+Each metric shows percentage changes compared to the previous period, helping you track trends over time.
+
+## Dashboard Sections
+
+Below are the sections available in the usage analytics dashboard, organized in the order they appear:
+
+### 1. Questions Section
+
+<Frame>
+  <img src="/images/guides/analytics/questions-1.png" alt="Questions Section Overview" />
+</Frame>
+
+The questions section shows all questions that have been asked to your Guru over time. You can view detailed information including:
+- Question text with clickable links
+- Trust score (confidence level of the answer)
+- Vote status (upvote, downvote, or no vote)
+- User who asked the question
+- Response time
+- User intent classification
+- Sentiment analysis
+- Topics extracted from the question
+- Language and country information
+
+<Frame>
+  <img src="/images/guides/analytics/questions-2.png" alt="Questions Section Details" />
+</Frame>
+
+You can search questions by text, sort by various columns, and filter using the page-wide filters. The section also includes a bar chart showing question frequency over time.
+
+### 2. Unable to Answer Section
+
+<Frame>
+  <img src="/images/guides/analytics/unable-1.png" alt="Unable to Answer Section Overview" />
+</Frame>
+
+The unable to answer section shows questions that your Guru was unable to answer. Each entry includes:
+- The reason why the question couldn't be answered (e.g., "Not enough context", "Not related")
+- Source, user, intent, sentiment, topics, language, and country information
+
+<Frame>
+  <img src="/images/guides/analytics/unable-2.png" alt="Unable to Answer Section Details" />
+</Frame>
+
+This section includes a bar chart showing the frequency of unanswered questions over time and a language distribution chart. This provides valuable insight into whether your data sources are sufficient for your users. You can improve your data sources and reindex them to enable your Guru to answer more questions.
+
+### 3. Referenced Data Sources Section
+
+<Frame>
+  <img src="/images/guides/analytics/referenced-sources.png" alt="Referenced Data Sources Section" />
+</Frame>
+
+The referenced data sources section shows the data sources that your Guru has used to answer questions. The "Referenced" column shows the number of times each data source has been referenced to answer questions.
+
+Clicking on a data source opens a modal showing all questions that referenced that source, along with detailed information about each question.
+
+<Frame>
+  <img src="/images/guides/analytics/referenced-source-questions.png" alt="Referenced Questions Modal" />
+</Frame>
+
+### 4. User Distribution
+
+<Frame>
+  <img src="/images/guides/analytics/user-dist.png" alt="User Distribution" />
+</Frame>
+
+The user distribution section shows how questions are distributed among users. It displays two pie charts:
+- **Questions**: Distribution of all questions by user
+- **Unable to Answer**: Distribution of unanswered questions by user
+
+This helps you understand which users are most active and identify patterns in question distribution.
+
+### 5. Source Distribution
+
+<Frame>
+  <img src="/images/guides/analytics/sources-dist.png" alt="Source Distribution" />
+</Frame>
+
+The source distribution section shows where questions are coming from. It displays two pie charts:
+- **Questions**: Distribution of all questions by source (Slack, Discord, GitHub, Widget, API, Gurubase UI, Zendesk, etc.)
+- **Unable to Answer**: Distribution of unanswered questions by source
+
+This helps you understand which channels are most popular and where users are experiencing issues.
+
+### 6. Country Distribution
+
+<Frame>
+  <img src="/images/guides/analytics/country-dist.png" alt="Country Distribution" />
+</Frame>
+
+The country distribution section shows the geographic distribution of questions. It displays two horizontal bar charts:
+- **Questions**: Distribution of all questions by country
+- **Unable to Answer**: Distribution of unanswered questions by country
+
+This helps you understand your global user base and identify regional patterns.
+
+### 7. Topic Distribution
+
+<Frame>
+  <img src="/images/guides/analytics/topic-dist.png" alt="Topic Distribution" />
+</Frame>
+
+The topic distribution section shows the most common topics in questions. It displays two pie charts:
+- **Questions**: Distribution of all questions by topic
+- **Unable to Answer**: Distribution of unanswered questions by topic
+
+This helps you understand what users are most interested in and identify knowledge gaps in your data sources.
+
+### 8. Vote Statistics
+
+<Frame>
+  <img src="/images/guides/analytics/vote-stats.png" alt="Vote Statistics" />
+</Frame>
+
+The vote statistics section shows Guru-level satisfaction through voting data. It displays a pie chart showing:
+- **Upvotes**: Questions that received positive feedback
+- **Downvotes**: Questions that received negative feedback
+- **No Vote**: Questions without user feedback
+
+This provides insight into overall user satisfaction with your Guru's answers.
+
+### 9. Average Trust Score Over Time
+
+<Frame>
+  <img src="/images/guides/analytics/avg-trust-score-over-time.png" alt="Average Trust Score Over Time" />
+</Frame>
+
+The average trust score over time section shows a line graph tracking the average confidence level of answers over the selected time period. This helps you monitor the quality and reliability of your Guru's responses over time.
+
+### 10. Binge Length Statistics
+
+<Frame>
+  <img src="/images/guides/analytics/binge-len-stats.png" alt="Binge Length Statistics" />
+</Frame>
+
+The binge length statistics section shows user engagement patterns. It displays:
+- **Guru-Level Average**: Overall average number of questions per session
+- **Per-User Averages**: Individual user statistics showing how many binge sessions each user had and their average questions per session
+
+This helps you understand how engaged users are and how many questions they typically ask in a single session.
+
+### 11. User Intent Distribution
+
+<Frame>
+  <img src="/images/guides/analytics/intent-dist.png" alt="User Intent Distribution" />
+</Frame>
+
+The user intent distribution section shows the types of questions users are asking. It displays two pie charts:
+- **Questions**: Distribution of all questions by intent
+- **Unable to Answer**: Distribution of unanswered questions by intent
+
+The intent types include:
+- **Short Answer**: User wants a brief, concise answer
+- **Explanation**: User wants detailed explanation of a concept
+- **How To**: User wants step-by-step instructions
+- **Why**: User wants to understand reasons or causes
+- **Comparison**: User wants to compare different options
+- **Clarification**: User needs clarification on something unclear
+- **Greeting**: User is greeting or starting conversation
+- **Thanks**: User is expressing gratitude
+- **Troubleshooting**: User is trying to solve a problem
+- **Information Request**: User wants specific information
+- **Other**: Any other intent not covered above
+
+This helps you understand what users are trying to accomplish and identify areas where your Guru might need improvement.
+
+### 12. Sentiment Analysis
+
+<Frame>
+  <img src="/images/guides/analytics/sentiment-dist.png" alt="Sentiment Analysis" />
+</Frame>
+
+The sentiment analysis section shows the emotional tone of user questions. It displays two pie charts:
+- **Questions**: Distribution of all questions by sentiment
+- **Unable to Answer**: Distribution of unanswered questions by sentiment
+
+The sentiment types include:
+- **Positive**
+- **Neutral**
+- **Negative**
+
+This helps you understand user satisfaction and identify potential issues that might affect user experience.
+
+<CardGroup cols={2}>
+  <Card
+    title="Add Widget to Your Site"
+    icon="code"
+    href="/integrations/bots/website-widget"
+  >
+    Learn how to embed your Guru on your website
+  </Card>
+  <Card
+    title="Add GitHub Bot to Your Workspace"
+    icon="github"
+    href="/integrations/bots/github"
+  >
+    Learn how to add a GitHub bot to your repositories
+  </Card>
+  <Card
+    title="Add Discord Bot to Your Server"
+    icon="discord"
+    href="/integrations/bots/discord"
+  >
+    Learn how to add a Discord bot to your server
+  </Card>
+  <Card
+    title="API Integration"
+    icon="plug"
+    href="/api-reference/introduction"
+  >
+    Integrate Guru with your applications
+  </Card>
+</CardGroup>

guides/audit-logs.mdx

@@ -183,7 +183,7 @@ All maintainers have full access to audit logs, allowing them to:
   <Card
     title="Analytics Guide"
     icon="bar-chart"
-    href="/guides/analyze-usage"
+    href="/guides/analytics"
   >
     Learn how to analyze your Guru's usage patterns
   </Card>

guides/create-guru.mdx

@@ -151,7 +151,7 @@ Expand your Gurubase implementation with these advanced features and integration
   <Card
     title="Analyze Usage Patterns"
     icon="chart-simple"
-    href="/guides/analyze-usage"
+    href="/guides/analytics"
   >
     Monitor and analyze how users interact with your Guru
   </Card>

mint.json

@@ -53,7 +53,7 @@
       "group": "Guides",
       "pages": [
         "guides/create-guru",
-        "guides/analyze-usage",
+        "guides/analytics",
         "guides/prompting-your-guru",
         "guides/pii-masking",
         "guides/data-sources",