@scoutflo/alert-correlation 0.1.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 +34 -0
- package/dist/src/contracts/alertRef.d.ts +21 -0
- package/dist/src/contracts/alertRef.js +12 -0
- package/dist/src/contracts/alertRef.js.map +1 -0
- package/dist/src/contracts/context.d.ts +37 -0
- package/dist/src/contracts/context.js +3 -0
- package/dist/src/contracts/context.js.map +1 -0
- package/dist/src/contracts/decision.d.ts +29 -0
- package/dist/src/contracts/decision.js +3 -0
- package/dist/src/contracts/decision.js.map +1 -0
- package/dist/src/contracts/facts.d.ts +32 -0
- package/dist/src/contracts/facts.js +3 -0
- package/dist/src/contracts/facts.js.map +1 -0
- package/dist/src/contracts/index.d.ts +5 -0
- package/dist/src/contracts/index.js +22 -0
- package/dist/src/contracts/index.js.map +1 -0
- package/dist/src/contracts/topology.d.ts +38 -0
- package/dist/src/contracts/topology.js +3 -0
- package/dist/src/contracts/topology.js.map +1 -0
- package/dist/src/decision/decideTarget.d.ts +3 -0
- package/dist/src/decision/decideTarget.js +50 -0
- package/dist/src/decision/decideTarget.js.map +1 -0
- package/dist/src/decision/reasonCodes.d.ts +10 -0
- package/dist/src/decision/reasonCodes.js +13 -0
- package/dist/src/decision/reasonCodes.js.map +1 -0
- package/dist/src/extractors/genericExtractor.d.ts +23 -0
- package/dist/src/extractors/genericExtractor.js +162 -0
- package/dist/src/extractors/genericExtractor.js.map +1 -0
- package/dist/src/extractors/prometheusExtractor.d.ts +4 -0
- package/dist/src/extractors/prometheusExtractor.js +114 -0
- package/dist/src/extractors/prometheusExtractor.js.map +1 -0
- package/dist/src/extractors/registry.d.ts +4 -0
- package/dist/src/extractors/registry.js +23 -0
- package/dist/src/extractors/registry.js.map +1 -0
- package/dist/src/extractors/sentryExtractor.d.ts +2 -0
- package/dist/src/extractors/sentryExtractor.js +114 -0
- package/dist/src/extractors/sentryExtractor.js.map +1 -0
- package/dist/src/extractors/types.d.ts +12 -0
- package/dist/src/extractors/types.js +3 -0
- package/dist/src/extractors/types.js.map +1 -0
- package/dist/src/extractors/victoriaMetricsExtractor.d.ts +2 -0
- package/dist/src/extractors/victoriaMetricsExtractor.js +12 -0
- package/dist/src/extractors/victoriaMetricsExtractor.js.map +1 -0
- package/dist/src/index.d.ts +18 -0
- package/dist/src/index.js +36 -0
- package/dist/src/index.js.map +1 -0
- package/dist/src/matchers/providerRelationshipMatcher.d.ts +4 -0
- package/dist/src/matchers/providerRelationshipMatcher.js +111 -0
- package/dist/src/matchers/providerRelationshipMatcher.js.map +1 -0
- package/dist/src/matchers/types.d.ts +10 -0
- package/dist/src/matchers/types.js +3 -0
- package/dist/src/matchers/types.js.map +1 -0
- package/dist/src/resolveAlertCorrelation.d.ts +13 -0
- package/dist/src/resolveAlertCorrelation.js +17 -0
- package/dist/src/resolveAlertCorrelation.js.map +1 -0
- package/dist/src/time/normalizeAlertTime.d.ts +9 -0
- package/dist/src/time/normalizeAlertTime.js +25 -0
- package/dist/src/time/normalizeAlertTime.js.map +1 -0
- package/dist/test/contracts.test.d.ts +1 -0
- package/dist/test/contracts.test.js +39 -0
- package/dist/test/contracts.test.js.map +1 -0
- package/dist/test/decision.test.d.ts +1 -0
- package/dist/test/decision.test.js +50 -0
- package/dist/test/decision.test.js.map +1 -0
- package/dist/test/generic-extractor.test.d.ts +1 -0
- package/dist/test/generic-extractor.test.js +28 -0
- package/dist/test/generic-extractor.test.js.map +1 -0
- package/dist/test/prometheus-extractor.test.d.ts +1 -0
- package/dist/test/prometheus-extractor.test.js +29 -0
- package/dist/test/prometheus-extractor.test.js.map +1 -0
- package/dist/test/resolve-alert-correlation.test.d.ts +1 -0
- package/dist/test/resolve-alert-correlation.test.js +38 -0
- package/dist/test/resolve-alert-correlation.test.js.map +1 -0
- package/dist/test/sentry-extractor.test.d.ts +1 -0
- package/dist/test/sentry-extractor.test.js +30 -0
- package/dist/test/sentry-extractor.test.js.map +1 -0
- package/dist/test/smoke.test.d.ts +1 -0
- package/dist/test/smoke.test.js +12 -0
- package/dist/test/smoke.test.js.map +1 -0
- package/dist/test/time.test.d.ts +1 -0
- package/dist/test/time.test.js +30 -0
- package/dist/test/time.test.js.map +1 -0
- package/dist/test/victoriametrics-extractor.test.d.ts +1 -0
- package/dist/test/victoriametrics-extractor.test.js +27 -0
- package/dist/test/victoriametrics-extractor.test.js.map +1 -0
- package/package.json +32 -0
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
3
|
+
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
4
|
+
};
|
|
5
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
+
const strict_1 = __importDefault(require("node:assert/strict"));
|
|
7
|
+
const node_test_1 = __importDefault(require("node:test"));
|
|
8
|
+
const src_1 = require("../src");
|
|
9
|
+
(0, node_test_1.default)('alertRefSchema requires timestamp', () => {
|
|
10
|
+
const parsed = src_1.alertRefSchema.safeParse({
|
|
11
|
+
integrationId: 'int-prom',
|
|
12
|
+
provider: 'prometheus',
|
|
13
|
+
alertKey: 'prometheus:abc',
|
|
14
|
+
selectedAt: '2026-06-14T10:00:00.000Z',
|
|
15
|
+
});
|
|
16
|
+
strict_1.default.equal(parsed.success, false);
|
|
17
|
+
});
|
|
18
|
+
(0, node_test_1.default)('AlertCorrelationDecision supports degraded context', () => {
|
|
19
|
+
const decision = {
|
|
20
|
+
status: 'degraded',
|
|
21
|
+
target: null,
|
|
22
|
+
candidates: [],
|
|
23
|
+
evidence: [],
|
|
24
|
+
confidence: 0,
|
|
25
|
+
reasonCodes: ['source_resource_missing'],
|
|
26
|
+
};
|
|
27
|
+
strict_1.default.equal(decision.status, 'degraded');
|
|
28
|
+
});
|
|
29
|
+
(0, node_test_1.default)('AlertRef type includes selectedAt separately from timestamp', () => {
|
|
30
|
+
const ref = {
|
|
31
|
+
integrationId: 'int-sentry',
|
|
32
|
+
provider: 'sentry',
|
|
33
|
+
alertKey: 'sentry:issue-1',
|
|
34
|
+
timestamp: '2026-06-14T09:55:00.000Z',
|
|
35
|
+
selectedAt: '2026-06-14T10:00:00.000Z',
|
|
36
|
+
};
|
|
37
|
+
strict_1.default.notEqual(ref.timestamp, ref.selectedAt);
|
|
38
|
+
});
|
|
39
|
+
//# sourceMappingURL=contracts.test.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"contracts.test.js","sourceRoot":"","sources":["../../test/contracts.test.ts"],"names":[],"mappings":";;;;;AAAA,gEAAwC;AACxC,0DAA6B;AAC7B,gCAIgB;AAEhB,IAAA,mBAAI,EAAC,mCAAmC,EAAE,GAAG,EAAE;IAC7C,MAAM,MAAM,GAAG,oBAAc,CAAC,SAAS,CAAC;QACtC,aAAa,EAAE,UAAU;QACzB,QAAQ,EAAE,YAAY;QACtB,QAAQ,EAAE,gBAAgB;QAC1B,UAAU,EAAE,0BAA0B;KACvC,CAAC,CAAC;IAEH,gBAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AACtC,CAAC,CAAC,CAAC;AAEH,IAAA,mBAAI,EAAC,oDAAoD,EAAE,GAAG,EAAE;IAC9D,MAAM,QAAQ,GAA6B;QACzC,MAAM,EAAE,UAAU;QAClB,MAAM,EAAE,IAAI;QACZ,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE,CAAC;QACb,WAAW,EAAE,CAAC,yBAAyB,CAAC;KACzC,CAAC;IAEF,gBAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAC5C,CAAC,CAAC,CAAC;AAEH,IAAA,mBAAI,EAAC,6DAA6D,EAAE,GAAG,EAAE;IACvE,MAAM,GAAG,GAAa;QACpB,aAAa,EAAE,YAAY;QAC3B,QAAQ,EAAE,QAAQ;QAClB,QAAQ,EAAE,gBAAgB;QAC1B,SAAS,EAAE,0BAA0B;QACrC,UAAU,EAAE,0BAA0B;KACvC,CAAC;IAEF,gBAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;AACjD,CAAC,CAAC,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
3
|
+
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
4
|
+
};
|
|
5
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
+
const strict_1 = __importDefault(require("node:assert/strict"));
|
|
7
|
+
const node_test_1 = __importDefault(require("node:test"));
|
|
8
|
+
const src_1 = require("../src");
|
|
9
|
+
(0, node_test_1.default)('resolves single topology-scoped high confidence service', () => {
|
|
10
|
+
const decision = (0, src_1.decideTarget)([
|
|
11
|
+
{
|
|
12
|
+
target: { type: 'service', id: 'svc-checkout' },
|
|
13
|
+
name: 'checkout',
|
|
14
|
+
confidence: 10,
|
|
15
|
+
evidence: [
|
|
16
|
+
{
|
|
17
|
+
kind: 'relationship_attribute',
|
|
18
|
+
factKey: 'service',
|
|
19
|
+
factValue: 'checkout',
|
|
20
|
+
relationshipId: 'rel-1',
|
|
21
|
+
reason: 'serviceLabel exact match',
|
|
22
|
+
},
|
|
23
|
+
],
|
|
24
|
+
reasonCodes: ['relationship_attribute_match'],
|
|
25
|
+
},
|
|
26
|
+
]);
|
|
27
|
+
strict_1.default.equal(decision.status, 'resolved');
|
|
28
|
+
strict_1.default.deepEqual(decision.target, { type: 'service', id: 'svc-checkout' });
|
|
29
|
+
});
|
|
30
|
+
(0, node_test_1.default)('keeps multiple high confidence services ambiguous', () => {
|
|
31
|
+
const decision = (0, src_1.decideTarget)([
|
|
32
|
+
{ target: { type: 'service', id: 'svc-a' }, confidence: 9, evidence: [], reasonCodes: [] },
|
|
33
|
+
{ target: { type: 'service', id: 'svc-b' }, confidence: 9, evidence: [], reasonCodes: [] },
|
|
34
|
+
]);
|
|
35
|
+
strict_1.default.equal(decision.status, 'ambiguous');
|
|
36
|
+
strict_1.default.equal(decision.target, null);
|
|
37
|
+
});
|
|
38
|
+
(0, node_test_1.default)('does not deterministically resolve weak raw-name evidence', () => {
|
|
39
|
+
const decision = (0, src_1.decideTarget)([
|
|
40
|
+
{
|
|
41
|
+
target: { type: 'service', id: 'svc-checkout' },
|
|
42
|
+
confidence: 5,
|
|
43
|
+
evidence: [{ kind: 'raw_alert_field', factKey: 'service', factValue: 'checkout', reason: 'raw label only' }],
|
|
44
|
+
reasonCodes: ['raw_label_candidate'],
|
|
45
|
+
},
|
|
46
|
+
]);
|
|
47
|
+
strict_1.default.equal(decision.status, 'ambiguous');
|
|
48
|
+
strict_1.default.equal(decision.target, null);
|
|
49
|
+
});
|
|
50
|
+
//# sourceMappingURL=decision.test.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"decision.test.js","sourceRoot":"","sources":["../../test/decision.test.ts"],"names":[],"mappings":";;;;;AAAA,gEAAwC;AACxC,0DAA6B;AAC7B,gCAAsC;AAEtC,IAAA,mBAAI,EAAC,yDAAyD,EAAE,GAAG,EAAE;IACnE,MAAM,QAAQ,GAAG,IAAA,kBAAY,EAAC;QAC5B;YACE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,cAAc,EAAE;YAC/C,IAAI,EAAE,UAAU;YAChB,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,wBAAwB;oBAC9B,OAAO,EAAE,SAAS;oBAClB,SAAS,EAAE,UAAU;oBACrB,cAAc,EAAE,OAAO;oBACvB,MAAM,EAAE,0BAA0B;iBACnC;aACF;YACD,WAAW,EAAE,CAAC,8BAA8B,CAAC;SAC9C;KACF,CAAC,CAAC;IAEH,gBAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC1C,gBAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC;AAC7E,CAAC,CAAC,CAAC;AAEH,IAAA,mBAAI,EAAC,mDAAmD,EAAE,GAAG,EAAE;IAC7D,MAAM,QAAQ,GAAG,IAAA,kBAAY,EAAC;QAC5B,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;QAC1F,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;KAC3F,CAAC,CAAC;IAEH,gBAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC3C,gBAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AACtC,CAAC,CAAC,CAAC;AAEH,IAAA,mBAAI,EAAC,2DAA2D,EAAE,GAAG,EAAE;IACrE,MAAM,QAAQ,GAAG,IAAA,kBAAY,EAAC;QAC5B;YACE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,cAAc,EAAE;YAC/C,UAAU,EAAE,CAAC;YACb,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;YAC5G,WAAW,EAAE,CAAC,qBAAqB,CAAC;SACrC;KACF,CAAC,CAAC;IAEH,gBAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC3C,gBAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AACtC,CAAC,CAAC,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
3
|
+
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
4
|
+
};
|
|
5
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
+
const strict_1 = __importDefault(require("node:assert/strict"));
|
|
7
|
+
const node_test_1 = __importDefault(require("node:test"));
|
|
8
|
+
const src_1 = require("../src");
|
|
9
|
+
(0, node_test_1.default)('generic extractor finds common labels and summary fields', () => {
|
|
10
|
+
const facts = (0, src_1.extractAlertFacts)({
|
|
11
|
+
alertRef: {
|
|
12
|
+
integrationId: 'int-generic',
|
|
13
|
+
provider: 'unknown',
|
|
14
|
+
alertKey: 'unknown:1',
|
|
15
|
+
timestamp: '2026-06-14T09:55:00.000Z',
|
|
16
|
+
selectedAt: '2026-06-14T10:00:00.000Z',
|
|
17
|
+
},
|
|
18
|
+
raw: {
|
|
19
|
+
title: 'High CPU',
|
|
20
|
+
labels: { service: 'payments', namespace: 'prod' },
|
|
21
|
+
severity: 'critical',
|
|
22
|
+
},
|
|
23
|
+
});
|
|
24
|
+
strict_1.default.equal(facts.provider, 'unknown');
|
|
25
|
+
strict_1.default.equal(facts.title?.value, 'High CPU');
|
|
26
|
+
strict_1.default.ok(facts.labels.some((fact) => fact.key === 'service' && fact.value === 'payments'));
|
|
27
|
+
});
|
|
28
|
+
//# sourceMappingURL=generic-extractor.test.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"generic-extractor.test.js","sourceRoot":"","sources":["../../test/generic-extractor.test.ts"],"names":[],"mappings":";;;;;AAAA,gEAAwC;AACxC,0DAA6B;AAC7B,gCAA2C;AAE3C,IAAA,mBAAI,EAAC,0DAA0D,EAAE,GAAG,EAAE;IACpE,MAAM,KAAK,GAAG,IAAA,uBAAiB,EAAC;QAC9B,QAAQ,EAAE;YACR,aAAa,EAAE,aAAa;YAC5B,QAAQ,EAAE,SAAS;YACnB,QAAQ,EAAE,WAAW;YACrB,SAAS,EAAE,0BAA0B;YACrC,UAAU,EAAE,0BAA0B;SACvC;QACD,GAAG,EAAE;YACH,KAAK,EAAE,UAAU;YACjB,MAAM,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE;YAClD,QAAQ,EAAE,UAAU;SACrB;KACF,CAAC,CAAC;IAEH,gBAAM,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACxC,gBAAM,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IAC7C,gBAAM,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC;AAC9F,CAAC,CAAC,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
3
|
+
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
4
|
+
};
|
|
5
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
+
const strict_1 = __importDefault(require("node:assert/strict"));
|
|
7
|
+
const node_test_1 = __importDefault(require("node:test"));
|
|
8
|
+
const src_1 = require("../src");
|
|
9
|
+
(0, node_test_1.default)('prometheus extractor merges labels from alertmanager shapes', () => {
|
|
10
|
+
const facts = (0, src_1.extractAlertFacts)({
|
|
11
|
+
alertRef: {
|
|
12
|
+
integrationId: 'int-prom',
|
|
13
|
+
provider: 'prometheus',
|
|
14
|
+
alertKey: 'prometheus:fingerprint',
|
|
15
|
+
timestamp: '2026-06-14T09:55:00.000Z',
|
|
16
|
+
selectedAt: '2026-06-14T10:00:00.000Z',
|
|
17
|
+
},
|
|
18
|
+
raw: {
|
|
19
|
+
commonLabels: { alertname: 'HighLatency', service: 'checkout' },
|
|
20
|
+
alerts: [{ labels: { namespace: 'prod', pod: 'checkout-abc-12345' } }],
|
|
21
|
+
startsAt: '2026-06-14T09:50:00.000Z',
|
|
22
|
+
},
|
|
23
|
+
});
|
|
24
|
+
strict_1.default.equal(facts.extractor.name, 'prometheus-extractor');
|
|
25
|
+
strict_1.default.ok(facts.labels.some((fact) => fact.key === 'service' && fact.value === 'checkout'));
|
|
26
|
+
strict_1.default.ok(facts.labels.some((fact) => fact.key === 'namespace' && fact.value === 'prod'));
|
|
27
|
+
strict_1.default.equal(facts.time.startsAt, '2026-06-14T09:50:00.000Z');
|
|
28
|
+
});
|
|
29
|
+
//# sourceMappingURL=prometheus-extractor.test.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"prometheus-extractor.test.js","sourceRoot":"","sources":["../../test/prometheus-extractor.test.ts"],"names":[],"mappings":";;;;;AAAA,gEAAwC;AACxC,0DAA6B;AAC7B,gCAA2C;AAE3C,IAAA,mBAAI,EAAC,6DAA6D,EAAE,GAAG,EAAE;IACvE,MAAM,KAAK,GAAG,IAAA,uBAAiB,EAAC;QAC9B,QAAQ,EAAE;YACR,aAAa,EAAE,UAAU;YACzB,QAAQ,EAAE,YAAY;YACtB,QAAQ,EAAE,wBAAwB;YAClC,SAAS,EAAE,0BAA0B;YACrC,UAAU,EAAE,0BAA0B;SACvC;QACD,GAAG,EAAE;YACH,YAAY,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE;YAC/D,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,oBAAoB,EAAE,EAAE,CAAC;YACtE,QAAQ,EAAE,0BAA0B;SACrC;KACF,CAAC,CAAC;IAEH,gBAAM,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,sBAAsB,CAAC,CAAC;IAC3D,gBAAM,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC;IAC5F,gBAAM,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,WAAW,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC;IAC1F,gBAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,0BAA0B,CAAC,CAAC;AAChE,CAAC,CAAC,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
3
|
+
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
4
|
+
};
|
|
5
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
+
const strict_1 = __importDefault(require("node:assert/strict"));
|
|
7
|
+
const node_test_1 = __importDefault(require("node:test"));
|
|
8
|
+
const src_1 = require("../src");
|
|
9
|
+
(0, node_test_1.default)('extracts facts and resolves service from topology relationship', () => {
|
|
10
|
+
const result = (0, src_1.resolveAlertCorrelation)({
|
|
11
|
+
alertRef: {
|
|
12
|
+
integrationId: 'int-prom',
|
|
13
|
+
provider: 'prometheus',
|
|
14
|
+
alertKey: 'prometheus:abc',
|
|
15
|
+
timestamp: '2026-06-14T09:55:00.000Z',
|
|
16
|
+
selectedAt: '2026-06-14T10:00:00.000Z',
|
|
17
|
+
},
|
|
18
|
+
rawAlert: { labels: { service: 'checkout' } },
|
|
19
|
+
topology: {
|
|
20
|
+
sourceResource: { id: 'res-prom', name: 'Prometheus', provider: 'prometheus' },
|
|
21
|
+
monitoredByRelationships: [
|
|
22
|
+
{
|
|
23
|
+
id: 'rel-1',
|
|
24
|
+
relation: 'MONITORED_BY',
|
|
25
|
+
from: { type: 'service', id: 'svc-checkout' },
|
|
26
|
+
to: { type: 'resource', id: 'res-prom' },
|
|
27
|
+
attributes: { serviceLabel: 'checkout' },
|
|
28
|
+
},
|
|
29
|
+
],
|
|
30
|
+
deployedAsRelationships: [],
|
|
31
|
+
services: [{ id: 'svc-checkout', name: 'checkout' }],
|
|
32
|
+
resources: [],
|
|
33
|
+
},
|
|
34
|
+
});
|
|
35
|
+
strict_1.default.equal(result.decision.status, 'resolved');
|
|
36
|
+
strict_1.default.deepEqual(result.decision.target, { type: 'service', id: 'svc-checkout' });
|
|
37
|
+
});
|
|
38
|
+
//# sourceMappingURL=resolve-alert-correlation.test.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"resolve-alert-correlation.test.js","sourceRoot":"","sources":["../../test/resolve-alert-correlation.test.ts"],"names":[],"mappings":";;;;;AAAA,gEAAwC;AACxC,0DAA6B;AAC7B,gCAAiD;AAEjD,IAAA,mBAAI,EAAC,gEAAgE,EAAE,GAAG,EAAE;IAC1E,MAAM,MAAM,GAAG,IAAA,6BAAuB,EAAC;QACrC,QAAQ,EAAE;YACR,aAAa,EAAE,UAAU;YACzB,QAAQ,EAAE,YAAY;YACtB,QAAQ,EAAE,gBAAgB;YAC1B,SAAS,EAAE,0BAA0B;YACrC,UAAU,EAAE,0BAA0B;SACvC;QACD,QAAQ,EAAE,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE;QAC7C,QAAQ,EAAE;YACR,cAAc,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE;YAC9E,wBAAwB,EAAE;gBACxB;oBACE,EAAE,EAAE,OAAO;oBACX,QAAQ,EAAE,cAAc;oBACxB,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,cAAc,EAAE;oBAC7C,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE;oBACxC,UAAU,EAAE,EAAE,YAAY,EAAE,UAAU,EAAE;iBACzC;aACF;YACD,uBAAuB,EAAE,EAAE;YAC3B,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;YACpD,SAAS,EAAE,EAAE;SACd;KACF,CAAC,CAAC;IAEH,gBAAM,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACjD,gBAAM,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC;AACpF,CAAC,CAAC,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
3
|
+
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
4
|
+
};
|
|
5
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
+
const strict_1 = __importDefault(require("node:assert/strict"));
|
|
7
|
+
const node_test_1 = __importDefault(require("node:test"));
|
|
8
|
+
const src_1 = require("../src");
|
|
9
|
+
(0, node_test_1.default)('sentry extractor pulls project, release package, and microservice tag', () => {
|
|
10
|
+
const facts = (0, src_1.extractAlertFacts)({
|
|
11
|
+
alertRef: {
|
|
12
|
+
integrationId: 'int-sentry',
|
|
13
|
+
provider: 'sentry',
|
|
14
|
+
alertKey: 'sentry:issue-1',
|
|
15
|
+
timestamp: '2026-06-14T09:55:00.000Z',
|
|
16
|
+
selectedAt: '2026-06-14T10:00:00.000Z',
|
|
17
|
+
},
|
|
18
|
+
raw: {
|
|
19
|
+
title: 'TypeError',
|
|
20
|
+
project: { slug: 'checkout-api' },
|
|
21
|
+
firstRelease: { versionInfo: { package: 'checkout' } },
|
|
22
|
+
tags: [{ key: 'microservice', value: 'checkout' }],
|
|
23
|
+
},
|
|
24
|
+
});
|
|
25
|
+
strict_1.default.equal(facts.extractor.name, 'sentry-extractor');
|
|
26
|
+
strict_1.default.ok(facts.identifiers.some((fact) => fact.key === 'projectSlug' && fact.value === 'checkout-api'));
|
|
27
|
+
strict_1.default.ok(facts.identifiers.some((fact) => fact.key === 'releasePackage' && fact.value === 'checkout'));
|
|
28
|
+
strict_1.default.ok(facts.labels.some((fact) => fact.key === 'microservice' && fact.value === 'checkout'));
|
|
29
|
+
});
|
|
30
|
+
//# sourceMappingURL=sentry-extractor.test.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"sentry-extractor.test.js","sourceRoot":"","sources":["../../test/sentry-extractor.test.ts"],"names":[],"mappings":";;;;;AAAA,gEAAwC;AACxC,0DAA6B;AAC7B,gCAA2C;AAE3C,IAAA,mBAAI,EAAC,uEAAuE,EAAE,GAAG,EAAE;IACjF,MAAM,KAAK,GAAG,IAAA,uBAAiB,EAAC;QAC9B,QAAQ,EAAE;YACR,aAAa,EAAE,YAAY;YAC3B,QAAQ,EAAE,QAAQ;YAClB,QAAQ,EAAE,gBAAgB;YAC1B,SAAS,EAAE,0BAA0B;YACrC,UAAU,EAAE,0BAA0B;SACvC;QACD,GAAG,EAAE;YACH,KAAK,EAAE,WAAW;YAClB,OAAO,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE;YACjC,YAAY,EAAE,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE;YACtD,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;SACnD;KACF,CAAC,CAAC;IAEH,gBAAM,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;IACvD,gBAAM,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,aAAa,IAAI,IAAI,CAAC,KAAK,KAAK,cAAc,CAAC,CAAC,CAAC;IACzG,gBAAM,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,gBAAgB,IAAI,IAAI,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC;IACxG,gBAAM,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,cAAc,IAAI,IAAI,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC;AACnG,CAAC,CAAC,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
3
|
+
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
4
|
+
};
|
|
5
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
+
const strict_1 = __importDefault(require("node:assert/strict"));
|
|
7
|
+
const node_test_1 = __importDefault(require("node:test"));
|
|
8
|
+
const src_1 = require("../src");
|
|
9
|
+
(0, node_test_1.default)('exports package marker', () => {
|
|
10
|
+
strict_1.default.equal(src_1.ALERT_CORRELATION_PACKAGE, '@scoutflo/alert-correlation');
|
|
11
|
+
});
|
|
12
|
+
//# sourceMappingURL=smoke.test.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"smoke.test.js","sourceRoot":"","sources":["../../test/smoke.test.ts"],"names":[],"mappings":";;;;;AAAA,gEAAwC;AACxC,0DAA6B;AAC7B,gCAAmD;AAEnD,IAAA,mBAAI,EAAC,wBAAwB,EAAE,GAAG,EAAE;IAClC,gBAAM,CAAC,KAAK,CAAC,+BAAyB,EAAE,6BAA6B,CAAC,CAAC;AACzE,CAAC,CAAC,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
3
|
+
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
4
|
+
};
|
|
5
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
+
const strict_1 = __importDefault(require("node:assert/strict"));
|
|
7
|
+
const node_test_1 = __importDefault(require("node:test"));
|
|
8
|
+
const src_1 = require("../src");
|
|
9
|
+
const ref = {
|
|
10
|
+
integrationId: 'int-prom',
|
|
11
|
+
provider: 'prometheus',
|
|
12
|
+
alertKey: 'prometheus:abc',
|
|
13
|
+
timestamp: '2026-06-14T09:55:00.000Z',
|
|
14
|
+
selectedAt: '2026-06-14T10:00:00.000Z',
|
|
15
|
+
};
|
|
16
|
+
(0, node_test_1.default)('uses provider startsAt before alertRef timestamp', () => {
|
|
17
|
+
const time = (0, src_1.normalizeAlertTime)(ref, {
|
|
18
|
+
startsAt: '2026-06-14T09:50:00.000Z',
|
|
19
|
+
endsAt: '2026-06-14T09:59:00.000Z',
|
|
20
|
+
});
|
|
21
|
+
strict_1.default.equal(time.startsAt, '2026-06-14T09:50:00.000Z');
|
|
22
|
+
strict_1.default.equal(time.endsAt, '2026-06-14T09:59:00.000Z');
|
|
23
|
+
strict_1.default.equal(time.isOpenEnded, false);
|
|
24
|
+
});
|
|
25
|
+
(0, node_test_1.default)('falls back to alertRef timestamp when provider time is absent', () => {
|
|
26
|
+
const time = (0, src_1.normalizeAlertTime)(ref, {});
|
|
27
|
+
strict_1.default.equal(time.startsAt, ref.timestamp);
|
|
28
|
+
strict_1.default.equal(time.isOpenEnded, true);
|
|
29
|
+
});
|
|
30
|
+
//# sourceMappingURL=time.test.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"time.test.js","sourceRoot":"","sources":["../../test/time.test.ts"],"names":[],"mappings":";;;;;AAAA,gEAAwC;AACxC,0DAA6B;AAC7B,gCAA4C;AAE5C,MAAM,GAAG,GAAG;IACV,aAAa,EAAE,UAAU;IACzB,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE,gBAAgB;IAC1B,SAAS,EAAE,0BAA0B;IACrC,UAAU,EAAE,0BAA0B;CACvC,CAAC;AAEF,IAAA,mBAAI,EAAC,kDAAkD,EAAE,GAAG,EAAE;IAC5D,MAAM,IAAI,GAAG,IAAA,wBAAkB,EAAC,GAAG,EAAE;QACnC,QAAQ,EAAE,0BAA0B;QACpC,MAAM,EAAE,0BAA0B;KACnC,CAAC,CAAC;IAEH,gBAAM,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,0BAA0B,CAAC,CAAC;IACxD,gBAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;IACtD,gBAAM,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;AACxC,CAAC,CAAC,CAAC;AAEH,IAAA,mBAAI,EAAC,+DAA+D,EAAE,GAAG,EAAE;IACzE,MAAM,IAAI,GAAG,IAAA,wBAAkB,EAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACzC,gBAAM,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;IAC3C,gBAAM,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;AACvC,CAAC,CAAC,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
3
|
+
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
4
|
+
};
|
|
5
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
+
const strict_1 = __importDefault(require("node:assert/strict"));
|
|
7
|
+
const node_test_1 = __importDefault(require("node:test"));
|
|
8
|
+
const src_1 = require("../src");
|
|
9
|
+
(0, node_test_1.default)('victoriametrics extractor keeps VM provider identity', () => {
|
|
10
|
+
const facts = (0, src_1.extractAlertFacts)({
|
|
11
|
+
alertRef: {
|
|
12
|
+
integrationId: 'int-vm',
|
|
13
|
+
provider: 'victoriametrics',
|
|
14
|
+
alertKey: 'victoriametrics:abc',
|
|
15
|
+
timestamp: '2026-06-14T09:55:00.000Z',
|
|
16
|
+
selectedAt: '2026-06-14T10:00:00.000Z',
|
|
17
|
+
},
|
|
18
|
+
raw: {
|
|
19
|
+
metric: { alertname: 'HighCPU', service: 'payments' },
|
|
20
|
+
rule: { labels: { namespace: 'prod' } },
|
|
21
|
+
},
|
|
22
|
+
});
|
|
23
|
+
strict_1.default.equal(facts.provider, 'victoriametrics');
|
|
24
|
+
strict_1.default.equal(facts.extractor.name, 'victoriametrics-extractor');
|
|
25
|
+
strict_1.default.ok(facts.labels.some((fact) => fact.key === 'service' && fact.value === 'payments'));
|
|
26
|
+
});
|
|
27
|
+
//# sourceMappingURL=victoriametrics-extractor.test.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"victoriametrics-extractor.test.js","sourceRoot":"","sources":["../../test/victoriametrics-extractor.test.ts"],"names":[],"mappings":";;;;;AAAA,gEAAwC;AACxC,0DAA6B;AAC7B,gCAA2C;AAE3C,IAAA,mBAAI,EAAC,sDAAsD,EAAE,GAAG,EAAE;IAChE,MAAM,KAAK,GAAG,IAAA,uBAAiB,EAAC;QAC9B,QAAQ,EAAE;YACR,aAAa,EAAE,QAAQ;YACvB,QAAQ,EAAE,iBAAiB;YAC3B,QAAQ,EAAE,qBAAqB;YAC/B,SAAS,EAAE,0BAA0B;YACrC,UAAU,EAAE,0BAA0B;SACvC;QACD,GAAG,EAAE;YACH,MAAM,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE;YACrD,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE;SACxC;KACF,CAAC,CAAC;IAEH,gBAAM,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IAChD,gBAAM,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,2BAA2B,CAAC,CAAC;IAChE,gBAAM,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC;AAC9F,CAAC,CAAC,CAAC"}
|
package/package.json
ADDED
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@scoutflo/alert-correlation",
|
|
3
|
+
"version": "0.1.0",
|
|
4
|
+
"description": "Pure alert-to-topology correlation contracts and policies for Scoutflo alert investigation workflows.",
|
|
5
|
+
"main": "dist/src/index.js",
|
|
6
|
+
"types": "dist/src/index.d.ts",
|
|
7
|
+
"files": [
|
|
8
|
+
"dist/"
|
|
9
|
+
],
|
|
10
|
+
"scripts": {
|
|
11
|
+
"build": "tsc -p tsconfig.json",
|
|
12
|
+
"test": "npm run build && node --test dist/test/*.test.js"
|
|
13
|
+
},
|
|
14
|
+
"keywords": [
|
|
15
|
+
"scoutflo",
|
|
16
|
+
"alert-correlation",
|
|
17
|
+
"topology"
|
|
18
|
+
],
|
|
19
|
+
"author": "Scoutflo",
|
|
20
|
+
"license": "MIT",
|
|
21
|
+
"dependencies": {
|
|
22
|
+
"zod": "^3.23.8"
|
|
23
|
+
},
|
|
24
|
+
"devDependencies": {
|
|
25
|
+
"@types/node": "^20.14.10",
|
|
26
|
+
"typescript": "^5.5.3"
|
|
27
|
+
},
|
|
28
|
+
"publishConfig": {
|
|
29
|
+
"registry": "https://registry.npmjs.org",
|
|
30
|
+
"access": "public"
|
|
31
|
+
}
|
|
32
|
+
}
|