Skip to content

v3.7.0 — Metrics Section, Certificate Audit, Navigation Restructure

Choose a tag to compare

@cvquesty cvquesty released this 21 May 15:59
· 740 commits to main since this release

OpenVox GUI 3.7.0

66 commits since v3.6.7. This is the largest feature release since the project began.


Metrics Section (10 Visualization Pages)

A new top-level Metrics nav group providing fleet-wide analytics and PuppetDB server instrumentation:

Run Performance — 10-chart thumbnail dashboard with click-to-expand:

  • Agent-side: Run Duration Trends, Timing Phase Breakdown, Top 10 Slowest Nodes (hourly averaged)
  • Server-side via PuppetDB Jolokia/JMX: Command Processing Time (catalog/facts/report as separate lines), Storage Operation Timing, Database Connection Pool (read/write active/idle/pending), HTTP API Latency, Catalog Deduplication, GC Pressure, Fleet Population
  • All server metrics auto-refresh (configurable 5s/10s/15s/30s/1m/Off) with localStorage persistence
  • Refresh rate control, manual refresh button, clear history

Fleet Compliance — bar chart showing compliant/drifted/failed/noop/unreported. Trend area chart over configurable time window. Expandable alphabetized node lists.

Fleet Fact Overview — auto-detects interesting facts ranked by variety. Scatter plots for numeric data (uptime, memory, CPU count), bar charts for categorical (OS, kernel, versions). Outlier detection highlights values on only 1-2 nodes with clickable certname links.

Catalog Graph — real directed dependency graph using React Flow + dagre. Class Hierarchy tab shows role -> profile -> module class structure reconstructed from Puppet tags. Resource Dependencies tab shows requires/before/notifies edges. Color-coded nodes (red=roles, green=profiles, blue=modules), bright theme, auto-fit zoom.

PuppetDB Health — JVM heap usage as a live area chart accumulating in localStorage (up to 360 points). Command queue depth line chart. Auto-refresh every 10 seconds.

Plus: Change Timeline, Environment Comparison (time-series with auto-refresh), Node Heatmap, Classification Tree, Class Coverage.


Certificate Audit

New tool under Tools > Certificate Audit that cross-references signed CA certificates against PuppetDB nodes to find orphans. Categories: "Never Reported", "Deactivated", "Expired in PuppetDB". Checkbox multi-select with "Clean Selected" or "Clean All" bulk actions. Fixed Revoked Certificates parser bug and increased CA command timeout to 120s.


Navigation Restructure

  • "Monitoring" renamed to Dashboard with Overview and Nodes as children
  • "Information" renamed to Tools with Certificate Audit added
  • Reports moved under the Logs section
  • Colored nav icons for each section
  • All Nodes section added to the Nodes page

UX Improvements

  • Clickable certnames everywhere — every FQDN in the entire GUI is a blue link to the node detail page (Dashboard, Certificates, Fact Explorer, Resource Explorer, Packages, Compliance, Timeline, Cert Audit, Heatmap, Classifier, Fact Distribution)
  • All dropdowns alphabetized — certificates, node selectors, classifiers
  • Certificate Authority list alphabetized and scrollable
  • High-quality chart rendering — smooth natural curves, gradient fills, dark glass-morphism tooltips, refined grids, no donut/pie charts anywhere
  • Server-side response caching (30s TTL) for performance overview, compliance, and JMX metrics

Technical

  • @xyflow/react + dagre dependencies for catalog graph
  • @mantine/dropzone for SSL wizard file uploads
  • 30+ new /api/metrics/* endpoints
  • PuppetDB Jolokia/JMX passthrough endpoints
  • Puppet-internal classes (main, Settings, Stage) filtered from all views
  • All JMX values type-guarded with Number() || 0 for render safety

Full Changelog

See CHANGELOG.md for the complete 3.7.0 entry.