@adalo/metrics 0.0.0-staging.23 → 0.0.0-staging.26

package/__tests__/httpMetricsRedisCollector.test.js

@@ -13,9 +13,7 @@ function createRedisV3Mock() {
   }
   return {
     multi: jest.fn(() => multiChain),
-    set: jest.fn(),
     eval: jest.fn(),
-    del: jest.fn(),
     _multiChain: multiChain,
   }
 }
@@ -37,9 +35,6 @@ describe('HttpMetricsRedisCollector', () => {
 
   it('pushMetrics drains Redis then completes without network push', async () => {
     const redis = createRedisV3Mock()
-    redis.set.mockImplementation((key, val, mode, ttl, nx, cb) => {
-      cb(null, 'OK')
-    })
     const field = buildFieldKey('GET', '/health', 200, '', '')
     redis.eval.mockImplementation((lua, numKeys, k1, k2, cb) => {
       cb(null, [
@@ -47,11 +42,6 @@ describe('HttpMetricsRedisCollector', () => {
         [field, '10'],
       ])
     })
-    redis.del.mockImplementation((key, cb) => {
-      if (cb) {
-        cb()
-      }
-    })
 
     const collector = new HttpMetricsRedisCollector({
       redisClient: redis,

package/__tests__/httpMetricsRedisRecorder.test.js

@@ -23,18 +23,24 @@ function createRedisV3Mock() {
 }
 
 describe('HttpMetricsRedisRecorder', () => {
+  const originalEnv = process.env
+
+  beforeEach(() => {
+    process.env = { ...originalEnv, BUILD_APP_NAME: 'app' }
+  })
+
+  afterEach(() => {
+    process.env = originalEnv
+  })
+
   it('throws without redisClient', () => {
-    expect(() => new HttpMetricsRedisRecorder({ appName: 'a', processType: 'web' })).toThrow(
-      'redisClient is required'
-    )
+    expect(() => new HttpMetricsRedisRecorder({})).toThrow('redisClient is required')
   })
 
   it('trackHttpRequest forwards to Redis multi/hincrby', async () => {
     const redis = createRedisV3Mock()
     const rec = new HttpMetricsRedisRecorder({
       redisClient: redis,
-      appName: 'app',
-      processType: 'web',
     })
     const countKey = rec._store.countKey
     const durKey = rec._store.durKey

package/__tests__/httpMetricsRedisStore.test.js

@@ -21,13 +21,70 @@ function createRedisV3Mock() {
   }
   return {
     multi: jest.fn(() => multiChain),
-    set: jest.fn(),
     eval: jest.fn(),
-    del: jest.fn(),
     _multiChain: multiChain,
   }
 }
 
+/**
+ * In-memory redis@3 mock: MULTI/EXEC applies HINCRBY to shared hashes; EVAL returns
+ * [HGETALL+DEL countKey, HGETALL+DEL durKey] like the real drain Lua. Use this to
+ * simulate many writers (same client) without Redis.
+ */
+function createRedisV3InMemoryMock() {
+  /** @type {Record<string, Record<string, string>>} */
+  const hashes = {}
+
+  function hgetallFlat(key) {
+    const h = hashes[key]
+    if (!h) return []
+    const flat = []
+    for (const [f, v] of Object.entries(h)) {
+      flat.push(f, v)
+    }
+    return flat
+  }
+
+  function drainKey(key) {
+    const flat = hgetallFlat(key)
+    delete hashes[key]
+    return flat
+  }
+
+  const client = {
+    multi: jest.fn(() => {
+      const ops = []
+      const chain = {}
+      chain.hincrby = jest.fn((key, field, inc) => {
+        ops.push({ key, field, inc: Number(inc) })
+        return chain
+      })
+      chain.expire = jest.fn().mockReturnValue(chain)
+      chain.exec = jest.fn(cb => {
+        for (const op of ops) {
+          if (!hashes[op.key]) hashes[op.key] = {}
+          const cur = parseInt(hashes[op.key][op.field] || '0', 10)
+          hashes[op.key][op.field] = String(cur + op.inc)
+        }
+        if (cb) cb(null)
+      })
+      return chain
+    }),
+    eval: jest.fn((lua, numKeys, k1, k2, cb) => {
+      const out = [drainKey(k1), drainKey(k2)]
+      if (cb) cb(null, out)
+    }),
+    /** @param {string} key */
+    _fieldCount(key) {
+      return Object.keys(hashes[key] || {}).length
+    },
+    _peek(key) {
+      return { ...(hashes[key] || {}) }
+    },
+  }
+  return client
+}
+
 describe('HttpMetricsRedisStore', () => {
   describe('buildFieldKey', () => {
     it('joins parts with FIELD_SEP', () => {
@@ -54,7 +111,6 @@ describe('HttpMetricsRedisStore', () => {
       const seg = `${encodeURIComponent('my app')}:${encodeURIComponent('web')}`
       expect(store.countKey).toBe(`metrics:http:v2:${seg}:count`)
       expect(store.durKey).toBe(`metrics:http:v2:${seg}:dur`)
-      expect(store.lockKey).toBe(`metrics:http:v2:${seg}:drain_lock`)
     })
   })
 
@@ -82,26 +138,51 @@ describe('HttpMetricsRedisStore', () => {
   })
 
   describe('flushToCounters', () => {
-    it('returns false when lock is not acquired', async () => {
+    it('applies aggregated count and summed duration for one route (many requests → one field)', async () => {
       const redis = createRedisV3Mock()
-      redis.set.mockImplementation((key, val, mode, ttl, nx, cb) => {
-        cb(null, null)
+      const field = buildFieldKey('GET', '/api/items', 200, '', '')
+      redis.eval.mockImplementation((lua, numKeys, k1, k2, cb) => {
+        cb(null, [
+          [field, '100'],
+          [field, '4500'],
+        ])
       })
+
       const store = new HttpMetricsRedisStore({
         redisClient: redis,
         appName: 'app',
         processType: 'web',
       })
-      const ok = await store.flushToCounters(jest.fn(), jest.fn())
-      expect(ok).toBe(false)
-      expect(redis.eval).not.toHaveBeenCalled()
+      const applyCount = jest.fn()
+      const applyDuration = jest.fn()
+
+      const ok = await store.flushToCounters(applyCount, applyDuration)
+
+      expect(ok).toBe(true)
+      expect(applyCount).toHaveBeenCalledWith(
+        {
+          method: 'GET',
+          route: '/api/items',
+          status_code: '200',
+          appId: '',
+          databaseId: '',
+        },
+        100
+      )
+      expect(applyDuration).toHaveBeenCalledWith(
+        {
+          method: 'GET',
+          route: '/api/items',
+          status_code: '200',
+          appId: '',
+          databaseId: '',
+        },
+        4500
+      )
     })
 
     it('drains hashes and applies count and duration', async () => {
       const redis = createRedisV3Mock()
-      redis.set.mockImplementation((key, val, mode, ttl, nx, cb) => {
-        cb(null, 'OK')
-      })
       const field = buildFieldKey('POST', '/r', 201, 'a1', 'd1')
       redis.eval.mockImplementation((lua, numKeys, k1, k2, cb) => {
         cb(null, [
@@ -109,11 +190,6 @@ describe('HttpMetricsRedisStore', () => {
           [field, '50'],
         ])
       })
-      redis.del.mockImplementation((key, cb) => {
-        if (cb) {
-          cb()
-        }
-      })
 
       const store = new HttpMetricsRedisStore({
         redisClient: redis,
@@ -157,17 +233,9 @@ describe('HttpMetricsRedisStore', () => {
 
     it('resolves true with no applies when eval returns short array', async () => {
       const redis = createRedisV3Mock()
-      redis.set.mockImplementation((key, val, mode, ttl, nx, cb) => {
-        cb(null, 'OK')
-      })
       redis.eval.mockImplementation((lua, numKeys, k1, k2, cb) => {
         cb(null, [])
       })
-      redis.del.mockImplementation((key, cb) => {
-        if (cb) {
-          cb()
-        }
-      })
       const store = new HttpMetricsRedisStore({
         redisClient: redis,
         appName: 'app',
@@ -179,4 +247,159 @@ describe('HttpMetricsRedisStore', () => {
       expect(applyCount).not.toHaveBeenCalled()
     })
   })
+
+  describe('in-memory integration (many fields, shared writers)', () => {
+    it('flush applies many distinct hash fields (many routes / labels)', async () => {
+      const redis = createRedisV3InMemoryMock()
+      const store = new HttpMetricsRedisStore({
+        redisClient: redis,
+        appName: 'svc',
+        processType: 'web',
+      })
+      const routes = Array.from({ length: 24 }, (_, i) => `/api/v${i % 3}/item/${i}`)
+      for (let i = 0; i < routes.length; i++) {
+        const method = i % 2 === 0 ? 'GET' : 'POST'
+        const status = i % 5 === 0 ? 500 : 200
+        store.record(method, routes[i], status, `app-${i % 4}`, `db-${i % 3}`, 10 + i)
+      }
+      expect(redis._fieldCount(store.countKey)).toBe(routes.length)
+
+      const applyCount = jest.fn()
+      const applyDuration = jest.fn()
+      const ok = await store.flushToCounters(applyCount, applyDuration)
+
+      expect(ok).toBe(true)
+      expect(applyCount).toHaveBeenCalledTimes(routes.length)
+      let sumCount = 0
+      let sumDur = 0
+      applyCount.mock.calls.forEach(([, c]) => {
+        sumCount += c
+      })
+      applyDuration.mock.calls.forEach(([, d]) => {
+        sumDur += d
+      })
+      expect(sumCount).toBe(routes.length)
+      expect(sumDur).toBe(routes.reduce((acc, _, i) => acc + (10 + i), 0))
+      expect(redis._peek(store.countKey)).toEqual({})
+    })
+
+    it('many requests for the same field aggregate to one apply (like one dyno hot route)', async () => {
+      const redis = createRedisV3InMemoryMock()
+      const store = new HttpMetricsRedisStore({
+        redisClient: redis,
+        appName: 'app',
+        processType: 'web',
+      })
+      const n = 80
+      for (let i = 0; i < n; i++) {
+        store.record('GET', '/hot', 200, 'a1', 'd1', 5)
+      }
+      expect(redis._fieldCount(store.countKey)).toBe(1)
+
+      const applyCount = jest.fn()
+      const applyDuration = jest.fn()
+      await store.flushToCounters(applyCount, applyDuration)
+
+      expect(applyCount).toHaveBeenCalledTimes(1)
+      expect(applyCount).toHaveBeenCalledWith(
+        expect.objectContaining({
+          method: 'GET',
+          route: '/hot',
+          status_code: '200',
+          appId: 'a1',
+          databaseId: 'd1',
+        }),
+        n
+      )
+      expect(applyDuration).toHaveBeenCalledWith(
+        expect.objectContaining({ route: '/hot' }),
+        n * 5
+      )
+    })
+
+    it('multiple store instances on the same redis client combine like multiple dynos', async () => {
+      const redis = createRedisV3InMemoryMock()
+      const opts = { redisClient: redis, appName: 'prod', processType: 'web' }
+      const dynoA = new HttpMetricsRedisStore(opts)
+      const dynoB = new HttpMetricsRedisStore(opts)
+
+      dynoA.record('GET', '/a', 200, '', '', 3)
+      dynoB.record('GET', '/b', 304, '', '', 7)
+      dynoA.record('POST', '/c', 201, 'x', 'y', 11)
+
+      expect(redis._fieldCount(dynoA.countKey)).toBe(3)
+
+      const applyCount = jest.fn()
+      const applyDuration = jest.fn()
+      const ok = await dynoB.flushToCounters(applyCount, applyDuration)
+
+      expect(ok).toBe(true)
+      expect(applyCount).toHaveBeenCalledTimes(3)
+      expect(applyDuration).toHaveBeenCalledTimes(3)
+    })
+
+    it('interleaved record() calls from parallel async work combine correctly', async () => {
+      const redis = createRedisV3InMemoryMock()
+      const store = new HttpMetricsRedisStore({
+        redisClient: redis,
+        appName: 'app',
+        processType: 'web',
+      })
+
+      await Promise.all(
+        [0, 1, 2, 3, 4].map(worker =>
+          Promise.all(
+            Array.from({ length: 15 }, (_, j) => {
+              const route = `/w${worker}/r${j}`
+              store.record('GET', route, 200, `app${worker}`, 'db0', 2)
+              return Promise.resolve()
+            })
+          )
+        )
+      )
+
+      expect(redis._fieldCount(store.countKey)).toBe(5 * 15)
+
+      const applyCount = jest.fn()
+      const applyDuration = jest.fn()
+      await store.flushToCounters(applyCount, applyDuration)
+
+      expect(applyCount).toHaveBeenCalledTimes(75)
+      let total = 0
+      applyCount.mock.calls.forEach(([, c]) => {
+        total += c
+      })
+      expect(total).toBe(75)
+      expect(
+        applyDuration.mock.calls.reduce((acc, [, d]) => acc + d, 0)
+      ).toBe(75 * 2)
+    })
+
+    it('mixed methods, statuses, and apps in one drain', async () => {
+      const redis = createRedisV3InMemoryMock()
+      const store = new HttpMetricsRedisStore({
+        redisClient: redis,
+        appName: 'mixed',
+        processType: 'api',
+      })
+      const samples = [
+        ['GET', '/x', 200, 'a', 'd', 1],
+        ['GET', '/x', 404, 'a', 'd', 2],
+        ['DELETE', '/x|y', 204, 'b', 'd', 3],
+      ]
+      for (const [m, r, s, a, d, dur] of samples) {
+        store.record(m, r, s, a, d, dur)
+      }
+
+      const applyCount = jest.fn()
+      const applyDuration = jest.fn()
+      await store.flushToCounters(applyCount, applyDuration)
+
+      expect(applyCount).toHaveBeenCalledTimes(3)
+      expect(applyCount.mock.calls.map(([{ method, route, status_code }]) => `${method} ${route} ${status_code}`).sort()).toEqual(
+        ['DELETE /x|y 204', 'GET /x 200', 'GET /x 404'].sort()
+      )
+      expect(applyDuration.mock.calls.reduce((acc, [, v]) => acc + v, 0)).toBe(6)
+    })
+  })
 })

package/lib/metrics/httpMetricsRedisRecorder.d.ts

@@ -8,14 +8,14 @@ export class HttpMetricsRedisRecorder {
     /**
      * @param {Object} opts
      * @param {import('redis').RedisClient} opts.redisClient **Required.** Injected client (same pattern as {@link RedisMetricsClient}).
-     * @param {string} opts.appName Application name (must match collector; typically `BUILD_APP_NAME`).
-     * @param {string} opts.processType Logical process segment in Redis keys (e.g. `web`; must match collector’s key segment).
+     * @param {string} [opts.appName] Optional override; default same as {@link BaseMetricsClient}: `BUILD_APP_NAME` or `unknown-app`.
+     * @param {string} [opts.processType] Redis key segment (default **`web`**, same as {@link HttpMetricsRedisCollector}).
      * @param {number} [opts.ttlSec] Redis hash key TTL in seconds (sliding; default 120).
      */
-    constructor({ redisClient, appName, processType, ttlSec }: {
+    constructor({ redisClient, appName, processType, ttlSec }?: {
         redisClient: import('redis').RedisClient;
-        appName: string;
-        processType: string;
+        appName?: string | undefined;
+        processType?: string | undefined;
         ttlSec?: number | undefined;
     });
     processType: string;

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

@@ -1 +1 @@
-{"version":3,"file":"httpMetricsRedisRecorder.d.ts","sourceRoot":"","sources":["../../src/metrics/httpMetricsRedisRecorder.js"],"names":[],"mappings":"AASA;;;;;GAKG;AACH;IACE;;;;;;OAMG;IACH;QAL6C,WAAW,EAA7C,OAAO,OAAO,EAAE,WAAW;QACd,OAAO,EAApB,MAAM;QACO,WAAW,EAAxB,MAAM;QACQ,MAAM;OAc9B;IARC,oBAA8B;IAC9B,gBAAsB;IACtB,8BAKE;IAGJ;;;;;;;;OAQG;IACH;QAP0B,MAAM,EAArB,MAAM;QACS,KAAK,EAApB,MAAM;QACS,WAAW,EAA1B,MAAM;QACU,KAAK;QACL,UAAU;QACX,QAAQ,EAAvB,MAAM;aAgBhB;IAED;;;;;;;OAOG;IACH,kCAJW,OAAO,MAAM,EAAE,eAAe,OAC9B,OAAO,MAAM,EAAE,cAAc,0BAkCvC;CACF"}
+{"version":3,"file":"httpMetricsRedisRecorder.d.ts","sourceRoot":"","sources":["../../src/metrics/httpMetricsRedisRecorder.js"],"names":[],"mappings":"AAOA;;;;;GAKG;AACH;IACE;;;;;;OAMG;IACH;QAL6C,WAAW,EAA7C,OAAO,OAAO,EAAE,WAAW;QACb,OAAO;QACP,WAAW;QACX,MAAM;OAe9B;IARC,oBAA8B;IAC9B,gBAA8B;IAC9B,8BAKE;IAGJ;;;;;;;;OAQG;IACH;QAP0B,MAAM,EAArB,MAAM;QACS,KAAK,EAApB,MAAM;QACS,WAAW,EAA1B,MAAM;QACU,KAAK;QACL,UAAU;QACX,QAAQ,EAAvB,MAAM;aAiBhB;IAED;;;;;;;OAOG;IACH,kCAJW,OAAO,MAAM,EAAE,eAAe,OAC9B,OAAO,MAAM,EAAE,cAAc,0BAkCvC;CACF"}

package/lib/metrics/httpMetricsRedisRecorder.js

@@ -1,9 +1,9 @@
 "use strict";
 
 const {
-  HttpMetricsRedisStore
+  HttpMetricsRedisStore,
+  httpMetricsTraceLog
 } = require('./httpMetricsRedisStore');
-const LOG = '[http-metrics-redis]';
 function trunc(s, max = 120) {
   const t = String(s);
   return t.length > max ? `${t.slice(0, max - 3)}...` : t;
@@ -19,24 +19,25 @@ class HttpMetricsRedisRecorder {
   /**
    * @param {Object} opts
    * @param {import('redis').RedisClient} opts.redisClient **Required.** Injected client (same pattern as {@link RedisMetricsClient}).
-   * @param {string} opts.appName Application name (must match collector; typically `BUILD_APP_NAME`).
-   * @param {string} opts.processType Logical process segment in Redis keys (e.g. `web`; must match collector’s key segment).
+   * @param {string} [opts.appName] Optional override; default same as {@link BaseMetricsClient}: `BUILD_APP_NAME` or `unknown-app`.
+   * @param {string} [opts.processType] Redis key segment (default **`web`**, same as {@link HttpMetricsRedisCollector}).
    * @param {number} [opts.ttlSec] Redis hash key TTL in seconds (sliding; default 120).
    */
   constructor({
     redisClient,
     appName,
-    processType,
+    processType = 'web',
     ttlSec
-  }) {
+  } = {}) {
     if (redisClient == null) {
       throw new Error('HttpMetricsRedisRecorder: redisClient is required');
     }
+    const resolvedAppName = appName || process.env.BUILD_APP_NAME || 'unknown-app';
     this.processType = processType;
-    this.appName = appName;
+    this.appName = resolvedAppName;
     this._store = new HttpMetricsRedisStore({
       redisClient,
-      appName,
+      appName: resolvedAppName,
       processType,
       ttlSec
     });
@@ -59,7 +60,7 @@ class HttpMetricsRedisRecorder {
     databaseId = '',
     duration
   }) {
-    console.warn(`${LOG} 1_track pid=${process.pid} app=${this.appName} segment=${this.processType} ` + `method=${method} route=${trunc(route)} status=${status_code} durationMs=${duration} ` + `appId=${trunc(appId || '—', 40)} databaseId=${trunc(databaseId || '—', 40)}`);
+    httpMetricsTraceLog(`track_request pid=${process.pid} app=${this.appName} segment=${this.processType} ` + `method=${method} route=${trunc(route)} status=${status_code} durationMs=${duration} ` + `appId=${trunc(appId || '—', 40)} databaseId=${trunc(databaseId || '—', 40)} ` + `(then save_to_redis lines from store)`);
     this._store.record(method, route, status_code, appId, databaseId, duration);
   }
 

package/lib/metrics/httpMetricsRedisRecorder.js.map

@@ -1 +1 @@
-{"version":3,"file":"httpMetricsRedisRecorder.js","names":["HttpMetricsRedisStore","require","LOG","trunc","s","max","t","String","length","slice","HttpMetricsRedisRecorder","constructor","redisClient","appName","processType","ttlSec","Error","_store","trackHttpRequest","method","route","status_code","appId","databaseId","duration","console","warn","process","pid","record","trackHttpRequestMiddleware","req","res","next","start","Date","now","on","path","params","body","query","datasourceId","statusCode","module","exports"],"sources":["../../src/metrics/httpMetricsRedisRecorder.js"],"sourcesContent":["const { HttpMetricsRedisStore } = require('./httpMetricsRedisStore')\n\nconst LOG = '[http-metrics-redis]'\n\nfunction trunc(s, max = 120) {\n  const t = String(s)\n  return t.length > max ? `${t.slice(0, max - 3)}...` : t\n}\n\n/**\n * Records HTTP request aggregates only to Redis (no in-process Prometheus counters on this path).\n * Pair with {@link HttpMetricsRedisCollector} on a drain process to flush into counters and push to the VM-agent.\n *\n * @see HttpMetricsRedisStore\n */\nclass HttpMetricsRedisRecorder {\n  /**\n   * @param {Object} opts\n   * @param {import('redis').RedisClient} opts.redisClient **Required.** Injected client (same pattern as {@link RedisMetricsClient}).\n   * @param {string} opts.appName Application name (must match collector; typically `BUILD_APP_NAME`).\n   * @param {string} opts.processType Logical process segment in Redis keys (e.g. `web`; must match collector’s key segment).\n   * @param {number} [opts.ttlSec] Redis hash key TTL in seconds (sliding; default 120).\n   */\n  constructor({ redisClient, appName, processType, ttlSec }) {\n    if (redisClient == null) {\n      throw new Error('HttpMetricsRedisRecorder: redisClient is required')\n    }\n    this.processType = processType\n    this.appName = appName\n    this._store = new HttpMetricsRedisStore({\n      redisClient,\n      appName,\n      processType,\n      ttlSec,\n    })\n  }\n\n  /**\n   * @param {Object} params\n   * @param {string} params.method\n   * @param {string} params.route\n   * @param {number} params.status_code\n   * @param {string} [params.appId]\n   * @param {string} [params.databaseId]\n   * @param {number} params.duration\n   */\n  trackHttpRequest({\n    method,\n    route,\n    status_code,\n    appId = '',\n    databaseId = '',\n    duration,\n  }) {\n    console.warn(\n      `${LOG} 1_track pid=${process.pid} app=${this.appName} segment=${this.processType} ` +\n        `method=${method} route=${trunc(route)} status=${status_code} durationMs=${duration} ` +\n        `appId=${trunc(appId || '—', 40)} databaseId=${trunc(databaseId || '—', 40)}`\n    )\n    this._store.record(method, route, status_code, appId, databaseId, duration)\n  }\n\n  /**\n   * Express middleware: appends a `finish` listener and writes one aggregate row per request to Redis.\n   * Does not check `METRICS_ENABLED`; the app should only mount this when HTTP Redis metrics should run.\n   *\n   * @param {import('http').IncomingMessage} req\n   * @param {import('http').ServerResponse} res\n   * @param {function} next\n   */\n  trackHttpRequestMiddleware = (req, res, next) => {\n    if (req.method === 'OPTIONS') {\n      next()\n      return\n    }\n\n    const start = Date.now()\n    res.on('finish', () => {\n      const route = req.route?.path || req.path || 'unknown'\n      const appId =\n        req.params?.appId || req.body?.appId || req.query?.appId || ''\n      const databaseId =\n        req.params?.databaseId ||\n        req.body?.databaseId ||\n        req.query?.databaseId ||\n        req.params?.datasourceId ||\n        req.body?.datasourceId ||\n        req.query?.datasourceId ||\n        ''\n\n      this.trackHttpRequest({\n        method: req.method,\n        route,\n        status_code: res.statusCode,\n        appId,\n        databaseId,\n        duration: Date.now() - start,\n      })\n    })\n\n    next()\n  }\n}\n\nmodule.exports = { HttpMetricsRedisRecorder }\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"httpMetricsRedisRecorder.js","names":["HttpMetricsRedisStore","httpMetricsTraceLog","require","trunc","s","max","t","String","length","slice","HttpMetricsRedisRecorder","constructor","redisClient","appName","processType","ttlSec","Error","resolvedAppName","process","env","BUILD_APP_NAME","_store","trackHttpRequest","method","route","status_code","appId","databaseId","duration","pid","record","trackHttpRequestMiddleware","req","res","next","start","Date","now","on","path","params","body","query","datasourceId","statusCode","module","exports"],"sources":["../../src/metrics/httpMetricsRedisRecorder.js"],"sourcesContent":["const { HttpMetricsRedisStore, httpMetricsTraceLog } = require('./httpMetricsRedisStore')\n\nfunction trunc(s, max = 120) {\n  const t = String(s)\n  return t.length > max ? `${t.slice(0, max - 3)}...` : t\n}\n\n/**\n * Records HTTP request aggregates only to Redis (no in-process Prometheus counters on this path).\n * Pair with {@link HttpMetricsRedisCollector} on a drain process to flush into counters and push to the VM-agent.\n *\n * @see HttpMetricsRedisStore\n */\nclass HttpMetricsRedisRecorder {\n  /**\n   * @param {Object} opts\n   * @param {import('redis').RedisClient} opts.redisClient **Required.** Injected client (same pattern as {@link RedisMetricsClient}).\n   * @param {string} [opts.appName] Optional override; default same as {@link BaseMetricsClient}: `BUILD_APP_NAME` or `unknown-app`.\n   * @param {string} [opts.processType] Redis key segment (default **`web`**, same as {@link HttpMetricsRedisCollector}).\n   * @param {number} [opts.ttlSec] Redis hash key TTL in seconds (sliding; default 120).\n   */\n  constructor({ redisClient, appName, processType = 'web', ttlSec } = {}) {\n    if (redisClient == null) {\n      throw new Error('HttpMetricsRedisRecorder: redisClient is required')\n    }\n    const resolvedAppName = appName || process.env.BUILD_APP_NAME || 'unknown-app'\n    this.processType = processType\n    this.appName = resolvedAppName\n    this._store = new HttpMetricsRedisStore({\n      redisClient,\n      appName: resolvedAppName,\n      processType,\n      ttlSec,\n    })\n  }\n\n  /**\n   * @param {Object} params\n   * @param {string} params.method\n   * @param {string} params.route\n   * @param {number} params.status_code\n   * @param {string} [params.appId]\n   * @param {string} [params.databaseId]\n   * @param {number} params.duration\n   */\n  trackHttpRequest({\n    method,\n    route,\n    status_code,\n    appId = '',\n    databaseId = '',\n    duration,\n  }) {\n    httpMetricsTraceLog(\n      `track_request pid=${process.pid} app=${this.appName} segment=${this.processType} ` +\n        `method=${method} route=${trunc(route)} status=${status_code} durationMs=${duration} ` +\n        `appId=${trunc(appId || '—', 40)} databaseId=${trunc(databaseId || '—', 40)} ` +\n        `(then save_to_redis lines from store)`\n    )\n    this._store.record(method, route, status_code, appId, databaseId, duration)\n  }\n\n  /**\n   * Express middleware: appends a `finish` listener and writes one aggregate row per request to Redis.\n   * Does not check `METRICS_ENABLED`; the app should only mount this when HTTP Redis metrics should run.\n   *\n   * @param {import('http').IncomingMessage} req\n   * @param {import('http').ServerResponse} res\n   * @param {function} next\n   */\n  trackHttpRequestMiddleware = (req, res, next) => {\n    if (req.method === 'OPTIONS') {\n      next()\n      return\n    }\n\n    const start = Date.now()\n    res.on('finish', () => {\n      const route = req.route?.path || req.path || 'unknown'\n      const appId =\n        req.params?.appId || req.body?.appId || req.query?.appId || ''\n      const databaseId =\n        req.params?.databaseId ||\n        req.body?.databaseId ||\n        req.query?.databaseId ||\n        req.params?.datasourceId ||\n        req.body?.datasourceId ||\n        req.query?.datasourceId ||\n        ''\n\n      this.trackHttpRequest({\n        method: req.method,\n        route,\n        status_code: res.statusCode,\n        appId,\n        databaseId,\n        duration: Date.now() - start,\n      })\n    })\n\n    next()\n  }\n}\n\nmodule.exports = { HttpMetricsRedisRecorder }\n"],"mappings":"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","ignoreList":[]}

package/lib/metrics/httpMetricsRedisStore.d.ts

@@ -1,9 +1,12 @@
 /**
  * Redis HTTP aggregate store. Uses an **injected** client (same pattern as {@link RedisMetricsClient}).
- * Expects `redis` v3-style API: `multi().hincrby().expire().exec(cb)`, `eval`, `set`, `del`.
+ * Expects `redis` v3-style API: `multi().hincrby().expire().exec(cb)`, `eval`.
  *
- * **Stored metrics:** two hashes per app/segment — `:count` (HINCRBY per route group) and `:dur`
- * (sum of duration ms per same field). Hash field = `method\\x1eroute\\x1estatus\\x1eappId\\x1edatabaseId`.
+ * **Structure:** `countKey` / `durKey` are each **one Redis hash**. The hash has **many fields** — not
+ * one bucket for all traffic. Each **field name** encodes one label group `(method, route, status_code,
+ * appId, databaseId)`. The **value** in `:count` is **HINCRBY 1** per request for that group; in `:dur`
+ * it is **HINCRBY** of that request’s **duration ms** (so many requests → summed ms per same field).
+ * Different routes → different hash fields. Drain runs atomic Lua (HGETALL + DEL) per tick.
  */
 export class HttpMetricsRedisStore {
     /**
@@ -23,7 +26,6 @@ export class HttpMetricsRedisStore {
     ttlSec: number;
     countKey: string;
     durKey: string;
-    lockKey: string;
     /**
      * @returns {import('redis').RedisClient}
      * @private
@@ -68,4 +70,10 @@ export function isRedisPeerInstalled(): boolean;
  * @type {number}
  */
 export const DEFAULT_HTTP_METRICS_REDIS_TTL_SEC: number;
+/**
+ * Trace line for SAVE (web → Redis) and GET/drain (collector ← Redis). Emits **stdout + stderr**
+ * so hosts that treat streams differently still show something.
+ * @param {string} body - Line body after `[http-metrics-redis]` prefix.
+ */
+export function httpMetricsTraceLog(body: string): void;
 //# sourceMappingURL=httpMetricsRedisStore.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"httpMetricsRedisStore.d.ts","sourceRoot":"","sources":["../../src/metrics/httpMetricsRedisStore.js"],"names":[],"mappings":"AA0DA;;;;;;GAMG;AACH;IACE;;;;;;OAMG;IACH;QAL6C,WAAW,EAA7C,OAAO,OAAO,EAAE,WAAW;QACd,OAAO,EAApB,MAAM;QACO,WAAW,EAAxB,MAAM;QACQ,MAAM;OAiB9B;IAXC,qCAA0B;IAC1B,eAGwC;IAIxC,iBAAiD;IACjD,eAA6C;IAC7C,gBAAqD;IAGvD;;;OAGG;IACH,sBAEC;IAED;;;;;;;OAOG;IACH,eAPW,MAAM,SACN,MAAM,cACN,MAAM,SACN,MAAM,cACN,MAAM,cACN,MAAM,QAyBhB;IAED;;;;OAIG;IACH,qCAJoB,MAAM,SAAS,MAAM,KAAK,IAAI,0BAC9B,MAAM,SAAS,MAAM,KAAK,IAAI,GACrC,QAAQ,OAAO,CAAC,CAgG5B;CACF;AApMD;;;;;;;GAOG;AACH,sCAPW,MAAM,SACN,MAAM,cACN,MAAM,SACN,MAAM,cACN,MAAM,GACJ,MAAM,CAIlB;AA7CD;;;GAGG;AACH,wBAFU,MAAM,CAEQ;AAmBxB;;GAEG;AACH,wCAFa,OAAO,CASnB;AA3BD;;;GAGG;AACH,iDAFU,MAAM,CAE8B"}
+{"version":3,"file":"httpMetricsRedisStore.d.ts","sourceRoot":"","sources":["../../src/metrics/httpMetricsRedisStore.js"],"names":[],"mappings":"AA+FA;;;;;;;;;GASG;AACH;IACE;;;;;;OAMG;IACH;QAL6C,WAAW,EAA7C,OAAO,OAAO,EAAE,WAAW;QACd,OAAO,EAApB,MAAM;QACO,WAAW,EAAxB,MAAM;QACQ,MAAM;OAgB9B;IAVC,qCAA0B;IAC1B,eAGwC;IAIxC,iBAAiD;IACjD,eAA6C;IAG/C;;;OAGG;IACH,sBAEC;IAED;;;;;;;OAOG;IACH,eAPW,MAAM,SACN,MAAM,cACN,MAAM,SACN,MAAM,cACN,MAAM,cACN,MAAM,QA6BhB;IAED;;;;OAIG;IACH,qCAJoB,MAAM,SAAS,MAAM,KAAK,IAAI,0BAC9B,MAAM,SAAS,MAAM,KAAK,IAAI,GACrC,QAAQ,OAAO,CAAC,CAqF5B;CACF;AA/LD;;;;;;;GAOG;AACH,sCAPW,MAAM,SACN,MAAM,cACN,MAAM,SACN,MAAM,cACN,MAAM,GACJ,MAAM,CAIlB;AAlFD;;;GAGG;AACH,wBAFU,MAAM,CAEQ;AAwDxB;;GAEG;AACH,wCAFa,OAAO,CASnB;AAhED;;;GAGG;AACH,iDAFU,MAAM,CAE8B;AA0B9C;;;;GAIG;AACH,0CAFW,MAAM,QAUhB"}

package/lib/metrics/httpMetricsRedisStore.js

@@ -12,6 +12,42 @@ const FIELD_SEP = '\x1e';
  */
 const DEFAULT_HTTP_METRICS_REDIS_TTL_SEC = 120;
 const LOG = '[http-metrics-redis]';
+
+/**
+ * When Node runs behind `cluster`, HTTP is usually served from workers — include worker id in traces.
+ * @returns {string}
+ */
+function clusterHint() {
+  try {
+    // eslint-disable-next-line global-require
+    const c = require('cluster');
+    if (c.isWorker && c.worker != null) {
+      return ` cluster_worker=${c.worker.id}`;
+    }
+  } catch (_) {
+    /* cluster not in use */
+  }
+  return '';
+}
+function truncField(s, max = 96) {
+  const t = String(s);
+  return t.length > max ? `${t.slice(0, max - 3)}...` : t;
+}
+
+/**
+ * Trace line for SAVE (web → Redis) and GET/drain (collector ← Redis). Emits **stdout + stderr**
+ * so hosts that treat streams differently still show something.
+ * @param {string} body - Line body after `[http-metrics-redis]` prefix.
+ */
+function httpMetricsTraceLog(body) {
+  const line = `${LOG} ${body}${clusterHint()}`;
+  console.log(line);
+  try {
+    process.stderr.write(`${line}\n`);
+  } catch (_) {
+    /* ignore */
+  }
+}
 const DRAIN_LUA = `
 local function drain(key)
   local v = redis.call('HGETALL', key)
@@ -57,10 +93,13 @@ function hgetallPairsToObject(pairs) {
 
 /**
  * Redis HTTP aggregate store. Uses an **injected** client (same pattern as {@link RedisMetricsClient}).
- * Expects `redis` v3-style API: `multi().hincrby().expire().exec(cb)`, `eval`, `set`, `del`.
+ * Expects `redis` v3-style API: `multi().hincrby().expire().exec(cb)`, `eval`.
  *
- * **Stored metrics:** two hashes per app/segment — `:count` (HINCRBY per route group) and `:dur`
- * (sum of duration ms per same field). Hash field = `method\\x1eroute\\x1estatus\\x1eappId\\x1edatabaseId`.
+ * **Structure:** `countKey` / `durKey` are each **one Redis hash**. The hash has **many fields** — not
+ * one bucket for all traffic. Each **field name** encodes one label group `(method, route, status_code,
+ * appId, databaseId)`. The **value** in `:count` is **HINCRBY 1** per request for that group; in `:dur`
+ * it is **HINCRBY** of that request’s **duration ms** (so many requests → summed ms per same field).
+ * Different routes → different hash fields. Drain runs atomic Lua (HGETALL + DEL) per tick.
  */
 class HttpMetricsRedisStore {
   /**
@@ -84,7 +123,6 @@ class HttpMetricsRedisStore {
     const keySeg = `${encodeURIComponent(appName)}:${encodeURIComponent(processType)}`;
     this.countKey = `metrics:http:v2:${keySeg}:count`;
     this.durKey = `metrics:http:v2:${keySeg}:dur`;
-    this.lockKey = `metrics:http:v2:${keySeg}:drain_lock`;
   }
 
   /**
@@ -108,12 +146,13 @@ class HttpMetricsRedisStore {
       const client = this._ensureClient();
       const field = buildFieldKey(method, route, statusCode, appId, databaseId);
       const dur = Math.max(0, Math.round(Number(durationMs) || 0));
+      httpMetricsTraceLog(`save_to_redis pid=${process.pid} countKey=${this.countKey} ` + `durKey=${this.durKey} field=${truncField(field)} durationMs=${dur} (before MULTI/EXEC)`);
       client.multi().hincrby(this.countKey, field, 1).hincrby(this.durKey, field, dur).expire(this.countKey, this.ttlSec).expire(this.durKey, this.ttlSec).exec(err => {
         if (err) {
           console.error('[HttpMetricsRedisStore] record failed:', err.message);
           return;
         }
-        console.warn(`${LOG} 2_redis_write pid=${process.pid} countKey=${this.countKey} durKey=${this.durKey} ok`);
+        httpMetricsTraceLog(`save_to_redis_ok pid=${process.pid} countKey=${this.countKey} durKey=${this.durKey} (after MULTI/EXEC)`);
       });
     } catch (e) {
       console.error('[HttpMetricsRedisStore] record:', e.message);
@@ -134,65 +173,57 @@ class HttpMetricsRedisStore {
       return Promise.resolve(false);
     }
     return new Promise(resolve => {
-      client.set(this.lockKey, '1', 'EX', 25, 'NX', (setErr, ok) => {
-        if (setErr || ok !== 'OK') {
-          console.warn(`${LOG} 3_redis_drain_skip pid=${process.pid} countKey=${this.countKey} reason=${setErr ? `error:${setErr.message}` : 'lock_not_acquired'}`);
+      httpMetricsTraceLog(`get_from_redis_try pid=${process.pid} countKey=${this.countKey} (EVAL drain)`);
+      client.eval(DRAIN_LUA, 2, this.countKey, this.durKey, (evalErr, raw) => {
+        if (evalErr) {
+          console.error('[HttpMetricsRedisStore] drain failed:', evalErr.message);
           resolve(false);
           return;
         }
-        client.eval(DRAIN_LUA, 2, this.countKey, this.durKey, (evalErr, raw) => {
-          const finish = () => {
-            client.del(this.lockKey, () => resolve(true));
-          };
-          if (evalErr) {
-            console.error('[HttpMetricsRedisStore] drain failed:', evalErr.message);
-            finish();
+        try {
+          if (!raw || !Array.isArray(raw) || raw.length < 2) {
+            httpMetricsTraceLog(`get_from_redis_empty pid=${process.pid} countKey=${this.countKey} hash_fields=0 sum_requests=0 (lua returned no pairs)`);
+            resolve(true);
             return;
           }
-          try {
-            if (!raw || !Array.isArray(raw) || raw.length < 2) {
-              console.warn(`${LOG} 3_redis_drain pid=${process.pid} countKey=${this.countKey} hash_fields=0 sum_requests=0 (empty_after_lua)`);
-              finish();
-              return;
+          const counts = hgetallPairsToObject(raw[0]);
+          const durs = hgetallPairsToObject(raw[1]);
+          const fieldKeys = Object.keys(counts);
+          let sumRequests = 0;
+          const samples = [];
+          for (const field of fieldKeys) {
+            const count = parseInt(counts[field], 10);
+            if (!count || count < 1) {
+              continue;
             }
-            const counts = hgetallPairsToObject(raw[0]);
-            const durs = hgetallPairsToObject(raw[1]);
-            const fieldKeys = Object.keys(counts);
-            let sumRequests = 0;
-            const samples = [];
-            for (const field of fieldKeys) {
-              const count = parseInt(counts[field], 10);
-              if (!count || count < 1) {
-                continue;
-              }
-              const dur = parseInt(durs[field] || '0', 10) || 0;
-              const parts = field.split(FIELD_SEP);
-              if (parts.length !== 5) {
-                continue;
-              }
-              const [m, route, statusStr, aid, did] = parts;
-              sumRequests += count;
-              if (samples.length < 3) {
-                samples.push(`${m} ${route} ${statusStr} x${count}`);
-              }
-              const labels = {
-                method: m,
-                route,
-                status_code: statusStr,
-                appId: aid,
-                databaseId: did
-              };
-              applyCount(labels, count);
-              if (dur > 0) {
-                applyDuration(labels, dur);
-              }
+            const dur = parseInt(durs[field] || '0', 10) || 0;
+            const parts = field.split(FIELD_SEP);
+            if (parts.length !== 5) {
+              continue;
+            }
+            const [m, route, statusStr, aid, did] = parts;
+            sumRequests += count;
+            if (samples.length < 3) {
+              samples.push(`${m} ${route} ${statusStr} x${count}`);
+            }
+            const labels = {
+              method: m,
+              route,
+              status_code: statusStr,
+              appId: aid,
+              databaseId: did
+            };
+            applyCount(labels, count);
+            if (dur > 0) {
+              applyDuration(labels, dur);
             }
-            console.warn(`${LOG} 3_redis_drain pid=${process.pid} countKey=${this.countKey} hash_fields=${fieldKeys.length} sum_requests=${sumRequests} sample=${samples.join(' | ') || '—'}`);
-          } catch (e) {
-            console.error('[HttpMetricsRedisStore] flush apply failed:', e.message);
           }
-          finish();
-        });
+          httpMetricsTraceLog(`get_from_redis_ok pid=${process.pid} countKey=${this.countKey} hash_fields=${fieldKeys.length} sum_requests=${sumRequests} sample=${samples.join(' | ') || '—'}`);
+          resolve(true);
+        } catch (e) {
+          console.error('[HttpMetricsRedisStore] flush apply failed:', e.message);
+          resolve(false);
+        }
       });
     });
   }
@@ -202,6 +233,7 @@ module.exports = {
   buildFieldKey,
   FIELD_SEP,
   isRedisPeerInstalled,
-  DEFAULT_HTTP_METRICS_REDIS_TTL_SEC
+  DEFAULT_HTTP_METRICS_REDIS_TTL_SEC,
+  httpMetricsTraceLog
 };
 //# sourceMappingURL=httpMetricsRedisStore.js.map

package/lib/metrics/httpMetricsRedisStore.js.map

@@ -1 +1 @@
-{"version":3,"file":"httpMetricsRedisStore.js","names":["FIELD_SEP","DEFAULT_HTTP_METRICS_REDIS_TTL_SEC","LOG","DRAIN_LUA","isRedisPeerInstalled","require","resolve","buildFieldKey","method","route","statusCode","appId","databaseId","String","join","hgetallPairsToObject","pairs","o","length","i","HttpMetricsRedisStore","constructor","redisClient","appName","processType","ttlSec","Error","_client","keySeg","encodeURIComponent","countKey","durKey","lockKey","_ensureClient","record","durationMs","client","field","dur","Math","max","round","Number","multi","hincrby","expire","exec","err","console","error","message","warn","process","pid","e","flushToCounters","applyCount","applyDuration","Promise","set","setErr","ok","eval","evalErr","raw","finish","del","Array","isArray","counts","durs","fieldKeys","Object","keys","sumRequests","samples","count","parseInt","parts","split","m","statusStr","aid","did","push","labels","status_code","module","exports"],"sources":["../../src/metrics/httpMetricsRedisStore.js"],"sourcesContent":["/**\n * Record separator for hash fields (avoids collisions when route contains \"|\").\n * @type {string}\n */\nconst FIELD_SEP = '\\x1e'\n\n/**\n * Default Redis key TTL in seconds (sliding: refreshed on each `record` write).\n * @type {number}\n */\nconst DEFAULT_HTTP_METRICS_REDIS_TTL_SEC = 120\n\nconst LOG = '[http-metrics-redis]'\n\nconst DRAIN_LUA = `\nlocal function drain(key)\n  local v = redis.call('HGETALL', key)\n  redis.call('DEL', key)\n  return v\nend\nreturn {drain(KEYS[1]), drain(KEYS[2])}\n`\n\n/**\n * @returns {boolean} Whether the `redis` npm package is resolvable (optional peer).\n */\nfunction isRedisPeerInstalled() {\n  try {\n    require.resolve('redis')\n    return true\n  } catch {\n    return false\n  }\n}\n\n/**\n * @param {string} method\n * @param {string} route\n * @param {number} statusCode\n * @param {string} appId\n * @param {string} databaseId\n * @returns {string}\n */\nfunction buildFieldKey(method, route, statusCode, appId, databaseId) {\n  return [method, route, String(statusCode), appId, databaseId].join(FIELD_SEP)\n}\n\nfunction hgetallPairsToObject(pairs) {\n  const o = {}\n  if (!pairs || !pairs.length) {\n    return o\n  }\n  for (let i = 0; i < pairs.length; i += 2) {\n    o[pairs[i]] = pairs[i + 1]\n  }\n  return o\n}\n\n/**\n * Redis HTTP aggregate store. Uses an **injected** client (same pattern as {@link RedisMetricsClient}).\n * Expects `redis` v3-style API: `multi().hincrby().expire().exec(cb)`, `eval`, `set`, `del`.\n *\n * **Stored metrics:** two hashes per app/segment — `:count` (HINCRBY per route group) and `:dur`\n * (sum of duration ms per same field). Hash field = `method\\\\x1eroute\\\\x1estatus\\\\x1eappId\\\\x1edatabaseId`.\n */\nclass HttpMetricsRedisStore {\n  /**\n   * @param {Object} opts\n   * @param {import('redis').RedisClient} opts.redisClient\n   * @param {string} opts.appName BUILD_APP_NAME (key segment)\n   * @param {string} opts.processType logical process for key (e.g. web)\n   * @param {number} [opts.ttlSec] Expire keys after this many seconds (default 120)\n   */\n  constructor({ redisClient, appName, processType, ttlSec }) {\n    if (redisClient == null) {\n      throw new Error('HttpMetricsRedisStore: redisClient is required')\n    }\n    this._client = redisClient\n    this.ttlSec =\n      typeof ttlSec === 'number' && ttlSec > 0\n        ? ttlSec\n        : DEFAULT_HTTP_METRICS_REDIS_TTL_SEC\n    const keySeg = `${encodeURIComponent(appName)}:${encodeURIComponent(\n      processType\n    )}`\n    this.countKey = `metrics:http:v2:${keySeg}:count`\n    this.durKey = `metrics:http:v2:${keySeg}:dur`\n    this.lockKey = `metrics:http:v2:${keySeg}:drain_lock`\n  }\n\n  /**\n   * @returns {import('redis').RedisClient}\n   * @private\n   */\n  _ensureClient() {\n    return this._client\n  }\n\n  /**\n   * @param {string} method\n   * @param {string} route\n   * @param {number} statusCode\n   * @param {string} appId\n   * @param {string} databaseId\n   * @param {number} durationMs\n   */\n  record(method, route, statusCode, appId, databaseId, durationMs) {\n    try {\n      const client = this._ensureClient()\n      const field = buildFieldKey(method, route, statusCode, appId, databaseId)\n      const dur = Math.max(0, Math.round(Number(durationMs) || 0))\n      client\n        .multi()\n        .hincrby(this.countKey, field, 1)\n        .hincrby(this.durKey, field, dur)\n        .expire(this.countKey, this.ttlSec)\n        .expire(this.durKey, this.ttlSec)\n        .exec(err => {\n          if (err) {\n            console.error('[HttpMetricsRedisStore] record failed:', err.message)\n            return\n          }\n          console.warn(\n            `${LOG} 2_redis_write pid=${process.pid} countKey=${this.countKey} durKey=${this.durKey} ok`\n          )\n        })\n    } catch (e) {\n      console.error('[HttpMetricsRedisStore] record:', e.message)\n    }\n  }\n\n  /**\n   * @param {(labels: Object, value: number) => void} applyCount\n   * @param {(labels: Object, value: number) => void} applyDuration\n   * @returns {Promise<boolean>}\n   */\n  flushToCounters(applyCount, applyDuration) {\n    let client\n    try {\n      client = this._ensureClient()\n    } catch (e) {\n      console.error('[HttpMetricsRedisStore] flush:', e.message)\n      return Promise.resolve(false)\n    }\n    return new Promise(resolve => {\n      client.set(this.lockKey, '1', 'EX', 25, 'NX', (setErr, ok) => {\n        if (setErr || ok !== 'OK') {\n          console.warn(\n            `${LOG} 3_redis_drain_skip pid=${process.pid} countKey=${this.countKey} reason=${\n              setErr ? `error:${setErr.message}` : 'lock_not_acquired'\n            }`\n          )\n          resolve(false)\n          return\n        }\n        client.eval(\n          DRAIN_LUA,\n          2,\n          this.countKey,\n          this.durKey,\n          (evalErr, raw) => {\n            const finish = () => {\n              client.del(this.lockKey, () => resolve(true))\n            }\n\n            if (evalErr) {\n              console.error(\n                '[HttpMetricsRedisStore] drain failed:',\n                evalErr.message\n              )\n              finish()\n              return\n            }\n\n            try {\n              if (!raw || !Array.isArray(raw) || raw.length < 2) {\n                console.warn(\n                  `${LOG} 3_redis_drain pid=${process.pid} countKey=${this.countKey} hash_fields=0 sum_requests=0 (empty_after_lua)`\n                )\n                finish()\n                return\n              }\n              const counts = hgetallPairsToObject(raw[0])\n              const durs = hgetallPairsToObject(raw[1])\n              const fieldKeys = Object.keys(counts)\n              let sumRequests = 0\n              const samples = []\n              for (const field of fieldKeys) {\n                const count = parseInt(counts[field], 10)\n                if (!count || count < 1) {\n                  continue\n                }\n                const dur = parseInt(durs[field] || '0', 10) || 0\n                const parts = field.split(FIELD_SEP)\n                if (parts.length !== 5) {\n                  continue\n                }\n                const [m, route, statusStr, aid, did] = parts\n                sumRequests += count\n                if (samples.length < 3) {\n                  samples.push(`${m} ${route} ${statusStr} x${count}`)\n                }\n                const labels = {\n                  method: m,\n                  route,\n                  status_code: statusStr,\n                  appId: aid,\n                  databaseId: did,\n                }\n                applyCount(labels, count)\n                if (dur > 0) {\n                  applyDuration(labels, dur)\n                }\n              }\n              console.warn(\n                `${LOG} 3_redis_drain pid=${process.pid} countKey=${this.countKey} hash_fields=${\n                  fieldKeys.length\n                } sum_requests=${sumRequests} sample=${samples.join(' | ') || '—'}`\n              )\n            } catch (e) {\n              console.error(\n                '[HttpMetricsRedisStore] flush apply failed:',\n                e.message\n              )\n            }\n            finish()\n          }\n        )\n      })\n    })\n  }\n}\n\nmodule.exports = {\n  HttpMetricsRedisStore,\n  buildFieldKey,\n  FIELD_SEP,\n  isRedisPeerInstalled,\n  DEFAULT_HTTP_METRICS_REDIS_TTL_SEC,\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"httpMetricsRedisStore.js","names":["FIELD_SEP","DEFAULT_HTTP_METRICS_REDIS_TTL_SEC","LOG","clusterHint","c","require","isWorker","worker","id","_","truncField","s","max","t","String","length","slice","httpMetricsTraceLog","body","line","console","log","process","stderr","write","DRAIN_LUA","isRedisPeerInstalled","resolve","buildFieldKey","method","route","statusCode","appId","databaseId","join","hgetallPairsToObject","pairs","o","i","HttpMetricsRedisStore","constructor","redisClient","appName","processType","ttlSec","Error","_client","keySeg","encodeURIComponent","countKey","durKey","_ensureClient","record","durationMs","client","field","dur","Math","round","Number","pid","multi","hincrby","expire","exec","err","error","message","e","flushToCounters","applyCount","applyDuration","Promise","eval","evalErr","raw","Array","isArray","counts","durs","fieldKeys","Object","keys","sumRequests","samples","count","parseInt","parts","split","m","statusStr","aid","did","push","labels","status_code","module","exports"],"sources":["../../src/metrics/httpMetricsRedisStore.js"],"sourcesContent":["/**\n * Record separator for hash fields (avoids collisions when route contains \"|\").\n * @type {string}\n */\nconst FIELD_SEP = '\\x1e'\n\n/**\n * Default Redis key TTL in seconds (sliding: refreshed on each `record` write).\n * @type {number}\n */\nconst DEFAULT_HTTP_METRICS_REDIS_TTL_SEC = 120\n\nconst LOG = '[http-metrics-redis]'\n\n/**\n * When Node runs behind `cluster`, HTTP is usually served from workers — include worker id in traces.\n * @returns {string}\n */\nfunction clusterHint() {\n  try {\n    // eslint-disable-next-line global-require\n    const c = require('cluster')\n    if (c.isWorker && c.worker != null) {\n      return ` cluster_worker=${c.worker.id}`\n    }\n  } catch (_) {\n    /* cluster not in use */\n  }\n  return ''\n}\n\nfunction truncField(s, max = 96) {\n  const t = String(s)\n  return t.length > max ? `${t.slice(0, max - 3)}...` : t\n}\n\n/**\n * Trace line for SAVE (web → Redis) and GET/drain (collector ← Redis). Emits **stdout + stderr**\n * so hosts that treat streams differently still show something.\n * @param {string} body - Line body after `[http-metrics-redis]` prefix.\n */\nfunction httpMetricsTraceLog(body) {\n  const line = `${LOG} ${body}${clusterHint()}`\n  console.log(line)\n  try {\n    process.stderr.write(`${line}\\n`)\n  } catch (_) {\n    /* ignore */\n  }\n}\n\nconst DRAIN_LUA = `\nlocal function drain(key)\n  local v = redis.call('HGETALL', key)\n  redis.call('DEL', key)\n  return v\nend\nreturn {drain(KEYS[1]), drain(KEYS[2])}\n`\n\n/**\n * @returns {boolean} Whether the `redis` npm package is resolvable (optional peer).\n */\nfunction isRedisPeerInstalled() {\n  try {\n    require.resolve('redis')\n    return true\n  } catch {\n    return false\n  }\n}\n\n/**\n * @param {string} method\n * @param {string} route\n * @param {number} statusCode\n * @param {string} appId\n * @param {string} databaseId\n * @returns {string}\n */\nfunction buildFieldKey(method, route, statusCode, appId, databaseId) {\n  return [method, route, String(statusCode), appId, databaseId].join(FIELD_SEP)\n}\n\nfunction hgetallPairsToObject(pairs) {\n  const o = {}\n  if (!pairs || !pairs.length) {\n    return o\n  }\n  for (let i = 0; i < pairs.length; i += 2) {\n    o[pairs[i]] = pairs[i + 1]\n  }\n  return o\n}\n\n/**\n * Redis HTTP aggregate store. Uses an **injected** client (same pattern as {@link RedisMetricsClient}).\n * Expects `redis` v3-style API: `multi().hincrby().expire().exec(cb)`, `eval`.\n *\n * **Structure:** `countKey` / `durKey` are each **one Redis hash**. The hash has **many fields** — not\n * one bucket for all traffic. Each **field name** encodes one label group `(method, route, status_code,\n * appId, databaseId)`. The **value** in `:count` is **HINCRBY 1** per request for that group; in `:dur`\n * it is **HINCRBY** of that request’s **duration ms** (so many requests → summed ms per same field).\n * Different routes → different hash fields. Drain runs atomic Lua (HGETALL + DEL) per tick.\n */\nclass HttpMetricsRedisStore {\n  /**\n   * @param {Object} opts\n   * @param {import('redis').RedisClient} opts.redisClient\n   * @param {string} opts.appName BUILD_APP_NAME (key segment)\n   * @param {string} opts.processType logical process for key (e.g. web)\n   * @param {number} [opts.ttlSec] Expire keys after this many seconds (default 120)\n   */\n  constructor({ redisClient, appName, processType, ttlSec }) {\n    if (redisClient == null) {\n      throw new Error('HttpMetricsRedisStore: redisClient is required')\n    }\n    this._client = redisClient\n    this.ttlSec =\n      typeof ttlSec === 'number' && ttlSec > 0\n        ? ttlSec\n        : DEFAULT_HTTP_METRICS_REDIS_TTL_SEC\n    const keySeg = `${encodeURIComponent(appName)}:${encodeURIComponent(\n      processType\n    )}`\n    this.countKey = `metrics:http:v2:${keySeg}:count`\n    this.durKey = `metrics:http:v2:${keySeg}:dur`\n  }\n\n  /**\n   * @returns {import('redis').RedisClient}\n   * @private\n   */\n  _ensureClient() {\n    return this._client\n  }\n\n  /**\n   * @param {string} method\n   * @param {string} route\n   * @param {number} statusCode\n   * @param {string} appId\n   * @param {string} databaseId\n   * @param {number} durationMs\n   */\n  record(method, route, statusCode, appId, databaseId, durationMs) {\n    try {\n      const client = this._ensureClient()\n      const field = buildFieldKey(method, route, statusCode, appId, databaseId)\n      const dur = Math.max(0, Math.round(Number(durationMs) || 0))\n      httpMetricsTraceLog(\n        `save_to_redis pid=${process.pid} countKey=${this.countKey} ` +\n          `durKey=${this.durKey} field=${truncField(field)} durationMs=${dur} (before MULTI/EXEC)`\n      )\n      client\n        .multi()\n        .hincrby(this.countKey, field, 1)\n        .hincrby(this.durKey, field, dur)\n        .expire(this.countKey, this.ttlSec)\n        .expire(this.durKey, this.ttlSec)\n        .exec(err => {\n          if (err) {\n            console.error('[HttpMetricsRedisStore] record failed:', err.message)\n            return\n          }\n          httpMetricsTraceLog(\n            `save_to_redis_ok pid=${process.pid} countKey=${this.countKey} durKey=${this.durKey} (after MULTI/EXEC)`\n          )\n        })\n    } catch (e) {\n      console.error('[HttpMetricsRedisStore] record:', e.message)\n    }\n  }\n\n  /**\n   * @param {(labels: Object, value: number) => void} applyCount\n   * @param {(labels: Object, value: number) => void} applyDuration\n   * @returns {Promise<boolean>}\n   */\n  flushToCounters(applyCount, applyDuration) {\n    let client\n    try {\n      client = this._ensureClient()\n    } catch (e) {\n      console.error('[HttpMetricsRedisStore] flush:', e.message)\n      return Promise.resolve(false)\n    }\n    return new Promise(resolve => {\n      httpMetricsTraceLog(\n        `get_from_redis_try pid=${process.pid} countKey=${this.countKey} (EVAL drain)`\n      )\n      client.eval(\n        DRAIN_LUA,\n        2,\n        this.countKey,\n        this.durKey,\n        (evalErr, raw) => {\n          if (evalErr) {\n            console.error(\n              '[HttpMetricsRedisStore] drain failed:',\n              evalErr.message\n            )\n            resolve(false)\n            return\n          }\n\n          try {\n            if (!raw || !Array.isArray(raw) || raw.length < 2) {\n              httpMetricsTraceLog(\n                `get_from_redis_empty pid=${process.pid} countKey=${this.countKey} hash_fields=0 sum_requests=0 (lua returned no pairs)`\n              )\n              resolve(true)\n              return\n            }\n            const counts = hgetallPairsToObject(raw[0])\n            const durs = hgetallPairsToObject(raw[1])\n            const fieldKeys = Object.keys(counts)\n            let sumRequests = 0\n            const samples = []\n            for (const field of fieldKeys) {\n              const count = parseInt(counts[field], 10)\n              if (!count || count < 1) {\n                continue\n              }\n              const dur = parseInt(durs[field] || '0', 10) || 0\n              const parts = field.split(FIELD_SEP)\n              if (parts.length !== 5) {\n                continue\n              }\n              const [m, route, statusStr, aid, did] = parts\n              sumRequests += count\n              if (samples.length < 3) {\n                samples.push(`${m} ${route} ${statusStr} x${count}`)\n              }\n              const labels = {\n                method: m,\n                route,\n                status_code: statusStr,\n                appId: aid,\n                databaseId: did,\n              }\n              applyCount(labels, count)\n              if (dur > 0) {\n                applyDuration(labels, dur)\n              }\n            }\n            httpMetricsTraceLog(\n              `get_from_redis_ok pid=${process.pid} countKey=${this.countKey} hash_fields=${\n                fieldKeys.length\n              } sum_requests=${sumRequests} sample=${samples.join(' | ') || '—'}`\n            )\n            resolve(true)\n          } catch (e) {\n            console.error(\n              '[HttpMetricsRedisStore] flush apply failed:',\n              e.message\n            )\n            resolve(false)\n          }\n        }\n      )\n    })\n  }\n}\n\nmodule.exports = {\n  HttpMetricsRedisStore,\n  buildFieldKey,\n  FIELD_SEP,\n  isRedisPeerInstalled,\n  DEFAULT_HTTP_METRICS_REDIS_TTL_SEC,\n  httpMetricsTraceLog,\n}\n"],"mappings":"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","ignoreList":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adalo/metrics",
-  "version": "0.0.0-staging.23",
+  "version": "0.0.0-staging.26",
   "description": "Reusable metrics utilities for Node.js and Laravel apps",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -31,10 +31,10 @@
     "@types/pg": "^8.15.6"
   },
   "devDependencies": {
-    "@babel/cli": "7.18.6",
-    "@babel/core": "7.18.6",
-    "@babel/preset-env": "7.18.6",
-    "@babel/preset-typescript": "7.18.6",
+    "@babel/cli": "7.24.7",
+    "@babel/core": "7.24.7",
+    "@babel/preset-env": "7.24.7",
+    "@babel/preset-typescript": "7.24.7",
     "@types/ioredis": "^5.0.0",
     "@types/jest": "28.1.6",
     "@types/node": "17.0.38",

package/src/metrics/httpMetricsRedisRecorder.js

@@ -1,6 +1,4 @@
-const { HttpMetricsRedisStore } = require('./httpMetricsRedisStore')
-
-const LOG = '[http-metrics-redis]'
+const { HttpMetricsRedisStore, httpMetricsTraceLog } = require('./httpMetricsRedisStore')
 
 function trunc(s, max = 120) {
   const t = String(s)
@@ -17,19 +15,20 @@ class HttpMetricsRedisRecorder {
   /**
    * @param {Object} opts
    * @param {import('redis').RedisClient} opts.redisClient **Required.** Injected client (same pattern as {@link RedisMetricsClient}).
-   * @param {string} opts.appName Application name (must match collector; typically `BUILD_APP_NAME`).
-   * @param {string} opts.processType Logical process segment in Redis keys (e.g. `web`; must match collector’s key segment).
+   * @param {string} [opts.appName] Optional override; default same as {@link BaseMetricsClient}: `BUILD_APP_NAME` or `unknown-app`.
+   * @param {string} [opts.processType] Redis key segment (default **`web`**, same as {@link HttpMetricsRedisCollector}).
    * @param {number} [opts.ttlSec] Redis hash key TTL in seconds (sliding; default 120).
    */
-  constructor({ redisClient, appName, processType, ttlSec }) {
+  constructor({ redisClient, appName, processType = 'web', ttlSec } = {}) {
     if (redisClient == null) {
       throw new Error('HttpMetricsRedisRecorder: redisClient is required')
     }
+    const resolvedAppName = appName || process.env.BUILD_APP_NAME || 'unknown-app'
     this.processType = processType
-    this.appName = appName
+    this.appName = resolvedAppName
     this._store = new HttpMetricsRedisStore({
       redisClient,
-      appName,
+      appName: resolvedAppName,
       processType,
       ttlSec,
     })
@@ -52,10 +51,11 @@ class HttpMetricsRedisRecorder {
     databaseId = '',
     duration,
   }) {
-    console.warn(
-      `${LOG} 1_track pid=${process.pid} app=${this.appName} segment=${this.processType} ` +
+    httpMetricsTraceLog(
+      `track_request pid=${process.pid} app=${this.appName} segment=${this.processType} ` +
         `method=${method} route=${trunc(route)} status=${status_code} durationMs=${duration} ` +
-        `appId=${trunc(appId || '—', 40)} databaseId=${trunc(databaseId || '—', 40)}`
+        `appId=${trunc(appId || '—', 40)} databaseId=${trunc(databaseId || '—', 40)} ` +
+        `(then save_to_redis lines from store)`
     )
     this._store.record(method, route, status_code, appId, databaseId, duration)
   }

package/src/metrics/httpMetricsRedisStore.js

@@ -12,6 +12,43 @@ const DEFAULT_HTTP_METRICS_REDIS_TTL_SEC = 120
 
 const LOG = '[http-metrics-redis]'
 
+/**
+ * When Node runs behind `cluster`, HTTP is usually served from workers — include worker id in traces.
+ * @returns {string}
+ */
+function clusterHint() {
+  try {
+    // eslint-disable-next-line global-require
+    const c = require('cluster')
+    if (c.isWorker && c.worker != null) {
+      return ` cluster_worker=${c.worker.id}`
+    }
+  } catch (_) {
+    /* cluster not in use */
+  }
+  return ''
+}
+
+function truncField(s, max = 96) {
+  const t = String(s)
+  return t.length > max ? `${t.slice(0, max - 3)}...` : t
+}
+
+/**
+ * Trace line for SAVE (web → Redis) and GET/drain (collector ← Redis). Emits **stdout + stderr**
+ * so hosts that treat streams differently still show something.
+ * @param {string} body - Line body after `[http-metrics-redis]` prefix.
+ */
+function httpMetricsTraceLog(body) {
+  const line = `${LOG} ${body}${clusterHint()}`
+  console.log(line)
+  try {
+    process.stderr.write(`${line}\n`)
+  } catch (_) {
+    /* ignore */
+  }
+}
+
 const DRAIN_LUA = `
 local function drain(key)
   local v = redis.call('HGETALL', key)
@@ -58,10 +95,13 @@ function hgetallPairsToObject(pairs) {
 
 /**
  * Redis HTTP aggregate store. Uses an **injected** client (same pattern as {@link RedisMetricsClient}).
- * Expects `redis` v3-style API: `multi().hincrby().expire().exec(cb)`, `eval`, `set`, `del`.
+ * Expects `redis` v3-style API: `multi().hincrby().expire().exec(cb)`, `eval`.
  *
- * **Stored metrics:** two hashes per app/segment — `:count` (HINCRBY per route group) and `:dur`
- * (sum of duration ms per same field). Hash field = `method\\x1eroute\\x1estatus\\x1eappId\\x1edatabaseId`.
+ * **Structure:** `countKey` / `durKey` are each **one Redis hash**. The hash has **many fields** — not
+ * one bucket for all traffic. Each **field name** encodes one label group `(method, route, status_code,
+ * appId, databaseId)`. The **value** in `:count` is **HINCRBY 1** per request for that group; in `:dur`
+ * it is **HINCRBY** of that request’s **duration ms** (so many requests → summed ms per same field).
+ * Different routes → different hash fields. Drain runs atomic Lua (HGETALL + DEL) per tick.
  */
 class HttpMetricsRedisStore {
   /**
@@ -85,7 +125,6 @@ class HttpMetricsRedisStore {
     )}`
     this.countKey = `metrics:http:v2:${keySeg}:count`
     this.durKey = `metrics:http:v2:${keySeg}:dur`
-    this.lockKey = `metrics:http:v2:${keySeg}:drain_lock`
   }
 
   /**
@@ -109,6 +148,10 @@ class HttpMetricsRedisStore {
       const client = this._ensureClient()
       const field = buildFieldKey(method, route, statusCode, appId, databaseId)
       const dur = Math.max(0, Math.round(Number(durationMs) || 0))
+      httpMetricsTraceLog(
+        `save_to_redis pid=${process.pid} countKey=${this.countKey} ` +
+          `durKey=${this.durKey} field=${truncField(field)} durationMs=${dur} (before MULTI/EXEC)`
+      )
       client
         .multi()
         .hincrby(this.countKey, field, 1)
@@ -120,8 +163,8 @@ class HttpMetricsRedisStore {
             console.error('[HttpMetricsRedisStore] record failed:', err.message)
             return
           }
-          console.warn(
-            `${LOG} 2_redis_write pid=${process.pid} countKey=${this.countKey} durKey=${this.durKey} ok`
+          httpMetricsTraceLog(
+            `save_to_redis_ok pid=${process.pid} countKey=${this.countKey} durKey=${this.durKey} (after MULTI/EXEC)`
           )
         })
     } catch (e) {
@@ -143,90 +186,79 @@ class HttpMetricsRedisStore {
       return Promise.resolve(false)
     }
     return new Promise(resolve => {
-      client.set(this.lockKey, '1', 'EX', 25, 'NX', (setErr, ok) => {
-        if (setErr || ok !== 'OK') {
-          console.warn(
-            `${LOG} 3_redis_drain_skip pid=${process.pid} countKey=${this.countKey} reason=${
-              setErr ? `error:${setErr.message}` : 'lock_not_acquired'
-            }`
-          )
-          resolve(false)
-          return
-        }
-        client.eval(
-          DRAIN_LUA,
-          2,
-          this.countKey,
-          this.durKey,
-          (evalErr, raw) => {
-            const finish = () => {
-              client.del(this.lockKey, () => resolve(true))
-            }
+      httpMetricsTraceLog(
+        `get_from_redis_try pid=${process.pid} countKey=${this.countKey} (EVAL drain)`
+      )
+      client.eval(
+        DRAIN_LUA,
+        2,
+        this.countKey,
+        this.durKey,
+        (evalErr, raw) => {
+          if (evalErr) {
+            console.error(
+              '[HttpMetricsRedisStore] drain failed:',
+              evalErr.message
+            )
+            resolve(false)
+            return
+          }
 
-            if (evalErr) {
-              console.error(
-                '[HttpMetricsRedisStore] drain failed:',
-                evalErr.message
+          try {
+            if (!raw || !Array.isArray(raw) || raw.length < 2) {
+              httpMetricsTraceLog(
+                `get_from_redis_empty pid=${process.pid} countKey=${this.countKey} hash_fields=0 sum_requests=0 (lua returned no pairs)`
               )
-              finish()
+              resolve(true)
               return
             }
-
-            try {
-              if (!raw || !Array.isArray(raw) || raw.length < 2) {
-                console.warn(
-                  `${LOG} 3_redis_drain pid=${process.pid} countKey=${this.countKey} hash_fields=0 sum_requests=0 (empty_after_lua)`
-                )
-                finish()
-                return
+            const counts = hgetallPairsToObject(raw[0])
+            const durs = hgetallPairsToObject(raw[1])
+            const fieldKeys = Object.keys(counts)
+            let sumRequests = 0
+            const samples = []
+            for (const field of fieldKeys) {
+              const count = parseInt(counts[field], 10)
+              if (!count || count < 1) {
+                continue
               }
-              const counts = hgetallPairsToObject(raw[0])
-              const durs = hgetallPairsToObject(raw[1])
-              const fieldKeys = Object.keys(counts)
-              let sumRequests = 0
-              const samples = []
-              for (const field of fieldKeys) {
-                const count = parseInt(counts[field], 10)
-                if (!count || count < 1) {
-                  continue
-                }
-                const dur = parseInt(durs[field] || '0', 10) || 0
-                const parts = field.split(FIELD_SEP)
-                if (parts.length !== 5) {
-                  continue
-                }
-                const [m, route, statusStr, aid, did] = parts
-                sumRequests += count
-                if (samples.length < 3) {
-                  samples.push(`${m} ${route} ${statusStr} x${count}`)
-                }
-                const labels = {
-                  method: m,
-                  route,
-                  status_code: statusStr,
-                  appId: aid,
-                  databaseId: did,
-                }
-                applyCount(labels, count)
-                if (dur > 0) {
-                  applyDuration(labels, dur)
-                }
+              const dur = parseInt(durs[field] || '0', 10) || 0
+              const parts = field.split(FIELD_SEP)
+              if (parts.length !== 5) {
+                continue
+              }
+              const [m, route, statusStr, aid, did] = parts
+              sumRequests += count
+              if (samples.length < 3) {
+                samples.push(`${m} ${route} ${statusStr} x${count}`)
+              }
+              const labels = {
+                method: m,
+                route,
+                status_code: statusStr,
+                appId: aid,
+                databaseId: did,
+              }
+              applyCount(labels, count)
+              if (dur > 0) {
+                applyDuration(labels, dur)
               }
-              console.warn(
-                `${LOG} 3_redis_drain pid=${process.pid} countKey=${this.countKey} hash_fields=${
-                  fieldKeys.length
-                } sum_requests=${sumRequests} sample=${samples.join(' | ') || '—'}`
-              )
-            } catch (e) {
-              console.error(
-                '[HttpMetricsRedisStore] flush apply failed:',
-                e.message
-              )
             }
-            finish()
+            httpMetricsTraceLog(
+              `get_from_redis_ok pid=${process.pid} countKey=${this.countKey} hash_fields=${
+                fieldKeys.length
+              } sum_requests=${sumRequests} sample=${samples.join(' | ') || '—'}`
+            )
+            resolve(true)
+          } catch (e) {
+            console.error(
+              '[HttpMetricsRedisStore] flush apply failed:',
+              e.message
+            )
+            resolve(false)
           }
-        )
-      })
+        }
+      )
     })
   }
 }
@@ -237,4 +269,5 @@ module.exports = {
   FIELD_SEP,
   isRedisPeerInstalled,
   DEFAULT_HTTP_METRICS_REDIS_TTL_SEC,
+  httpMetricsTraceLog,
 }