@rsdk/db 5.15.0-next.0 → 5.15.0-next.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (140) hide show
  1. package/dist/index.d.ts +1 -0
  2. package/dist/index.js +15 -0
  3. package/dist/index.js.map +1 -1
  4. package/dist/metrics/call-then.d.ts +30 -0
  5. package/dist/metrics/call-then.js +91 -0
  6. package/dist/metrics/call-then.js.map +1 -0
  7. package/dist/metrics/clock.d.ts +2 -0
  8. package/dist/metrics/clock.js +9 -0
  9. package/dist/metrics/clock.js.map +1 -0
  10. package/dist/metrics/db-client-metrics.d.ts +85 -0
  11. package/dist/metrics/db-client-metrics.js +164 -0
  12. package/dist/metrics/db-client-metrics.js.map +1 -0
  13. package/dist/metrics/db-metric.d.ts +41 -0
  14. package/dist/metrics/db-metric.js +99 -0
  15. package/dist/metrics/db-metric.js.map +1 -0
  16. package/dist/metrics/db-metrics.config.d.ts +7 -0
  17. package/dist/metrics/db-metrics.config.js +60 -0
  18. package/dist/metrics/db-metrics.config.js.map +1 -0
  19. package/dist/metrics/db-metrics.module-base.d.ts +61 -0
  20. package/dist/metrics/db-metrics.module-base.js +61 -0
  21. package/dist/metrics/db-metrics.module-base.js.map +1 -0
  22. package/dist/metrics/db-metrics.providers.d.ts +66 -0
  23. package/dist/metrics/db-metrics.providers.js +83 -0
  24. package/dist/metrics/db-metrics.providers.js.map +1 -0
  25. package/dist/metrics/detach-group.d.ts +19 -0
  26. package/dist/metrics/detach-group.js +31 -0
  27. package/dist/metrics/detach-group.js.map +1 -0
  28. package/dist/metrics/detach.d.ts +24 -0
  29. package/dist/metrics/detach.js +45 -0
  30. package/dist/metrics/detach.js.map +1 -0
  31. package/dist/metrics/entity-operations.recorder.d.ts +17 -0
  32. package/dist/metrics/entity-operations.recorder.js +28 -0
  33. package/dist/metrics/entity-operations.recorder.js.map +1 -0
  34. package/dist/metrics/events.d.ts +11 -0
  35. package/dist/metrics/events.js +20 -0
  36. package/dist/metrics/events.js.map +1 -0
  37. package/dist/metrics/guards.d.ts +12 -0
  38. package/dist/metrics/guards.js +19 -0
  39. package/dist/metrics/guards.js.map +1 -0
  40. package/dist/metrics/index.d.ts +1 -0
  41. package/dist/metrics/index.js +11 -0
  42. package/dist/metrics/index.js.map +1 -0
  43. package/dist/metrics/instrumentation/pg-pool.instrumentation.d.ts +48 -0
  44. package/dist/metrics/instrumentation/pg-pool.instrumentation.js +117 -0
  45. package/dist/metrics/instrumentation/pg-pool.instrumentation.js.map +1 -0
  46. package/dist/metrics/instrumentation/pool-adapters.d.ts +22 -0
  47. package/dist/metrics/instrumentation/pool-adapters.js +16 -0
  48. package/dist/metrics/instrumentation/pool-adapters.js.map +1 -0
  49. package/dist/metrics/instrumentation/pool-close.d.ts +10 -0
  50. package/dist/metrics/instrumentation/pool-close.js +43 -0
  51. package/dist/metrics/instrumentation/pool-close.js.map +1 -0
  52. package/dist/metrics/instrumentation/pool-scope.d.ts +13 -0
  53. package/dist/metrics/instrumentation/pool-scope.js +3 -0
  54. package/dist/metrics/instrumentation/pool-scope.js.map +1 -0
  55. package/dist/metrics/instrumentation/pool.adapter.d.ts +50 -0
  56. package/dist/metrics/instrumentation/pool.adapter.js +3 -0
  57. package/dist/metrics/instrumentation/pool.adapter.js.map +1 -0
  58. package/dist/metrics/instrumentation/pool.recorder.d.ts +74 -0
  59. package/dist/metrics/instrumentation/pool.recorder.js +125 -0
  60. package/dist/metrics/instrumentation/pool.recorder.js.map +1 -0
  61. package/dist/metrics/instrumentation/query-completion.d.ts +12 -0
  62. package/dist/metrics/instrumentation/query-completion.js +76 -0
  63. package/dist/metrics/instrumentation/query-completion.js.map +1 -0
  64. package/dist/metrics/instrumentation/query.instrumentation.d.ts +35 -0
  65. package/dist/metrics/instrumentation/query.instrumentation.js +85 -0
  66. package/dist/metrics/instrumentation/query.instrumentation.js.map +1 -0
  67. package/dist/metrics/instrumentation/tarn-pool.instrumentation.d.ts +44 -0
  68. package/dist/metrics/instrumentation/tarn-pool.instrumentation.js +95 -0
  69. package/dist/metrics/instrumentation/tarn-pool.instrumentation.js.map +1 -0
  70. package/dist/metrics/instrumentation/transaction-tracker.d.ts +32 -0
  71. package/dist/metrics/instrumentation/transaction-tracker.js +64 -0
  72. package/dist/metrics/instrumentation/transaction-tracker.js.map +1 -0
  73. package/dist/metrics/metric-types.d.ts +17 -0
  74. package/dist/metrics/metric-types.js +3 -0
  75. package/dist/metrics/metric-types.js.map +1 -0
  76. package/dist/metrics/metrics.d.ts +82 -0
  77. package/dist/metrics/metrics.js +269 -0
  78. package/dist/metrics/metrics.js.map +1 -0
  79. package/dist/metrics/plugin-kit.d.ts +12 -0
  80. package/dist/metrics/plugin-kit.js +42 -0
  81. package/dist/metrics/plugin-kit.js.map +1 -0
  82. package/dist/metrics/pool-names.d.ts +47 -0
  83. package/dist/metrics/pool-names.js +44 -0
  84. package/dist/metrics/pool-names.js.map +1 -0
  85. package/dist/metrics/pool-stats.registry.d.ts +25 -0
  86. package/dist/metrics/pool-stats.registry.js +32 -0
  87. package/dist/metrics/pool-stats.registry.js.map +1 -0
  88. package/dist/metrics/scrape-source.registry.d.ts +29 -0
  89. package/dist/metrics/scrape-source.registry.js +55 -0
  90. package/dist/metrics/scrape-source.registry.js.map +1 -0
  91. package/dist/metrics/sql.d.ts +34 -0
  92. package/dist/metrics/sql.js +132 -0
  93. package/dist/metrics/sql.js.map +1 -0
  94. package/package.json +2 -2
  95. package/src/index.ts +1 -0
  96. package/src/metrics/call-then.ts +134 -0
  97. package/src/metrics/clock.ts +5 -0
  98. package/src/metrics/db-client-metrics.spec.ts +1894 -0
  99. package/src/metrics/db-client-metrics.ts +206 -0
  100. package/src/metrics/db-metric.spec.ts +185 -0
  101. package/src/metrics/db-metric.ts +186 -0
  102. package/src/metrics/db-metrics.config.ts +46 -0
  103. package/src/metrics/db-metrics.module-base.spec.ts +91 -0
  104. package/src/metrics/db-metrics.module-base.ts +77 -0
  105. package/src/metrics/db-metrics.providers.spec.ts +182 -0
  106. package/src/metrics/db-metrics.providers.ts +134 -0
  107. package/src/metrics/detach-group.spec.ts +41 -0
  108. package/src/metrics/detach-group.ts +30 -0
  109. package/src/metrics/detach.spec.ts +61 -0
  110. package/src/metrics/detach.ts +57 -0
  111. package/src/metrics/entity-operations.recorder.ts +26 -0
  112. package/src/metrics/events.spec.ts +19 -0
  113. package/src/metrics/events.ts +28 -0
  114. package/src/metrics/guards.spec.ts +20 -0
  115. package/src/metrics/guards.ts +19 -0
  116. package/src/metrics/index.ts +6 -0
  117. package/src/metrics/instrumentation/pg-pool.instrumentation.ts +177 -0
  118. package/src/metrics/instrumentation/pool-adapters.ts +35 -0
  119. package/src/metrics/instrumentation/pool-close.ts +59 -0
  120. package/src/metrics/instrumentation/pool-guards.spec.ts +318 -0
  121. package/src/metrics/instrumentation/pool-scope.ts +14 -0
  122. package/src/metrics/instrumentation/pool.adapter.ts +67 -0
  123. package/src/metrics/instrumentation/pool.recorder.ts +167 -0
  124. package/src/metrics/instrumentation/query-completion.spec.ts +209 -0
  125. package/src/metrics/instrumentation/query-completion.ts +107 -0
  126. package/src/metrics/instrumentation/query.instrumentation.ts +136 -0
  127. package/src/metrics/instrumentation/tarn-pool.instrumentation.ts +138 -0
  128. package/src/metrics/instrumentation/transaction-tracker.ts +103 -0
  129. package/src/metrics/metric-types.ts +36 -0
  130. package/src/metrics/metrics.ts +233 -0
  131. package/src/metrics/plugin-kit.ts +39 -0
  132. package/src/metrics/pool-names.spec.ts +79 -0
  133. package/src/metrics/pool-names.ts +77 -0
  134. package/src/metrics/pool-stats.registry.spec.ts +81 -0
  135. package/src/metrics/pool-stats.registry.ts +54 -0
  136. package/src/metrics/public-api.spec.ts +104 -0
  137. package/src/metrics/scrape-source.registry.spec.ts +59 -0
  138. package/src/metrics/scrape-source.registry.ts +55 -0
  139. package/src/metrics/sql.spec.ts +110 -0
  140. package/src/metrics/sql.ts +172 -0
@@ -0,0 +1,48 @@
1
+ import type { EventSource } from '../events';
2
+ import type { PoolAdapter } from './pool.adapter';
3
+ /**
4
+ * Пул из `pg-pool` (`pg.Pool` и `pg.native.Pool`): публичные члены, которые
5
+ * читает инструментирование
6
+ */
7
+ export interface PgPoolLike extends EventSource {
8
+ readonly totalCount: number;
9
+ readonly idleCount: number;
10
+ readonly waitingCount: number;
11
+ readonly options: {
12
+ max?: number;
13
+ };
14
+ connect(...args: any[]): any;
15
+ end?(...args: any[]): any;
16
+ }
17
+ /**
18
+ * Пул `pg-pool` вместе с внутренним `_clients`: по нему инструментирование
19
+ * находит соединения, открытые до подключения метрик. Элементы не
20
+ * проверены, их разбирает {@link connectedClients}
21
+ */
22
+ export type PgPoolInternals = PgPoolLike & {
23
+ readonly _clients?: readonly unknown[];
24
+ };
25
+ /**
26
+ * Проверяет каждый член пула, который использует
27
+ * {@link pgPoolAdapter}, в том числе необязательные: `end`, если есть,
28
+ * — функция, `_clients`, если есть, — массив. Пул другого драйвера (tarn,
29
+ * mysql2) или объект с частью полей не проходит
30
+ */
31
+ export declare const isPgPoolLike: (value: unknown) => value is PgPoolInternals;
32
+ /**
33
+ * Соединения пула, которые уже подключились. Пул кладёт клиента `pg`
34
+ * в `_clients` до подключения, а `_connected` становится `true` после него.
35
+ * По ним считаются открытые соединения в `stats` и соединения, открытые до
36
+ * подключения метрик. Всё, что не объект, пропускается
37
+ */
38
+ export declare const connectedClients: (pool: PgPoolInternals) => object[];
39
+ /**
40
+ * Пул `pg-pool`. Подключённые до вызова соединения берутся из `_clients`;
41
+ * соединение, которое в момент вызова ещё подключается, учитывается по
42
+ * событию `connect`, когда подключится. В `stats` оно до этого тоже не
43
+ * считается открытым.
44
+ *
45
+ * Ошибки соединений считает `PoolRecorder` по самим соединениям:
46
+ * событие пула `error` приходит только для простаивающих соединений
47
+ */
48
+ export declare const pgPoolAdapter: PoolAdapter<PgPoolInternals>;
@@ -0,0 +1,117 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.pgPoolAdapter = exports.connectedClients = exports.isPgPoolLike = void 0;
4
+ const call_then_1 = require("../call-then");
5
+ const clock_1 = require("../clock");
6
+ const detach_1 = require("../detach");
7
+ const events_1 = require("../events");
8
+ const guards_1 = require("../guards");
9
+ /**
10
+ * Проверяет каждый член пула, который использует
11
+ * {@link pgPoolAdapter}, в том числе необязательные: `end`, если есть,
12
+ * — функция, `_clients`, если есть, — массив. Пул другого драйвера (tarn,
13
+ * mysql2) или объект с частью полей не проходит
14
+ */
15
+ const isPgPoolLike = (value) => {
16
+ if (!(0, guards_1.isEventSource)(value)) {
17
+ return false;
18
+ }
19
+ const pool = value;
20
+ const options = pool.options;
21
+ return (typeof pool.totalCount === 'number' &&
22
+ typeof pool.idleCount === 'number' &&
23
+ typeof pool.waitingCount === 'number' &&
24
+ (0, guards_1.isObject)(options) &&
25
+ (options.max === undefined || typeof options.max === 'number') &&
26
+ typeof pool.connect === 'function' &&
27
+ (pool.end === undefined || typeof pool.end === 'function') &&
28
+ (pool._clients === undefined || Array.isArray(pool._clients)));
29
+ };
30
+ exports.isPgPoolLike = isPgPoolLike;
31
+ /**
32
+ * Соединения пула, которые уже подключились. Пул кладёт клиента `pg`
33
+ * в `_clients` до подключения, а `_connected` становится `true` после него.
34
+ * По ним считаются открытые соединения в `stats` и соединения, открытые до
35
+ * подключения метрик. Всё, что не объект, пропускается
36
+ */
37
+ const connectedClients = (pool) => (pool._clients ?? []).filter((client) => (0, guards_1.isObject)(client) && client._connected === true);
38
+ exports.connectedClients = connectedClients;
39
+ /**
40
+ * Сообщения, которыми pg-pool отклоняет `connect` по `connectionTimeoutMillis`.
41
+ * Тип ошибки у них общий (`Error`), отличить таймаут можно только по тексту
42
+ */
43
+ const ACQUIRE_TIMEOUT_MESSAGES = new Set([
44
+ // Пул полон, запрос не дождался свободного соединения в очереди (`connect`)
45
+ 'timeout exceeded when trying to connect',
46
+ // Пул не полон, новое соединение не успело открыться: `newClient` рвёт сокет
47
+ // и подменяет сообщение ошибки
48
+ 'Connection terminated due to connection timeout',
49
+ ]);
50
+ /**
51
+ * Таймаут получения соединения — и в очереди, и при открытии нового. Так же
52
+ * считает tarn: его `TimeoutError` покрывает оба случая
53
+ */
54
+ const isAcquireTimeout = (error) => {
55
+ const message = error?.message;
56
+ return typeof message === 'string' && ACQUIRE_TIMEOUT_MESSAGES.has(message);
57
+ };
58
+ /**
59
+ * `connect` сообщает о соединении callback-ом первым аргументом или promise:
60
+ * обёртка мерит ожидание соединения и отличает таймаут
61
+ */
62
+ const wrapConnect = (pool, events) => {
63
+ const originalConnect = pool.connect;
64
+ return (0, detach_1.replaceMethod)(pool, 'connect', function (...args) {
65
+ const startedAt = (0, clock_1.now)();
66
+ return (0, call_then_1.callThen)(originalConnect, this, args, (error) => events.acquireFinished(startedAt, isAcquireTimeout(error)), { callbackAt: 'first' });
67
+ });
68
+ };
69
+ /**
70
+ * Пул `pg-pool`. Подключённые до вызова соединения берутся из `_clients`;
71
+ * соединение, которое в момент вызова ещё подключается, учитывается по
72
+ * событию `connect`, когда подключится. В `stats` оно до этого тоже не
73
+ * считается открытым.
74
+ *
75
+ * Ошибки соединений считает `PoolRecorder` по самим соединениям:
76
+ * событие пула `error` приходит только для простаивающих соединений
77
+ */
78
+ exports.pgPoolAdapter = {
79
+ isPool: exports.isPgPoolLike,
80
+ // Итог — когда закончился первый вызов `end`: к этому моменту пул закрыл
81
+ // все соединения и о каждом сообщил событием `remove`. Повторный `end`
82
+ // pg-pool отклоняет сразу, пока первый ещё идёт
83
+ closeMethod: 'end',
84
+ openConnections: exports.connectedClients,
85
+ // `totalCount` — длина `_clients`, а туда клиент попадает до подключения.
86
+ // Поэтому открытыми считаются только подключённые клиенты, как у tarn.
87
+ // Каждый подключающийся клиент pg-pool создаёт для одного вызова `connect`,
88
+ // и этого вызывающего нет в `waitingCount`: он добавляется к ждущим, как
89
+ // `numPendingAcquires` у tarn. Без `_clients` подключённых не отличить,
90
+ // и счётчики берутся как есть
91
+ stats: (pool) => {
92
+ if (pool._clients === undefined) {
93
+ return {
94
+ total: pool.totalCount,
95
+ idle: pool.idleCount,
96
+ active: pool.totalCount - pool.idleCount,
97
+ waiting: pool.waitingCount,
98
+ max: pool.options.max ?? 0,
99
+ };
100
+ }
101
+ const connected = (0, exports.connectedClients)(pool).length;
102
+ return {
103
+ total: connected,
104
+ idle: pool.idleCount,
105
+ active: connected - pool.idleCount,
106
+ waiting: pool.waitingCount + (pool.totalCount - connected),
107
+ max: pool.options.max ?? 0,
108
+ };
109
+ },
110
+ attach: (pool, events, onConnectionCreated) => (0, detach_1.once)((0, events_1.listen)(pool, {
111
+ connect: onConnectionCreated,
112
+ acquire: (client) => events.connectionAcquired(client),
113
+ release: (_error, client) => events.connectionReleased(client),
114
+ remove: (client) => events.connectionClosed(client),
115
+ }), wrapConnect(pool, events)),
116
+ };
117
+ //# sourceMappingURL=pg-pool.instrumentation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pg-pool.instrumentation.js","sourceRoot":"","sources":["../../../src/metrics/instrumentation/pg-pool.instrumentation.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,22 @@
1
+ import type { PgPoolInternals } from './pg-pool.instrumentation';
2
+ import type { PoolAdapter } from './pool.adapter';
3
+ import type { TarnPoolInternals } from './tarn-pool.instrumentation';
4
+ /**
5
+ * Вид пула: `pg` — `pg-pool` (TypeORM), `tarn` — пул knex (MikroORM).
6
+ * Записан литералами, а не через `keyof PoolTypes`: тип входит в
7
+ * `plugin-kit` и не должен ссылаться на внутренние типы пулов
8
+ */
9
+ export type DbPoolKind = 'pg' | 'tarn';
10
+ /**
11
+ * Вид пула → тип, к которому его сужает проверка адаптера
12
+ */
13
+ interface PoolTypes {
14
+ pg: PgPoolInternals;
15
+ tarn: TarnPoolInternals;
16
+ }
17
+ /**
18
+ * Адаптер пула этого вида. Отдельная функция, а не обращение к таблице:
19
+ * так TypeScript связывает вид пула с типом, к которому сужает его проверка
20
+ */
21
+ export declare const poolAdapter: <K extends DbPoolKind>(kind: K) => PoolAdapter<PoolTypes[K]>;
22
+ export {};
@@ -0,0 +1,16 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.poolAdapter = void 0;
4
+ const pg_pool_instrumentation_1 = require("./pg-pool.instrumentation");
5
+ const tarn_pool_instrumentation_1 = require("./tarn-pool.instrumentation");
6
+ const POOL_ADAPTERS = {
7
+ pg: pg_pool_instrumentation_1.pgPoolAdapter,
8
+ tarn: tarn_pool_instrumentation_1.tarnPoolAdapter,
9
+ };
10
+ /**
11
+ * Адаптер пула этого вида. Отдельная функция, а не обращение к таблице:
12
+ * так TypeScript связывает вид пула с типом, к которому сужает его проверка
13
+ */
14
+ const poolAdapter = (kind) => POOL_ADAPTERS[kind];
15
+ exports.poolAdapter = poolAdapter;
16
+ //# sourceMappingURL=pool-adapters.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pool-adapters.js","sourceRoot":"","sources":["../../../src/metrics/instrumentation/pool-adapters.ts"],"names":[],"mappings":";;;AACA,uEAA0D;AAG1D,2EAA8D;AAiB9D,MAAM,aAAa,GAEf;IACF,EAAE,EAAE,uCAAa;IACjB,IAAI,EAAE,2CAAe;CACtB,CAAC;AAEF;;;GAGG;AACI,MAAM,WAAW,GAAG,CACzB,IAAO,EACoB,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;AAFvC,QAAA,WAAW,eAE4B"}
@@ -0,0 +1,10 @@
1
+ import type { Detach } from '../detach';
2
+ /**
3
+ * Итог по пулу: шаги выполняются один раз, когда закончился первый вызов
4
+ * метода закрытия или вызван возвращённый detach, — что наступит раньше.
5
+ * Обёртка метода закрытия снимается перед шагами
6
+ *
7
+ * @param steps что сделать при итоге, по порядку
8
+ * @returns detach, который подводит итог
9
+ */
10
+ export declare const finishOnClose: <TPool extends object>(pool: TPool, methodName: keyof TPool & string, steps: readonly Detach[]) => Detach;
@@ -0,0 +1,43 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.finishOnClose = void 0;
4
+ const call_then_1 = require("../call-then");
5
+ const detach_1 = require("../detach");
6
+ /**
7
+ * Оборачивает метод, которым пул закрывается (`end` у pg-pool, `destroy`
8
+ * у tarn), чтобы вызвать `finish`, когда закончился первый его вызов.
9
+ * Повторные вызовы идут мимо учёта: и pg-pool, и tarn к этому моменту уже
10
+ * закрывают пул по первому вызову. Если метода нет, оборачивать нечего
11
+ */
12
+ const wrapClose = (pool, methodName, finish) => {
13
+ const original = pool[methodName];
14
+ if (typeof original !== 'function') {
15
+ return detach_1.noop;
16
+ }
17
+ let closing = false;
18
+ return (0, detach_1.replaceMethod)(pool, methodName, function (...args) {
19
+ if (closing) {
20
+ return original.apply(this, args);
21
+ }
22
+ closing = true;
23
+ return (0, call_then_1.callThen)(original, this, args, finish, {
24
+ callbackAt: 'last',
25
+ });
26
+ });
27
+ };
28
+ /**
29
+ * Итог по пулу: шаги выполняются один раз, когда закончился первый вызов
30
+ * метода закрытия или вызван возвращённый detach, — что наступит раньше.
31
+ * Обёртка метода закрытия снимается перед шагами
32
+ *
33
+ * @param steps что сделать при итоге, по порядку
34
+ * @returns detach, который подводит итог
35
+ */
36
+ const finishOnClose = (pool, methodName, steps) => {
37
+ let restoreClose = detach_1.noop;
38
+ const finish = (0, detach_1.once)(() => restoreClose(), ...steps);
39
+ restoreClose = wrapClose(pool, methodName, finish);
40
+ return finish;
41
+ };
42
+ exports.finishOnClose = finishOnClose;
43
+ //# sourceMappingURL=pool-close.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pool-close.js","sourceRoot":"","sources":["../../../src/metrics/instrumentation/pool-close.ts"],"names":[],"mappings":";;;AAAA,4CAAwC;AAExC,sCAAsD;AAEtD;;;;;GAKG;AACH,MAAM,SAAS,GAAG,CAChB,IAAW,EACX,UAAgC,EAChC,MAAkB,EACV,EAAE;IACV,MAAM,QAAQ,GAAY,IAAI,CAAC,UAAU,CAAC,CAAC;IAE3C,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;QACnC,OAAO,aAAI,CAAC;IACd,CAAC;IAED,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,OAAO,IAAA,sBAAa,EAAC,IAAI,EAAE,UAAU,EAAE,UAErC,GAAG,IAAe;QAElB,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACpC,CAAC;QAED,OAAO,GAAG,IAAI,CAAC;QAEf,OAAO,IAAA,oBAAQ,EAAC,QAAgC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE;YACpE,UAAU,EAAE,MAAM;SACnB,CAAC,CAAC;IACL,CAAgC,CAAC,CAAC;AACpC,CAAC,CAAC;AAEF;;;;;;;GAOG;AACI,MAAM,aAAa,GAAG,CAC3B,IAAW,EACX,UAAgC,EAChC,KAAwB,EAChB,EAAE;IACV,IAAI,YAAY,GAAW,aAAI,CAAC;IAChC,MAAM,MAAM,GAAG,IAAA,aAAI,EAAC,GAAG,EAAE,CAAC,YAAY,EAAE,EAAE,GAAG,KAAK,CAAC,CAAC;IAEpD,YAAY,GAAG,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAEnD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAXW,QAAA,aAAa,iBAWxB"}
@@ -0,0 +1,13 @@
1
+ /**
2
+ * Пул, которому принадлежит соединение. Через него запросы и транзакции
3
+ * соединения узнают значение label `pool` и то, что итог по пулу уже
4
+ * подведён
5
+ */
6
+ export interface PoolScope {
7
+ readonly pool: string;
8
+ /**
9
+ * `false` после итога по пулу: ряды пула в gauge уже удалены, и
10
+ * `inc`/`dec` создали бы их заново
11
+ */
12
+ readonly attached: boolean;
13
+ }
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ //# sourceMappingURL=pool-scope.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pool-scope.js","sourceRoot":"","sources":["../../../src/metrics/instrumentation/pool-scope.ts"],"names":[],"mappings":""}
@@ -0,0 +1,50 @@
1
+ import type { Detach } from '../detach';
2
+ import type { PoolStats } from '../pool-stats.registry';
3
+ import type { PoolRecorder } from './pool.recorder';
4
+ /**
5
+ * Методы записи пула, которые разрешено вызывать адаптеру. Учёт нового
6
+ * соединения (`connectionCreated`) и итог по пулу (`detach`) сюда не входят:
7
+ * их делает `DbClientMetrics`, а адаптер сообщает о новом соединении через
8
+ * `onConnectionCreated`
9
+ */
10
+ export type PoolEvents = Pick<PoolRecorder, 'acquireFinished' | 'connectionAcquired' | 'connectionReleased' | 'connectionClosed'>;
11
+ /**
12
+ * То, что зависит от библиотеки пула: проверка, события, обёртки методов,
13
+ * состояние для gauge и метод закрытия. Имя пула, источник gauge, итог при
14
+ * закрытии и обёртку `query` у соединений адаптер не трогает: их по одной
15
+ * схеме для всех пулов ставит `DbClientMetrics`. Новый драйвер — новый
16
+ * адаптер и строка в таблице `POOL_ADAPTERS`
17
+ */
18
+ export interface PoolAdapter<TPool> {
19
+ /**
20
+ * Метод, которым пул закрывается: итог подводится, когда закончился
21
+ * первый его вызов
22
+ */
23
+ readonly closeMethod: keyof TPool & string;
24
+ /**
25
+ * Проверяет каждый член пула, который читает адаптер
26
+ */
27
+ isPool(value: unknown): value is TPool;
28
+ /**
29
+ * Соединения, которые пул открыл до подключения метрик
30
+ */
31
+ openConnections(pool: TPool): Iterable<object>;
32
+ /**
33
+ * Состояние пула для `db_pool_connections*` на момент scrape. Состояния
34
+ * значат одно и то же для любого пула: соединение, которое ещё
35
+ * открывается, не входит ни в `total`, ни в `active`, а тот, кто его
36
+ * ждёт, входит в `waiting`
37
+ */
38
+ stats(pool: TPool): PoolStats;
39
+ /**
40
+ * Подписывается на события пула и оборачивает его методы, чтобы
41
+ * передавать в `events` получение, возврат и закрытие соединений.
42
+ * О новом соединении — только через `onConnectionCreated`: учёт
43
+ * соединения и обёртку его запросов делает `DbClientMetrics`, и
44
+ * {@link PoolEvents} других методов адаптеру не даёт
45
+ *
46
+ * @returns detach: снимает все подписки и обёртки, поставленные здесь.
47
+ * Повторный вызов ничего не делает
48
+ */
49
+ attach(pool: TPool, events: PoolEvents, onConnectionCreated: (connection: object) => void): Detach;
50
+ }
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ //# sourceMappingURL=pool.adapter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pool.adapter.js","sourceRoot":"","sources":["../../../src/metrics/instrumentation/pool.adapter.ts"],"names":[],"mappings":""}
@@ -0,0 +1,74 @@
1
+ import type { CounterLike, HistogramLike, RemovableGaugeLike } from '../metric-types';
2
+ import type { PoolScope } from './pool-scope';
3
+ import type { TransactionTracker } from './transaction-tracker';
4
+ export interface PoolMetrics {
5
+ created: CounterLike<'pool'>;
6
+ closed: CounterLike<'pool'>;
7
+ acquireDuration: HistogramLike<'pool'>;
8
+ acquireTimeouts: CounterLike<'pool'>;
9
+ usage: HistogramLike<'pool'>;
10
+ errors: CounterLike<'pool'>;
11
+ /**
12
+ * Gauge с label `pool`, которые ведутся через `inc`/`dec`: при итоге
13
+ * по пулу его ряд из них удаляется
14
+ */
15
+ poolGauges: RemovableGaugeLike<'pool'>[];
16
+ }
17
+ /**
18
+ * Записывает события жизненного цикла соединений одного пула.
19
+ * Не знает, откуда события приходят: это дело инструментирования
20
+ * конкретного пула. Ошибки соединений слушает сам, на каждом соединении,
21
+ * поэтому они считаются одинаково для любого пула
22
+ */
23
+ export declare class PoolRecorder implements PoolScope {
24
+ readonly pool: string;
25
+ private readonly metrics;
26
+ private readonly transactions;
27
+ private readonly acquiredAt;
28
+ /**
29
+ * Соединения, которые пул открыл и ещё не закрыл, и отписка от их
30
+ * ошибок. Закрытие тех, что останутся здесь, досчитывается в итоге
31
+ */
32
+ private readonly open;
33
+ /**
34
+ * Соединения, ошибка которых уже учтена: `pg.Client` на один обрыв
35
+ * эмитит `error` больше одного раза
36
+ */
37
+ private readonly failed;
38
+ private detached;
39
+ constructor(pool: string, metrics: PoolMetrics, transactions: TransactionTracker);
40
+ get attached(): boolean;
41
+ /**
42
+ * Соединение открыто пулом. Соединения, которые пул открыл до подключения
43
+ * метрик, тоже учитываются здесь, в момент подключения: иначе их закрытие
44
+ * попало бы в закрытые без пары в созданных. Одно соединение учитывается
45
+ * один раз, сколько бы раз о нём ни сообщили
46
+ */
47
+ connectionCreated(connection: object): void;
48
+ connectionClosed(connection: object): void;
49
+ /**
50
+ * @param startedAt когда начали ждать соединение
51
+ */
52
+ acquireFinished(startedAt: number, timedOut: boolean): void;
53
+ connectionAcquired(connection: object): void;
54
+ connectionReleased(connection: object): void;
55
+ /**
56
+ * Подводит итог по пулу. Инструментирование вызывает его, когда пул
57
+ * закрылся, или раньше, если приложение останавливается, а пул ещё не
58
+ * закрыт. Соединения, которые к этому моменту ещё открыты, считаются
59
+ * закрытыми: пул закрывается вместе с приложением, и БД откатит их
60
+ * транзакции. Если пул уже закрыл все соединения, досчитывать нечего.
61
+ *
62
+ * Затем ряды пула удаляются из gauge, а запросы и транзакции, которые
63
+ * завершатся позже, их не трогают (см. {@link PoolScope.attached}).
64
+ * Повторный вызов ничего не делает
65
+ */
66
+ detach(): void;
67
+ /**
68
+ * Слушает ошибки соединения через `errorMonitor`: он не считается
69
+ * обработчиком `error`, поэтому ошибка без обработчика у владельца
70
+ * соединения по-прежнему бросается, как без метрик
71
+ */
72
+ private watchErrors;
73
+ private connectionError;
74
+ }
@@ -0,0 +1,125 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.PoolRecorder = void 0;
4
+ const node_events_1 = require("node:events");
5
+ const clock_1 = require("../clock");
6
+ const detach_1 = require("../detach");
7
+ const guards_1 = require("../guards");
8
+ /**
9
+ * Записывает события жизненного цикла соединений одного пула.
10
+ * Не знает, откуда события приходят: это дело инструментирования
11
+ * конкретного пула. Ошибки соединений слушает сам, на каждом соединении,
12
+ * поэтому они считаются одинаково для любого пула
13
+ */
14
+ class PoolRecorder {
15
+ pool;
16
+ metrics;
17
+ transactions;
18
+ acquiredAt = new WeakMap();
19
+ /**
20
+ * Соединения, которые пул открыл и ещё не закрыл, и отписка от их
21
+ * ошибок. Закрытие тех, что останутся здесь, досчитывается в итоге
22
+ */
23
+ open = new Map();
24
+ /**
25
+ * Соединения, ошибка которых уже учтена: `pg.Client` на один обрыв
26
+ * эмитит `error` больше одного раза
27
+ */
28
+ failed = new WeakSet();
29
+ detached = false;
30
+ constructor(pool, metrics, transactions) {
31
+ this.pool = pool;
32
+ this.metrics = metrics;
33
+ this.transactions = transactions;
34
+ }
35
+ get attached() {
36
+ return !this.detached;
37
+ }
38
+ /**
39
+ * Соединение открыто пулом. Соединения, которые пул открыл до подключения
40
+ * метрик, тоже учитываются здесь, в момент подключения: иначе их закрытие
41
+ * попало бы в закрытые без пары в созданных. Одно соединение учитывается
42
+ * один раз, сколько бы раз о нём ни сообщили
43
+ */
44
+ connectionCreated(connection) {
45
+ if (this.detached || this.open.has(connection)) {
46
+ return;
47
+ }
48
+ this.metrics.created.inc({ pool: this.pool });
49
+ this.open.set(connection, this.watchErrors(connection));
50
+ }
51
+ connectionClosed(connection) {
52
+ const unwatch = this.open.get(connection);
53
+ if (unwatch) {
54
+ this.open.delete(connection);
55
+ unwatch();
56
+ this.metrics.closed.inc({ pool: this.pool });
57
+ }
58
+ this.transactions.onConnectionClosed(connection);
59
+ }
60
+ /**
61
+ * @param startedAt когда начали ждать соединение
62
+ */
63
+ acquireFinished(startedAt, timedOut) {
64
+ this.metrics.acquireDuration.observe({ pool: this.pool }, (0, clock_1.secondsSince)(startedAt));
65
+ if (timedOut) {
66
+ this.metrics.acquireTimeouts.inc({ pool: this.pool });
67
+ }
68
+ }
69
+ connectionAcquired(connection) {
70
+ this.acquiredAt.set(connection, (0, clock_1.now)());
71
+ }
72
+ connectionReleased(connection) {
73
+ const acquiredAt = this.acquiredAt.get(connection);
74
+ if (acquiredAt === undefined) {
75
+ return;
76
+ }
77
+ this.acquiredAt.delete(connection);
78
+ this.metrics.usage.observe({ pool: this.pool }, (0, clock_1.secondsSince)(acquiredAt));
79
+ }
80
+ /**
81
+ * Подводит итог по пулу. Инструментирование вызывает его, когда пул
82
+ * закрылся, или раньше, если приложение останавливается, а пул ещё не
83
+ * закрыт. Соединения, которые к этому моменту ещё открыты, считаются
84
+ * закрытыми: пул закрывается вместе с приложением, и БД откатит их
85
+ * транзакции. Если пул уже закрыл все соединения, досчитывать нечего.
86
+ *
87
+ * Затем ряды пула удаляются из gauge, а запросы и транзакции, которые
88
+ * завершатся позже, их не трогают (см. {@link PoolScope.attached}).
89
+ * Повторный вызов ничего не делает
90
+ */
91
+ detach() {
92
+ if (this.detached) {
93
+ return;
94
+ }
95
+ for (const connection of this.open.keys()) {
96
+ this.connectionClosed(connection);
97
+ }
98
+ this.detached = true;
99
+ for (const gauge of this.metrics.poolGauges) {
100
+ gauge.remove({ pool: this.pool });
101
+ }
102
+ }
103
+ /**
104
+ * Слушает ошибки соединения через `errorMonitor`: он не считается
105
+ * обработчиком `error`, поэтому ошибка без обработчика у владельца
106
+ * соединения по-прежнему бросается, как без метрик
107
+ */
108
+ watchErrors(connection) {
109
+ if (!(0, guards_1.isEventSource)(connection)) {
110
+ return detach_1.noop;
111
+ }
112
+ const onError = () => this.connectionError(connection);
113
+ connection.on(node_events_1.errorMonitor, onError);
114
+ return () => connection.removeListener(node_events_1.errorMonitor, onError);
115
+ }
116
+ connectionError(connection) {
117
+ if (this.failed.has(connection)) {
118
+ return;
119
+ }
120
+ this.failed.add(connection);
121
+ this.metrics.errors.inc({ pool: this.pool });
122
+ }
123
+ }
124
+ exports.PoolRecorder = PoolRecorder;
125
+ //# sourceMappingURL=pool.recorder.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pool.recorder.js","sourceRoot":"","sources":["../../../src/metrics/instrumentation/pool.recorder.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,12 @@
1
+ import type { CallDone } from '../call-then';
2
+ export type QueryCompletion = CallDone;
3
+ /**
4
+ * Вызывает `query` драйвера и сообщает о завершении запроса, не меняя
5
+ * поведение вызова. Драйверы `pg` завершают запрос тремя способами:
6
+ * callback последним аргументом, promise или submittable-объект
7
+ * (QueryStream, Cursor), который живёт, пока читают поток.
8
+ *
9
+ * Callback и promise обрабатывает {@link callThen}, здесь добавлено только
10
+ * ожидание submittable: см. {@link watchSubmittable}
11
+ */
12
+ export declare const callWithCompletion: (query: (...args: any[]) => any, thisArg: unknown, args: unknown[], complete: QueryCompletion) => unknown;