apcore-js 0.18.0 → 0.20.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/README.md +112 -9
- package/dist/acl-handlers.d.ts +14 -0
- package/dist/acl-handlers.d.ts.map +1 -1
- package/dist/acl-handlers.js +37 -4
- package/dist/acl-handlers.js.map +1 -1
- package/dist/acl.d.ts +22 -1
- package/dist/acl.d.ts.map +1 -1
- package/dist/acl.js +90 -34
- package/dist/acl.js.map +1 -1
- package/dist/async-task.d.ts +70 -16
- package/dist/async-task.d.ts.map +1 -1
- package/dist/async-task.js +212 -72
- package/dist/async-task.js.map +1 -1
- package/dist/bindings.d.ts.map +1 -1
- package/dist/bindings.js +113 -11
- package/dist/bindings.js.map +1 -1
- package/dist/builtin-steps.d.ts +33 -8
- package/dist/builtin-steps.d.ts.map +1 -1
- package/dist/builtin-steps.js +119 -47
- package/dist/builtin-steps.js.map +1 -1
- package/dist/client.d.ts +1 -0
- package/dist/client.d.ts.map +1 -1
- package/dist/client.js.map +1 -1
- package/dist/config.d.ts +38 -0
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +163 -33
- package/dist/config.js.map +1 -1
- package/dist/context.d.ts +34 -7
- package/dist/context.d.ts.map +1 -1
- package/dist/context.js +108 -40
- package/dist/context.js.map +1 -1
- package/dist/decorator.d.ts +3 -0
- package/dist/decorator.d.ts.map +1 -1
- package/dist/decorator.js +3 -0
- package/dist/decorator.js.map +1 -1
- package/dist/errors.d.ts +88 -2
- package/dist/errors.d.ts.map +1 -1
- package/dist/errors.js +231 -56
- package/dist/errors.js.map +1 -1
- package/dist/events/circuit-breaker.d.ts +45 -0
- package/dist/events/circuit-breaker.d.ts.map +1 -0
- package/dist/events/circuit-breaker.js +115 -0
- package/dist/events/circuit-breaker.js.map +1 -0
- package/dist/events/emitter.d.ts +24 -1
- package/dist/events/emitter.d.ts.map +1 -1
- package/dist/events/emitter.js +86 -12
- package/dist/events/emitter.js.map +1 -1
- package/dist/events/index.d.ts +4 -2
- package/dist/events/index.d.ts.map +1 -1
- package/dist/events/index.js +3 -2
- package/dist/events/index.js.map +1 -1
- package/dist/events/subscribers.d.ts +33 -1
- package/dist/events/subscribers.d.ts.map +1 -1
- package/dist/events/subscribers.js +124 -1
- package/dist/events/subscribers.js.map +1 -1
- package/dist/executor.d.ts +14 -3
- package/dist/executor.d.ts.map +1 -1
- package/dist/executor.js +155 -48
- package/dist/executor.js.map +1 -1
- package/dist/generated/version.d.ts +1 -1
- package/dist/generated/version.js +1 -1
- package/dist/index.d.ts +47 -25
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +35 -18
- package/dist/index.js.map +1 -1
- package/dist/middleware/base.d.ts +25 -3
- package/dist/middleware/base.d.ts.map +1 -1
- package/dist/middleware/base.js +24 -0
- package/dist/middleware/base.js.map +1 -1
- package/dist/middleware/circuit-breaker.d.ts +54 -0
- package/dist/middleware/circuit-breaker.d.ts.map +1 -0
- package/dist/middleware/circuit-breaker.js +168 -0
- package/dist/middleware/circuit-breaker.js.map +1 -0
- package/dist/middleware/context-namespace.d.ts +30 -0
- package/dist/middleware/context-namespace.d.ts.map +1 -0
- package/dist/middleware/context-namespace.js +38 -0
- package/dist/middleware/context-namespace.js.map +1 -0
- package/dist/middleware/index.d.ts +8 -2
- package/dist/middleware/index.d.ts.map +1 -1
- package/dist/middleware/index.js +5 -2
- package/dist/middleware/index.js.map +1 -1
- package/dist/middleware/logging.d.ts +6 -0
- package/dist/middleware/logging.d.ts.map +1 -1
- package/dist/middleware/logging.js +13 -3
- package/dist/middleware/logging.js.map +1 -1
- package/dist/middleware/manager.d.ts +11 -4
- package/dist/middleware/manager.d.ts.map +1 -1
- package/dist/middleware/manager.js +26 -9
- package/dist/middleware/manager.js.map +1 -1
- package/dist/middleware/platform-notify.d.ts +8 -4
- package/dist/middleware/platform-notify.d.ts.map +1 -1
- package/dist/middleware/platform-notify.js +15 -7
- package/dist/middleware/platform-notify.js.map +1 -1
- package/dist/middleware/retry.d.ts +16 -7
- package/dist/middleware/retry.d.ts.map +1 -1
- package/dist/middleware/retry.js +21 -15
- package/dist/middleware/retry.js.map +1 -1
- package/dist/middleware/tracing.d.ts +50 -0
- package/dist/middleware/tracing.d.ts.map +1 -0
- package/dist/middleware/tracing.js +89 -0
- package/dist/middleware/tracing.js.map +1 -0
- package/dist/observability/batch-span-processor.d.ts +48 -0
- package/dist/observability/batch-span-processor.d.ts.map +1 -0
- package/dist/observability/batch-span-processor.js +89 -0
- package/dist/observability/batch-span-processor.js.map +1 -0
- package/dist/observability/context-logger.d.ts +54 -1
- package/dist/observability/context-logger.d.ts.map +1 -1
- package/dist/observability/context-logger.js +287 -10
- package/dist/observability/context-logger.js.map +1 -1
- package/dist/observability/error-history.d.ts +36 -7
- package/dist/observability/error-history.d.ts.map +1 -1
- package/dist/observability/error-history.js +169 -50
- package/dist/observability/error-history.js.map +1 -1
- package/dist/observability/index.d.ts +16 -5
- package/dist/observability/index.d.ts.map +1 -1
- package/dist/observability/index.js +8 -3
- package/dist/observability/index.js.map +1 -1
- package/dist/observability/metrics-utils.d.ts.map +1 -1
- package/dist/observability/metrics-utils.js +3 -5
- package/dist/observability/metrics-utils.js.map +1 -1
- package/dist/observability/metrics.d.ts +15 -1
- package/dist/observability/metrics.d.ts.map +1 -1
- package/dist/observability/metrics.js +37 -3
- package/dist/observability/metrics.js.map +1 -1
- package/dist/observability/prometheus-exporter.d.ts +37 -0
- package/dist/observability/prometheus-exporter.d.ts.map +1 -0
- package/dist/observability/prometheus-exporter.js +135 -0
- package/dist/observability/prometheus-exporter.js.map +1 -0
- package/dist/observability/storage.d.ts +43 -0
- package/dist/observability/storage.d.ts.map +1 -0
- package/dist/observability/storage.js +58 -0
- package/dist/observability/storage.js.map +1 -0
- package/dist/observability/store.d.ts +29 -0
- package/dist/observability/store.d.ts.map +1 -0
- package/dist/observability/store.js +36 -0
- package/dist/observability/store.js.map +1 -0
- package/dist/observability/tracing.d.ts +2 -0
- package/dist/observability/tracing.d.ts.map +1 -1
- package/dist/observability/tracing.js +12 -2
- package/dist/observability/tracing.js.map +1 -1
- package/dist/observability/usage-exporter.d.ts +58 -0
- package/dist/observability/usage-exporter.d.ts.map +1 -0
- package/dist/observability/usage-exporter.js +86 -0
- package/dist/observability/usage-exporter.js.map +1 -0
- package/dist/observability/usage.d.ts +18 -1
- package/dist/observability/usage.d.ts.map +1 -1
- package/dist/observability/usage.js +35 -4
- package/dist/observability/usage.js.map +1 -1
- package/dist/pipeline-config.d.ts +24 -7
- package/dist/pipeline-config.d.ts.map +1 -1
- package/dist/pipeline-config.js +113 -19
- package/dist/pipeline-config.js.map +1 -1
- package/dist/pipeline.d.ts +123 -2
- package/dist/pipeline.d.ts.map +1 -1
- package/dist/pipeline.js +249 -50
- package/dist/pipeline.js.map +1 -1
- package/dist/registry/conflicts.d.ts +2 -2
- package/dist/registry/conflicts.d.ts.map +1 -1
- package/dist/registry/conflicts.js +10 -11
- package/dist/registry/conflicts.js.map +1 -1
- package/dist/registry/dependencies.d.ts +1 -1
- package/dist/registry/dependencies.d.ts.map +1 -1
- package/dist/registry/dependencies.js +69 -20
- package/dist/registry/dependencies.js.map +1 -1
- package/dist/registry/index.d.ts +2 -0
- package/dist/registry/index.d.ts.map +1 -1
- package/dist/registry/index.js +1 -0
- package/dist/registry/index.js.map +1 -1
- package/dist/registry/multi-class.d.ts +57 -0
- package/dist/registry/multi-class.d.ts.map +1 -0
- package/dist/registry/multi-class.js +120 -0
- package/dist/registry/multi-class.js.map +1 -0
- package/dist/registry/registry.d.ts +99 -4
- package/dist/registry/registry.d.ts.map +1 -1
- package/dist/registry/registry.js +291 -33
- package/dist/registry/registry.js.map +1 -1
- package/dist/registry/scanner.d.ts.map +1 -1
- package/dist/registry/scanner.js +6 -0
- package/dist/registry/scanner.js.map +1 -1
- package/dist/registry/version.d.ts +1 -0
- package/dist/registry/version.d.ts.map +1 -1
- package/dist/registry/version.js +33 -4
- package/dist/registry/version.js.map +1 -1
- package/dist/schema/constants.d.ts +9 -0
- package/dist/schema/constants.d.ts.map +1 -0
- package/dist/schema/constants.js +9 -0
- package/dist/schema/constants.js.map +1 -0
- package/dist/schema/extractor.d.ts +69 -0
- package/dist/schema/extractor.d.ts.map +1 -0
- package/dist/schema/extractor.js +142 -0
- package/dist/schema/extractor.js.map +1 -0
- package/dist/schema/index.d.ts +3 -1
- package/dist/schema/index.d.ts.map +1 -1
- package/dist/schema/index.js +2 -1
- package/dist/schema/index.js.map +1 -1
- package/dist/schema/loader.d.ts +27 -3
- package/dist/schema/loader.d.ts.map +1 -1
- package/dist/schema/loader.js +137 -32
- package/dist/schema/loader.js.map +1 -1
- package/dist/schema/ref-resolver.d.ts.map +1 -1
- package/dist/schema/ref-resolver.js +10 -1
- package/dist/schema/ref-resolver.js.map +1 -1
- package/dist/schema/types.d.ts +4 -0
- package/dist/schema/types.d.ts.map +1 -1
- package/dist/schema/types.js.map +1 -1
- package/dist/schema/validator.d.ts +9 -0
- package/dist/schema/validator.d.ts.map +1 -1
- package/dist/schema/validator.js +153 -4
- package/dist/schema/validator.js.map +1 -1
- package/dist/sys-modules/audit.d.ts +50 -0
- package/dist/sys-modules/audit.d.ts.map +1 -0
- package/dist/sys-modules/audit.js +89 -0
- package/dist/sys-modules/audit.js.map +1 -0
- package/dist/sys-modules/control.d.ts +32 -4
- package/dist/sys-modules/control.d.ts.map +1 -1
- package/dist/sys-modules/control.js +197 -23
- package/dist/sys-modules/control.js.map +1 -1
- package/dist/sys-modules/index.d.ts +7 -2
- package/dist/sys-modules/index.d.ts.map +1 -1
- package/dist/sys-modules/index.js +3 -1
- package/dist/sys-modules/index.js.map +1 -1
- package/dist/sys-modules/overrides.d.ts +58 -0
- package/dist/sys-modules/overrides.d.ts.map +1 -0
- package/dist/sys-modules/overrides.js +106 -0
- package/dist/sys-modules/overrides.js.map +1 -0
- package/dist/sys-modules/registration.d.ts +18 -1
- package/dist/sys-modules/registration.d.ts.map +1 -1
- package/dist/sys-modules/registration.js +115 -11
- package/dist/sys-modules/registration.js.map +1 -1
- package/dist/sys-modules/toggle.d.ts +7 -2
- package/dist/sys-modules/toggle.d.ts.map +1 -1
- package/dist/sys-modules/toggle.js +61 -5
- package/dist/sys-modules/toggle.js.map +1 -1
- package/dist/trace-context.d.ts +47 -9
- package/dist/trace-context.d.ts.map +1 -1
- package/dist/trace-context.js +139 -16
- package/dist/trace-context.js.map +1 -1
- package/dist/utils/index.d.ts.map +1 -1
- package/dist/utils/index.js +2 -1
- package/dist/utils/index.js.map +1 -1
- package/package.json +1 -1
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/observability/metrics.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;
|
|
1
|
+
{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/observability/metrics.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Prometheus text-format exporter with /metrics, /healthz, and /readyz HTTP endpoints.
|
|
3
|
+
*/
|
|
4
|
+
import type { MetricsCollector } from './metrics.js';
|
|
5
|
+
import type { UsageCollector } from './usage.js';
|
|
6
|
+
export interface PrometheusExporterStartOptions {
|
|
7
|
+
port?: number;
|
|
8
|
+
path?: string;
|
|
9
|
+
}
|
|
10
|
+
/**
|
|
11
|
+
* Serves Prometheus text metrics and K8s health endpoints over HTTP.
|
|
12
|
+
*
|
|
13
|
+
* Serves:
|
|
14
|
+
* GET {path} (default /metrics) — Prometheus text exposition format
|
|
15
|
+
* GET /healthz — liveness probe, always 200 OK
|
|
16
|
+
* GET /readyz — readiness probe, 200 OK after markReady() is called
|
|
17
|
+
*/
|
|
18
|
+
export declare class PrometheusExporter {
|
|
19
|
+
private readonly _collector;
|
|
20
|
+
private readonly _usageCollector;
|
|
21
|
+
private _server;
|
|
22
|
+
private _ready;
|
|
23
|
+
constructor(options: {
|
|
24
|
+
collector: MetricsCollector;
|
|
25
|
+
usageCollector?: UsageCollector;
|
|
26
|
+
});
|
|
27
|
+
/** Return current metrics in Prometheus text exposition format. */
|
|
28
|
+
export(): string;
|
|
29
|
+
private _exportUsageMetrics;
|
|
30
|
+
/** Signal that the application is ready to serve traffic (/readyz → 200). */
|
|
31
|
+
markReady(): void;
|
|
32
|
+
/** Start the HTTP server in a background listener. */
|
|
33
|
+
start(options?: PrometheusExporterStartOptions): void;
|
|
34
|
+
/** Shut down the HTTP server. */
|
|
35
|
+
stop(): Promise<void>;
|
|
36
|
+
}
|
|
37
|
+
//# sourceMappingURL=prometheus-exporter.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"prometheus-exporter.d.ts","sourceRoot":"","sources":["../../src/observability/prometheus-exporter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAWjD,MAAM,WAAW,8BAA8B;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;GAOG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmB;IAC9C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAwB;IACxD,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE;QAAE,SAAS,EAAE,gBAAgB,CAAC;QAAC,cAAc,CAAC,EAAE,cAAc,CAAA;KAAE;IAKrF,mEAAmE;IACnE,MAAM,IAAI,MAAM;IAQhB,OAAO,CAAC,mBAAmB;IA6C3B,6EAA6E;IAC7E,SAAS,IAAI,IAAI;IAIjB,sDAAsD;IACtD,KAAK,CAAC,OAAO,CAAC,EAAE,8BAA8B,GAAG,IAAI;IAsCrD,iCAAiC;IACjC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAUtB"}
|
|
@@ -0,0 +1,135 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Prometheus text-format exporter with /metrics, /healthz, and /readyz HTTP endpoints.
|
|
3
|
+
*/
|
|
4
|
+
import { createServer } from 'node:http';
|
|
5
|
+
function computePercentiles(values, ps) {
|
|
6
|
+
if (values.length === 0)
|
|
7
|
+
return ps.map(() => 0);
|
|
8
|
+
const sorted = [...values].sort((a, b) => a - b);
|
|
9
|
+
return ps.map((p) => {
|
|
10
|
+
const idx = Math.ceil((p / 100) * sorted.length) - 1;
|
|
11
|
+
return sorted[Math.max(0, idx)];
|
|
12
|
+
});
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
* Serves Prometheus text metrics and K8s health endpoints over HTTP.
|
|
16
|
+
*
|
|
17
|
+
* Serves:
|
|
18
|
+
* GET {path} (default /metrics) — Prometheus text exposition format
|
|
19
|
+
* GET /healthz — liveness probe, always 200 OK
|
|
20
|
+
* GET /readyz — readiness probe, 200 OK after markReady() is called
|
|
21
|
+
*/
|
|
22
|
+
export class PrometheusExporter {
|
|
23
|
+
_collector;
|
|
24
|
+
_usageCollector;
|
|
25
|
+
_server = null;
|
|
26
|
+
_ready = false;
|
|
27
|
+
constructor(options) {
|
|
28
|
+
this._collector = options.collector;
|
|
29
|
+
this._usageCollector = options.usageCollector ?? null;
|
|
30
|
+
}
|
|
31
|
+
/** Return current metrics in Prometheus text exposition format. */
|
|
32
|
+
export() {
|
|
33
|
+
let output = this._collector.exportPrometheus();
|
|
34
|
+
if (this._usageCollector !== null) {
|
|
35
|
+
output += this._exportUsageMetrics();
|
|
36
|
+
}
|
|
37
|
+
return output;
|
|
38
|
+
}
|
|
39
|
+
_exportUsageMetrics() {
|
|
40
|
+
const summaries = this._usageCollector.getSummary();
|
|
41
|
+
if (summaries.length === 0)
|
|
42
|
+
return '';
|
|
43
|
+
// Build per-metric-family lines so HELP/TYPE immediately precede each family's data.
|
|
44
|
+
const callsLines = [
|
|
45
|
+
'# HELP apcore_usage_calls_total Total usage calls by module and status',
|
|
46
|
+
'# TYPE apcore_usage_calls_total counter',
|
|
47
|
+
];
|
|
48
|
+
const errorRateLines = [
|
|
49
|
+
'# HELP apcore_usage_error_rate Module error rate (0.0-1.0)',
|
|
50
|
+
'# TYPE apcore_usage_error_rate gauge',
|
|
51
|
+
];
|
|
52
|
+
const p50Lines = [
|
|
53
|
+
'# HELP apcore_usage_p50_latency_ms Module p50 latency in milliseconds',
|
|
54
|
+
'# TYPE apcore_usage_p50_latency_ms gauge',
|
|
55
|
+
];
|
|
56
|
+
const p95Lines = [
|
|
57
|
+
'# HELP apcore_usage_p95_latency_ms Module p95 latency in milliseconds',
|
|
58
|
+
'# TYPE apcore_usage_p95_latency_ms gauge',
|
|
59
|
+
];
|
|
60
|
+
const p99Lines = [
|
|
61
|
+
'# HELP apcore_usage_p99_latency_ms Module p99 latency in milliseconds',
|
|
62
|
+
'# TYPE apcore_usage_p99_latency_ms gauge',
|
|
63
|
+
];
|
|
64
|
+
for (const summary of summaries) {
|
|
65
|
+
const { moduleId, callCount, errorCount } = summary;
|
|
66
|
+
const successCount = callCount - errorCount;
|
|
67
|
+
const errorRate = callCount > 0 ? errorCount / callCount : 0;
|
|
68
|
+
callsLines.push(`apcore_usage_calls_total{module_id="${moduleId}",status="success"} ${successCount}`);
|
|
69
|
+
callsLines.push(`apcore_usage_calls_total{module_id="${moduleId}",status="error"} ${errorCount}`);
|
|
70
|
+
errorRateLines.push(`apcore_usage_error_rate{module_id="${moduleId}"} ${errorRate}`);
|
|
71
|
+
const latencies = this._usageCollector.getLatencies(moduleId);
|
|
72
|
+
const [p50, p95, p99] = computePercentiles(latencies, [50, 95, 99]);
|
|
73
|
+
p50Lines.push(`apcore_usage_p50_latency_ms{module_id="${moduleId}"} ${p50}`);
|
|
74
|
+
p95Lines.push(`apcore_usage_p95_latency_ms{module_id="${moduleId}"} ${p95}`);
|
|
75
|
+
p99Lines.push(`apcore_usage_p99_latency_ms{module_id="${moduleId}"} ${p99}`);
|
|
76
|
+
}
|
|
77
|
+
return [...callsLines, ...errorRateLines, ...p50Lines, ...p95Lines, ...p99Lines].join('\n') + '\n';
|
|
78
|
+
}
|
|
79
|
+
/** Signal that the application is ready to serve traffic (/readyz → 200). */
|
|
80
|
+
markReady() {
|
|
81
|
+
this._ready = true;
|
|
82
|
+
}
|
|
83
|
+
/** Start the HTTP server in a background listener. */
|
|
84
|
+
start(options) {
|
|
85
|
+
const port = options?.port ?? 9090;
|
|
86
|
+
const metricsPath = options?.path ?? '/metrics';
|
|
87
|
+
if (this._server !== null) {
|
|
88
|
+
throw new Error('PrometheusExporter is already running. Call stop() first.');
|
|
89
|
+
}
|
|
90
|
+
const exporter = this;
|
|
91
|
+
this._server = createServer((req, res) => {
|
|
92
|
+
const url = req.url ?? '/';
|
|
93
|
+
if (url === metricsPath) {
|
|
94
|
+
const body = Buffer.from(exporter.export(), 'utf-8');
|
|
95
|
+
res.writeHead(200, {
|
|
96
|
+
'Content-Type': 'text/plain; version=0.0.4; charset=utf-8',
|
|
97
|
+
'Content-Length': String(body.length),
|
|
98
|
+
});
|
|
99
|
+
res.end(body);
|
|
100
|
+
}
|
|
101
|
+
else if (url === '/healthz') {
|
|
102
|
+
res.writeHead(200);
|
|
103
|
+
res.end('OK');
|
|
104
|
+
}
|
|
105
|
+
else if (url === '/readyz') {
|
|
106
|
+
if (exporter._ready) {
|
|
107
|
+
res.writeHead(200);
|
|
108
|
+
res.end('OK');
|
|
109
|
+
}
|
|
110
|
+
else {
|
|
111
|
+
res.writeHead(503);
|
|
112
|
+
res.end('Not ready');
|
|
113
|
+
}
|
|
114
|
+
}
|
|
115
|
+
else {
|
|
116
|
+
res.writeHead(404);
|
|
117
|
+
res.end();
|
|
118
|
+
}
|
|
119
|
+
});
|
|
120
|
+
this._server.listen(port);
|
|
121
|
+
}
|
|
122
|
+
/** Shut down the HTTP server. */
|
|
123
|
+
stop() {
|
|
124
|
+
return new Promise((resolve) => {
|
|
125
|
+
if (this._server !== null) {
|
|
126
|
+
this._server.close(() => resolve());
|
|
127
|
+
this._server = null;
|
|
128
|
+
}
|
|
129
|
+
else {
|
|
130
|
+
resolve();
|
|
131
|
+
}
|
|
132
|
+
});
|
|
133
|
+
}
|
|
134
|
+
}
|
|
135
|
+
//# sourceMappingURL=prometheus-exporter.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"prometheus-exporter.js","sourceRoot":"","sources":["../../src/observability/prometheus-exporter.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Pluggable observability storage backend (Issue #43 §1).
|
|
3
|
+
*
|
|
4
|
+
* Provides a language-agnostic key/value abstraction so SDK consumers can
|
|
5
|
+
* persist error history, usage records, and metric snapshots to redis,
|
|
6
|
+
* postgres, etc. without ErrorHistory / UsageCollector / MetricsCollector
|
|
7
|
+
* needing to know the underlying technology.
|
|
8
|
+
*
|
|
9
|
+
* The default `InMemoryStorageBackend` keeps everything in a Map and is the
|
|
10
|
+
* implicit fallback when no backend is supplied.
|
|
11
|
+
*/
|
|
12
|
+
/**
|
|
13
|
+
* Pluggable key/value storage backend.
|
|
14
|
+
*
|
|
15
|
+
* All operations may return synchronously or asynchronously — implementations
|
|
16
|
+
* targeting redis/postgres typically return Promises, while in-memory
|
|
17
|
+
* implementations return values directly. Callers should `await` the result.
|
|
18
|
+
*
|
|
19
|
+
* Namespaces partition the key space (e.g. "errors", "usage", "metrics") so
|
|
20
|
+
* a single backend instance can be shared by multiple collectors safely.
|
|
21
|
+
*/
|
|
22
|
+
export interface StorageBackend {
|
|
23
|
+
save(namespace: string, key: string, value: Record<string, unknown>): Promise<void> | void;
|
|
24
|
+
get(namespace: string, key: string): Promise<Record<string, unknown> | null> | Record<string, unknown> | null;
|
|
25
|
+
list(namespace: string, prefix?: string): Promise<Array<[string, Record<string, unknown>]>> | Array<[string, Record<string, unknown>]>;
|
|
26
|
+
delete(namespace: string, key: string): Promise<void> | void;
|
|
27
|
+
}
|
|
28
|
+
/**
|
|
29
|
+
* In-memory default backend.
|
|
30
|
+
*
|
|
31
|
+
* Each namespace is its own `Map<string, Record<string, unknown>>`. Values are
|
|
32
|
+
* stored by reference — callers that need snapshot semantics should clone
|
|
33
|
+
* before save. This is the implicit default when no backend is supplied to
|
|
34
|
+
* `ErrorHistory`, `UsageCollector`, or `MetricsCollector`.
|
|
35
|
+
*/
|
|
36
|
+
export declare class InMemoryStorageBackend implements StorageBackend {
|
|
37
|
+
private readonly _namespaces;
|
|
38
|
+
save(namespace: string, key: string, value: Record<string, unknown>): void;
|
|
39
|
+
get(namespace: string, key: string): Record<string, unknown> | null;
|
|
40
|
+
list(namespace: string, prefix?: string): Array<[string, Record<string, unknown>]>;
|
|
41
|
+
delete(namespace: string, key: string): void;
|
|
42
|
+
}
|
|
43
|
+
//# sourceMappingURL=storage.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/observability/storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,CACF,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAExB,GAAG,CACD,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAE5E,IAAI,CACF,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,GAEb,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,GACjD,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAE7C,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC9D;AAED;;;;;;;GAOG;AACH,qBAAa,sBAAuB,YAAW,cAAc;IAC3D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgE;IAE5F,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAS1E,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAMnE,IAAI,CACF,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,GACd,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAY3C,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;CAQ7C"}
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Pluggable observability storage backend (Issue #43 §1).
|
|
3
|
+
*
|
|
4
|
+
* Provides a language-agnostic key/value abstraction so SDK consumers can
|
|
5
|
+
* persist error history, usage records, and metric snapshots to redis,
|
|
6
|
+
* postgres, etc. without ErrorHistory / UsageCollector / MetricsCollector
|
|
7
|
+
* needing to know the underlying technology.
|
|
8
|
+
*
|
|
9
|
+
* The default `InMemoryStorageBackend` keeps everything in a Map and is the
|
|
10
|
+
* implicit fallback when no backend is supplied.
|
|
11
|
+
*/
|
|
12
|
+
/**
|
|
13
|
+
* In-memory default backend.
|
|
14
|
+
*
|
|
15
|
+
* Each namespace is its own `Map<string, Record<string, unknown>>`. Values are
|
|
16
|
+
* stored by reference — callers that need snapshot semantics should clone
|
|
17
|
+
* before save. This is the implicit default when no backend is supplied to
|
|
18
|
+
* `ErrorHistory`, `UsageCollector`, or `MetricsCollector`.
|
|
19
|
+
*/
|
|
20
|
+
export class InMemoryStorageBackend {
|
|
21
|
+
_namespaces = new Map();
|
|
22
|
+
save(namespace, key, value) {
|
|
23
|
+
let ns = this._namespaces.get(namespace);
|
|
24
|
+
if (ns === undefined) {
|
|
25
|
+
ns = new Map();
|
|
26
|
+
this._namespaces.set(namespace, ns);
|
|
27
|
+
}
|
|
28
|
+
ns.set(key, value);
|
|
29
|
+
}
|
|
30
|
+
get(namespace, key) {
|
|
31
|
+
const ns = this._namespaces.get(namespace);
|
|
32
|
+
if (ns === undefined)
|
|
33
|
+
return null;
|
|
34
|
+
return ns.get(key) ?? null;
|
|
35
|
+
}
|
|
36
|
+
list(namespace, prefix) {
|
|
37
|
+
const ns = this._namespaces.get(namespace);
|
|
38
|
+
if (ns === undefined)
|
|
39
|
+
return [];
|
|
40
|
+
const entries = [];
|
|
41
|
+
for (const [k, v] of ns.entries()) {
|
|
42
|
+
if (prefix === undefined || k.startsWith(prefix)) {
|
|
43
|
+
entries.push([k, v]);
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
return entries;
|
|
47
|
+
}
|
|
48
|
+
delete(namespace, key) {
|
|
49
|
+
const ns = this._namespaces.get(namespace);
|
|
50
|
+
if (ns === undefined)
|
|
51
|
+
return;
|
|
52
|
+
ns.delete(key);
|
|
53
|
+
if (ns.size === 0) {
|
|
54
|
+
this._namespaces.delete(namespace);
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
//# sourceMappingURL=storage.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/observability/storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAkCH;;;;;;;GAOG;AACH,MAAM,OAAO,sBAAsB;IAChB,WAAW,GAAsD,IAAI,GAAG,EAAE,CAAC;IAE5F,IAAI,CAAC,SAAiB,EAAE,GAAW,EAAE,KAA8B;QACjE,IAAI,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;YACrB,EAAE,GAAG,IAAI,GAAG,EAAE,CAAC;YACf,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACtC,CAAC;QACD,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACrB,CAAC;IAED,GAAG,CAAC,SAAiB,EAAE,GAAW;QAChC,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,EAAE,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QAClC,OAAO,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;IAC7B,CAAC;IAED,IAAI,CACF,SAAiB,EACjB,MAAe;QAEf,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,EAAE,KAAK,SAAS;YAAE,OAAO,EAAE,CAAC;QAChC,MAAM,OAAO,GAA6C,EAAE,CAAC;QAC7D,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC;YAClC,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,CAAC,SAAiB,EAAE,GAAW;QACnC,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,EAAE,KAAK,SAAS;YAAE,OAAO;QAC7B,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACf,IAAI,EAAE,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAClB,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;CACF"}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Pluggable observability storage backend interface and in-memory default.
|
|
3
|
+
*/
|
|
4
|
+
export interface MetricPoint {
|
|
5
|
+
readonly name: string;
|
|
6
|
+
readonly value: number;
|
|
7
|
+
readonly moduleId: string | null;
|
|
8
|
+
readonly labels: Record<string, string>;
|
|
9
|
+
readonly timestamp: string;
|
|
10
|
+
}
|
|
11
|
+
export interface ObservabilityStore {
|
|
12
|
+
recordError(entry: unknown): void;
|
|
13
|
+
getErrors(moduleId?: string | null, limit?: number | null): unknown[];
|
|
14
|
+
recordMetric(metric: MetricPoint): void;
|
|
15
|
+
getMetrics(moduleId?: string | null, metricName?: string | null): MetricPoint[];
|
|
16
|
+
flush(): void;
|
|
17
|
+
clear(): void;
|
|
18
|
+
}
|
|
19
|
+
export declare class InMemoryObservabilityStore implements ObservabilityStore {
|
|
20
|
+
private _errors;
|
|
21
|
+
private _metrics;
|
|
22
|
+
recordError(entry: unknown): void;
|
|
23
|
+
getErrors(moduleId?: string | null, limit?: number | null): unknown[];
|
|
24
|
+
recordMetric(metric: MetricPoint): void;
|
|
25
|
+
getMetrics(moduleId?: string | null, metricName?: string | null): MetricPoint[];
|
|
26
|
+
flush(): void;
|
|
27
|
+
clear(): void;
|
|
28
|
+
}
|
|
29
|
+
//# sourceMappingURL=store.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/observability/store.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAClC,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,EAAE,CAAC;IACtE,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IACxC,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,WAAW,EAAE,CAAC;IAChF,KAAK,IAAI,IAAI,CAAC;IACd,KAAK,IAAI,IAAI,CAAC;CACf;AAED,qBAAa,0BAA2B,YAAW,kBAAkB;IACnE,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,QAAQ,CAAqB;IAErC,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAIjC,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,EAAE;IAQrE,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAIvC,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,WAAW,EAAE;IAW/E,KAAK,IAAI,IAAI;IAEb,KAAK,IAAI,IAAI;CAId"}
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Pluggable observability storage backend interface and in-memory default.
|
|
3
|
+
*/
|
|
4
|
+
export class InMemoryObservabilityStore {
|
|
5
|
+
_errors = [];
|
|
6
|
+
_metrics = [];
|
|
7
|
+
recordError(entry) {
|
|
8
|
+
this._errors.push(entry);
|
|
9
|
+
}
|
|
10
|
+
getErrors(moduleId, limit) {
|
|
11
|
+
let entries = [...this._errors];
|
|
12
|
+
if (moduleId != null) {
|
|
13
|
+
entries = entries.filter((e) => e['moduleId'] === moduleId);
|
|
14
|
+
}
|
|
15
|
+
return limit != null ? entries.slice(0, limit) : entries;
|
|
16
|
+
}
|
|
17
|
+
recordMetric(metric) {
|
|
18
|
+
this._metrics.push(metric);
|
|
19
|
+
}
|
|
20
|
+
getMetrics(moduleId, metricName) {
|
|
21
|
+
let metrics = [...this._metrics];
|
|
22
|
+
if (moduleId != null) {
|
|
23
|
+
metrics = metrics.filter((m) => m.moduleId === moduleId);
|
|
24
|
+
}
|
|
25
|
+
if (metricName != null) {
|
|
26
|
+
metrics = metrics.filter((m) => m.name === metricName);
|
|
27
|
+
}
|
|
28
|
+
return metrics;
|
|
29
|
+
}
|
|
30
|
+
flush() { }
|
|
31
|
+
clear() {
|
|
32
|
+
this._errors = [];
|
|
33
|
+
this._metrics = [];
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
//# sourceMappingURL=store.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/observability/store.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmBH,MAAM,OAAO,0BAA0B;IAC7B,OAAO,GAAc,EAAE,CAAC;IACxB,QAAQ,GAAkB,EAAE,CAAC;IAErC,WAAW,CAAC,KAAc;QACxB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED,SAAS,CAAC,QAAwB,EAAE,KAAqB;QACvD,IAAI,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;YACrB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAE,CAA6B,CAAC,UAAU,CAAC,KAAK,QAAQ,CAAC,CAAC;QAC3F,CAAC;QACD,OAAO,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAC3D,CAAC;IAED,YAAY,CAAC,MAAmB;QAC9B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAED,UAAU,CAAC,QAAwB,EAAE,UAA0B;QAC7D,IAAI,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjC,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;YACrB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;YACvB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,KAAU,CAAC;IAEhB,KAAK;QACH,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QAClB,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;IACrB,CAAC;CACF"}
|
|
@@ -40,10 +40,12 @@ export declare class OTLPExporter implements SpanExporter {
|
|
|
40
40
|
private _endpoint;
|
|
41
41
|
private _serviceName;
|
|
42
42
|
private _headers;
|
|
43
|
+
private _timeoutMs;
|
|
43
44
|
constructor(options?: {
|
|
44
45
|
endpoint?: string;
|
|
45
46
|
serviceName?: string;
|
|
46
47
|
headers?: Record<string, string>;
|
|
48
|
+
timeoutMs?: number;
|
|
47
49
|
});
|
|
48
50
|
export(span: Span): void;
|
|
49
51
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../src/observability/tracing.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGnD,MAAM,WAAW,IAAI;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACxC;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC,GAAG,IAAI,CAYP;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;CAC1B;AAED,qBAAa,cAAe,YAAW,YAAY;IACjD,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;CAIzB;AAED,qBAAa,gBAAiB,YAAW,YAAY;IACnD,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,SAAS,CAAS;gBAEd,QAAQ,GAAE,MAAe;IAIrC,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAQxB,QAAQ,IAAI,IAAI,EAAE;IAIlB,KAAK,IAAI,IAAI;CAGd;AAED,qBAAa,YAAa,YAAW,YAAY;IAC/C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAyB;
|
|
1
|
+
{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../src/observability/tracing.ts"],"names":[],"mappings":"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"}
|
|
@@ -46,10 +46,12 @@ export class OTLPExporter {
|
|
|
46
46
|
_endpoint;
|
|
47
47
|
_serviceName;
|
|
48
48
|
_headers;
|
|
49
|
+
_timeoutMs;
|
|
49
50
|
constructor(options) {
|
|
50
51
|
this._endpoint = options?.endpoint ?? 'http://localhost:4318/v1/traces';
|
|
51
52
|
this._serviceName = options?.serviceName ?? 'apcore';
|
|
52
53
|
this._headers = options?.headers ?? {};
|
|
54
|
+
this._timeoutMs = options?.timeoutMs ?? 5000;
|
|
53
55
|
}
|
|
54
56
|
export(span) {
|
|
55
57
|
const payload = {
|
|
@@ -77,7 +79,10 @@ export class OTLPExporter {
|
|
|
77
79
|
}],
|
|
78
80
|
}],
|
|
79
81
|
};
|
|
80
|
-
// Fire-and-forget POST
|
|
82
|
+
// Fire-and-forget POST with timeout so a stuck OTLP backend does not
|
|
83
|
+
// accumulate pending promises and retain span data in memory.
|
|
84
|
+
const controller = new AbortController();
|
|
85
|
+
const timer = setTimeout(() => controller.abort(), this._timeoutMs);
|
|
81
86
|
fetch(this._endpoint, {
|
|
82
87
|
method: 'POST',
|
|
83
88
|
headers: {
|
|
@@ -85,8 +90,13 @@ export class OTLPExporter {
|
|
|
85
90
|
...this._headers,
|
|
86
91
|
},
|
|
87
92
|
body: JSON.stringify(payload),
|
|
88
|
-
|
|
93
|
+
signal: controller.signal,
|
|
94
|
+
})
|
|
95
|
+
.catch((err) => {
|
|
89
96
|
console.warn('[apcore:tracing] OTLP export failed:', err);
|
|
97
|
+
})
|
|
98
|
+
.finally(() => {
|
|
99
|
+
clearTimeout(timer);
|
|
90
100
|
});
|
|
91
101
|
}
|
|
92
102
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tracing.js","sourceRoot":"","sources":["../../src/observability/tracing.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAc9C,MAAM,UAAU,UAAU,CAAC,OAO1B;IACC,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,SAAS,CAAC,CAAC,CAAC;QACtC,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,IAAI;QAC1C,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,EAAE;QACpC,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,EAAE;KACX,CAAC;AACJ,CAAC;AAMD,MAAM,OAAO,cAAc;IACzB,MAAM,CAAC,IAAU;QACf,mEAAmE;QACnE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IACrC,CAAC;CACF;AAED,MAAM,OAAO,gBAAgB;IACnB,MAAM,GAAW,EAAE,CAAC;IACpB,SAAS,CAAS;IAE1B,YAAY,WAAmB,MAAM;QACnC,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC5B,CAAC;IAED,MAAM,CAAC,IAAU;QACf,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACzC,yEAAyE;YACzE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAED,QAAQ;QACN,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACnB,CAAC;CACF;AAED,MAAM,OAAO,YAAY;IACf,SAAS,CAAS;IAClB,YAAY,CAAS;IACrB,QAAQ,CAAyB;
|
|
1
|
+
{"version":3,"file":"tracing.js","sourceRoot":"","sources":["../../src/observability/tracing.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* UsageExporter — push interface for delivering UsageCollector summaries
|
|
3
|
+
* to external sinks on a schedule (Issue #45 §3).
|
|
4
|
+
*
|
|
5
|
+
* The collector pulls; the exporter pushes. Keep them decoupled so an
|
|
6
|
+
* application can swap in (for example) a Prometheus, OTLP, or HTTP
|
|
7
|
+
* exporter without changing how the collector is wired into the pipeline.
|
|
8
|
+
*
|
|
9
|
+
* Cross-language alignment: mirrors apcore-python's
|
|
10
|
+
* `apcore.observability.usage.UsageExporter` / `PeriodicUsageExporter` and
|
|
11
|
+
* the Rust trait in `apcore::observability::usage::UsageExporter`.
|
|
12
|
+
*/
|
|
13
|
+
import type { UsageCollector } from './usage.js';
|
|
14
|
+
/**
|
|
15
|
+
* Contract for a usage-summary sink.
|
|
16
|
+
*
|
|
17
|
+
* `export` is invoked by {@link PeriodicUsageExporter} (or any caller) with
|
|
18
|
+
* the latest summary snapshot. Implementations may be sync or async; the
|
|
19
|
+
* scheduler awaits whichever is returned.
|
|
20
|
+
*
|
|
21
|
+
* `shutdown` is invoked once during graceful teardown so an exporter can
|
|
22
|
+
* flush buffers, close sockets, etc.
|
|
23
|
+
*/
|
|
24
|
+
export interface UsageExporter {
|
|
25
|
+
export(summary: Record<string, unknown>): Promise<void> | void;
|
|
26
|
+
shutdown(): Promise<void> | void;
|
|
27
|
+
}
|
|
28
|
+
/**
|
|
29
|
+
* No-op exporter — the safe default. Useful as a placeholder when an
|
|
30
|
+
* application has registered a {@link PeriodicUsageExporter} but does not
|
|
31
|
+
* yet have a real backend wired up.
|
|
32
|
+
*/
|
|
33
|
+
export declare class NoopUsageExporter implements UsageExporter {
|
|
34
|
+
export(_summary: Record<string, unknown>): void;
|
|
35
|
+
shutdown(): void;
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
* Periodically pushes a {@link UsageCollector} summary into a
|
|
39
|
+
* {@link UsageExporter}.
|
|
40
|
+
*
|
|
41
|
+
* Default interval is 1 hour (3 600 000 ms) which matches apcore-python's
|
|
42
|
+
* `PeriodicUsageExporter` default. The first push happens one interval
|
|
43
|
+
* after `start()`; nothing is exported synchronously on start.
|
|
44
|
+
*/
|
|
45
|
+
export declare class PeriodicUsageExporter {
|
|
46
|
+
private readonly collector;
|
|
47
|
+
private readonly exporter;
|
|
48
|
+
private readonly intervalMs;
|
|
49
|
+
private _timer;
|
|
50
|
+
private _running;
|
|
51
|
+
constructor(collector: UsageCollector, exporter: UsageExporter, intervalMs?: number);
|
|
52
|
+
/** Begin periodic export. Idempotent — calling twice is a no-op. */
|
|
53
|
+
start(): void;
|
|
54
|
+
/** Stop the timer and await `exporter.shutdown()`. Idempotent. */
|
|
55
|
+
stop(): Promise<void>;
|
|
56
|
+
private _tick;
|
|
57
|
+
}
|
|
58
|
+
//# sourceMappingURL=usage-exporter.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"usage-exporter.d.ts","sourceRoot":"","sources":["../../src/observability/usage-exporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC/D,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAClC;AAED;;;;GAIG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IAErD,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/C,QAAQ,IAAI,IAAI;CAGjB;AAED;;;;;;;GAOG;AACH,qBAAa,qBAAqB;IAK9B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAN7B,OAAO,CAAC,MAAM,CAA+C;IAC7D,OAAO,CAAC,QAAQ,CAAS;gBAGN,SAAS,EAAE,cAAc,EACzB,QAAQ,EAAE,aAAa,EACvB,UAAU,GAAE,MAAkB;IAGjD,oEAAoE;IACpE,KAAK,IAAI,IAAI;IAQb,kEAAkE;IAC5D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B,OAAO,CAAC,KAAK;CAmBd"}
|