Skip to content

Latest commit

 

History

History
421 lines (268 loc) · 12.8 KB

CHANGELOG.md

File metadata and controls

421 lines (268 loc) · 12.8 KB

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

Breaking

Changed

  • The done() functions returned by gauge.startTimer() and summary.startTimer() now return the timed duration. Histograms already had this behavior.

  • types: fixed type for registry.getMetricsAsArray()

  • changed: typedef for pushgateway to reflect js implementation.

    Pushgateway's typedef were missing promise return type. That was causing vscode to think that push/pushAdd and delete didn't promise resulting in incorrect behavior.

Added

[14.0.0] - 2021-09-18

Breaking

  • changed: linearBuckets does not propagate rounding errors anymore.

    Fewer bucket bounds will be affected by rounding errors. Histogram bucket labels may change. 6f1f3b2

  • changed: The push gateway methods pushAdd(), push() and delete() now return Promises instead of accepting a callback:

    // Old:
    gateway.pushAdd({ jobName: 'test' }, (err, resp, body) => {});
    // New:
    gateway
      .pushAdd({ jobName: 'test' })
      .then(({ resp, body }) => {})
      .catch(err => {});
    // or
    const { resp, body } = await gateway.pushAdd({ jobName: 'test' });

    f177b1f

  • changed: The default nodejs_eventloop_lag_* metrics are now reset every time they are observed. This prevents these metrics from "stabilizing" over a long period of time and becoming insensitive to small changes. For more info, see #370. 0f444cd

Changed

  • Add missing await/thens to examples. 074f339
  • Add missing type declaration for client.contentType. 3b66641
  • Modernize some label processing code. c9bf1d8

[13.2.0] - 2021-08-08

Changed

  • Don't add event listener to process if cluster module is not used.
  • fix: set labels for default memory metrics on linux.
  • fix: fix DEP0152 deprecation warning in Node.js v16+.
  • fix: Set aggregation mode for newer event loop metrics. (Fixes #418)
  • Improve performance of/reduce memory allocations in Gauge.

Added

  • feat: added zero() to Histogram for setting the metrics for a given label combination to zero
  • fix: allow Gauge.inc/dec(0) without defaulting to 1

[13.1.0] - 2021-01-24

Changed

  • fix: push client attempting to write Promise (fixes #390)
  • types: improve type checking of labels
  • fix: Summary#observe should throw when adding additional labels to labelset (fixes #262)

Added

  • feat: added the ability to pass labels as an object to labels() and remove()
  • Added: More examples with commented output

[13.0.0] - 2020-12-16

Breaking

  • changed: The following functions are now async (return a promise): registry.metrics() registry.getMetricsAsJSON() registry.getMetricsAsArray() registry.getSingleMetricAsString()

    If your metrics server has a line like res.send(register.metrics()), you should change it to res.send(await register.metrics()).

    Additionally, all metric types now accept an optional collect function, which is called when the metric's value should be collected and within which you should set the metric's value. You should provide a collect function for point-in-time metrics (e.g. current memory usage, as opposed to HTTP request durations that are continuously logged in a histogram).

  • changed: register.clusterMetrics() no longer accepts a callback; it only returns a promise.

  • removed: v12.0.0 added the undocumented functions registry.registerCollector and registry.collectors(). These have been removed. If you were using them, you should instead provide a collect function as described above.

Changed

  • fix: provide nodejs_version_info metric value after calling registry.resetMetrics() (#238)
  • fix: provide process_max_fds metric value after calling registry.resetMetrics()
  • fix: provide process_start_time_seconds metric value after calling registry.resetMetrics()
  • chore: improve performance of registry.getMetricAsPrometheusString
  • chore: refactor metrics to reduce code duplication
  • chore: replace utils.getPropertiesFromObj with Object.values
  • chore: remove unused catch bindings
  • chore: upgrade Prettier to 2.x
  • fix: startTimer returns number in typescript instead of void
  • fix: incorrect typings of `registry.getSingleMetric' (#388)
  • chore: stop testing node v13 on CI

Added

  • feat: exposed registry.registerCollector() and registry.collectors() methods in TypeScript declaration
  • Added: complete working example of a pushgateway push in example/pushgateway.js
  • feat: added support for adding labels to default metrics (#374)
  • Added CHANGELOG reminder

[12.0.0] - 2020-02-20

Breaking

  • Dropped support for end-of-life Node.js versions 6.x and 8.x
  • Dropped the previously deprecated support for positional parameters in constructors, only the config object forms remain.
  • Default metrics are collected on scrape of metrics endpoint, not on an interval. The timeout option to collectDefaultMetrics(conf) is no longer supported or needed, and the function no longer returns a Timeout object.

Changed

  • chore: remove ignored package-lock.json
  • fix: process_max_fds is process limit, not OS (#314)
  • Changed Metric labelNames & labelValues in TypeScript declaration to a generic type T extends string, instead of string
  • Lazy-load Node.js Cluster module to fix Passenger support (#293)
  • fix: avoid mutation bug in registry.getMetricsAsJSON()
  • fix: improve performance of registry.getMetrics*
  • End function of histogram startTimer, when invoked returns the number of seconds
  • chore: reindent package.json
  • chore: correct var name in processStartTime
  • chore: add test for process_start_time_seconds
  • chore: spelling corrections in README

Added

  • feat: implement GC metrics collection without native(C++) modules.
  • feat: implement advanced event loop monitoring

[11.5.3] - 2019-06-27

Changed

  • Parameter compressCount in Summaries to control compression of data in t-digest.
  • Compress t-digest in Summaries

[11.5.2] - 2019-06-20

Changed

  • fix: avoid mutation bug in registry

[11.5.1] - 2019-06-13

Changed

  • fix: guard against missing constructor

[11.5.0] - 2019-06-04

Added

  • Added timestamps toggle to collectDefaultMetrics options
  • Export validateMetricName

[11.4.0] - 2019-06-04

Added

  • nodejs_active_handles metric to the collectDefaultMetrics(). Unlike nodejs_active_handles_total it split count of active handles by type.
  • nodejs_active_requests metric to the collectDefaultMetrics(). Unlike nodejs_active_requests_total it split count of active requests by type.

[11.3.0] - 2019-04-02

Changed

  • Check that cluster worker is still connected before attempting to query it for metrics. (#244)

Added

[11.2.1]

Breaking

Changed

Added

  • Updated types for Summary in typescript definition file

[11.2.0]

Changed

  • Updated child dependency merge patch version to remove vulnerability.

Added

  • Added an initial benchmark suite which can be run with npm run benchmarks.
  • Add support for sliding windows in Summaries

[11.1.3] - 2018-09-22

Changed

  • Fixed performance by avoiding Object.assign on hot paths, as well as mutating objects when appropriate.

[11.1.2] - 2018-09-19

Changed

  • Allow setting Gauge values to NaN, +Inf, and -Inf
  • Fixed histogram scrape performance by using acc.push instead of acc.concat. Fixes #216 with #219

[11.1.1] - 2018-06-29

Changed

  • Fixed processOpenFileDescriptors metric when no custom config was set

[11.1.0] - 2018-06-29

  • Added ability to set a name prefix in the default metrics

Changed

  • Fixed startTimer utility to not mutate objects passed as startLabels
  • Fixed Counter to validate labels parameter of inc() against initial labelset
  • Fixed AggregatorFactory losing the aggregator method of metrics

[11.0.0] - 2018-03-10

Breaking

  • Fixed gauge.setToCurrentTime() to use seconds instead of milliseconds
  • Dropped support for node 4

[10.2.3] - 2018-02-28

Breaking

Changed

  • Fixed issue that registry.getMetricsAsJSON() ignores registry default labels

Added

10.2.2 - 2017-11-02

Changed

  • Fixed invalid process_virtual_memory_bytes reported under linux

10.2.1 - 2017-10-27

Changed

  • Only resolve/reject clusterMetrics promise if no callback is provided

10.2.0 - 2017-10-16

Changed

  • Don't add event listeners if cluster module is not used.
  • Fixed issue with counters having extra records when using empty labels

Added

  • Added reset to Counter and Gauge
  • Added resetMetrics to register to calling reset of all metric instances

10.1.1 - 2017-09-26

Changed

  • Update TypeScript definitions and JSDoc comments to match JavaScript sources
  • Fix lexical scope of arguments in cluster code

10.1.0 - 2017-09-04

Added

  • Support aggregating metrics across workers in a Node.js cluster.

10.0.4 - 2017-08-22

Changed

  • Include invalid values in the error messages

10.0.3 - 2017-08-07

Added

  • Added registerMetric to definitions file

Changed

  • Fixed typing of DefaultMetricsCollectorConfiguration in definitions file
  • Don't pass timestamps through to pushgateway by default

10.0.2 - 2017-07-07

Changed

  • Don't poll default metrics every single tick

10.0.1 - 2017-07-06

Added

  • Metrics should be initialized to 0 when there are no labels

10.0.0 - 2017-07-04

Breaking

  • Print deprecation warning when metrics are constructed using non-objects
  • Print deprecation warning when collectDefaultMetrics is called with a number

Added

  • Ability to set default labels by registry
  • Allow passing in registry as second argument to collectDefaultMetrics to use that instead of the default registry

Changed

  • Convert code base to ES2015 code (node 4)
    • add engines field to package.json
    • Use object shorthand
    • Remove util-extend in favor of Object.assign
    • Arrow functions over binding or putting this in a variable
    • Use template strings
    • prototype -> class

9.1.1 - 2017-06-17

Changed

  • Don't set timestamps for metrics that are never updated

9.1.0 - 2017-06-07

Added

  • Ability to merge registries

Changed

  • Correct typedefs for object constructor of metrics

9.0.0 - 2017-05-06

Added

  • Support for multiple registers
  • Support for object literals in metric constructors
  • Timestamp support

Changed

  • Collection of default metrics is now disabled by default. Start collection by running collectDefaultMetrics().

Deprecated

  • Creating metrics with one argument per parameter - use object literals instead.