@rsdk/db 5.15.0-next.9 → 5.15.0
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.
- package/CHANGELOG.md +4 -0
- package/dist/index.d.ts +1 -0
- package/dist/index.js +15 -0
- package/dist/index.js.map +1 -1
- package/dist/metrics/call-then.d.ts +30 -0
- package/dist/metrics/call-then.js +91 -0
- package/dist/metrics/call-then.js.map +1 -0
- package/dist/metrics/clock.d.ts +2 -0
- package/dist/metrics/clock.js +9 -0
- package/dist/metrics/clock.js.map +1 -0
- package/dist/metrics/db-client-metrics.d.ts +85 -0
- package/dist/metrics/db-client-metrics.js +164 -0
- package/dist/metrics/db-client-metrics.js.map +1 -0
- package/dist/metrics/db-metric.d.ts +41 -0
- package/dist/metrics/db-metric.js +99 -0
- package/dist/metrics/db-metric.js.map +1 -0
- package/dist/metrics/db-metrics.config.d.ts +7 -0
- package/dist/metrics/db-metrics.config.js +60 -0
- package/dist/metrics/db-metrics.config.js.map +1 -0
- package/dist/metrics/db-metrics.module-base.d.ts +61 -0
- package/dist/metrics/db-metrics.module-base.js +61 -0
- package/dist/metrics/db-metrics.module-base.js.map +1 -0
- package/dist/metrics/db-metrics.providers.d.ts +66 -0
- package/dist/metrics/db-metrics.providers.js +83 -0
- package/dist/metrics/db-metrics.providers.js.map +1 -0
- package/dist/metrics/detach-group.d.ts +19 -0
- package/dist/metrics/detach-group.js +31 -0
- package/dist/metrics/detach-group.js.map +1 -0
- package/dist/metrics/detach.d.ts +24 -0
- package/dist/metrics/detach.js +45 -0
- package/dist/metrics/detach.js.map +1 -0
- package/dist/metrics/entity-operations.recorder.d.ts +17 -0
- package/dist/metrics/entity-operations.recorder.js +28 -0
- package/dist/metrics/entity-operations.recorder.js.map +1 -0
- package/dist/metrics/events.d.ts +11 -0
- package/dist/metrics/events.js +20 -0
- package/dist/metrics/events.js.map +1 -0
- package/dist/metrics/guards.d.ts +12 -0
- package/dist/metrics/guards.js +19 -0
- package/dist/metrics/guards.js.map +1 -0
- package/dist/metrics/index.d.ts +1 -0
- package/dist/metrics/index.js +11 -0
- package/dist/metrics/index.js.map +1 -0
- package/dist/metrics/instrumentation/pg-pool.instrumentation.d.ts +48 -0
- package/dist/metrics/instrumentation/pg-pool.instrumentation.js +117 -0
- package/dist/metrics/instrumentation/pg-pool.instrumentation.js.map +1 -0
- package/dist/metrics/instrumentation/pool-adapters.d.ts +22 -0
- package/dist/metrics/instrumentation/pool-adapters.js +16 -0
- package/dist/metrics/instrumentation/pool-adapters.js.map +1 -0
- package/dist/metrics/instrumentation/pool-close.d.ts +10 -0
- package/dist/metrics/instrumentation/pool-close.js +43 -0
- package/dist/metrics/instrumentation/pool-close.js.map +1 -0
- package/dist/metrics/instrumentation/pool-scope.d.ts +13 -0
- package/dist/metrics/instrumentation/pool-scope.js +3 -0
- package/dist/metrics/instrumentation/pool-scope.js.map +1 -0
- package/dist/metrics/instrumentation/pool.adapter.d.ts +50 -0
- package/dist/metrics/instrumentation/pool.adapter.js +3 -0
- package/dist/metrics/instrumentation/pool.adapter.js.map +1 -0
- package/dist/metrics/instrumentation/pool.recorder.d.ts +74 -0
- package/dist/metrics/instrumentation/pool.recorder.js +125 -0
- package/dist/metrics/instrumentation/pool.recorder.js.map +1 -0
- package/dist/metrics/instrumentation/query-completion.d.ts +12 -0
- package/dist/metrics/instrumentation/query-completion.js +76 -0
- package/dist/metrics/instrumentation/query-completion.js.map +1 -0
- package/dist/metrics/instrumentation/query.instrumentation.d.ts +35 -0
- package/dist/metrics/instrumentation/query.instrumentation.js +85 -0
- package/dist/metrics/instrumentation/query.instrumentation.js.map +1 -0
- package/dist/metrics/instrumentation/tarn-pool.instrumentation.d.ts +44 -0
- package/dist/metrics/instrumentation/tarn-pool.instrumentation.js +95 -0
- package/dist/metrics/instrumentation/tarn-pool.instrumentation.js.map +1 -0
- package/dist/metrics/instrumentation/transaction-tracker.d.ts +32 -0
- package/dist/metrics/instrumentation/transaction-tracker.js +64 -0
- package/dist/metrics/instrumentation/transaction-tracker.js.map +1 -0
- package/dist/metrics/metric-types.d.ts +17 -0
- package/dist/metrics/metric-types.js +3 -0
- package/dist/metrics/metric-types.js.map +1 -0
- package/dist/metrics/metrics.d.ts +82 -0
- package/dist/metrics/metrics.js +269 -0
- package/dist/metrics/metrics.js.map +1 -0
- package/dist/metrics/plugin-kit.d.ts +12 -0
- package/dist/metrics/plugin-kit.js +42 -0
- package/dist/metrics/plugin-kit.js.map +1 -0
- package/dist/metrics/pool-names.d.ts +47 -0
- package/dist/metrics/pool-names.js +44 -0
- package/dist/metrics/pool-names.js.map +1 -0
- package/dist/metrics/pool-stats.registry.d.ts +25 -0
- package/dist/metrics/pool-stats.registry.js +32 -0
- package/dist/metrics/pool-stats.registry.js.map +1 -0
- package/dist/metrics/scrape-source.registry.d.ts +29 -0
- package/dist/metrics/scrape-source.registry.js +55 -0
- package/dist/metrics/scrape-source.registry.js.map +1 -0
- package/dist/metrics/sql.d.ts +34 -0
- package/dist/metrics/sql.js +132 -0
- package/dist/metrics/sql.js.map +1 -0
- package/package.json +2 -2
- package/src/index.ts +1 -0
- package/src/metrics/call-then.ts +134 -0
- package/src/metrics/clock.ts +5 -0
- package/src/metrics/db-client-metrics.spec.ts +1894 -0
- package/src/metrics/db-client-metrics.ts +206 -0
- package/src/metrics/db-metric.spec.ts +185 -0
- package/src/metrics/db-metric.ts +186 -0
- package/src/metrics/db-metrics.config.ts +46 -0
- package/src/metrics/db-metrics.module-base.spec.ts +91 -0
- package/src/metrics/db-metrics.module-base.ts +77 -0
- package/src/metrics/db-metrics.providers.spec.ts +182 -0
- package/src/metrics/db-metrics.providers.ts +134 -0
- package/src/metrics/detach-group.spec.ts +41 -0
- package/src/metrics/detach-group.ts +30 -0
- package/src/metrics/detach.spec.ts +61 -0
- package/src/metrics/detach.ts +57 -0
- package/src/metrics/entity-operations.recorder.ts +26 -0
- package/src/metrics/events.spec.ts +19 -0
- package/src/metrics/events.ts +28 -0
- package/src/metrics/guards.spec.ts +20 -0
- package/src/metrics/guards.ts +19 -0
- package/src/metrics/index.ts +6 -0
- package/src/metrics/instrumentation/pg-pool.instrumentation.ts +177 -0
- package/src/metrics/instrumentation/pool-adapters.ts +35 -0
- package/src/metrics/instrumentation/pool-close.ts +59 -0
- package/src/metrics/instrumentation/pool-guards.spec.ts +318 -0
- package/src/metrics/instrumentation/pool-scope.ts +14 -0
- package/src/metrics/instrumentation/pool.adapter.ts +67 -0
- package/src/metrics/instrumentation/pool.recorder.ts +167 -0
- package/src/metrics/instrumentation/query-completion.spec.ts +209 -0
- package/src/metrics/instrumentation/query-completion.ts +107 -0
- package/src/metrics/instrumentation/query.instrumentation.ts +136 -0
- package/src/metrics/instrumentation/tarn-pool.instrumentation.ts +138 -0
- package/src/metrics/instrumentation/transaction-tracker.ts +103 -0
- package/src/metrics/metric-types.ts +36 -0
- package/src/metrics/metrics.ts +233 -0
- package/src/metrics/plugin-kit.ts +39 -0
- package/src/metrics/pool-names.spec.ts +79 -0
- package/src/metrics/pool-names.ts +77 -0
- package/src/metrics/pool-stats.registry.spec.ts +81 -0
- package/src/metrics/pool-stats.registry.ts +54 -0
- package/src/metrics/public-api.spec.ts +104 -0
- package/src/metrics/scrape-source.registry.spec.ts +59 -0
- package/src/metrics/scrape-source.registry.ts +55 -0
- package/src/metrics/sql.spec.ts +110 -0
- package/src/metrics/sql.ts +172 -0
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.callWithCompletion = void 0;
|
|
4
|
+
const node_events_1 = require("node:events");
|
|
5
|
+
const call_then_1 = require("../call-then");
|
|
6
|
+
const detach_1 = require("../detach");
|
|
7
|
+
const guards_1 = require("../guards");
|
|
8
|
+
/**
|
|
9
|
+
* Поток закрыл тот, кто его читал (`break` из `for await`, `destroy()`
|
|
10
|
+
* через AbortSignal). Запрос при этом не падал
|
|
11
|
+
*/
|
|
12
|
+
const isAbort = (error) => (0, guards_1.isObject)(error) &&
|
|
13
|
+
(error.code === 'ABORT_ERR' || error.name === 'AbortError');
|
|
14
|
+
/**
|
|
15
|
+
* Ждёт завершения submittable-запроса, не меняя его поведение.
|
|
16
|
+
*
|
|
17
|
+
* Обычный обработчик `error` здесь не годится: при любом обработчике
|
|
18
|
+
* `emit('error')` перестаёт бросать исключение, и ошибка потока без
|
|
19
|
+
* обработчика у потребителя молча пропадает. А Cursor эмитит `error`, только
|
|
20
|
+
* если на него кто-то подписан. Поэтому ошибки потока слушаются через
|
|
21
|
+
* `errorMonitor` — он не считается обработчиком, — а ошибки запроса
|
|
22
|
+
* перехватываются в `handleError`: Cursor без подписчиков не сообщает о них
|
|
23
|
+
* ни `error`, ни `end`.
|
|
24
|
+
*
|
|
25
|
+
* `close` без `end` и без ошибки — поток закрыли через `destroy()`.
|
|
26
|
+
*
|
|
27
|
+
* Подмену `handleError` снимает {@link replaceMethod} при завершении
|
|
28
|
+
* запроса
|
|
29
|
+
*/
|
|
30
|
+
const watchSubmittable = (query, complete) => {
|
|
31
|
+
const originalHandleError = query.handleError;
|
|
32
|
+
let restoreHandleError = detach_1.noop;
|
|
33
|
+
let finished = false;
|
|
34
|
+
const finish = (error) => {
|
|
35
|
+
if (finished) {
|
|
36
|
+
return;
|
|
37
|
+
}
|
|
38
|
+
finished = true;
|
|
39
|
+
query.removeListener('end', onEnd);
|
|
40
|
+
query.removeListener('close', onEnd);
|
|
41
|
+
query.removeListener(node_events_1.errorMonitor, finish);
|
|
42
|
+
restoreHandleError();
|
|
43
|
+
complete(isAbort(error) ? undefined : error);
|
|
44
|
+
};
|
|
45
|
+
const onEnd = () => finish();
|
|
46
|
+
query.on('end', onEnd);
|
|
47
|
+
query.on('close', onEnd);
|
|
48
|
+
query.on(node_events_1.errorMonitor, finish);
|
|
49
|
+
if (typeof originalHandleError === 'function') {
|
|
50
|
+
restoreHandleError = (0, detach_1.replaceMethod)(query, 'handleError', function (...args) {
|
|
51
|
+
finish(args[0]);
|
|
52
|
+
return originalHandleError.apply(this, args);
|
|
53
|
+
});
|
|
54
|
+
}
|
|
55
|
+
};
|
|
56
|
+
/**
|
|
57
|
+
* Вызывает `query` драйвера и сообщает о завершении запроса, не меняя
|
|
58
|
+
* поведение вызова. Драйверы `pg` завершают запрос тремя способами:
|
|
59
|
+
* callback последним аргументом, promise или submittable-объект
|
|
60
|
+
* (QueryStream, Cursor), который живёт, пока читают поток.
|
|
61
|
+
*
|
|
62
|
+
* Callback и promise обрабатывает {@link callThen}, здесь добавлено только
|
|
63
|
+
* ожидание submittable: см. {@link watchSubmittable}
|
|
64
|
+
*/
|
|
65
|
+
const callWithCompletion = (query, thisArg, args, complete) => (0, call_then_1.callThen)(query, thisArg, args, complete, {
|
|
66
|
+
callbackAt: 'last',
|
|
67
|
+
watchResult: (result, done) => {
|
|
68
|
+
if (result !== args[0] || !(0, guards_1.isEventSource)(result)) {
|
|
69
|
+
return false;
|
|
70
|
+
}
|
|
71
|
+
watchSubmittable(result, done);
|
|
72
|
+
return true;
|
|
73
|
+
},
|
|
74
|
+
});
|
|
75
|
+
exports.callWithCompletion = callWithCompletion;
|
|
76
|
+
//# sourceMappingURL=query-completion.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"query-completion.js","sourceRoot":"","sources":["../../../src/metrics/instrumentation/query-completion.ts"],"names":[],"mappings":";;;AAAA,6CAA2C;AAG3C,4CAAwC;AACxC,sCAAgD;AAEhD,sCAAoD;AAIpD;;;GAGG;AACH,MAAM,OAAO,GAAG,CAAC,KAAc,EAAW,EAAE,CAC1C,IAAA,iBAAQ,EAAC,KAAK,CAAC;IACf,CAAC,KAAK,CAAC,IAAI,KAAK,WAAW,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC;AAU9D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,gBAAgB,GAAG,CACvB,KAAkB,EAClB,QAAyB,EACnB,EAAE;IACR,MAAM,mBAAmB,GAAG,KAAK,CAAC,WAAW,CAAC;IAC9C,IAAI,kBAAkB,GAAG,aAAI,CAAC;IAC9B,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,MAAM,MAAM,GAAG,CAAC,KAAe,EAAQ,EAAE;QACvC,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QAED,QAAQ,GAAG,IAAI,CAAC;QAChB,KAAK,CAAC,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACnC,KAAK,CAAC,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACrC,KAAK,CAAC,cAAc,CAAC,0BAAY,EAAE,MAAM,CAAC,CAAC;QAC3C,kBAAkB,EAAE,CAAC;QAErB,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC,CAAC;IACF,MAAM,KAAK,GAAG,GAAS,EAAE,CAAC,MAAM,EAAE,CAAC;IAEnC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACvB,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACzB,KAAK,CAAC,EAAE,CAAC,0BAAY,EAAE,MAAM,CAAC,CAAC;IAE/B,IAAI,OAAO,mBAAmB,KAAK,UAAU,EAAE,CAAC;QAC9C,kBAAkB,GAAG,IAAA,sBAAa,EAChC,KAAK,EACL,aAAa,EACb,UAAyB,GAAG,IAAe;YACzC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAChB,OAAO,mBAAmB,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC/C,CAAC,CACF,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACI,MAAM,kBAAkB,GAAG,CAChC,KAA8B,EAC9B,OAAgB,EAChB,IAAe,EACf,QAAyB,EAChB,EAAE,CACX,IAAA,oBAAQ,EAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE;IACvC,UAAU,EAAE,MAAM;IAClB,WAAW,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE;QAC5B,IAAI,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAA,sBAAa,EAAC,MAAM,CAAC,EAAE,CAAC;YACjD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC,CAAC;AAhBQ,QAAA,kBAAkB,sBAgB1B"}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import type { ActiveGaugeLike, CounterLike, HistogramLike } from '../metric-types';
|
|
2
|
+
import type { PoolScope } from './pool-scope';
|
|
3
|
+
import type { TransactionTracker } from './transaction-tracker';
|
|
4
|
+
/**
|
|
5
|
+
* Клиент `pg` или `pg-native`: всё, что нужно — метод `query`
|
|
6
|
+
*/
|
|
7
|
+
export interface QueryableClient {
|
|
8
|
+
query(...args: any[]): any;
|
|
9
|
+
}
|
|
10
|
+
export interface QueryMetrics {
|
|
11
|
+
duration: HistogramLike<'operation' | 'status'>;
|
|
12
|
+
active: ActiveGaugeLike<'pool'>;
|
|
13
|
+
slow: CounterLike<'operation'>;
|
|
14
|
+
errors: CounterLike<'code'>;
|
|
15
|
+
}
|
|
16
|
+
/**
|
|
17
|
+
* Оборачивает `client.query`: длительность, выполняющиеся запросы, медленные
|
|
18
|
+
* запросы, ошибки по SQLSTATE. Границы транзакций передаёт в {@link TransactionTracker}.
|
|
19
|
+
*
|
|
20
|
+
* После итога по пулу его ряд в `db_client_queries_active` удалён: запросы
|
|
21
|
+
* этого пула его больше не трогают, остальные метрики пишутся
|
|
22
|
+
*/
|
|
23
|
+
export declare class QueryInstrumentation {
|
|
24
|
+
private readonly metrics;
|
|
25
|
+
private readonly transactions;
|
|
26
|
+
private readonly slowQueryThresholdMs;
|
|
27
|
+
constructor(metrics: QueryMetrics, transactions: TransactionTracker, slowQueryThresholdMs: number);
|
|
28
|
+
/**
|
|
29
|
+
* Соединение без метода `query` пропускается. Повторный вызов не
|
|
30
|
+
* оборачивает клиент ещё раз, а только меняет пул, к которому относятся
|
|
31
|
+
* его запросы
|
|
32
|
+
*/
|
|
33
|
+
instrument(client: object, scope: PoolScope): void;
|
|
34
|
+
private start;
|
|
35
|
+
}
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.QueryInstrumentation = void 0;
|
|
4
|
+
const clock_1 = require("../clock");
|
|
5
|
+
const sql_1 = require("../sql");
|
|
6
|
+
const query_completion_1 = require("./query-completion");
|
|
7
|
+
const isQueryableClient = (value) => typeof value?.query === 'function';
|
|
8
|
+
/**
|
|
9
|
+
* Пул, к которому сейчас относятся запросы обёрнутого клиента. Хранится
|
|
10
|
+
* здесь, а не на самом клиенте: так посторонний код не может прочитать или
|
|
11
|
+
* подменить привязку. Таблица одна на весь модуль, поэтому второй экземпляр
|
|
12
|
+
* {@link QueryInstrumentation} (второе приложение в процессе) тоже видит,
|
|
13
|
+
* что клиент уже обёрнут
|
|
14
|
+
*/
|
|
15
|
+
const scopes = new WeakMap();
|
|
16
|
+
/**
|
|
17
|
+
* Оборачивает `client.query`: длительность, выполняющиеся запросы, медленные
|
|
18
|
+
* запросы, ошибки по SQLSTATE. Границы транзакций передаёт в {@link TransactionTracker}.
|
|
19
|
+
*
|
|
20
|
+
* После итога по пулу его ряд в `db_client_queries_active` удалён: запросы
|
|
21
|
+
* этого пула его больше не трогают, остальные метрики пишутся
|
|
22
|
+
*/
|
|
23
|
+
class QueryInstrumentation {
|
|
24
|
+
metrics;
|
|
25
|
+
transactions;
|
|
26
|
+
slowQueryThresholdMs;
|
|
27
|
+
constructor(metrics, transactions, slowQueryThresholdMs) {
|
|
28
|
+
this.metrics = metrics;
|
|
29
|
+
this.transactions = transactions;
|
|
30
|
+
this.slowQueryThresholdMs = slowQueryThresholdMs;
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* Соединение без метода `query` пропускается. Повторный вызов не
|
|
34
|
+
* оборачивает клиент ещё раз, а только меняет пул, к которому относятся
|
|
35
|
+
* его запросы
|
|
36
|
+
*/
|
|
37
|
+
instrument(client, scope) {
|
|
38
|
+
if (!isQueryableClient(client)) {
|
|
39
|
+
return;
|
|
40
|
+
}
|
|
41
|
+
const wrapped = scopes.has(client);
|
|
42
|
+
scopes.set(client, scope);
|
|
43
|
+
if (wrapped) {
|
|
44
|
+
return;
|
|
45
|
+
}
|
|
46
|
+
const originalQuery = client.query;
|
|
47
|
+
// eslint-disable-next-line @typescript-eslint/no-this-alias
|
|
48
|
+
const instrumentation = this;
|
|
49
|
+
client.query = function (...args) {
|
|
50
|
+
const complete = instrumentation.start(client, scopes.get(client) ?? scope, (0, sql_1.extractSqlText)(args[0]));
|
|
51
|
+
return (0, query_completion_1.callWithCompletion)(originalQuery, this, args, complete);
|
|
52
|
+
};
|
|
53
|
+
}
|
|
54
|
+
start(client, scope, sql) {
|
|
55
|
+
const { operation, boundary } = (0, sql_1.classifyQuery)(sql);
|
|
56
|
+
const startedAt = (0, clock_1.now)();
|
|
57
|
+
const countedActive = scope.attached;
|
|
58
|
+
let completed = false;
|
|
59
|
+
if (countedActive) {
|
|
60
|
+
this.metrics.active.inc({ pool: scope.pool });
|
|
61
|
+
}
|
|
62
|
+
return (error, response) => {
|
|
63
|
+
if (completed) {
|
|
64
|
+
return;
|
|
65
|
+
}
|
|
66
|
+
completed = true;
|
|
67
|
+
const seconds = (0, clock_1.secondsSince)(startedAt);
|
|
68
|
+
if (countedActive && scope.attached) {
|
|
69
|
+
this.metrics.active.dec({ pool: scope.pool });
|
|
70
|
+
}
|
|
71
|
+
this.metrics.duration.observe({ operation, status: error ? 'error' : 'ok' }, seconds);
|
|
72
|
+
if (seconds * 1000 >= this.slowQueryThresholdMs) {
|
|
73
|
+
this.metrics.slow.inc({ operation });
|
|
74
|
+
}
|
|
75
|
+
if (error) {
|
|
76
|
+
this.metrics.errors.inc({ code: (0, sql_1.extractSqlState)(error) });
|
|
77
|
+
}
|
|
78
|
+
if (boundary) {
|
|
79
|
+
this.transactions.onBoundary(client, scope, boundary, startedAt, error, response);
|
|
80
|
+
}
|
|
81
|
+
};
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
exports.QueryInstrumentation = QueryInstrumentation;
|
|
85
|
+
//# sourceMappingURL=query.instrumentation.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"query.instrumentation.js","sourceRoot":"","sources":["../../../src/metrics/instrumentation/query.instrumentation.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
import type { EventSource } from '../events';
|
|
2
|
+
import type { PoolAdapter } from './pool.adapter';
|
|
3
|
+
/**
|
|
4
|
+
* Пул из `tarn`, который использует knex: публичные члены, которые читает
|
|
5
|
+
* инструментирование
|
|
6
|
+
*/
|
|
7
|
+
export interface TarnPoolLike extends EventSource {
|
|
8
|
+
readonly max: number;
|
|
9
|
+
numUsed(): number;
|
|
10
|
+
numFree(): number;
|
|
11
|
+
numPendingAcquires(): number;
|
|
12
|
+
destroy?(...args: any[]): any;
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
* Пул tarn вместе с внутренними `free` и `used`: по ним инструментирование
|
|
16
|
+
* находит соединения, открытые до подключения метрик. Элементы не
|
|
17
|
+
* проверены, их разбирает {@link openResources}
|
|
18
|
+
*/
|
|
19
|
+
export type TarnPoolInternals = TarnPoolLike & {
|
|
20
|
+
readonly free?: readonly unknown[];
|
|
21
|
+
readonly used?: readonly unknown[];
|
|
22
|
+
};
|
|
23
|
+
/**
|
|
24
|
+
* Проверяет каждый член пула, который использует
|
|
25
|
+
* {@link tarnPoolAdapter}, в том числе необязательные: `destroy`,
|
|
26
|
+
* если есть, — функция, `free` и `used`, если есть, — массивы. Пул другого
|
|
27
|
+
* драйвера (pg, mysql2) или объект с частью полей не проходит
|
|
28
|
+
*/
|
|
29
|
+
export declare const isTarnPoolLike: (value: unknown) => value is TarnPoolInternals;
|
|
30
|
+
/**
|
|
31
|
+
* Соединения, которые пул уже открыл: `resource` из элементов `free` и
|
|
32
|
+
* `used`. Элементы и соединения, которые не объекты, пропускаются
|
|
33
|
+
*/
|
|
34
|
+
export declare const openResources: (pool: TarnPoolInternals) => object[];
|
|
35
|
+
/**
|
|
36
|
+
* Пул tarn (knex, MikroORM). Соединения, открытые до вызова, берутся из
|
|
37
|
+
* `free` и `used`; создающиеся соединения там ещё не лежат, их учтёт событие
|
|
38
|
+
* `createSuccess`. Соединения в tarn бывают от любого драйвера knex,
|
|
39
|
+
* поэтому оборачивать ли их `query`, решает плагин (`instrumentQueries`
|
|
40
|
+
* у `DbClientMetrics.instrumentPool`).
|
|
41
|
+
*
|
|
42
|
+
* Ошибки соединений считает `PoolRecorder` по самим соединениям
|
|
43
|
+
*/
|
|
44
|
+
export declare const tarnPoolAdapter: PoolAdapter<TarnPoolInternals>;
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.tarnPoolAdapter = exports.openResources = exports.isTarnPoolLike = void 0;
|
|
4
|
+
const clock_1 = require("../clock");
|
|
5
|
+
const events_1 = require("../events");
|
|
6
|
+
const guards_1 = require("../guards");
|
|
7
|
+
/**
|
|
8
|
+
* Проверяет каждый член пула, который использует
|
|
9
|
+
* {@link tarnPoolAdapter}, в том числе необязательные: `destroy`,
|
|
10
|
+
* если есть, — функция, `free` и `used`, если есть, — массивы. Пул другого
|
|
11
|
+
* драйвера (pg, mysql2) или объект с частью полей не проходит
|
|
12
|
+
*/
|
|
13
|
+
const isTarnPoolLike = (value) => {
|
|
14
|
+
if (!(0, guards_1.isEventSource)(value)) {
|
|
15
|
+
return false;
|
|
16
|
+
}
|
|
17
|
+
const pool = value;
|
|
18
|
+
return (typeof pool.max === 'number' &&
|
|
19
|
+
typeof pool.numUsed === 'function' &&
|
|
20
|
+
typeof pool.numFree === 'function' &&
|
|
21
|
+
typeof pool.numPendingAcquires === 'function' &&
|
|
22
|
+
(pool.destroy === undefined || typeof pool.destroy === 'function') &&
|
|
23
|
+
(pool.free === undefined || Array.isArray(pool.free)) &&
|
|
24
|
+
(pool.used === undefined || Array.isArray(pool.used)));
|
|
25
|
+
};
|
|
26
|
+
exports.isTarnPoolLike = isTarnPoolLike;
|
|
27
|
+
/**
|
|
28
|
+
* Соединения, которые пул уже открыл: `resource` из элементов `free` и
|
|
29
|
+
* `used`. Элементы и соединения, которые не объекты, пропускаются
|
|
30
|
+
*/
|
|
31
|
+
const openResources = (pool) => [...(pool.free ?? []), ...(pool.used ?? [])]
|
|
32
|
+
.map((item) => (0, guards_1.isObject)(item) && 'resource' in item ? item.resource : undefined)
|
|
33
|
+
.filter(guards_1.isObject);
|
|
34
|
+
exports.openResources = openResources;
|
|
35
|
+
/**
|
|
36
|
+
* Таймаут получения соединения. В tarn это `class TimeoutError extends Error {}`
|
|
37
|
+
* без своего `name`, поэтому у экземпляра `name === 'Error'`, и узнать его
|
|
38
|
+
* можно только по имени класса. Импортировать класс нельзя: у `@rsdk/db`
|
|
39
|
+
* нет зависимости от tarn
|
|
40
|
+
*/
|
|
41
|
+
const isAcquireTimeout = (error) => error?.constructor?.name === 'TimeoutError' ||
|
|
42
|
+
error?.name === 'TimeoutError';
|
|
43
|
+
/**
|
|
44
|
+
* Пул tarn (knex, MikroORM). Соединения, открытые до вызова, берутся из
|
|
45
|
+
* `free` и `used`; создающиеся соединения там ещё не лежат, их учтёт событие
|
|
46
|
+
* `createSuccess`. Соединения в tarn бывают от любого драйвера knex,
|
|
47
|
+
* поэтому оборачивать ли их `query`, решает плагин (`instrumentQueries`
|
|
48
|
+
* у `DbClientMetrics.instrumentPool`).
|
|
49
|
+
*
|
|
50
|
+
* Ошибки соединений считает `PoolRecorder` по самим соединениям
|
|
51
|
+
*/
|
|
52
|
+
exports.tarnPoolAdapter = {
|
|
53
|
+
isPool: exports.isTarnPoolLike,
|
|
54
|
+
// Итог — когда закончился первый вызов `destroy`: tarn ждёт, пока вернут
|
|
55
|
+
// выданные соединения, закрывает все и о каждом сообщает событием
|
|
56
|
+
// `destroySuccess` или `destroyFail`
|
|
57
|
+
closeMethod: 'destroy',
|
|
58
|
+
openConnections: exports.openResources,
|
|
59
|
+
stats: (pool) => {
|
|
60
|
+
const idle = pool.numFree();
|
|
61
|
+
const active = pool.numUsed();
|
|
62
|
+
return {
|
|
63
|
+
total: idle + active,
|
|
64
|
+
idle,
|
|
65
|
+
active,
|
|
66
|
+
waiting: pool.numPendingAcquires(),
|
|
67
|
+
max: pool.max,
|
|
68
|
+
};
|
|
69
|
+
},
|
|
70
|
+
attach: (pool, events, onConnectionCreated) => {
|
|
71
|
+
// Начало ожидания по id запроса соединения: tarn сообщает id в
|
|
72
|
+
// `acquireRequest` и в его исходе
|
|
73
|
+
const acquireStartedAt = new Map();
|
|
74
|
+
const finishAcquire = (eventId, timedOut) => {
|
|
75
|
+
const startedAt = acquireStartedAt.get(eventId);
|
|
76
|
+
acquireStartedAt.delete(eventId);
|
|
77
|
+
if (startedAt !== undefined) {
|
|
78
|
+
events.acquireFinished(startedAt, timedOut);
|
|
79
|
+
}
|
|
80
|
+
};
|
|
81
|
+
return (0, events_1.listen)(pool, {
|
|
82
|
+
acquireRequest: (eventId) => acquireStartedAt.set(eventId, (0, clock_1.now)()),
|
|
83
|
+
acquireSuccess: (eventId, resource) => {
|
|
84
|
+
finishAcquire(eventId, false);
|
|
85
|
+
events.connectionAcquired(resource);
|
|
86
|
+
},
|
|
87
|
+
acquireFail: (eventId, error) => finishAcquire(eventId, isAcquireTimeout(error)),
|
|
88
|
+
release: (resource) => events.connectionReleased(resource),
|
|
89
|
+
createSuccess: (_eventId, resource) => onConnectionCreated(resource),
|
|
90
|
+
destroySuccess: (_eventId, resource) => events.connectionClosed(resource),
|
|
91
|
+
destroyFail: (_eventId, resource) => events.connectionClosed(resource),
|
|
92
|
+
});
|
|
93
|
+
},
|
|
94
|
+
};
|
|
95
|
+
//# sourceMappingURL=tarn-pool.instrumentation.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tarn-pool.instrumentation.js","sourceRoot":"","sources":["../../../src/metrics/instrumentation/tarn-pool.instrumentation.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
import type { ActiveGaugeLike, CounterLike, HistogramLike } from '../metric-types';
|
|
2
|
+
import type { TransactionBoundary } from '../sql';
|
|
3
|
+
import type { PoolScope } from './pool-scope';
|
|
4
|
+
export interface TransactionMetrics {
|
|
5
|
+
total: CounterLike<'result'>;
|
|
6
|
+
duration: HistogramLike<'result'>;
|
|
7
|
+
active: ActiveGaugeLike<'pool'>;
|
|
8
|
+
}
|
|
9
|
+
/**
|
|
10
|
+
* Отслеживает открытые транзакции по соединениям: в Postgres у соединения
|
|
11
|
+
* не больше одной транзакции верхнего уровня.
|
|
12
|
+
*
|
|
13
|
+
* После итога по пулу его ряд в `db_transactions_active` удалён: транзакции
|
|
14
|
+
* этого пула его больше не трогают, но счётчик и длительность пишутся
|
|
15
|
+
*/
|
|
16
|
+
export declare class TransactionTracker {
|
|
17
|
+
private readonly metrics;
|
|
18
|
+
private readonly open;
|
|
19
|
+
constructor(metrics: TransactionMetrics);
|
|
20
|
+
/**
|
|
21
|
+
* Учитывает завершившийся запрос, который открывает или закрывает транзакцию
|
|
22
|
+
*
|
|
23
|
+
* @param startedAt начало запроса: для BEGIN это начало транзакции
|
|
24
|
+
*/
|
|
25
|
+
onBoundary(connection: object, scope: PoolScope, boundary: TransactionBoundary, startedAt: number, error: unknown, response: unknown): void;
|
|
26
|
+
/**
|
|
27
|
+
* Соединение закрыто с открытой транзакцией: БД её откатит
|
|
28
|
+
*/
|
|
29
|
+
onConnectionClosed(connection: object): void;
|
|
30
|
+
private begin;
|
|
31
|
+
private close;
|
|
32
|
+
}
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.TransactionTracker = void 0;
|
|
4
|
+
const clock_1 = require("../clock");
|
|
5
|
+
/**
|
|
6
|
+
* Отслеживает открытые транзакции по соединениям: в Postgres у соединения
|
|
7
|
+
* не больше одной транзакции верхнего уровня.
|
|
8
|
+
*
|
|
9
|
+
* После итога по пулу его ряд в `db_transactions_active` удалён: транзакции
|
|
10
|
+
* этого пула его больше не трогают, но счётчик и длительность пишутся
|
|
11
|
+
*/
|
|
12
|
+
class TransactionTracker {
|
|
13
|
+
metrics;
|
|
14
|
+
open = new WeakMap();
|
|
15
|
+
constructor(metrics) {
|
|
16
|
+
this.metrics = metrics;
|
|
17
|
+
}
|
|
18
|
+
/**
|
|
19
|
+
* Учитывает завершившийся запрос, который открывает или закрывает транзакцию
|
|
20
|
+
*
|
|
21
|
+
* @param startedAt начало запроса: для BEGIN это начало транзакции
|
|
22
|
+
*/
|
|
23
|
+
onBoundary(connection, scope, boundary, startedAt, error, response) {
|
|
24
|
+
if (boundary === 'begin') {
|
|
25
|
+
this.begin(connection, scope, startedAt, error);
|
|
26
|
+
return;
|
|
27
|
+
}
|
|
28
|
+
/**
|
|
29
|
+
* Postgres отвечает на COMMIT прерванной транзакции тегом ROLLBACK без ошибки,
|
|
30
|
+
* а упавший COMMIT (serialization failure, deferred constraint) тоже откатывает её
|
|
31
|
+
*/
|
|
32
|
+
const committed = boundary === 'commit' &&
|
|
33
|
+
!error &&
|
|
34
|
+
response?.command !== 'ROLLBACK';
|
|
35
|
+
this.close(connection, committed ? 'commit' : 'rollback');
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
* Соединение закрыто с открытой транзакцией: БД её откатит
|
|
39
|
+
*/
|
|
40
|
+
onConnectionClosed(connection) {
|
|
41
|
+
this.close(connection, 'rollback');
|
|
42
|
+
}
|
|
43
|
+
begin(connection, scope, startedAt, error) {
|
|
44
|
+
if (error || !scope.attached || this.open.has(connection)) {
|
|
45
|
+
return;
|
|
46
|
+
}
|
|
47
|
+
this.open.set(connection, { scope, startedAt });
|
|
48
|
+
this.metrics.active.inc({ pool: scope.pool });
|
|
49
|
+
}
|
|
50
|
+
close(connection, result) {
|
|
51
|
+
const transaction = this.open.get(connection);
|
|
52
|
+
if (!transaction) {
|
|
53
|
+
return;
|
|
54
|
+
}
|
|
55
|
+
this.open.delete(connection);
|
|
56
|
+
if (transaction.scope.attached) {
|
|
57
|
+
this.metrics.active.dec({ pool: transaction.scope.pool });
|
|
58
|
+
}
|
|
59
|
+
this.metrics.total.inc({ result });
|
|
60
|
+
this.metrics.duration.observe({ result }, (0, clock_1.secondsSince)(transaction.startedAt));
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
exports.TransactionTracker = TransactionTracker;
|
|
64
|
+
//# sourceMappingURL=transaction-tracker.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"transaction-tracker.js","sourceRoot":"","sources":["../../../src/metrics/instrumentation/transaction-tracker.ts"],"names":[],"mappings":";;;AAAA,oCAAwC;AAuBxC;;;;;;GAMG;AACH,MAAa,kBAAkB;IAGA;IAFZ,IAAI,GAAG,IAAI,OAAO,EAA2B,CAAC;IAE/D,YAA6B,OAA2B;QAA3B,YAAO,GAAP,OAAO,CAAoB;IAAG,CAAC;IAE5D;;;;OAIG;IACH,UAAU,CACR,UAAkB,EAClB,KAAgB,EAChB,QAA6B,EAC7B,SAAiB,EACjB,KAAc,EACd,QAAiB;QAEjB,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;YACzB,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;YAChD,OAAO;QACT,CAAC;QAED;;;WAGG;QACH,MAAM,SAAS,GACb,QAAQ,KAAK,QAAQ;YACrB,CAAC,KAAK;YACL,QAA6C,EAAE,OAAO,KAAK,UAAU,CAAC;QAEzE,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAC5D,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,UAAkB;QACnC,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACrC,CAAC;IAEO,KAAK,CACX,UAAkB,EAClB,KAAgB,EAChB,SAAiB,EACjB,KAAc;QAEd,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YAC1D,OAAO;QACT,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC;IAEO,KAAK,CAAC,UAAkB,EAAE,MAAyB;QACzD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC9C,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC7B,IAAI,WAAW,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QACnC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAC3B,EAAE,MAAM,EAAE,EACV,IAAA,oBAAY,EAAC,WAAW,CAAC,SAAS,CAAC,CACpC,CAAC;IACJ,CAAC;CACF;AAxED,gDAwEC"}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import type { Counter, Gauge, Histogram } from '@rsdk/core';
|
|
2
|
+
/**
|
|
3
|
+
* Counter, в который компонент только пишет
|
|
4
|
+
*/
|
|
5
|
+
export type CounterLike<T extends string = string> = Pick<Counter<T>, 'inc'>;
|
|
6
|
+
/**
|
|
7
|
+
* Gauge, который компонент увеличивает и уменьшает по ходу работы
|
|
8
|
+
*/
|
|
9
|
+
export type ActiveGaugeLike<T extends string = string> = Pick<Gauge<T>, 'inc' | 'dec'>;
|
|
10
|
+
/**
|
|
11
|
+
* Gauge, из которого компонент только удаляет свои ряды
|
|
12
|
+
*/
|
|
13
|
+
export type RemovableGaugeLike<T extends string = string> = Pick<Gauge<T>, 'remove'>;
|
|
14
|
+
/**
|
|
15
|
+
* Histogram, в который компонент только пишет
|
|
16
|
+
*/
|
|
17
|
+
export type HistogramLike<T extends string = string> = Pick<Histogram<T>, 'observe'>;
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"metric-types.js","sourceRoot":"","sources":["../../src/metrics/metric-types.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
import { Counter, Gauge, Histogram } from '@rsdk/core';
|
|
2
|
+
/**
|
|
3
|
+
* Границы `db_client_operation_duration_seconds`. Плагины берут их через
|
|
4
|
+
* `plugin-kit` для своих длительностей, которые должны сравниваться
|
|
5
|
+
* с длительностью запроса.
|
|
6
|
+
*
|
|
7
|
+
* Все массивы границ здесь неизменяемые, а prom-client получает их копию
|
|
8
|
+
* от `resolveDbMetric`: метрики с одной константой не делят один массив
|
|
9
|
+
*/
|
|
10
|
+
export declare const QUERY_BUCKETS: readonly number[];
|
|
11
|
+
export declare class DbClientOperationDuration extends Histogram<'operation' | 'status'> {
|
|
12
|
+
}
|
|
13
|
+
export declare class DbClientQueriesActive extends Gauge<'pool'> {
|
|
14
|
+
}
|
|
15
|
+
export declare class DbClientSlowQueries extends Counter<'operation'> {
|
|
16
|
+
}
|
|
17
|
+
export declare class DbClientQueryErrors extends Counter<'code'> {
|
|
18
|
+
}
|
|
19
|
+
export declare class DbPoolConnections extends Gauge<'pool' | 'state'> {
|
|
20
|
+
}
|
|
21
|
+
export declare class DbPoolConnectionsMax extends Gauge<'pool'> {
|
|
22
|
+
}
|
|
23
|
+
export declare class DbPoolConnectionsCreated extends Counter<'pool'> {
|
|
24
|
+
}
|
|
25
|
+
export declare class DbPoolConnectionsClosed extends Counter<'pool'> {
|
|
26
|
+
}
|
|
27
|
+
export declare class DbPoolAcquireDuration extends Histogram<'pool'> {
|
|
28
|
+
}
|
|
29
|
+
export declare class DbPoolAcquireTimeouts extends Counter<'pool'> {
|
|
30
|
+
}
|
|
31
|
+
export declare class DbPoolConnectionUsage extends Histogram<'pool'> {
|
|
32
|
+
}
|
|
33
|
+
export declare class DbPoolErrors extends Counter<'pool'> {
|
|
34
|
+
}
|
|
35
|
+
export declare class DbTransactions extends Counter<'result'> {
|
|
36
|
+
}
|
|
37
|
+
export declare class DbTransactionDuration extends Histogram<'result'> {
|
|
38
|
+
}
|
|
39
|
+
export declare class DbTransactionsActive extends Gauge<'pool'> {
|
|
40
|
+
}
|
|
41
|
+
export declare class OrmEntityOperations extends Counter<'entity' | 'op'> {
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* Метрики пула, запросов и транзакций, общие для всех ORM: ключ — под каким
|
|
45
|
+
* именем метрику получает `DbClientMetrics`. Набор записан только здесь: по
|
|
46
|
+
* этой таблице объявляются провайдеры (а через них autodoc) и создаются
|
|
47
|
+
* метрики в `DbClientMetrics.create`
|
|
48
|
+
*/
|
|
49
|
+
declare const CLIENT_METRICS: {
|
|
50
|
+
readonly duration: typeof DbClientOperationDuration;
|
|
51
|
+
readonly queriesActive: typeof DbClientQueriesActive;
|
|
52
|
+
readonly slow: typeof DbClientSlowQueries;
|
|
53
|
+
readonly errors: typeof DbClientQueryErrors;
|
|
54
|
+
readonly connections: typeof DbPoolConnections;
|
|
55
|
+
readonly connectionsMax: typeof DbPoolConnectionsMax;
|
|
56
|
+
readonly created: typeof DbPoolConnectionsCreated;
|
|
57
|
+
readonly closed: typeof DbPoolConnectionsClosed;
|
|
58
|
+
readonly acquireDuration: typeof DbPoolAcquireDuration;
|
|
59
|
+
readonly acquireTimeouts: typeof DbPoolAcquireTimeouts;
|
|
60
|
+
readonly usage: typeof DbPoolConnectionUsage;
|
|
61
|
+
readonly poolErrors: typeof DbPoolErrors;
|
|
62
|
+
readonly transactions: typeof DbTransactions;
|
|
63
|
+
readonly transactionDuration: typeof DbTransactionDuration;
|
|
64
|
+
readonly transactionsActive: typeof DbTransactionsActive;
|
|
65
|
+
};
|
|
66
|
+
type ClientMetricKey = keyof typeof CLIENT_METRICS;
|
|
67
|
+
/**
|
|
68
|
+
* Экземпляры метрик из {@link CLIENT_METRICS} под теми же ключами
|
|
69
|
+
*/
|
|
70
|
+
export type ClientMetrics = {
|
|
71
|
+
readonly [K in ClientMetricKey]: InstanceType<(typeof CLIENT_METRICS)[K]>;
|
|
72
|
+
};
|
|
73
|
+
/**
|
|
74
|
+
* Классы метрик из {@link CLIENT_METRICS}: по ним объявляются провайдеры
|
|
75
|
+
*/
|
|
76
|
+
export declare const DB_CLIENT_METRICS: (typeof DbClientOperationDuration | typeof DbClientQueriesActive | typeof DbClientSlowQueries | typeof DbClientQueryErrors | typeof DbPoolConnections | typeof DbPoolConnectionsMax | typeof DbPoolConnectionsCreated | typeof DbPoolConnectionsClosed | typeof DbPoolAcquireDuration | typeof DbPoolAcquireTimeouts | typeof DbPoolConnectionUsage | typeof DbPoolErrors | typeof DbTransactions | typeof DbTransactionDuration | typeof DbTransactionsActive)[];
|
|
77
|
+
/**
|
|
78
|
+
* Регистрирует (или берёт уже зарегистрированные) все метрики из
|
|
79
|
+
* {@link CLIENT_METRICS}
|
|
80
|
+
*/
|
|
81
|
+
export declare const resolveClientMetrics: () => ClientMetrics;
|
|
82
|
+
export {};
|