analytics dashboard

Author: msukkari

docs/docs.json

@@ -36,6 +36,7 @@
                                 ]
                             },
                             "docs/features/code-navigation",
+                            "docs/features/analytics",
                             "docs/features/mcp-server",
                             {
                                 "group": "Agents",

docs/docs/configuration/audit-logs.mdx

@@ -40,7 +40,7 @@ curl --request GET '$SOURCEBOT_URL/api/ee/audit' \
   {
     "id": "cmc146c8r0001xgo2xyu0p463",
     "timestamp": "2025-06-17T22:47:58.587Z",
-    "action": "query.code_search",
+    "action": "user.performed_code_search",
     "actorId": "cmc12tnje0000xgn58jj8655h",
     "actorType": "user",
     "targetId": "1",
@@ -54,7 +54,7 @@ curl --request GET '$SOURCEBOT_URL/api/ee/audit' \
   {
     "id": "cmc12vqgb0008xgn5nv5hl9y5",
     "timestamp": "2025-06-17T22:11:44.171Z",
-    "action": "query.code_search",
+    "action": "user.performed_code_search",
     "actorId": "cmc12tnje0000xgn58jj8655h",
     "actorType": "user",
     "targetId": "1",
@@ -68,7 +68,7 @@ curl --request GET '$SOURCEBOT_URL/api/ee/audit' \
   {
     "id": "cmc12txwn0006xgn51ow1odid",
     "timestamp": "2025-06-17T22:10:20.519Z",
-    "action": "query.code_search",
+    "action": "user.performed_code_search",
     "actorId": "cmc12tnje0000xgn58jj8655h",
     "actorType": "user",
     "targetId": "1",
@@ -117,8 +117,8 @@ curl --request GET '$SOURCEBOT_URL/api/ee/audit' \
 | `user.creation_failed`                | `user` | `user` |
 | `user.owner_created`                  | `user` | `org` |
 | `user.performed_code_search`              | `user` | `org` |
-| `user.performed_code_nav_find_references` | `user` | `org` |
-| `user.performed_code_nav_goto_definition` | `user` | `org` |
+| `user.performed_find_references` | `user` | `org` |
+| `user.performed_goto_definition` | `user` | `org` |
 | `user.jit_provisioning_failed`        | `user` | `org` |
 | `user.jit_provisioned`                | `user` | `org` |
 | `user.join_request_creation_failed`   | `user` | `org` |
@@ -134,9 +134,6 @@ curl --request GET '$SOURCEBOT_URL/api/ee/audit' \
 | `user.signed_out`                     | `user` | `user` |
 | `org.ownership_transfer_failed`       | `user` | `org` |
 | `org.ownership_transferred`           | `user` | `org` |
-| `query.file_source`                   | `user \| api_key` | `file` |
-| `query.code_search`                   | `user \| api_key` | `org` |
-| `query.list_repositories`             | `user \| api_key` | `org` |
 
 
 ## Response schema

docs/docs/configuration/environment-variables.mdx

@@ -39,7 +39,7 @@ The following environment variables allow you to configure your Sourcebot deploy
 ### Enterprise Environment Variables
 | Variable | Default | Description |
 | :------- | :------ | :---------- |
-| `SOURCEBOT_EE_AUDIT_LOGGING_ENABLED` | `false` | <p>Enables/disables audit logging</p> |
+| `SOURCEBOT_EE_AUDIT_LOGGING_ENABLED` | `true` | <p>Enables/disables audit logging</p> |
 | `AUTH_EE_ENABLE_JIT_PROVISIONING` | `false` | <p>Enables/disables just-in-time user provisioning for SSO providers.</p> |
 | `AUTH_EE_GITHUB_BASE_URL` | `https://github.com` | <p>The base URL for GitHub Enterprise SSO authentication.</p> |
 | `AUTH_EE_GITHUB_CLIENT_ID` | `-` | <p>The client ID for GitHub Enterprise SSO authentication.</p> |

docs/docs/features/analytics.mdx

@@ -0,0 +1,52 @@
+---
+title: Analytics
+sidebarTitle: Analytics
+---
+
+import LicenseKeyRequired from '/snippets/license-key-required.mdx'
+import { Callout } from 'nextra/components'
+
+<LicenseKeyRequired />
+
+
+## Overview
+
+Analytics provides comprehensive insights into your organization's usage of Sourcebot, helping you understand adoption patterns and
+quantify the value of time saved.
+
+This dashboard is backed by [audit log](/docs/configuration/audit-logs) events. Please ensure you have audit logging enabled in order to see these insights.
+
+<video
+  autoPlay
+  muted
+  loop
+  playsInline
+  className="w-full aspect-video"
+  src="/images/analytics_demo.mp4"
+></video>
+
+## Data Metrics
+
+### Active Users
+Tracks the number of unique users who performed any Sourcebot operation within each time period. This metric helps you understand team adoption
+and engagement with Sourcebot.
+
+![DAU Chart](/images/dau_chart.png)
+
+### Code Searches
+Counts the number of code search operations performed by your team. Code searches include all semantic and syntax-based queries
+performed through the search interface.
+
+![Code Search Chart](/images/code_search_chart.png)
+
+### Code Navigation
+Tracks "Go to Definition" and "Find All References" navigation actions. Navigation actions help developers quickly move
+between code locations and understand code relationships.
+
+![Code Nav Chart](/images/code_nav_chart.png)
+
+## Cost Savings Calculator
+
+The analytics dashboard includes a built-in cost savings calculator that helps you quantify the ROI of using Sourcebot.
+
+![Cost Savings Chart](/images/cost_savings_chart.png)

docs/images/analytics_demo.mp4

@@ -0,0 +1,5 @@
+-- CreateIndex
+CREATE INDEX "idx_audit_core_actions_full" ON "Audit"("orgId", "timestamp", "action", "actorId");
+
+-- CreateIndex
+CREATE INDEX "idx_audit_actor_time_full" ON "Audit"("actorId", "timestamp");