docs: add analytics changelog and KB pages - #2780
Merged
Merged
Conversation
Document the org analytics, per-API-key statistics, and Enterprise member analytics shipped in #2769. - New changelog entry (2026-06-21-org-analytics) for the public changelog. - New knowledge-base pages: Analytics (project cost-by-model) and Member Analytics (Enterprise per-member breakdowns). - Per-key statistics section added to the API Keys KB page. - Eight dashboard screenshots (light + dark) captured from a seeded enterprise org for the new pages. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Contributor
|
Important Review skippedReview was skipped due to path filters ⛔ Files ignored due to path filters (1)
CodeRabbit blocks several paths by default. You can override this behavior by explicitly including those paths in the path filters. For example, including ⚙️ Run configurationConfiguration used: Repository UI Review profile: CHILL Plan: Pro Run ID: You can disable this status message by setting the Use the checkbox below for a quick retry:
WalkthroughThree new documentation pages are added: ChangesUsage Analytics Documentation
Estimated code review effort🎯 1 (Trivial) | ⏱️ ~5 minutes 🚥 Pre-merge checks | ✅ 5✅ Passed checks (5 passed)
✏️ Tip: You can configure your own custom pre-merge checks in the settings. ✨ Finishing Touches🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
Member
|
Images automagically compressed by Calibre's image-actions ✨ Compression reduced images by 68.2%, saving 815.1 KB.
|
Member
|
Images automagically compressed by Calibre's image-actions ✨ Compression reduced images by 7.9%, saving 19.4 KB.
3 images did not require optimisation. |
Member
|
Images automagically compressed by Calibre's image-actions ✨ Compression reduced images by 5.7%, saving 4.5 KB.
6 images did not require optimisation. |
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
Contributor
There was a problem hiding this comment.
Actionable comments posted: 1
🧹 Nitpick comments (1)
apps/ui/src/content/changelog/2026-06-21-org-analytics.md (1)
14-14: 🧹 Nitpick | 🔵 Trivial | 💤 Low valueSimplify the opening sentence to avoid repetition.
Three consecutive sentences begin with "Which", creating a repetitive rhythm. Consider rewording the second or third sentence to improve readability.
Example revision:
-The dashboard could already tell you how much you spent and how many requests you sent — but not where it actually went. Which model is eating the budget? Which API key drives the traffic? Which person on the team? **Analytics** answers all three, with cost, request, and token breakdowns by model, by key, and by member. +The dashboard could already tell you how much you spent and how many requests you sent — but not where it actually went. Which model is eating the budget? Which API key drives the traffic? Who is the biggest spender on the team? **Analytics** answers all three, with cost, request, and token breakdowns by model, by key, and by member.🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the rest with a brief reason, keep changes minimal, and validate. In `@apps/ui/src/content/changelog/2026-06-21-org-analytics.md` at line 14, The opening paragraph of the analytics feature description contains three consecutive sentences that begin with "Which", creating repetitive rhythm that affects readability. Restructure at least one of these questions (about model, API key, or team member) to use different phrasing or sentence structure while maintaining the same meaning and emphasis. For example, rephrase one question as a statement or combine related questions to create better flow and variety in the prose.Source: Linters/SAST tools
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@apps/ui/src/content/changelog/2026-06-21-org-analytics.md`:
- Around line 7-11: The image reference in the frontmatter of the changelog file
points to a missing asset `/changelog/org-analytics.png` that does not exist in
`apps/ui/public/changelog/`. To fix this, either locate the analytics image
asset from `apps/docs/public/learn/` (such as `api-key-statistics-dark.png` or
`member-analytics-light.png`) and copy it to the `apps/ui/public/changelog/`
directory renaming it to `org-analytics.png`, or update the src path in the
image frontmatter to reference one of the existing analytics images from the
docs directory. Ensure the image dimensions (width: 1536, height: 1024) and alt
text remain appropriate for the referenced asset.
---
Nitpick comments:
In `@apps/ui/src/content/changelog/2026-06-21-org-analytics.md`:
- Line 14: The opening paragraph of the analytics feature description contains
three consecutive sentences that begin with "Which", creating repetitive rhythm
that affects readability. Restructure at least one of these questions (about
model, API key, or team member) to use different phrasing or sentence structure
while maintaining the same meaning and emphasis. For example, rephrase one
question as a statement or combine related questions to create better flow and
variety in the prose.
🪄 Autofix (Beta)
Fix all unresolved CodeRabbit comments on this PR:
- Push a commit to this branch (recommended)
- Create a new PR with the fixes
ℹ️ Review info
⚙️ Run configuration
Configuration used: Repository UI
Review profile: CHILL
Plan: Pro
Run ID: fee3a87e-6b7b-42e9-bf5e-8a7ba816e5c1
⛔ Files ignored due to path filters (8)
apps/docs/public/learn/analytics-dark.pngis excluded by!**/*.pngapps/docs/public/learn/analytics-light.pngis excluded by!**/*.pngapps/docs/public/learn/api-key-statistics-dark.pngis excluded by!**/*.pngapps/docs/public/learn/api-key-statistics-light.pngis excluded by!**/*.pngapps/docs/public/learn/member-analytics-dark.pngis excluded by!**/*.pngapps/docs/public/learn/member-analytics-detail-dark.pngis excluded by!**/*.pngapps/docs/public/learn/member-analytics-detail-light.pngis excluded by!**/*.pngapps/docs/public/learn/member-analytics-light.pngis excluded by!**/*.png
📒 Files selected for processing (6)
apps/docs/content/learn/analytics.mdxapps/docs/content/learn/api-keys.mdxapps/docs/content/learn/index.mdxapps/docs/content/learn/member-analytics.mdxapps/docs/content/learn/meta.jsonapps/ui/src/content/changelog/2026-06-21-org-analytics.md
Generated with gpt-image-2 via LLM Gateway (1536x1024). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
smakosh
added this pull request to the merge queue
Jun 21, 2026
github-merge-queue
Bot
removed this pull request from the merge queue due to invalid changes in the merge commit
Jun 21, 2026
smakosh
enabled auto-merge
June 21, 2026 21:57
Member
|
Images automagically compressed by Calibre's image-actions ✨ Compression reduced images by 77.9%, saving 1.3 MB.
8 images did not require optimisation. |
Member
|
Images automagically compressed by Calibre's image-actions ✨ Compression reduced images by 7.9%, saving 29.7 KB.
8 images did not require optimisation. |
Member
|
Images automagically compressed by Calibre's image-actions ✨ Compression reduced images by 9.8%, saving 34.1 KB.
8 images did not require optimisation. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Documents the org analytics, per-API-key statistics, and Enterprise member analytics shipped in #2769 — across the public changelog and the docs knowledge base.
Changelog
2026-06-21-org-analytics("Usage Analytics by Model, Key and Member") for the public changelog, covering the project Analytics page, per-key statistics, and member analytics with plan gating.Knowledge base (
apps/docs)learn/analytics): project Cost by Model and Cost by Model Over Time charts, the Mappings / Canonical toggle, and how the data is computed.learn/member-analytics): the Enterprise per-member usage table and member detail view (summary cards, most-used model/provider, cost by model, top providers), with Enterprise + owner/admin gating.learn/meta.jsonand the knowledge-base index.Screenshots
Eight dashboard screenshots (light + dark) captured from a locally seeded DataFlow AI enterprise org via Playwright, dropped under
apps/docs/public/learn/and referenced withThemedImage:analytics-{light,dark}api-key-statistics-{light,dark}member-analytics-{light,dark}member-analytics-detail-{light,dark}Testing
pnpm formatcleanturbo run build --filter=docs --filter=uipasses (validates changelog frontmatter + MDX)🤖 Generated with Claude Code
Summary by CodeRabbit
New Features
Documentation