v1.3.0

v1.3.0 Release Notes

Upgrade Requirements

Database schema change — This release modifies the _visus schema. You must run visus init before starting the server after upgrading from v1.2.1.

New Features

• Distributed leader election — Replaced the IsMainNode heuristic (based on max node_id) with a proper distributed lease using field-eng-powertools/lease. This ensures correct coordination of cluster-scoped collectors when multiple visus instances share a CockroachDB cluster.

• Node registration and heartbeat — Each visus process now registers itself in the _visus.node table on startup with its hostname, PID, and version. A 1-minute heartbeat keeps the registration fresh, and graceful shutdown deregisters the node. Stale nodes are automatically cleaned up via CockroachDB row-level TTL.

• visus node list command — New subcommand to display all registered visus nodes with their ID, hostname, PID, version, and last heartbeat timestamp.

• --allow-unsafe-internals flag — Required for CockroachDB v26+, which no longer allows queries against crdb_internal or system tables without this session setting.

Bug Fixes

• Fix command output going to stderr instead of stdout
• Fix transaction handling and guard type assertions in collector
• Register errorCounts metric in scanner and fix cleanup of removed metrics

CI / Infrastructure

• Upgrade Go to 1.24 in Docker builds
• Bump all GitHub Actions to latest major versions for Node.js 24 compatibility

Full Changelog: v1.2.1...v1.3.0

v1.2.1

What's Changed

• collector: fix gauge label cleanup timing
• docs: adding note to describe the use of follower reads in metric collection

Full Changelog: v1.2.0...v1.2.1

v1.2.0

What's Changed

Dependency Updates

• gomod: bump golang.org/x/tools from 0.34.0 to 0.35.0 by @dependabot[bot] in #204
• gomod: bump github.com/cockroachdb/field-eng-powertools from 0.1.1 to 0.1.2 by @dependabot[bot] in #206
• gomod: bump github.com/prometheus/client_golang from 1.22.0 to 1.23.0 by @dependabot[bot] in #205

Bug fixes

• collection: Fix unregistering metrics from Prometheus registry by @sravotto in #208

Full Changelog: v1.1.1...v1.2.0

v1.1.0

What's Changed

Dependency Updates

• gomod: bump golang.org/x/tools from 0.32.0 to 0.33.0 by @dependabot in #196
• gomod: bump github.com/jackc/pgx/v5 from 5.7.4 to 5.7.5 by @dependabot in #198
• gomod: bump golang.org/x/tools from 0.33.0 to 0.34.0 by @dependabot in #199
• gomod: bump github.com/prometheus/common from 0.63.0 to 0.64.0 by @dependabot in #197

Unclassified Changes

• Adding queries to collect mvcc non-live bytes, at the table level. by @sravotto in #200

Full Changelog: v1.0.0...v1.1.0

Binaries: SHA256

ca3eb45484051642a147c1d4f7a0302bf40152c5aa4c12162d73c0f2ef1a249f  visus-v1.1.0.linux-arm64.tgz
900c90f93f3f0248ead2dced2eaedc80bf47152f790f82162fc61c2bea514b50  visus-v1.1.0.linux-amd64.tgz

v1.0.0

What's Changed

Enhancements

• scanner: adding a parser for auth logs
• scanner: supporting regex to exclude lines from a log.
• collection: adding a query to select databases from where to extract metrics.
• http: adding metric to display information about the visus binary.

Notes

To upgrade an existing visus instance, run $VISUS_ADMIN init following the instruction in the README.

Full Changelog: v0.3.0...v1.0.0

Binaries: SHA256

492c4a3a56b98f3ae9189f2a425f0ce34cdd827ba2cab328b84af433ca9def30  visus-v1.0.0.linux-arm64.tgz
d9ddc9a9eac6a2fefcca7f5567dd3a8a35254a6345dd1b216ef4eb1f883401c3  visus-v1.0.0.linux-amd64.tgz

v.0.3.0

What's Changed

• support certificates rotation when a SIGHUP signal is sent to the visus process
• metrics from log files: visus may be used to scan cockroachdb log files: it will produce metrics for the events in the logs, adding labels for the level and the source of the event.
• adding a stopper utility to manage services lifetime.

Binaries: SHA256

cd3940d041515f3bc0b02051a13254b711f48562494625feffab2f836f391879  visus-v0.3.0.linux-amd64.tgz
8b4b6721b45e56c4d1a399d8e81b56cb739a6483312ad9573e89fae59eb872d9  visus-v0.3.0.linux-arm64.tgz

v0.2.0

• Use AOST queries by default for gathering metrics.
  SHA256 of binaries:

8463511050c50a887e7f2f1e79fe2e040dac1435b604996ac2b6b8e3fc88e818  visus-v0.2.0.linux-amd64.tgz
9bd3ffc0b6397803e646bfdf0aadd37786fde2dc666d77cc9815afc5bfc17eb4  visus-v0.2.0.linux-arm64.tgz

v0.1.0

What's Changed

Initial release.

• Enable users to collect metrics using arbitrary SQL queries and expose them in a Prometheus format.
• Support for histogram filters.
• Support for cluster level metrics.
• Docker image.

See README.md for details.

Full Changelog: https://github.com/cockroachlabs/visus/commits/v0.1.0

SHA256 of binaries:
31de168b2f46b0c5f5b5a5e4b8a374afdc74eb575ce1b1dac20b0245b8dd10a6 visus-v0.1.0-linux-amd64.zip