Release 3.4.2

This is a maintenance release for the v3.4.1 release. The ChangeLog below lists the main changes included in this release, and you can also refer to the Lightbits Known Issues document for additional information.

New in This Release

1. api-service: Since version v3.3, Lightbits supports the optional “HTTP Strict-Transport-Security” (HSTS) response header in the Lightbits management API service. In release v3.4.1, this support was temporarily disabled. Release v3.4.2 reinstates HSTS support.
2. azure: Events are now shown in Azure app-insights as they trigger.
3. discovery-service: Return the correct number of log pages. Fix a long-standing bug in the discovery service where it would return the wrong number of log pages in certain scenarios, which could lead to nvme-cli crashes or failure to work.
4. prometheus: The prometheus.yml file is now backward-compatible with prometheusversions older than v2.35.
5. userlbe: NVMe multi-path enabled NVMe drives are now supported and can be used in Lightbits servers.
6. vcp: The traffic monitoring graphs in vcp1.4 have been updated to match the statistics reported by Lightbits v3.4.1 and later.

Monitoring Stack Changes

Lightbits Release 3.4.x introduces some changes to front-end metrics (node/volume IOPS/BW/latency), to address issues that could arise at large scale, along with some possible inaccuracies with latency metrics. Note that this could require an update to the Prometheus and Grafana configuration (or other similar tools used to scrape/store and display metrics collected from Lightbits).

If you use the Lightbits reference monitoring stack. update and use the following files from current Lightbits monitoring tools:

updated: prometheus/record.rules.yaml

updated: prometheus/prometheus.yaml

new: grafana: server_performance_ tab.json (replacing the performance_tab)

new: grafana: /volume_performance_ tab.json

More specifically, the following changes were made.

1. iops/BW metrics of the lightbox_fe_ nr_xxx_ irate format have been deprecated (and their associated Prometheus recording rules were updated). Similar lightbox_fe_ nr_xxx metrics still exist, and rate calculation was moved to Prometheus.
2. For latency metrics of the lightbox_fe_ xxx_duration_ x_xK_ avg format, units of metrics have changed to seconds (CPU cycles, recording rules, and the Grafana dashboard have been updated accordingly).
3. The collector for frontend metrics (iops/bw/duration, and all metrics of the lightbox_fe_ xxx_xxx_ format) have been moved from the datapath collector to a dedicated collector: "duroslight". (Note that if a scrape was done for specific collectors as per the reference in prometheus.yaml, this should be added to the list of collectors to scrape).
4. New/updated Grafana reference dashboards have been added for server/volume performance (deprecating the performance_tab dashboard).

Installation and Upgradeability

This release is upgradeable from the prior releases listed below. An (x) indicates upgradeability from the listed release. An empty bracket “( )” indicates that this release is not directly upgradeable from that particular release and upgrading requires an upgrade to an intermediary release (e.g., 3.2.1 to 3.3.2 to 3.4.2) or a new installation.

( ) Lightbits 2.2.x

( ) Lightbits 2.3.x

( ) Lightbits 3.0.x

( ) Lightbits 3.1.1

( ) Lightbits 3.1.2

( ) Lightbits 3.2.1

(x) Lightbits 3.3.1

(x) Lightbits 3.3.2

(x) Lightbits 3.4.1