docs: add ClickHouse analytics blog post#686
Open
berry-13 wants to merge 2 commits into
Open
Conversation
A first-person post on how librechat.ai's analytics run on Plausible backed by ClickHouse, including the recent cloud-to-cloud cluster move. Adds two reusable blog components: AnalyticsArchitecture, a theme-aware data-flow diagram, and SiteStats, a server component that reads live numbers from the Plausible Stats API when PLAUSIBLE_STATS_API_KEY is set and falls back to a static snapshot otherwise. Includes the cover image and registers both components in mdx-components.
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 826f8383d1
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
Contributor
📦 Next.js Bundle Analysis for librechat.aiThis analysis was generated by the Next.js Bundle Analysis action. 🤖 This PR introduced no changes to the JavaScript bundle! 🙌 |
…ents Replace the cluster-migration walkthrough with the part readers actually care about: pointing a LibreChat agent at the ClickHouse data and asking it questions in plain English, the privacy stance behind it, and the ClickHouse partnership tie-in. The migration drops to a single line. Adds a prompts appendix and bumps Plausible to v3.2.1.
Contributor
📦 Next.js Bundle Analysis for librechat.aiThis analysis was generated by the Next.js Bundle Analysis action. 🤖 This PR introduced no changes to the JavaScript bundle! 🙌 |
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
1 participant
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.
What
Adds a blog post on how the LibreChat website's analytics are built: Plausible for the privacy-friendly front end, ClickHouse as the storage engine underneath, and a walkthrough of the recent move between ClickHouse Cloud clusters.
The post lives at
/blog/2026-06-25_clickhouse-analyticsand is written first-person to match the existing ZimaCube post.New components
AnalyticsArchitecture— a theme-aware, accessible data-flow diagram (browser → Plausible CE → ClickHouse Cloud, with Postgres and the Core Web Vitals store as satellites). Pure layout, no image asset.SiteStats— an async server component. WhenPLAUSIBLE_STATS_API_KEYis set it queries the Plausible Stats API v2 at request time (cached one hour) and shows real visitor/pageview/visit numbers. Without the key it renders a dated static snapshot, so local dev, previews, and forks always build. The key stays server-side and never reaches the client.Both are registered in
lib/mdx-components.tsx. A 1200×630 cover image is included.Enabling live stats (optional)
PLAUSIBLE_STATS_API_KEYPLAUSIBLE_SITE_IDlibrechat.aiPLAUSIBLE_BASE_URLhttps://plausible.librechat.aiTesting
pnpm typecheckandpnpm lintpass.Note
No connection strings, hostnames, IPs, or credentials from the actual migration appear in the post or anywhere in this change.