Skip to main content

What’s new in Liberator 2.2

Liberator 2.2 focuses on observability and operability. The release adds an in-product System Monitoring page for super-admins, a standardized way to plug external Grafana instances into the underlying metrics, scheduled cache creation so cold-start latency is gone for predictable access patterns, and the foundations of an ETL on-the-fly dataset mapping workflow. It also lands a reliability fix that prevents long-running query workers from getting stranded across platform restarts.

Highlights

In-product System Monitoring

A new admin-only page surfacing cluster health, queue depth, dataset access patterns, long-running queries, and license utilization.

Grafana integration

A Bearer-authenticated, read-only metrics endpoint at /metrics-api-bearer/, with token issuance and revocation built into the Liberator UI.

Scheduled cache creation

Pre-generate dataset caches on a schedule so users never hit a cold-cache penalty for predictable access patterns.

ETL mapping UI

Define cross-dataset value correspondences and enrich queries with translate=true.

Reliable query workers

Query workers no longer get stranded on stale connections when the platform restarts behind them.

UI polish

System Monitoring’s Usage tab uses its own license-appropriate time window, and tab state is preserved as users navigate.

System monitoring

A new super-admin-only System Monitoring page consolidates the operational signals previously scattered across logs and ad-hoc queries. Five tabs:
TabTime-range selectorWhat it answers
Cluster6h / 24hIs the cluster behaving normally right now?
Queue6h / 24hIs anyone being blocked, and by whom?
Datasets6h / 24hWhat are users actually querying?
Long Queries6h / 24hWhich individual queries are slow enough to warrant attention?
Usage1d / 1w / 1m / 1yHow close are we to our license caps?
See the System Monitoring overview for a walkthrough.

Grafana integration

CloudQuant Data Liberator now exposes a standardized, Bearer-authenticated metrics endpoint at https://<your-liberator-host>/metrics-api-bearer/. The endpoint speaks the full standard Prometheus HTTP API surface (/api/v1/query, /api/v1/query_range, /api/v1/series, /api/v1/labels, /api/v1/label/<name>/values, /api/v1/status/buildinfo, /federate), so any off-the-shelf Prometheus client — Grafana, Mimir, federated Prometheus, custom scripts — can consume it without modification. Token lifecycle is fully self-service from the Liberator UI:
  1. Issue — a super-admin clicks Generate token in the Grafana Integration dialog. The full token value is shown exactly once.
  2. Use — point Grafana at /metrics-api-bearer with Authorization: Bearer cqm_<token> as a custom HTTP header.
  3. Rotate — issue a new token, switch Grafana to it, verify, then revoke the old one (zero-downtime).
  4. Revoke — same dialog, list view.
See the full walkthrough at Grafana integration.

Scheduled cache creation

For datasets with predictable access patterns (daily morning reports, weekly market-open snapshots), Liberator now supports scheduled cache creation. Super-admins set a cron-style schedule per dataset directly in the Liberator UI’s caching settings; the platform pre-generates the cache slice before users query it, so the first read of the day hits a warm cache rather than triggering a generation. See the cache pre-generation guide for the full Super Admin workflow.

ETL mapping UI

Liberator 2.2 lays the foundation for the ETL on-the-fly workflow, letting analysts define cross-dataset value correspondences (e.g. “the ticker column in Dataset A maps to the symbol column in Dataset B, with these reconciliations”) and have Liberator surface a virtual unified column across both datasets at query time, without a heavyweight pre-materialization step. What lands in 2.2:
  • ETL mapping UI design — UX research and component specs.
  • Data Translation Mapping — the underlying admin-API surface for storing and retrieving mapping definitions.
  • Dataset Field Mapping UI — the in-Liberator-UI workflow for defining correspondences and previewing the virtual unified column. See Dataset field mapping.
Full GA of the mapping workflow is targeted for the 2.3 release.

Reliability improvements

A user-facing reliability bug is fixed in 2.2: previously, after a behind-the-scenes platform restart, a small number of long-running queries could hang indefinitely rather than reconnecting. In 2.2 those workers detect the broken connection within a short keepalive window and reconnect automatically, so long-running queries continue cleanly across platform restarts instead of stalling.

UI changes

  • Usage tab time-range selector. The global 6h / 24h selector is now hidden when the Usage tab is active. Usage has its own 1d / 1w / 1m / 1y window because license utilization is measured against per-contract caps that don’t make sense on a 6-hour window.
  • Controlled Tabs. The System Monitoring page’s tab component is now fully controlled, so per-tab state survives switches without remounting, and the token-rotation flow triggers a clean cache reset across all tabs.

Also in 2.2

Smaller items in the same release:
  • OneDrive URL share-link paste — paste a full OneDrive or SharePoint share URL into a connection form; see SharePoint and OneDrive.
  • Email verification — new accounts receive an email verification message when provisioned.
  • Connection-form example text — UX hints in connection-source forms so users know what shape of input each field expects (host, bucket name, region, etc.) before they make a mistake.

Compatibility

There are no breaking changes to the client libraries (Python, REST, JavaScript, Excel, etc.) or to the dataset query surface, so existing code and queries continue to work unchanged. The new features in 2.2 are surfaced through the Liberator UI and the Bearer-token metrics endpoint. To start using the Grafana integration, a super-admin generates a Bearer token from the Grafana Integration tab in the Liberator UI. See the Grafana integration guide for the full walkthrough.