Skip to content

Upgrading to 2.0.0

This page covers what you need to know when upgrading to Quine 2.0.0.

What's New

  • Redesigned Exploration UI — modernized layout with sidebar navigation, a new Dashboard landing page, a Streams management page, JSON-LD graph export, and updated node interaction behavior. See Exploration UI Changes for details.
  • API v2 is now the default — API v1 endpoints remain available but are planned for removal
  • Recipe schema v2 with API v2 entities
  • Docker base image updated to eclipse-temurin:21.0.10_7-jre-noble (Ubuntu 24.04 LTS)
  • All-node scan queries now filter server-side for better performance
  • Content Security Policy headers added by default
  • Credential redaction in API responses

Breaking Changes

Metrics Prefix Changes

All graph-scoped metrics (shard, node, standing query, and ingest) are now prefixed with quine.. For example, node.property-counts becomes quine.node.property-counts and ingest.my-stream.count becomes quine.ingest.my-stream.count.

Update your monitoring infrastructure (Grafana dashboards, InfluxDB queries, alerting rules) to include the quine. prefix for all graph-scoped metrics. Global metrics (persistor, shared valve) remain unchanged.

Updating Grafana Queries

The exact syntax depends on your metrics reporter.

InfluxDB example:

-- Previous query
SELECT mean("value") FROM "node_property_counts" WHERE $timeFilter

-- 2.0.0+ query
SELECT mean("value") FROM "quine_node_property_counts" WHERE $timeFilter

Prometheus example:

# Previous query
rate(node_property_counts[5m])

# 2.0.0+ query
rate(quine_node_property_counts[5m])

Exploration UI Changes

The web interface has been redesigned with a modernized layout, sidebar navigation, and consistent theming across all pages.

New Pages

  • Dashboard — A new landing page with a system overview diagram, host metrics, ingest stream status, and standing query status.
  • Streams — A management page for creating and managing ingest streams and standing queries directly through the UI.

New Features

  • JSON-LD export — The Exploration UI download menu now includes a JSON-LD graph export option.

Behavior Changes

  • Node pinning — Nodes are now pinned in place by default when dragged. To unpin a node, Shift+click-hold it.
  • Default node appearance — Nodes now render the name property by default, regardless of label. This is customizable via the UI Styling endpoints.

API v1 Deprecation

API v2 is now the default for all installations. API v1 remains available but is planned for deprecation and will be removed in a future release.

See Migrating from API v1 for the complete migration guide, including endpoint mappings, design changes, and a migration checklist.

Recipe Schema v1 Deprecation

Recipes now support schema version 2, which uses API v2 entities. Version 1 recipes continue to work but should be migrated.

See Migrating from v1 Recipes for migration steps and a before/after example.