docs(demo): system explorer library + manual (github.demo)#159
Merged
Conversation
A ready-made saved-queries Library that introspects ClickHouse's own
`system` database — running queries, merges/mutations/replication
health, storage, and historical query/part/error activity — adapted
from Mikhail Filimonov's ClickHouse ops Grafana dashboard gist
(not ported 1:1: no template macros, no per-pool time-series).
- examples/system-explorer-charts.json — 14 queries: 5 live snapshots
(processes/merges/mutations/replicas/replication_queue), 3 storage/
error bar charts, and 6 historical time-series sharing one pair of
native query parameters, {from:String}/{to:String} (parsed via
parseDateTimeBestEffort), so the Dashboard's global filter bar
(#149 D3) drives all six time-ranged tiles from a single field pair.
- examples/build-system-explorer-charts.mjs — regenerates the JSON;
derives each chartable entry's schema key live via FORMAT JSON
(DESCRIBE's TSV output escapes an Enum8(...) type string differently
from the HTTP+JSON interface the app actually uses).
- docs/SYSTEM-EXPLORER-DEMO.md — load steps, a query/view/feature
table, and per-query deep links to https://github.demo.altinity.cloud/sql.
- README + docs/local-app.html: link the new demo alongside the
existing ontime chart demo.
Verified live on github.demo as an account with full system-table
grants: imported cleanly (Added 14 · updated 0 · skipped 0), opened as
Dashboard — 3 tiles populated immediately, 5 showed the shared "enter
a value" placeholder, and typing one From/To range populated all 5
together.
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.
Summary
systemdatabase (running queries, merges/mutations/replication health, storage, historical query/part/error activity), adapted from Mikhail Filimonov's ClickHouse ops Grafana dashboard gist — not ported 1:1.{from:String}/{to:String}(viaparseDateTimeBestEffort), so the Dashboard's global filter bar (Feature: open favorited Library queries as an interactive Dashboard #149 D3) drives all six time-ranged tiles from a single From/To field pair.examples/build-system-explorer-charts.mjsregenerates the JSON, deriving each chart's schema key live viaFORMAT JSON(matches the existingbuild-ontime-charts.mjspattern).docs/SYSTEM-EXPLORER-DEMO.md+ README/docs/local-app.htmllinks, alongside the existing ontime chart demo.Test plan
npm testgreen (nosrc/changes; docs/examples only)systemgrants): imported via File ▾ → Append (Added 14 · updated 0 · skipped 0), opened as Dashboard — 3 tiles populated immediately, 5 time-ranged tiles showed the shared "enter a value for: from, to" placeholder, and typing one From/To range populated all 5 together (5.5K/15/147/370/2.2K rows)🤖 Generated with Claude Code
https://claude.ai/code/session_011QWzDSvS1PgxaDFbAjsjjq