feat(view)!: charts with ECharts: pie, rings, treemap, tree, groups, bars; bi_pie is now bi_charts #4

Merged
dawid merged 3 commits from bi-charts into main 2026-11-19 13:22:14 +00:00
Owner

Rename: bi_pie → bi_charts everywhere: the MKP, the page at local/bi_charts/index.html, the dashboard, and the environment variables (BI_CHARTS_*). No release had the old name. The repository is already renamed.

ECharts: the page now draws with Apache ECharts 6.1.0.

  • ECharts is pinned in package-lock.json, so Renovate updates it.
  • build.py copies it into the MKP with its LICENSE and NOTICE, plus zrender's license.
  • The package is relicensed to GPL-2.0-or-later, because the Apache License 2.0 is compatible only with GPLv3.

Views:

view= Shows
pie (default) One slice per state, the total in the middle
rings The BI trees as rings, with names where they fit, and hosts and services as pills in an outer band (inspired by BVQ's System Health)
treemap Nested rectangles sized by hosts and services; a click zooms in
tree A tree of nodes, folded below depth; a click opens or folds a node
groups One donut per group, with its OK share
bars One stacked bar per group

Options:

  • by=group|pack
  • colors=ok:2e7d32,...
  • muted=0, labels=0, legend=0, animation=0
  • the existing parameters stay

Breaking change: view=tree is now the tree of nodes; the rings are view=rings.

Tests:

  • The tests read the chart through the page's hook, biCharts.items(), which gives each item's path, kind, state and color.
  • Locally: 57 unit tests pass, and 13 of the 14 browser integration tests passed on 2.4.0p41 and 2.5.0p20. The 14th failed while its site was still starting up: the login page took longer than 5 seconds to answer. This PR fixes that wait, which also caused the earlier one-off failure; the tests haven't been run again since the fix.

Fixed along the way: hovering a legend row rebuilt the row under the pointer, so it re-rendered in a loop.

Screenshots: all of them are rendered by tools/screenshots.py from sample data.

**Rename:** `bi_pie` → `bi_charts` everywhere: the MKP, the page at `local/bi_charts/index.html`, the dashboard, and the environment variables (`BI_CHARTS_*`). No release had the old name. The repository is already renamed. **ECharts:** the page now draws with Apache ECharts 6.1.0. - ECharts is pinned in `package-lock.json`, so Renovate updates it. - `build.py` copies it into the MKP with its LICENSE and NOTICE, plus zrender's license. - The package is relicensed to **GPL-2.0-or-later**, because the Apache License 2.0 is compatible only with GPLv3. **Views:** | `view=` | Shows | |---------|-------| | `pie` (default) | One slice per state, the total in the middle | | `rings` | The BI trees as rings, with names where they fit, and hosts and services as pills in an outer band (inspired by BVQ's System Health) | | `treemap` | Nested rectangles sized by hosts and services; a click zooms in | | `tree` | A tree of nodes, folded below `depth`; a click opens or folds a node | | `groups` | One donut per group, with its OK share | | `bars` | One stacked bar per group | **Options:** - `by=group|pack` - `colors=ok:2e7d32,...` - `muted=0`, `labels=0`, `legend=0`, `animation=0` - the existing parameters stay **Breaking change:** `view=tree` is now the tree of nodes; the rings are `view=rings`. **Tests:** - The tests read the chart through the page's hook, `biCharts.items()`, which gives each item's path, kind, state and color. - Locally: 57 unit tests pass, and 13 of the 14 browser integration tests passed on 2.4.0p41 and 2.5.0p20. The 14th failed while its site was still starting up: the login page took longer than 5 seconds to answer. This PR fixes that wait, which also caused the earlier one-off failure; the tests haven't been run again since the fix. **Fixed along the way:** hovering a legend row rebuilt the row under the pointer, so it re-rendered in a loop. **Screenshots:** all of them are rendered by `tools/screenshots.py` from sample data.
One integration job per Checkmk version and one for the update from 2.4 to
2.5; each builds an image with only its versions (BI_PIE_VERSIONS). A tag runs
the same pipeline, and its release job publishes the MKP only once every job
passed; release.yml is gone. The README links Checkmk's documentation of the
custom URL element (2.4) and the Embed URL widget (2.5).
ci: fail when Checkmk maintains a version the package is not tested with
All checks were successful
CI / unit (pull_request) Successful in 4m12s
CI / integration (Checkmk 2.4) (pull_request) Successful in 5m4s
CI / integration (Checkmk 2.5) (pull_request) Successful in 5m7s
CI / integration (update 2.4 to 2.5) (pull_request) Successful in 7m47s
CI / release (pull_request) Has been skipped
7eb556cec7
The unit job compares Checkmk's current versions (stable_downloads.json) with
the integration matrix and the manifest's version range; the weekly run then
fails when a new version comes out. Today that is 2.4 and 2.5, as Checkmk's
lifecycle table says (2.3 left maintenance on 2026-10-29).
The package, its page (local/bi_charts/index.html), its dashboard and the
repository (dawid/checkmk-bi-charts) take the new name, as the page grows more
kinds of chart than the pie. No release had the old name.
feat(view)!: charts drawn with ECharts, five views besides the pie
All checks were successful
CI / unit (pull_request) Successful in 1m27s
CI / integration (Checkmk 2.4) (pull_request) Successful in 5m5s
CI / integration (Checkmk 2.5) (pull_request) Successful in 5m37s
CI / integration (update 2.4 to 2.5) (pull_request) Successful in 7m46s
CI / release (pull_request) Has been skipped
49ff772209
The page draws with Apache ECharts (npm, pinned in package-lock.json; build.py
ships it with its licenses in the MKP) and offers view=pie, rings, treemap,
tree, groups and bars, with the options colors=, muted=0, legend=0, labels=0,
animation=0 and by=group|pack. The rings keep the hosts and services as pills
in an outer band and name the segments that have room. The tests read the
chart through the page's hook biCharts.items().

The package is now GPL-2.0-or-later: the Apache License 2.0 is compatible with
the GPL's version 3, not with version 2 alone.

BREAKING CHANGE: view=tree is now the tree of nodes; the rings are view=rings.

Tests of CI / unit: passed

57 passed, 0 failed, 0 skipped (57 tests, 32.4 s)

Of ccde37e3cb, the run, updated by every run.

<!-- ci-report tests: CI-unit --> ### Tests of CI / unit: passed **57 passed, 0 failed, 0 skipped** (57 tests, 32.4 s) <sub>Of ccde37e3cb, [the run](https://git.ciepiela.org/dawid/checkmk-bi-charts/actions/runs/8), updated by every run.</sub>

Tests of CI / integration (Checkmk 2.4): passed

15 passed, 0 failed, 0 skipped (15 tests, 248.3 s)

Of ccde37e3cb, the run, updated by every run.

<!-- ci-report tests: CI-integration-Checkmk-2.4- --> ### Tests of CI / integration (Checkmk 2.4): passed **15 passed, 0 failed, 0 skipped** (15 tests, 248.3 s) <sub>Of ccde37e3cb, [the run](https://git.ciepiela.org/dawid/checkmk-bi-charts/actions/runs/8), updated by every run.</sub>

Tests of CI / integration (Checkmk 2.5): passed

15 passed, 0 failed, 0 skipped (15 tests, 253.5 s)

Of ccde37e3cb, the run, updated by every run.

<!-- ci-report tests: CI-integration-Checkmk-2.5- --> ### Tests of CI / integration (Checkmk 2.5): passed **15 passed, 0 failed, 0 skipped** (15 tests, 253.5 s) <sub>Of ccde37e3cb, [the run](https://git.ciepiela.org/dawid/checkmk-bi-charts/actions/runs/8), updated by every run.</sub>

Tests of CI / integration (update 2.4 to 2.5): passed

6 passed, 0 failed, 0 skipped (6 tests, 406.5 s)

Of ccde37e3cb, the run, updated by every run.

<!-- ci-report tests: CI-integration-update-2.4-to-2.5- --> ### Tests of CI / integration (update 2.4 to 2.5): passed **6 passed, 0 failed, 0 skipped** (6 tests, 406.5 s) <sub>Of ccde37e3cb, [the run](https://git.ciepiela.org/dawid/checkmk-bi-charts/actions/runs/8), updated by every run.</sub>
dawid force-pushed bi-charts from 49ff772209
All checks were successful
CI / unit (pull_request) Successful in 1m27s
CI / integration (Checkmk 2.4) (pull_request) Successful in 5m5s
CI / integration (Checkmk 2.5) (pull_request) Successful in 5m37s
CI / integration (update 2.4 to 2.5) (pull_request) Successful in 7m46s
CI / release (pull_request) Has been skipped
to ccde37e3cb
All checks were successful
CI / unit (pull_request) Successful in 1m25s
CI / integration (Checkmk 2.4) (pull_request) Successful in 5m2s
CI / integration (Checkmk 2.5) (pull_request) Successful in 5m8s
CI / integration (update 2.4 to 2.5) (pull_request) Successful in 7m41s
CI / release (pull_request) Has been skipped
2026-11-19 13:21:06 +00:00
Compare
dawid merged commit 5fb2548358 into main 2026-11-19 13:22:14 +00:00
dawid deleted branch bi-charts 2026-11-19 13:22:15 +00:00
Sign in to join this conversation.
No description provided.