Rewrite clickhouse operational queries documentation for clarity and improved structure#122
Rewrite clickhouse operational queries documentation for clarity and improved structure#122pavlochaikivskyi wants to merge 22 commits intomainfrom
Conversation
…clickhouse tables
…vels and size metrics
…es with ttl configuration
PR Preview Ready!Your preview documentation is ready! Visit it here: Preview URL: http://codemie-docs-pr-previews.s3-website.eu-central-1.amazonaws.com/pr-122/ This preview will be automatically updated when you push new commits to this PR. |
| :::info Database Types | ||
| ClickHouse contains two types of databases: | ||
|
|
||
| - **`default`** - Langfuse application database containing business data (Langfuse uses `default` as the [database name by default](https://langfuse.com/self-hosting/configuration#:~:text=CLICKHOUSE_DB,Name%20of%20the%20ClickHouse%20database%20to%20use.)): |
There was a problem hiding this comment.
Woud it be better to use tabs to reduce overall page lenght?
| @@ -0,0 +1,792 @@ | |||
| --- | |||
| id: storage-management | |||
| title: Storage Management | |||
There was a problem hiding this comment.
Please rename this page accordingly. Not sure that this is a Storage Management. I would use something like "Data Volume Retention" or "Data Volume Maintenance"
There was a problem hiding this comment.
Also please add this "magic" emoji to indicate this is an non-oss feature (like in deployment extension section)
| - `scores` | ||
| - Other Langfuse tables and views | ||
|
|
||
| - **`system`** - ClickHouse internal database containing metadata ([Located in the `system` database](https://clickhouse.com/docs/operations/system-tables/overview)): |
There was a problem hiding this comment.
Please use – (en dash) in this cases instead of - (dash)
docs/admin/deployment/extensions/02-assistants-evaluation/03-deployment-prerequisites.md
Outdated
Show resolved
Hide resolved
docs/admin/configuration/extensions/assistants-evaluation/storage-management.md
Outdated
Show resolved
Hide resolved
| - `asynchronous_metric_log`, `text_log`, `part_log` | ||
| - `processors_profile_log`, `latency_log`, `session_log` | ||
| - `asynchronous_insert_log`, `error_log` | ||
| ::: |
There was a problem hiding this comment.
I don't understand this note :)
There was a problem hiding this comment.
Maybe we should put this in a separate section and make it a link?
we have 5 the same notes
docs/admin/configuration/extensions/assistants-evaluation/storage-management.md
Outdated
Show resolved
Hide resolved
docs/admin/configuration/extensions/assistants-evaluation/storage-management.md
Outdated
Show resolved
Hide resolved
docs/admin/configuration/extensions/assistants-evaluation/storage-management.md
Outdated
Show resolved
Hide resolved
| sum(rows) AS rows, | ||
| formatReadableSize(sum(bytes_on_disk)) AS compressed_size | ||
| FROM system.parts | ||
| WHERE database = 'system' AND table = 'query_log' AND active |
There was a problem hiding this comment.
could we modify the query and use highlight feature?
I'm just suggesting :)
Summary
Rewrote Langfuse ClickHouse operational queries documentation with improved structure, comprehensive tabbed SQL examples, and clearer organization. The new storage management guide provides better guidance for disk usage analysis, data cleanup, and retention policy monitoring.
Changes
Testing
npm startQuality Checks
npm run checkpasses (typecheck + lint + commitlint)<text>must be`<text>`)static/img/)Additional Notes