@adalo/metrics 0.1.174 → 0.1.176

package/README.md

@@ -25,26 +25,25 @@ new MetricsClient({
   pushgatewayUrl,     // defaults: process.env.METRICS_PUSHGATEWAY_URL || ''
   pushgatewaySecret,  // defaults: process.env.METRICS_PUSHGATEWAY_SECRET || '' (Base64 of user:password)
   intervalSec,        // defaults: process.env.METRICS_INTERVAL_SEC || 15
-  httpMetricsEnabled, // defaults: METRICS_HTTP_ENABLED === 'true' (in-process HTTP counters only)
 })
 ```
 
-### HTTP metrics: `MetricsClient` vs Redis
+### Architecture
 
-**`MetricsClient`** only registers **in-process** `app_requests_*` counters when `METRICS_HTTP_ENABLED` / `httpMetricsEnabled` is on. For **Redis-backed** HTTP aggregation (multi-web / cluster), use **`HttpMetricsRedisRecorder`** (writers) and **`HttpMetricsRedisCollector`** (drain + push) with an injected **`redisClient`** — same idea as `RedisMetricsClient`, not mixed into `MetricsClient`. See **[`docs/http-metrics-redis.md`](docs/http-metrics-redis.md)** (quick Redis reference) and the repo guide **[`../docs/METRICS.md`](../docs/METRICS.md)** (full architecture for devs and AI assistants).
+See **[`../docs/METRICS.md`](../docs/METRICS.md)** (flow diagrams, Redis HTTP path, env vars).
+
+`DatabaseMetricsClient` / `QueueRedisMetricsClient` / `RedisMetricsClient` exit with code 0 (no logs) if the resolved `processType` is wrong **only when** `METRICS_ENABLED` is `true`. When metrics are off, that check is skipped.
 
-`DatabaseMetricsClient` / `QueueRedisMetricsClient` / `RedisMetricsClient` call **`process.exit(0)` with no logs** if `BUILD_DYNO_PROCESS_TYPE` (or `processType`) does not match `database-metrics` / `queue-metrics` / (`redis-metrics` or `queue-metrics`) respectively.
 ## Example Usage
-```ts
-import { MetricsClient } from '@adalo/metrics-js'
+```js
+const { MetricsClient, HttpMetricsRedisRecorder } = require('@adalo/metrics')
+const { redisClient } = require('./redis')
 
 const metrics = new MetricsClient({ appName: 'my-app', enabled: true })
+const httpRecorder = new HttpMetricsRedisRecorder({ redisClient })
 
-// Express middleware
-app.use(metrics.trackHttpRequestMiddleware)
-
+app.use(httpRecorder.trackHttpRequestMiddleware.bind(httpRecorder))
 
-// Start metrics push
 metrics.startPush()
 ```
 
@@ -54,17 +53,17 @@ metrics.startPush()
 // Create custom gauges and counters
 
 const metrics = new MetricsClient()
-const testGauge = metricsClient.createGauge({
+const testGauge = metrics.createGauge({
   name: 'app_test_usage_percent',
   help: 'Current test usage of the Node.js process in percent',
-  labelNames: metricsClient.withDefaultLabels(['test_result']),
+  labelNames: metrics.withDefaultLabels(['test_result']),
 })
 
 // Push metrics manually
-metricsClient.gatewayPush({ groupings: { process_type: 'web' } })
+metrics.gatewayPush({ groupings: { process_type: 'web' } })
 
 // Automatically push metrics at intervals (staging: 60s; prod: 900 or 1800 for 15/30 min)
-metricsClient.startPush(15) // interval in seconds
+metrics.startPush(15) // interval in seconds
 ```
 
 ## HealthCheckClient

package/__tests__/httpMetricsRedisCollector.test.js

@@ -1,4 +1,7 @@
-const { HttpMetricsRedisCollector } = require('../src/metrics/httpMetricsRedisCollector')
+const {
+  HttpMetricsRedisCollector,
+  HTTP_PUSH_INSTANCE_ROTATE_MS,
+} = require('../src/metrics/httpMetricsRedisCollector')
 const { buildFieldKey } = require('../src/metrics/httpMetricsRedisStore')
 
 function appRequestTotalsByRoute(metricsJson) {
@@ -69,12 +72,113 @@ describe('HttpMetricsRedisCollector', () => {
     const metrics = await collector._registry.getMetricsAsJSON()
     const total = metrics.find(m => m.name === 'app_requests_total')
     expect(total).toBeDefined()
+    expect(total.values[0].labels.http_instance_id).toMatch(
+      /^[0-9a-f-]{36}$/i
+    )
+    expect(total.values[0].labels.dyno_id).toBeUndefined()
     const totalDur = metrics.find(m => m.name === 'app_requests_total_duration')
     expect(totalDur).toBeDefined()
 
     pushSpy.mockRestore()
   })
 
+  it('clears HTTP counters and issues new http_instance_id after rotate interval', async () => {
+    const redis = createRedisV3Mock()
+    const field = buildFieldKey('GET', '/health', 200)
+    redis.eval.mockImplementation((lua, numKeys, k1, k2, cb) => {
+      cb(null, [
+        [field, '1'],
+        [field, '10'],
+      ])
+    })
+
+    const collector = new HttpMetricsRedisCollector({
+      redisClient: redis,
+      appName: 'test-app',
+      dynoId: 'dyno-1',
+      processType: 'http-metrics',
+      redisProcessTypeForKeys: 'web',
+      disablePushgateway: true,
+    })
+
+    const pushSpy = jest.spyOn(collector, 'gatewayPush').mockResolvedValue()
+    const clearSpy = jest.spyOn(collector, 'clearAllCounters')
+
+    await collector.pushMetrics()
+    const afterFirst = await collector._registry.getMetricsAsJSON()
+    expect(appRequestTotalsByRoute(afterFirst)['/health']).toBe(1)
+    const idBefore = collector._httpPushInstanceId
+
+    collector._httpPushInstanceStartedAt =
+      Date.now() - HTTP_PUSH_INSTANCE_ROTATE_MS - 1
+    collector._httpRotationLastCheck = 0
+    redis.eval.mockImplementation((lua, numKeys, k1, k2, cb) => {
+      cb(null, [[], []])
+    })
+
+    await collector.pushMetrics()
+
+    expect(clearSpy).toHaveBeenCalled()
+    expect(collector._httpPushInstanceId).not.toBe(idBefore)
+    const afterRotate = await collector._registry.getMetricsAsJSON()
+    const total = afterRotate.find(m => m.name === 'app_requests_total')
+    expect(!total?.values || total.values.length === 0).toBe(true)
+
+    pushSpy.mockRestore()
+    clearSpy.mockRestore()
+  })
+
+  it('uses METRICS_HTTP_INSTANCE_ROTATE_MS when set (ms)', async () => {
+    const savedRotate = process.env.METRICS_HTTP_INSTANCE_ROTATE_MS
+    // Rotation ms is read at module load; isolateModules loads collector after env is set.
+    let IsolatedCollector
+    let isolatedRotateMs
+    jest.isolateModules(() => {
+      process.env.METRICS_HTTP_INSTANCE_ROTATE_MS = '500'
+      process.env.METRICS_DISABLE_PUSHGATEWAY = 'true'
+      const m = require('../src/metrics/httpMetricsRedisCollector')
+      IsolatedCollector = m.HttpMetricsRedisCollector
+      isolatedRotateMs = m.HTTP_PUSH_INSTANCE_ROTATE_MS
+    })
+    try {
+      expect(isolatedRotateMs).toBe(500)
+
+      const redis = createRedisV3Mock()
+      const field = buildFieldKey('GET', '/x', 200)
+      redis.eval.mockImplementation((lua, numKeys, k1, k2, cb) => {
+        cb(null, [
+          [field, '1'],
+          [field, '0'],
+        ])
+      })
+
+      const collector = new IsolatedCollector({
+        redisClient: redis,
+        appName: 'test-app',
+        processType: 'http-metrics',
+        redisProcessTypeForKeys: 'web',
+        disablePushgateway: true,
+      })
+
+      const clearSpy = jest.spyOn(collector, 'clearAllCounters')
+      await collector.pushMetrics()
+      collector._httpPushInstanceStartedAt = Date.now() - 501
+      collector._httpRotationLastCheck = 0
+      redis.eval.mockImplementation((lua, numKeys, k1, k2, cb) => {
+        cb(null, [[], []])
+      })
+      await collector.pushMetrics()
+      expect(clearSpy).toHaveBeenCalled()
+      clearSpy.mockRestore()
+    } finally {
+      if (savedRotate === undefined) {
+        delete process.env.METRICS_HTTP_INSTANCE_ROTATE_MS
+      } else {
+        process.env.METRICS_HTTP_INSTANCE_ROTATE_MS = savedRotate
+      }
+    }
+  })
+
   it('primes new label sets with 0 then applies count (extra push only when labels are new)', async () => {
     const redis = createRedisV3Mock()
     const field = buildFieldKey('GET', '/health', 200)

package/__tests__/httpMetricsRedisRecorder.test.js

@@ -26,15 +26,34 @@ describe('HttpMetricsRedisRecorder', () => {
   const originalEnv = process.env
 
   beforeEach(() => {
-    process.env = { ...originalEnv, BUILD_APP_NAME: 'app' }
+    process.env = {
+      ...originalEnv,
+      BUILD_APP_NAME: 'app',
+      METRICS_HTTP_ENABLED: 'true',
+    }
   })
 
   afterEach(() => {
     process.env = originalEnv
   })
 
-  it('throws without redisClient', () => {
-    expect(() => new HttpMetricsRedisRecorder({})).toThrow('redisClient is required')
+  it('throws without redisClient when METRICS_HTTP_ENABLED is true', () => {
+    expect(() => new HttpMetricsRedisRecorder({})).toThrow(
+      'redisClient is required when METRICS_HTTP_ENABLED=true'
+    )
+  })
+
+  it('does not use Redis when METRICS_HTTP_ENABLED is not true', () => {
+    process.env = {
+      ...originalEnv,
+      BUILD_APP_NAME: 'app',
+      METRICS_HTTP_ENABLED: 'false',
+    }
+    const rec = new HttpMetricsRedisRecorder({})
+    expect(rec._store).toBeNull()
+    const next = jest.fn()
+    rec.trackHttpRequestMiddleware({ method: 'GET' }, { on: jest.fn() }, next)
+    expect(next).toHaveBeenCalled()
   })
 
   it('trackHttpRequest forwards to Redis multi/hincrby', async () => {

package/lib/metrics/baseMetricsClient.d.ts

@@ -51,7 +51,7 @@ export class BaseMetricsClient {
         dyno_id: string;
         process_type: string;
     };
-    /** Default labels without dyno_id (for HTTP metrics so dyno_id is not included). */
+    /** Labels excluding `dyno_id` (for series keyed only by app + process_type). */
     defaultLabelsWithoutDynoId: {
         app: string;
         process_type: string;

package/lib/metrics/baseMetricsClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"baseMetricsClient.d.ts","sourceRoot":"","sources":["../../src/metrics/baseMetricsClient.js"],"names":[],"mappings":"AAKA;;;;GAIG;AACH;IACE;;;;;;;;;;;;;;OAcG;IACH;QAb2B,OAAO;QACP,MAAM;QACN,WAAW;QACV,OAAO;QACP,SAAS;QACV,cAAc;QACd,iBAAiB;QACjB,WAAW;QACV,gBAAgB;QACf,iBAAiB;QAClB,kBAAkB;QAClB,uBAAuB;OA4DlD;IAzDC,gBAA4E;IAC5E,eAAqE;IACrE,oBAG6B;IAC7B,iBAAuE;IACvE,mBAC+D;IAC/D,uBACoE;IACpE,kBAC0E;IAC1E,oBAGI;IACJ,wCAAiD;IACjD,4BAEoD;IACpD,0BAEmD;IAEnD,mBAAyF;IAEzF,uEAAsC;IAKtC;;;;MAIC;IAED,oFAAoF;IACpF;;;MAGC;IAGD,aAAmB;IACnB,WAAgB;IAChB,aAAkB;IAClB,sBAA2B;IAE3B,mEAAmE;IACnE;YADkB,MAAM,SAAc,MAAM,GAAG,QAAQ,MAAM,CAAC;MACvC;IAKvB,sCAAwC;IAG1C;;;;;;;;OAQG;IACH;QAN2B,IAAI,EAApB,MAAM;QACU,IAAI,EAApB,MAAM;QACuC,QAAQ,UAAzC,MAAM,GAAC,QAAQ,MAAM,CAAC;QACf,UAAU;UAC3B,OAAO,aAAa,EAAE,KAAK,CAuBvC;IAED;;;;;;;;;;;;OAYG;IACH;QAT0B,IAAI,EAAnB,MAAM;QACS,IAAI,EAAnB,MAAM;QACY,UAAU;QACX,sBAAsB;kBAE3B,MAAM,mBAAmB,MAAM,KAAK,IAAI,CAgC9D;IAED;;OAEG;IACH,6BAKC;IAED;;OAEG;IACH,kCAiCC;IAED,sEAmDC;IA/CK,+CAA0D;IAiDhE,iCAEC;IAED;;;;;;;;;OASG;IACH,iFAEC;IAED;;;OAGG;IACH,eAFa,QAAQ,IAAI,CAAC,CAOzB;IAED;;;;;;;;;OASG;IACH,yBAEC;IAED;;;OAGG;IACH,qBAFa,QAAQ,IAAI,CAAC,CAezB;IAED;;;OAGG;IACH,8BAkDC;IAED;;;;;OAKG;IACH,8CAFa,QAAQ,IAAI,CAAC,CAgBzB;IAED;;;OAGG;IACH,uBAoDC;IAED;;;;;;OAMG;IACH,6BAHW,MAAM,EAAE,KACN,MAAM,EAAE,CAIpB;IAED;;;;;;OAMG;IACH,0CAHW,MAAM,EAAE,KACN,MAAM,EAAE,CAIpB;IAED;;;;MAEC;IAED,gCAGC;IAID,8BAEC;IAED,gCAEC;IAED,4EAEC;IAED,sCAEC;IAED,2DAWC;CACF"}
+{"version":3,"file":"baseMetricsClient.d.ts","sourceRoot":"","sources":["../../src/metrics/baseMetricsClient.js"],"names":[],"mappings":"AAKA;;;;GAIG;AACH;IACE;;;;;;;;;;;;;;OAcG;IACH;QAb2B,OAAO;QACP,MAAM;QACN,WAAW;QACV,OAAO;QACP,SAAS;QACV,cAAc;QACd,iBAAiB;QACjB,WAAW;QACV,gBAAgB;QACf,iBAAiB;QAClB,kBAAkB;QAClB,uBAAuB;OA4DlD;IAzDC,gBAA4E;IAC5E,eAAqE;IACrE,oBAG6B;IAC7B,iBAAuE;IACvE,mBAC+D;IAC/D,uBACoE;IACpE,kBAC0E;IAC1E,oBAGI;IACJ,wCAAiD;IACjD,4BAEoD;IACpD,0BAEmD;IAEnD,mBAAyF;IAEzF,uEAAsC;IAKtC;;;;MAIC;IAED,gFAAgF;IAChF;;;MAGC;IAGD,aAAmB;IACnB,WAAgB;IAChB,aAAkB;IAClB,sBAA2B;IAE3B,mEAAmE;IACnE;YADkB,MAAM,SAAc,MAAM,GAAG,QAAQ,MAAM,CAAC;MACvC;IAKvB,sCAAwC;IAG1C;;;;;;;;OAQG;IACH;QAN2B,IAAI,EAApB,MAAM;QACU,IAAI,EAApB,MAAM;QACuC,QAAQ,UAAzC,MAAM,GAAC,QAAQ,MAAM,CAAC;QACf,UAAU;UAC3B,OAAO,aAAa,EAAE,KAAK,CAuBvC;IAED;;;;;;;;;;;;OAYG;IACH;QAT0B,IAAI,EAAnB,MAAM;QACS,IAAI,EAAnB,MAAM;QACY,UAAU;QACX,sBAAsB;kBAE3B,MAAM,mBAAmB,MAAM,KAAK,IAAI,CAgC9D;IAED;;OAEG;IACH,6BAKC;IAED;;OAEG;IACH,kCAiCC;IAED,sEAmDC;IA/CK,+CAA0D;IAiDhE,iCAEC;IAED;;;;;;;;;OASG;IACH,iFAEC;IAED;;;OAGG;IACH,eAFa,QAAQ,IAAI,CAAC,CAOzB;IAED;;;;;;;;;OASG;IACH,yBAEC;IAED;;;OAGG;IACH,qBAFa,QAAQ,IAAI,CAAC,CAezB;IAED;;;OAGG;IACH,8BAkDC;IAED;;;;;OAKG;IACH,8CAFa,QAAQ,IAAI,CAAC,CAgBzB;IAED;;;OAGG;IACH,uBAoDC;IAED;;;;;;OAMG;IACH,6BAHW,MAAM,EAAE,KACN,MAAM,EAAE,CAIpB;IAED;;;;;;OAMG;IACH,0CAHW,MAAM,EAAE,KACN,MAAM,EAAE,CAIpB;IAED;;;;MAEC;IAED,gCAGC;IAID,8BAEC;IAED,gCAEC;IAED,4EAEC;IAED,sCAEC;IAED,2DAWC;CACF"}

package/lib/metrics/baseMetricsClient.js

@@ -53,7 +53,7 @@ class BaseMetricsClient {
       process_type: this.processType
     };
 
-    /** Default labels without dyno_id (for HTTP metrics so dyno_id is not included). */
+    /** Labels excluding `dyno_id` (for series keyed only by app + process_type). */
     this.defaultLabelsWithoutDynoId = {
       app: this.appName,
       process_type: this.processType

package/lib/metrics/baseMetricsClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"baseMetricsClient.js","names":["client","require","https","http","URL","BaseMetricsClient","constructor","config","appName","process","env","BUILD_APP_NAME","dynoId","HOSTNAME","processType","BUILD_DYNO_PROCESS_TYPE","enabled","METRICS_ENABLED","logValues","METRICS_LOG_VALUES","pushgatewayUrl","METRICS_PUSHGATEWAY_URL","authToken","pushgatewaySecret","METRICS_PUSHGATEWAY_SECRET","intervalSec","parseInt","METRICS_INTERVAL_SEC","startupValidation","disablePushgateway","METRICS_DISABLE_PUSHGATEWAY","removeOldMetrics","METRICS_REMOVE_OLD_METRICS","prefixLogs","_registry","Registry","blockNodeDefaultMetrics","collectDefaultMetrics","register","defaultLabels","app","dyno_id","process_type","defaultLabelsWithoutDynoId","gateway","gauges","counters","countersFunctions","gaugeUpdaters","_clearOldWorkers","_setCleanupHandlers","keepProcessAliveWhenDisabled","createGauge","name","help","updateFn","labelNames","Object","keys","g","Gauge","registers","createCounter","useLabelsWithoutDynoId","defaultSet","c","Counter","data","value","inc","clearAllCounters","metricsLogValues","console","log","values","forEach","counter","reset","_pushMetrics","entries","result","val","Promise","undefined","set","err","error","gatewayPush","metrics","getMetricsAsJSON","JSON","stringify","_startPush","interval","customPushMetics","warn","_idleInterval","setInterval","clearInterval","runPush","resolve","pushMetrics","catch","pushOrigin","trim","origin","startPush","cleanup","gatewayDelete","exit","_deleteFromVMByLabels","message","esc","s","String","replace","selector","u","reject","Error","path","encodeURIComponent","req","protocol","request","hostname","port","method","headers","Authorization","agent","Agent","keepAlive","res","statusCode","on","chunk","end","params","_pushToVMAgent","pushUrl","pathname","search","contentType","then","setHeader","Buffer","byteLength","withDefaultLabels","labels","withDefaultLabelsWithoutDynoId","getDefaultLabels","metricsEnabled","registry","getMetricsAsString","metricsMiddleware","status","module","exports"],"sources":["../../src/metrics/baseMetricsClient.js"],"sourcesContent":["const client = require('prom-client')\nconst https = require('https')\nconst http = require('http')\nconst { URL } = require('url')\n\n/**\n * BaseMetricsClient provides common functionality for all metrics clients.\n * Handles registry setup, push to remote (VM-agent), default labels, and common operations.\n * Always pushes registry to the configured URL (POST Prometheus text format + Basic auth). No Pushgateway.\n */\nclass BaseMetricsClient {\n  /**\n   * @param {Object} config\n   * @param {string} [config.appName] Name of the application\n   * @param {string} [config.dynoId] Dyno/instance ID\n   * @param {string} [config.processType] Process type (web, worker, etc.)\n   * @param {boolean} [config.enabled] Enable metrics collection\n   * @param {boolean} [config.logValues] Log metrics values to console\n   * @param {string} [config.pushgatewayUrl] Push URL (VM-agent import endpoint, e.g. .../api/v1/import/prometheus). /metrics is for GET (scrape), not POST (push).\n   * @param {string} [config.pushgatewaySecret] Basic auth secret (Base64 of user:password)\n   * @param {number} [config.intervalSec] Interval in seconds for pushing metrics\n   * @param {boolean} [config.removeOldMetrics] Enable to clear metrics by service name\n   * @param {function} [config.startupValidation] Add to validate on start push.\n   * @param {boolean} [config.disablePushgateway] Disable pushing to Pushgateway (use HTTP scraping instead)\n   * @param {boolean} [config.blockNodeDefaultMetrics] When true, do not register prom-client default process metrics (heap, event loop, etc.). Default false — used by HTTP-only collectors.\n   */\n  constructor(config = {}) {\n    this.appName = config.appName || process.env.BUILD_APP_NAME || 'unknown-app'\n    this.dynoId = config.dynoId || process.env.HOSTNAME || 'unknown-dyno'\n    this.processType =\n      config.processType ||\n      process.env.BUILD_DYNO_PROCESS_TYPE ||\n      'undefined_build_dyno_type'\n    this.enabled = config.enabled ?? process.env.METRICS_ENABLED === 'true'\n    this.logValues =\n      config.logValues ?? process.env.METRICS_LOG_VALUES === 'true'\n    this.pushgatewayUrl =\n      config.pushgatewayUrl || process.env.METRICS_PUSHGATEWAY_URL || ''\n    this.authToken =\n      config.pushgatewaySecret || process.env.METRICS_PUSHGATEWAY_SECRET || ''\n    this.intervalSec =\n      config.intervalSec ||\n      parseInt(process.env.METRICS_INTERVAL_SEC || '', 10) ||\n      15\n    this.startupValidation = config.startupValidation\n    this.disablePushgateway =\n      config.disablePushgateway ??\n      process.env.METRICS_DISABLE_PUSHGATEWAY === 'true'\n    this.removeOldMetrics =\n      config.removeOldMetrics ??\n      process.env.METRICS_REMOVE_OLD_METRICS === 'true'\n\n    this.prefixLogs = `[${this.processType}] [${this.appName}] [${this.dynoId}] [Monitoring]`\n\n    this._registry = new client.Registry()\n    if (config.blockNodeDefaultMetrics) {\n      client.collectDefaultMetrics({ register: this._registry })\n    }\n\n    this.defaultLabels = {\n      app: this.appName,\n      dyno_id: this.dynoId,\n      process_type: this.processType,\n    }\n\n    /** Default labels without dyno_id (for HTTP metrics so dyno_id is not included). */\n    this.defaultLabelsWithoutDynoId = {\n      app: this.appName,\n      process_type: this.processType,\n    }\n\n    // Always push to configured URL (VM-agent). No Pushgateway.\n    this.gateway = null\n    this.gauges = {}\n    this.counters = {}\n    this.countersFunctions = {}\n\n    /** @type {Object<string, function(): number | Promise<number>>} */\n    this.gaugeUpdaters = {}\n\n    this._clearOldWorkers(config.removeOldMetrics)\n    this._setCleanupHandlers()\n\n    this.keepProcessAliveWhenDisabled = true\n  }\n\n  /**\n   * Create a gauge metric.\n   * @param {Object} options - Gauge configuration\n   * @param {string} options.name - Name of the gauge\n   * @param {string} options.help - Help text describing the gauge\n   * @param {function(): number|Promise<number>} [options.updateFn] - Optional function returning the gauge value\n   * @param {string[]} [options.labelNames] - Optional custom label names\n   * @returns {import('prom-client').Gauge} The created Prometheus gauge\n   */\n  createGauge = ({\n    name,\n    help,\n    updateFn,\n    labelNames = Object.keys(this.defaultLabels),\n  }) => {\n    if (this.gauges[name]) return this.gauges[name]\n\n    const g = new client.Gauge({\n      name,\n      help,\n      labelNames,\n      registers: [this._registry],\n    })\n    this.gauges[name] = g\n\n    if (updateFn && typeof updateFn === 'function') {\n      this.gaugeUpdaters[name] = updateFn\n    }\n\n    return g\n  }\n\n  /**\n   * Create a Prometheus Counter metric.\n   *\n   * @param {Object} params - Counter configuration\n   * @param {string} params.name - Metric name\n   * @param {string} params.help - Metric description\n   * @param {string[]} [params.labelNames] - Optional list of label names. Defaults to this.defaultLabels keys.\n   * @param {boolean} [params.useLabelsWithoutDynoId=false] - If true, counter uses app/process_type only (no dyno_id). Use for HTTP metrics.\n   *\n   * @returns {(labels?: Object, incrementValue?: number) => void}\n   *          A function to increment the counter.\n   *          Usage: (labels?, incrementValue?)\n   */\n  createCounter({\n    name,\n    help,\n    labelNames = Object.keys(this.defaultLabels),\n    useLabelsWithoutDynoId = false,\n  }) {\n    if (this.counters[name]) return this.countersFunctions[name]\n\n    const defaultSet = useLabelsWithoutDynoId\n      ? this.defaultLabelsWithoutDynoId\n      : this.defaultLabels\n\n    const c = new client.Counter({\n      name,\n      help,\n      labelNames,\n      registers: [this._registry],\n    })\n    this.counters[name] = c\n\n    this.countersFunctions = {\n      ...this.countersFunctions,\n      [name]: (data = {}, value = 1) => {\n        c.inc({ ...defaultSet, ...data }, value)\n      },\n    }\n\n    return this.countersFunctions[name]\n  }\n\n  /**\n   * Clear all collected counters\n   */\n  clearAllCounters = () => {\n    if (this.metricsLogValues) {\n      console.log('Counters to clear: ', Object.keys(this.counters))\n    }\n    Object.values(this.counters).forEach(counter => counter.reset())\n  }\n\n  /**\n   * Push all gauges and counters to PushGateway and optionally log.\n   */\n  _pushMetrics = async () => {\n    try {\n      for (const [name, updateFn] of Object.entries(this.gaugeUpdaters)) {\n        try {\n          if (!updateFn) {\n            continue\n          }\n          const result = updateFn()\n          const val = result instanceof Promise ? await result : result\n          if (val !== undefined) this.gauges[name].set(this.defaultLabels, val)\n        } catch (err) {\n          console.error(\n            `${this.prefixLogs} Failed to update gauge ${name}:`,\n            err\n          )\n        }\n      }\n\n      if (!this.disablePushgateway) {\n        await this.gatewayPush()\n      }\n      // this.clearAllCounters() //TODO: or uncommit or delete (based on grafana expectation)\n\n      if (this.logValues) {\n        const metrics = await this._registry.getMetricsAsJSON()\n        console.log(\n          `${this.prefixLogs} Metrics:\\n`,\n          JSON.stringify(metrics, null, 2)\n        )\n      }\n    } catch (err) {\n      console.error(`${this.prefixLogs} Failed to push metrics:`, err)\n    }\n  }\n\n  _startPush = (interval = this.intervalSec, customPushMetics = undefined) => {\n    if (!this.enabled) {\n      console.warn(`${this.prefixLogs} Metrics disabled`)\n      if (this.keepProcessAliveWhenDisabled && !this._idleInterval) {\n        this._idleInterval = setInterval(() => {}, 60 * 60 * 1000)\n      }\n      return\n    }\n\n    if (this._idleInterval) {\n      clearInterval(this._idleInterval)\n      this._idleInterval = null\n    }\n\n    if (this.startupValidation && !this.startupValidation()) {\n      return\n    }\n\n    const runPush = () => {\n      if (customPushMetics && typeof customPushMetics === 'function') {\n        return Promise.resolve(customPushMetics())\n      }\n      return this.pushMetrics()\n    }\n\n    if (customPushMetics && typeof customPushMetics === 'function') {\n      setInterval(() => customPushMetics(), interval * 1000)\n    } else {\n      setInterval(() => {\n        runPush().catch(err => {\n          console.error(`${this.prefixLogs} Failed to push metrics:`, err)\n        })\n      }, interval * 1000)\n    }\n\n    // First push immediately so metrics appear without waiting for the first interval\n    runPush().catch(err => {\n      console.error(`${this.prefixLogs} Failed to push metrics (initial):`, err)\n    })\n\n    let pushOrigin = 'none'\n    try {\n      if (this.pushgatewayUrl && this.pushgatewayUrl.trim()) {\n        pushOrigin = new URL(this.pushgatewayUrl.trim()).origin\n      }\n    } catch {\n      pushOrigin = 'invalid URL'\n    }\n    console.warn(\n      `${this.prefixLogs} Metrics collection started. (interval: ${this.intervalSec}s, push: ${pushOrigin})`\n    )\n  }\n\n  pushMetrics = async () => {\n    return this._pushMetrics()\n  }\n\n  /**\n   * Start periodic metrics collection and push.\n   *\n   * This method wraps the internal `_startPush` method.\n   * If a `customPushMetrics` function is provided, it will be executed\n   * at the given interval instead of the default `pushMetrics` behavior.\n   *\n   * @param {number} [interval=this.intervalSec] - Interval in seconds between pushes.\n   * @param {() => void | Promise<void>} [customPushMetrics] - Optional custom push function. If provided, Prometheus push is skipped.\n   */\n  startPush = (interval, customPushMetics = undefined) => {\n    this._startPush(interval, customPushMetics)\n  }\n\n  /**\n   * Cleanup metrics and exit process.\n   * @returns {Promise<void>}\n   */\n  cleanup = async () => {\n    if (this.enabled) {\n      await this.gatewayDelete()\n    }\n    process.exit(0)\n  }\n\n  /**\n   * Remove old/stale dyno/instance metrics from PushGateway.\n   *\n   * Compares existing PushGateway metrics for this job and deletes any instances\n   * that do not match the current dynoId.\n   *\n   * @param {boolean} removeOldMetrics If true, performs cleanup; otherwise does nothing\n   * @returns {Promise<void>}\n   * @private\n   */\n  _clearOldWorkers = async removeOldMetrics => {\n    // No Pushgateway; VM-agent does not support per-instance delete. Skip.\n  }\n\n  /**\n   * On shutdown: optionally delete this instance's metrics from VictoriaMetrics (by app, dyno_id, process_type).\n   * @returns {Promise<void>}\n   */\n  gatewayDelete = async () => {\n    if (\n      this.removeOldMetrics &&\n      this.pushgatewayUrl &&\n      this.pushgatewayUrl.trim()\n    ) {\n      await this._deleteFromVMByLabels().catch(err => {\n        console.warn(\n          `${this.prefixLogs} Deletion from VM on shutdown failed:`,\n          err.message\n        )\n      })\n    }\n  }\n\n  /**\n   * Call VictoriaMetrics delete_series API to remove all series matching this instance's labels (app, dyno_id, process_type).\n   * @private\n   */\n  _deleteFromVMByLabels = () => {\n    const esc = s => String(s).replace(/\\\\/g, '\\\\\\\\').replace(/\"/g, '\\\\\"')\n    const selector = `{app=\"${esc(this.appName)}\",dyno_id=\"${esc(\n      this.dynoId\n    )}\",process_type=\"${esc(this.processType)}\"}`\n    let origin\n    try {\n      const u = new URL((this.pushgatewayUrl || '').trim())\n      origin = u.origin\n    } catch {\n      return Promise.reject(new Error('Invalid push URL'))\n    }\n    const path = `/api/v1/admin/tsdb/delete_series?match[]=${encodeURIComponent(\n      selector\n    )}`\n    return new Promise((resolve, reject) => {\n      const u = new URL(origin)\n      const req = (u.protocol === 'https:' ? https : http).request(\n        {\n          hostname: u.hostname,\n          port: u.port || (u.protocol === 'https:' ? 443 : 80),\n          path,\n          method: 'POST',\n          headers: {\n            'Content-Length': '0',\n            Authorization: this.authToken\n              ? `Basic ${this.authToken}`\n              : undefined,\n          },\n          agent:\n            u.protocol === 'https:'\n              ? new https.Agent({ keepAlive: false })\n              : undefined,\n        },\n        res => {\n          if (res.statusCode >= 200 && res.statusCode < 300) resolve()\n          else {\n            let data = ''\n            res.on('data', chunk => {\n              data += chunk\n            })\n            res.on('end', () =>\n              reject(new Error(`Delete failed: ${res.statusCode} ${data}`))\n            )\n          }\n        }\n      )\n      req.on('error', reject)\n      req.end()\n    })\n  }\n\n  /**\n   * Push registry to configured URL (VM-agent). POST Prometheus text format + Basic auth.\n   *\n   * @param {object} [params] Unused; kept for API compatibility.\n   * @returns {Promise<void>}\n   */\n  gatewayPush = async (params = {}) => {\n    if (this.disablePushgateway) {\n      console.warn(\n        `${this.prefixLogs} Metrics push skipped: METRICS_DISABLE_PUSHGATEWAY is set`\n      )\n      return Promise.resolve()\n    }\n    if (!this.pushgatewayUrl || !this.pushgatewayUrl.trim()) {\n      console.warn(\n        `${this.prefixLogs} Metrics push skipped: METRICS_PUSHGATEWAY_URL is not set`\n      )\n      return Promise.resolve()\n    }\n    return this._pushToVMAgent()\n  }\n\n  /**\n   * POST registry (Prometheus text format) to VM-agent. VM-agent accepts push at /api/v1/import/prometheus; /metrics is GET (scrape) only.\n   * @private\n   */\n  _pushToVMAgent = () => {\n    let pushUrl = (this.pushgatewayUrl || '').trim()\n    try {\n      const u = new URL(pushUrl)\n      if (!u.pathname || u.pathname === '/' || u.pathname === '/metrics') {\n        pushUrl = `${u.origin}/api/v1/import/prometheus${u.search}`\n      }\n    } catch {\n      // leave pushUrl as-is\n    }\n    return new Promise((resolve, reject) => {\n      const u = new URL(pushUrl)\n      const req = (u.protocol === 'https:' ? https : http).request(\n        {\n          hostname: u.hostname,\n          port: u.port || (u.protocol === 'https:' ? 443 : 80),\n          path: u.pathname + u.search,\n          method: 'POST',\n          headers: {\n            'Content-Type': client.register.contentType,\n            Authorization: this.authToken\n              ? `Basic ${this.authToken}`\n              : undefined,\n          },\n          agent:\n            u.protocol === 'https:'\n              ? new https.Agent({ keepAlive: true })\n              : undefined,\n        },\n        res => {\n          if (res.statusCode >= 200 && res.statusCode < 300) {\n            resolve()\n          } else {\n            let data = ''\n            res.on('data', chunk => {\n              data += chunk\n            })\n            res.on('end', () =>\n              reject(new Error(`Push failed: ${res.statusCode} ${data}`))\n            )\n          }\n        }\n      )\n      req.on('error', reject)\n      this._registry\n        .metrics()\n        .then(metrics => {\n          req.setHeader('Content-Length', Buffer.byteLength(metrics, 'utf8'))\n          req.end(metrics, 'utf8')\n        })\n        .catch(reject)\n    })\n  }\n\n  /**\n   * Merge the default metric labels (`app`, `dyno_id`, `process_type`)\n   * with custom label names.\n   *\n   * @param {string[]} labels Additional label names\n   * @returns {string[]} Combined label names\n   */\n  withDefaultLabels = (labels = []) => {\n    return [...Object.keys(this.defaultLabels), ...labels]\n  }\n\n  /**\n   * Merge default labels without dyno_id (`app`, `process_type`) with custom label names.\n   * Use for HTTP metrics so dyno_id is not included.\n   *\n   * @param {string[]} labels Additional label names\n   * @returns {string[]} Combined label names\n   */\n  withDefaultLabelsWithoutDynoId = (labels = []) => {\n    return [...Object.keys(this.defaultLabelsWithoutDynoId), ...labels]\n  }\n\n  getDefaultLabels = (labels = []) => {\n    return this.defaultLabels\n  }\n\n  _setCleanupHandlers = () => {\n    process.on('SIGINT', this.cleanup)\n    process.on('SIGTERM', this.cleanup)\n  }\n\n  // GETTERS\n\n  get metricsEnabled() {\n    return this.enabled\n  }\n\n  get metricsLogValues() {\n    return this.logValues\n  }\n\n  get registry() {\n    return this._registry\n  }\n\n  async getMetricsAsString() {\n    return this._registry.metrics()\n  }\n\n  metricsMiddleware() {\n    return async (req, res) => {\n      try {\n        const metrics = await this.getMetricsAsString()\n        res.set('Content-Type', client.register.contentType)\n        res.end(metrics)\n      } catch (err) {\n        console.error(`${this.prefixLogs} Failed to get metrics:`, err)\n        res.status(500).end('Failed to collect metrics')\n      }\n    }\n  }\n}\n\nmodule.exports = { BaseMetricsClient }\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"baseMetricsClient.js","names":["client","require","https","http","URL","BaseMetricsClient","constructor","config","appName","process","env","BUILD_APP_NAME","dynoId","HOSTNAME","processType","BUILD_DYNO_PROCESS_TYPE","enabled","METRICS_ENABLED","logValues","METRICS_LOG_VALUES","pushgatewayUrl","METRICS_PUSHGATEWAY_URL","authToken","pushgatewaySecret","METRICS_PUSHGATEWAY_SECRET","intervalSec","parseInt","METRICS_INTERVAL_SEC","startupValidation","disablePushgateway","METRICS_DISABLE_PUSHGATEWAY","removeOldMetrics","METRICS_REMOVE_OLD_METRICS","prefixLogs","_registry","Registry","blockNodeDefaultMetrics","collectDefaultMetrics","register","defaultLabels","app","dyno_id","process_type","defaultLabelsWithoutDynoId","gateway","gauges","counters","countersFunctions","gaugeUpdaters","_clearOldWorkers","_setCleanupHandlers","keepProcessAliveWhenDisabled","createGauge","name","help","updateFn","labelNames","Object","keys","g","Gauge","registers","createCounter","useLabelsWithoutDynoId","defaultSet","c","Counter","data","value","inc","clearAllCounters","metricsLogValues","console","log","values","forEach","counter","reset","_pushMetrics","entries","result","val","Promise","undefined","set","err","error","gatewayPush","metrics","getMetricsAsJSON","JSON","stringify","_startPush","interval","customPushMetics","warn","_idleInterval","setInterval","clearInterval","runPush","resolve","pushMetrics","catch","pushOrigin","trim","origin","startPush","cleanup","gatewayDelete","exit","_deleteFromVMByLabels","message","esc","s","String","replace","selector","u","reject","Error","path","encodeURIComponent","req","protocol","request","hostname","port","method","headers","Authorization","agent","Agent","keepAlive","res","statusCode","on","chunk","end","params","_pushToVMAgent","pushUrl","pathname","search","contentType","then","setHeader","Buffer","byteLength","withDefaultLabels","labels","withDefaultLabelsWithoutDynoId","getDefaultLabels","metricsEnabled","registry","getMetricsAsString","metricsMiddleware","status","module","exports"],"sources":["../../src/metrics/baseMetricsClient.js"],"sourcesContent":["const client = require('prom-client')\nconst https = require('https')\nconst http = require('http')\nconst { URL } = require('url')\n\n/**\n * BaseMetricsClient provides common functionality for all metrics clients.\n * Handles registry setup, push to remote (VM-agent), default labels, and common operations.\n * Always pushes registry to the configured URL (POST Prometheus text format + Basic auth). No Pushgateway.\n */\nclass BaseMetricsClient {\n  /**\n   * @param {Object} config\n   * @param {string} [config.appName] Name of the application\n   * @param {string} [config.dynoId] Dyno/instance ID\n   * @param {string} [config.processType] Process type (web, worker, etc.)\n   * @param {boolean} [config.enabled] Enable metrics collection\n   * @param {boolean} [config.logValues] Log metrics values to console\n   * @param {string} [config.pushgatewayUrl] Push URL (VM-agent import endpoint, e.g. .../api/v1/import/prometheus). /metrics is for GET (scrape), not POST (push).\n   * @param {string} [config.pushgatewaySecret] Basic auth secret (Base64 of user:password)\n   * @param {number} [config.intervalSec] Interval in seconds for pushing metrics\n   * @param {boolean} [config.removeOldMetrics] Enable to clear metrics by service name\n   * @param {function} [config.startupValidation] Add to validate on start push.\n   * @param {boolean} [config.disablePushgateway] Disable pushing to Pushgateway (use HTTP scraping instead)\n   * @param {boolean} [config.blockNodeDefaultMetrics] When true, do not register prom-client default process metrics (heap, event loop, etc.). Default false — used by HTTP-only collectors.\n   */\n  constructor(config = {}) {\n    this.appName = config.appName || process.env.BUILD_APP_NAME || 'unknown-app'\n    this.dynoId = config.dynoId || process.env.HOSTNAME || 'unknown-dyno'\n    this.processType =\n      config.processType ||\n      process.env.BUILD_DYNO_PROCESS_TYPE ||\n      'undefined_build_dyno_type'\n    this.enabled = config.enabled ?? process.env.METRICS_ENABLED === 'true'\n    this.logValues =\n      config.logValues ?? process.env.METRICS_LOG_VALUES === 'true'\n    this.pushgatewayUrl =\n      config.pushgatewayUrl || process.env.METRICS_PUSHGATEWAY_URL || ''\n    this.authToken =\n      config.pushgatewaySecret || process.env.METRICS_PUSHGATEWAY_SECRET || ''\n    this.intervalSec =\n      config.intervalSec ||\n      parseInt(process.env.METRICS_INTERVAL_SEC || '', 10) ||\n      15\n    this.startupValidation = config.startupValidation\n    this.disablePushgateway =\n      config.disablePushgateway ??\n      process.env.METRICS_DISABLE_PUSHGATEWAY === 'true'\n    this.removeOldMetrics =\n      config.removeOldMetrics ??\n      process.env.METRICS_REMOVE_OLD_METRICS === 'true'\n\n    this.prefixLogs = `[${this.processType}] [${this.appName}] [${this.dynoId}] [Monitoring]`\n\n    this._registry = new client.Registry()\n    if (config.blockNodeDefaultMetrics) {\n      client.collectDefaultMetrics({ register: this._registry })\n    }\n\n    this.defaultLabels = {\n      app: this.appName,\n      dyno_id: this.dynoId,\n      process_type: this.processType,\n    }\n\n    /** Labels excluding `dyno_id` (for series keyed only by app + process_type). */\n    this.defaultLabelsWithoutDynoId = {\n      app: this.appName,\n      process_type: this.processType,\n    }\n\n    // Always push to configured URL (VM-agent). No Pushgateway.\n    this.gateway = null\n    this.gauges = {}\n    this.counters = {}\n    this.countersFunctions = {}\n\n    /** @type {Object<string, function(): number | Promise<number>>} */\n    this.gaugeUpdaters = {}\n\n    this._clearOldWorkers(config.removeOldMetrics)\n    this._setCleanupHandlers()\n\n    this.keepProcessAliveWhenDisabled = true\n  }\n\n  /**\n   * Create a gauge metric.\n   * @param {Object} options - Gauge configuration\n   * @param {string} options.name - Name of the gauge\n   * @param {string} options.help - Help text describing the gauge\n   * @param {function(): number|Promise<number>} [options.updateFn] - Optional function returning the gauge value\n   * @param {string[]} [options.labelNames] - Optional custom label names\n   * @returns {import('prom-client').Gauge} The created Prometheus gauge\n   */\n  createGauge = ({\n    name,\n    help,\n    updateFn,\n    labelNames = Object.keys(this.defaultLabels),\n  }) => {\n    if (this.gauges[name]) return this.gauges[name]\n\n    const g = new client.Gauge({\n      name,\n      help,\n      labelNames,\n      registers: [this._registry],\n    })\n    this.gauges[name] = g\n\n    if (updateFn && typeof updateFn === 'function') {\n      this.gaugeUpdaters[name] = updateFn\n    }\n\n    return g\n  }\n\n  /**\n   * Create a Prometheus Counter metric.\n   *\n   * @param {Object} params - Counter configuration\n   * @param {string} params.name - Metric name\n   * @param {string} params.help - Metric description\n   * @param {string[]} [params.labelNames] - Optional list of label names. Defaults to this.defaultLabels keys.\n   * @param {boolean} [params.useLabelsWithoutDynoId=false] - If true, counter uses app/process_type only (no dyno_id). Use for HTTP metrics.\n   *\n   * @returns {(labels?: Object, incrementValue?: number) => void}\n   *          A function to increment the counter.\n   *          Usage: (labels?, incrementValue?)\n   */\n  createCounter({\n    name,\n    help,\n    labelNames = Object.keys(this.defaultLabels),\n    useLabelsWithoutDynoId = false,\n  }) {\n    if (this.counters[name]) return this.countersFunctions[name]\n\n    const defaultSet = useLabelsWithoutDynoId\n      ? this.defaultLabelsWithoutDynoId\n      : this.defaultLabels\n\n    const c = new client.Counter({\n      name,\n      help,\n      labelNames,\n      registers: [this._registry],\n    })\n    this.counters[name] = c\n\n    this.countersFunctions = {\n      ...this.countersFunctions,\n      [name]: (data = {}, value = 1) => {\n        c.inc({ ...defaultSet, ...data }, value)\n      },\n    }\n\n    return this.countersFunctions[name]\n  }\n\n  /**\n   * Clear all collected counters\n   */\n  clearAllCounters = () => {\n    if (this.metricsLogValues) {\n      console.log('Counters to clear: ', Object.keys(this.counters))\n    }\n    Object.values(this.counters).forEach(counter => counter.reset())\n  }\n\n  /**\n   * Push all gauges and counters to PushGateway and optionally log.\n   */\n  _pushMetrics = async () => {\n    try {\n      for (const [name, updateFn] of Object.entries(this.gaugeUpdaters)) {\n        try {\n          if (!updateFn) {\n            continue\n          }\n          const result = updateFn()\n          const val = result instanceof Promise ? await result : result\n          if (val !== undefined) this.gauges[name].set(this.defaultLabels, val)\n        } catch (err) {\n          console.error(\n            `${this.prefixLogs} Failed to update gauge ${name}:`,\n            err\n          )\n        }\n      }\n\n      if (!this.disablePushgateway) {\n        await this.gatewayPush()\n      }\n      // this.clearAllCounters() //TODO: or uncommit or delete (based on grafana expectation)\n\n      if (this.logValues) {\n        const metrics = await this._registry.getMetricsAsJSON()\n        console.log(\n          `${this.prefixLogs} Metrics:\\n`,\n          JSON.stringify(metrics, null, 2)\n        )\n      }\n    } catch (err) {\n      console.error(`${this.prefixLogs} Failed to push metrics:`, err)\n    }\n  }\n\n  _startPush = (interval = this.intervalSec, customPushMetics = undefined) => {\n    if (!this.enabled) {\n      console.warn(`${this.prefixLogs} Metrics disabled`)\n      if (this.keepProcessAliveWhenDisabled && !this._idleInterval) {\n        this._idleInterval = setInterval(() => {}, 60 * 60 * 1000)\n      }\n      return\n    }\n\n    if (this._idleInterval) {\n      clearInterval(this._idleInterval)\n      this._idleInterval = null\n    }\n\n    if (this.startupValidation && !this.startupValidation()) {\n      return\n    }\n\n    const runPush = () => {\n      if (customPushMetics && typeof customPushMetics === 'function') {\n        return Promise.resolve(customPushMetics())\n      }\n      return this.pushMetrics()\n    }\n\n    if (customPushMetics && typeof customPushMetics === 'function') {\n      setInterval(() => customPushMetics(), interval * 1000)\n    } else {\n      setInterval(() => {\n        runPush().catch(err => {\n          console.error(`${this.prefixLogs} Failed to push metrics:`, err)\n        })\n      }, interval * 1000)\n    }\n\n    // First push immediately so metrics appear without waiting for the first interval\n    runPush().catch(err => {\n      console.error(`${this.prefixLogs} Failed to push metrics (initial):`, err)\n    })\n\n    let pushOrigin = 'none'\n    try {\n      if (this.pushgatewayUrl && this.pushgatewayUrl.trim()) {\n        pushOrigin = new URL(this.pushgatewayUrl.trim()).origin\n      }\n    } catch {\n      pushOrigin = 'invalid URL'\n    }\n    console.warn(\n      `${this.prefixLogs} Metrics collection started. (interval: ${this.intervalSec}s, push: ${pushOrigin})`\n    )\n  }\n\n  pushMetrics = async () => {\n    return this._pushMetrics()\n  }\n\n  /**\n   * Start periodic metrics collection and push.\n   *\n   * This method wraps the internal `_startPush` method.\n   * If a `customPushMetrics` function is provided, it will be executed\n   * at the given interval instead of the default `pushMetrics` behavior.\n   *\n   * @param {number} [interval=this.intervalSec] - Interval in seconds between pushes.\n   * @param {() => void | Promise<void>} [customPushMetrics] - Optional custom push function. If provided, Prometheus push is skipped.\n   */\n  startPush = (interval, customPushMetics = undefined) => {\n    this._startPush(interval, customPushMetics)\n  }\n\n  /**\n   * Cleanup metrics and exit process.\n   * @returns {Promise<void>}\n   */\n  cleanup = async () => {\n    if (this.enabled) {\n      await this.gatewayDelete()\n    }\n    process.exit(0)\n  }\n\n  /**\n   * Remove old/stale dyno/instance metrics from PushGateway.\n   *\n   * Compares existing PushGateway metrics for this job and deletes any instances\n   * that do not match the current dynoId.\n   *\n   * @param {boolean} removeOldMetrics If true, performs cleanup; otherwise does nothing\n   * @returns {Promise<void>}\n   * @private\n   */\n  _clearOldWorkers = async removeOldMetrics => {\n    // No Pushgateway; VM-agent does not support per-instance delete. Skip.\n  }\n\n  /**\n   * On shutdown: optionally delete this instance's metrics from VictoriaMetrics (by app, dyno_id, process_type).\n   * @returns {Promise<void>}\n   */\n  gatewayDelete = async () => {\n    if (\n      this.removeOldMetrics &&\n      this.pushgatewayUrl &&\n      this.pushgatewayUrl.trim()\n    ) {\n      await this._deleteFromVMByLabels().catch(err => {\n        console.warn(\n          `${this.prefixLogs} Deletion from VM on shutdown failed:`,\n          err.message\n        )\n      })\n    }\n  }\n\n  /**\n   * Call VictoriaMetrics delete_series API to remove all series matching this instance's labels (app, dyno_id, process_type).\n   * @private\n   */\n  _deleteFromVMByLabels = () => {\n    const esc = s => String(s).replace(/\\\\/g, '\\\\\\\\').replace(/\"/g, '\\\\\"')\n    const selector = `{app=\"${esc(this.appName)}\",dyno_id=\"${esc(\n      this.dynoId\n    )}\",process_type=\"${esc(this.processType)}\"}`\n    let origin\n    try {\n      const u = new URL((this.pushgatewayUrl || '').trim())\n      origin = u.origin\n    } catch {\n      return Promise.reject(new Error('Invalid push URL'))\n    }\n    const path = `/api/v1/admin/tsdb/delete_series?match[]=${encodeURIComponent(\n      selector\n    )}`\n    return new Promise((resolve, reject) => {\n      const u = new URL(origin)\n      const req = (u.protocol === 'https:' ? https : http).request(\n        {\n          hostname: u.hostname,\n          port: u.port || (u.protocol === 'https:' ? 443 : 80),\n          path,\n          method: 'POST',\n          headers: {\n            'Content-Length': '0',\n            Authorization: this.authToken\n              ? `Basic ${this.authToken}`\n              : undefined,\n          },\n          agent:\n            u.protocol === 'https:'\n              ? new https.Agent({ keepAlive: false })\n              : undefined,\n        },\n        res => {\n          if (res.statusCode >= 200 && res.statusCode < 300) resolve()\n          else {\n            let data = ''\n            res.on('data', chunk => {\n              data += chunk\n            })\n            res.on('end', () =>\n              reject(new Error(`Delete failed: ${res.statusCode} ${data}`))\n            )\n          }\n        }\n      )\n      req.on('error', reject)\n      req.end()\n    })\n  }\n\n  /**\n   * Push registry to configured URL (VM-agent). POST Prometheus text format + Basic auth.\n   *\n   * @param {object} [params] Unused; kept for API compatibility.\n   * @returns {Promise<void>}\n   */\n  gatewayPush = async (params = {}) => {\n    if (this.disablePushgateway) {\n      console.warn(\n        `${this.prefixLogs} Metrics push skipped: METRICS_DISABLE_PUSHGATEWAY is set`\n      )\n      return Promise.resolve()\n    }\n    if (!this.pushgatewayUrl || !this.pushgatewayUrl.trim()) {\n      console.warn(\n        `${this.prefixLogs} Metrics push skipped: METRICS_PUSHGATEWAY_URL is not set`\n      )\n      return Promise.resolve()\n    }\n    return this._pushToVMAgent()\n  }\n\n  /**\n   * POST registry (Prometheus text format) to VM-agent. VM-agent accepts push at /api/v1/import/prometheus; /metrics is GET (scrape) only.\n   * @private\n   */\n  _pushToVMAgent = () => {\n    let pushUrl = (this.pushgatewayUrl || '').trim()\n    try {\n      const u = new URL(pushUrl)\n      if (!u.pathname || u.pathname === '/' || u.pathname === '/metrics') {\n        pushUrl = `${u.origin}/api/v1/import/prometheus${u.search}`\n      }\n    } catch {\n      // leave pushUrl as-is\n    }\n    return new Promise((resolve, reject) => {\n      const u = new URL(pushUrl)\n      const req = (u.protocol === 'https:' ? https : http).request(\n        {\n          hostname: u.hostname,\n          port: u.port || (u.protocol === 'https:' ? 443 : 80),\n          path: u.pathname + u.search,\n          method: 'POST',\n          headers: {\n            'Content-Type': client.register.contentType,\n            Authorization: this.authToken\n              ? `Basic ${this.authToken}`\n              : undefined,\n          },\n          agent:\n            u.protocol === 'https:'\n              ? new https.Agent({ keepAlive: true })\n              : undefined,\n        },\n        res => {\n          if (res.statusCode >= 200 && res.statusCode < 300) {\n            resolve()\n          } else {\n            let data = ''\n            res.on('data', chunk => {\n              data += chunk\n            })\n            res.on('end', () =>\n              reject(new Error(`Push failed: ${res.statusCode} ${data}`))\n            )\n          }\n        }\n      )\n      req.on('error', reject)\n      this._registry\n        .metrics()\n        .then(metrics => {\n          req.setHeader('Content-Length', Buffer.byteLength(metrics, 'utf8'))\n          req.end(metrics, 'utf8')\n        })\n        .catch(reject)\n    })\n  }\n\n  /**\n   * Merge the default metric labels (`app`, `dyno_id`, `process_type`)\n   * with custom label names.\n   *\n   * @param {string[]} labels Additional label names\n   * @returns {string[]} Combined label names\n   */\n  withDefaultLabels = (labels = []) => {\n    return [...Object.keys(this.defaultLabels), ...labels]\n  }\n\n  /**\n   * Merge default labels without dyno_id (`app`, `process_type`) with custom label names.\n   * Use for HTTP metrics so dyno_id is not included.\n   *\n   * @param {string[]} labels Additional label names\n   * @returns {string[]} Combined label names\n   */\n  withDefaultLabelsWithoutDynoId = (labels = []) => {\n    return [...Object.keys(this.defaultLabelsWithoutDynoId), ...labels]\n  }\n\n  getDefaultLabels = (labels = []) => {\n    return this.defaultLabels\n  }\n\n  _setCleanupHandlers = () => {\n    process.on('SIGINT', this.cleanup)\n    process.on('SIGTERM', this.cleanup)\n  }\n\n  // GETTERS\n\n  get metricsEnabled() {\n    return this.enabled\n  }\n\n  get metricsLogValues() {\n    return this.logValues\n  }\n\n  get registry() {\n    return this._registry\n  }\n\n  async getMetricsAsString() {\n    return this._registry.metrics()\n  }\n\n  metricsMiddleware() {\n    return async (req, res) => {\n      try {\n        const metrics = await this.getMetricsAsString()\n        res.set('Content-Type', client.register.contentType)\n        res.end(metrics)\n      } catch (err) {\n        console.error(`${this.prefixLogs} Failed to get metrics:`, err)\n        res.status(500).end('Failed to collect metrics')\n      }\n    }\n  }\n}\n\nmodule.exports = { BaseMetricsClient }\n"],"mappings":"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","ignoreList":[]}

package/lib/metrics/httpMetricsRedisCollector.d.ts

@@ -1,29 +1,22 @@
-/**
- * Drain worker: reads HTTP aggregates from Redis (written by {@link HttpMetricsRedisRecorder}),
- * applies them to `app_requests_*` counters, then pushes the registry to the VM-agent (same as {@link BaseMetricsClient}).
- * **Minimal usage:** `{ redisClient }` only. Redis keys use segment **`web`** unless you pass **`redisProcessTypeForKeys`**.
- * `processType` / `appName` / `dynoId` follow {@link BaseMetricsClient} defaults (e.g. `BUILD_DYNO_PROCESS_TYPE`) and do **not** select Redis hash names.
- * Always passes `blockNodeDefaultMetrics: true` (HTTP-focused registry).
- *
- * @extends BaseMetricsClient
- */
 export class HttpMetricsRedisCollector extends BaseMetricsClient {
     /**
      * @param {Object} [config]
-     * @param {import('redis').RedisClient} config.redisClient **Required.** Injected client (same pattern as {@link RedisMetricsClient}).
-     * @param {string} [config.appName] Application name (defaults per {@link BaseMetricsClient})
-     * @param {string} [config.dynoId] Dyno/instance ID
-     * @param {string} [config.processType] Label `process_type` on push (default from env / base)
-     * @param {boolean} [config.enabled] Enable collection and push
-     * @param {boolean} [config.logValues] Log metric JSON to console
-     * @param {string} [config.pushgatewayUrl] VM-agent import URL
-     * @param {string} [config.pushgatewaySecret] Basic auth secret (Base64)
-     * @param {number} [config.intervalSec] Push interval (seconds)
-     * @param {boolean} [config.removeOldMetrics] Clear old series on shutdown where supported
-     * @param {function} [config.startupValidation] Run before first push
-     * @param {boolean} [config.disablePushgateway] Skip POST to VM-agent
-     * @param {string} [config.redisProcessTypeForKeys] Segment in Redis keys for HTTP hashes (default **`web`**). Optional; only if writers use a non-`web` segment.
-     * @param {number} [config.ttlSec] Passed to {@link HttpMetricsRedisStore} (should match writers)
+     * @param {import('redis').RedisClient} config.redisClient
+     * @param {string} [config.appName] Name of the application (defaults per {@link BaseMetricsClient})
+     * @param {string} [config.dynoId] Dyno/instance ID (defaults per {@link BaseMetricsClient})
+     * @param {string} [config.processType] Process type for labels (defaults per {@link BaseMetricsClient})
+     * @param {boolean} [config.enabled] Enable metrics collection (defaults per {@link BaseMetricsClient})
+     * @param {boolean} [config.logValues] Log metrics values to console (defaults per {@link BaseMetricsClient})
+     * @param {string} [config.pushgatewayUrl] VM-agent import URL (defaults per {@link BaseMetricsClient})
+     * @param {string} [config.pushgatewaySecret] Basic auth secret, Base64 (defaults per {@link BaseMetricsClient})
+     * @param {number} [config.intervalSec] Push interval in seconds (defaults per {@link BaseMetricsClient})
+     * @param {boolean} [config.removeOldMetrics] Enable clearing old metrics (defaults per {@link BaseMetricsClient})
+     * @param {function} [config.startupValidation] Run before first push (defaults per {@link BaseMetricsClient})
+     * @param {boolean} [config.disablePushgateway] Skip POST to VM-agent (defaults per {@link BaseMetricsClient})
+     * @param {string} [config.redisProcessTypeForKeys] Segment in Redis keys for HTTP hashes (default `web`).
+     * @param {number} [config.ttlSec] Redis hash TTL in seconds; should match writers’ {@link HttpMetricsRedisStore}.
+     *
+     * `http_instance_id` rotation interval: {@link HTTP_PUSH_INSTANCE_ROTATE_MS} (set at process start from env, see constant JSDoc).
      */
     constructor(config?: {
         redisClient: import('redis').RedisClient;
@@ -42,9 +35,22 @@ export class HttpMetricsRedisCollector extends BaseMetricsClient {
         ttlSec?: number | undefined;
     } | undefined);
     _store: HttpMetricsRedisStore;
-    /** @type {Set<string>} Redis field keys already primed with inc(0) + push in this process */
+    _httpPushInstanceId: any;
+    _httpPushInstanceStartedAt: number;
+    _httpRotationLastCheck: number;
+    /** @type {Set<string>} */
     _httpCounterPrimedKeys: Set<string>;
+    _labelsForHttpPush(rowLabels: any): any;
+    /** @param {number} now */
+    _rotateHttpPushInstance(now: number): void;
+    /** @param {number} now */
+    _maybeRotateHttpPushInstance(now?: number): void;
 }
+/**
+ * Ms between `http_instance_id` rotation + in-memory counter reset in {@link HttpMetricsRedisCollector}.
+ * From `process.env.METRICS_HTTP_INSTANCE_ROTATE_MS` if positive integer, else 7 days. Resolved at module load.
+ */
+export const HTTP_PUSH_INSTANCE_ROTATE_MS: number;
 import { BaseMetricsClient } from "./baseMetricsClient";
 import { HttpMetricsRedisStore } from "./httpMetricsRedisStore";
 //# sourceMappingURL=httpMetricsRedisCollector.d.ts.map

package/lib/metrics/httpMetricsRedisCollector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"httpMetricsRedisCollector.d.ts","sourceRoot":"","sources":["../../src/metrics/httpMetricsRedisCollector.js"],"names":[],"mappings":"AAMA;;;;;;;;GAQG;AACH;IACE;;;;;;;;;;;;;;;;OAgBG;IACH;qBAfW,OAAO,OAAO,EAAE,WAAW;;;;;;;;;;;;;;mBAgErC;IA/BC,8BAKE;IAEF,6FAA6F;IAC7F,wBADW,IAAI,MAAM,CAAC,CACiB;CAqE1C"}
+{"version":3,"file":"httpMetricsRedisCollector.d.ts","sourceRoot":"","sources":["../../src/metrics/httpMetricsRedisCollector.js"],"names":[],"mappings":"AAgBA;IACE;;;;;;;;;;;;;;;;;;OAkBG;IACH;qBAjBW,OAAO,OAAO,EAAE,WAAW;;;;;;;;;;;;;;mBAiErC;IAnCC,8BAKE;IAGF,yBAAmC;IACnC,mCAAqC;IACrC,+BAA+B;IAE/B,0BAA0B;IAC1B,wBADW,IAAI,MAAM,CAAC,CACiB;IAwBzC,wCAKC;IAED,0BAA0B;IAC1B,6BADY,MAAM,QAMjB;IAED,0BAA0B;IAC1B,mCADY,MAAM,QAUjB;CAiDF;AAzJD;;;GAGG;AACH,kDAEyB"}