rterm-backend 3.0.8 → 3.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/bin/gybackend.cjs +53 -7
- package/package.json +5 -67
- package/plugins/sample-k8s-slo/index.ts +58 -0
- package/plugins/sample-k8s-slo/plugin.json +11 -0
- package/plugins/web-intel/index.mjs +381 -0
- package/plugins/web-intel/plugin.json +28 -0
- package/plugins/web-intel/sidecar.mjs +134 -0
- package/plugins/web-intel/wigoloClient.mjs +145 -0
- package/LICENSE.md +0 -201
- package/README.md +0 -31
- package/plugins/agentspan-bridge/agentspan-bridge.extreme.spec.ts +0 -328
- package/plugins/agentspan-bridge/agentspan-bridge.phase2.extreme.spec.ts +0 -282
- package/plugins/netdata-rterm/netdata-rterm.extreme.spec.ts +0 -252
|
@@ -1,252 +0,0 @@
|
|
|
1
|
-
import {
|
|
2
|
-
parseNetdataAlert, mapSeverity, buildFingerprint, toTriggerEvent, correlateWithRterm, register,
|
|
3
|
-
} from './index.mjs'
|
|
4
|
-
|
|
5
|
-
const cases: Array<{ name: string; run: () => void | Promise<void> }> = []
|
|
6
|
-
function test(n: string, r: () => void | Promise<void>) { cases.push({ name: n, run: r }) }
|
|
7
|
-
|
|
8
|
-
// ---- parseNetdataAlert ----
|
|
9
|
-
test('parse: alert notification with all fields', () => {
|
|
10
|
-
const payload = {
|
|
11
|
-
message: 'CPU usage is 95%', alert: 'cpu_usage', info: 'CPU utilization too high',
|
|
12
|
-
chart: 'system.cpu', context: 'system.cpu', space: 'prod-cluster', family: 'cpu',
|
|
13
|
-
class: 'Error', severity: 'critical', date: '2026-07-22T10:00:00Z', duration: '5m',
|
|
14
|
-
additional_active_critical_alerts: 2, additional_active_warning_alerts: 1,
|
|
15
|
-
alert_url: 'https://app.netdata.cloud/alert/123',
|
|
16
|
-
}
|
|
17
|
-
const p = parseNetdataAlert(payload)
|
|
18
|
-
if (!p || p.kind !== 'alert') throw new Error('should parse alert')
|
|
19
|
-
if (p.alert !== 'cpu_usage') throw new Error('alert name')
|
|
20
|
-
if (p.severity !== 'critical') throw new Error('severity')
|
|
21
|
-
if (p.chart !== 'system.cpu') throw new Error('chart')
|
|
22
|
-
if (p.additionalCritical !== 2) throw new Error('additional critical')
|
|
23
|
-
if (p.host !== 'prod-cluster') throw new Error('host from space')
|
|
24
|
-
if (p.alertUrl !== 'https://app.netdata.cloud/alert/123') throw new Error('alert url')
|
|
25
|
-
})
|
|
26
|
-
|
|
27
|
-
test('parse: warning severity', () => {
|
|
28
|
-
const p = parseNetdataAlert({ alert: 'disk_space', severity: 'warning', message: 'Disk 80% full', space: 'web-01' })
|
|
29
|
-
if (!p || p.severity !== 'warning') throw new Error('should be warning')
|
|
30
|
-
})
|
|
31
|
-
|
|
32
|
-
test('parse: clear severity (alert resolved)', () => {
|
|
33
|
-
const p = parseNetdataAlert({ alert: 'cpu_usage', severity: 'clear', message: 'CPU back to normal', space: 'web-01' })
|
|
34
|
-
if (!p || p.severity !== 'clear') throw new Error('should be clear')
|
|
35
|
-
})
|
|
36
|
-
|
|
37
|
-
test('parse: reachability notification (node down)', () => {
|
|
38
|
-
const p = parseNetdataAlert({ message: 'Node unreachable', node: 'web-02', space: 'prod', status: 'down', date: '2026-07-22T10:00:00Z', duration: '2m' })
|
|
39
|
-
if (!p || p.kind !== 'reachability') throw new Error('should parse reachability')
|
|
40
|
-
if (p.status !== 'down') throw new Error('status')
|
|
41
|
-
if (p.host !== 'web-02') throw new Error('host from node')
|
|
42
|
-
})
|
|
43
|
-
|
|
44
|
-
test('parse: reachability notification (node up)', () => {
|
|
45
|
-
const p = parseNetdataAlert({ node: 'web-02', status: 'up', date: '2026-07-22T10:05:00Z' })
|
|
46
|
-
if (!p || p.status !== 'up') throw new Error('should be up')
|
|
47
|
-
})
|
|
48
|
-
|
|
49
|
-
test('parse: null for invalid payload', () => {
|
|
50
|
-
if (parseNetdataAlert(null) !== null) throw new Error('null payload')
|
|
51
|
-
if (parseNetdataAlert({}) !== null) throw new Error('empty object')
|
|
52
|
-
if (parseNetdataAlert('not an object') !== null) throw new Error('string')
|
|
53
|
-
if (parseNetdataAlert({ foo: 'bar' }) !== null) throw new Error('missing required fields')
|
|
54
|
-
})
|
|
55
|
-
|
|
56
|
-
// ---- mapSeverity ----
|
|
57
|
-
test('mapSeverity: critical -> critical', () => {
|
|
58
|
-
if (mapSeverity('critical') !== 'critical') throw new Error('critical')
|
|
59
|
-
})
|
|
60
|
-
test('mapSeverity: warning -> warning', () => {
|
|
61
|
-
if (mapSeverity('warning') !== 'warning') throw new Error('warning')
|
|
62
|
-
})
|
|
63
|
-
test('mapSeverity: clear -> info', () => {
|
|
64
|
-
if (mapSeverity('clear') !== 'info') throw new Error('clear should map to info')
|
|
65
|
-
})
|
|
66
|
-
test('mapSeverity: unknown -> info', () => {
|
|
67
|
-
if (mapSeverity('unknown') !== 'info') throw new Error('unknown')
|
|
68
|
-
})
|
|
69
|
-
|
|
70
|
-
// ---- buildFingerprint ----
|
|
71
|
-
test('buildFingerprint: alert fingerprint', () => {
|
|
72
|
-
const p = parseNetdataAlert({ alert: 'cpu_usage', severity: 'critical', space: 'web-01' })
|
|
73
|
-
const fp = buildFingerprint(p)
|
|
74
|
-
if (fp !== 'netdata:web-01:cpu_usage:critical') throw new Error(`got ${fp}`)
|
|
75
|
-
})
|
|
76
|
-
test('buildFingerprint: reachability fingerprint', () => {
|
|
77
|
-
const p = parseNetdataAlert({ node: 'web-02', status: 'down' })
|
|
78
|
-
const fp = buildFingerprint(p)
|
|
79
|
-
if (fp !== 'netdata:reachability:web-02:down') throw new Error(`got ${fp}`)
|
|
80
|
-
})
|
|
81
|
-
test('buildFingerprint: empty for null', () => {
|
|
82
|
-
if (buildFingerprint(null) !== '') throw new Error('should be empty')
|
|
83
|
-
})
|
|
84
|
-
|
|
85
|
-
// ---- toTriggerEvent ----
|
|
86
|
-
test('toTriggerEvent: alert -> trigger event with correct severity', () => {
|
|
87
|
-
const p = parseNetdataAlert({ alert: 'disk_full', severity: 'critical', space: 'db-01', message: 'Disk 95%', date: '2026-07-22T10:00:00Z' })
|
|
88
|
-
const evt = toTriggerEvent(p)
|
|
89
|
-
if (!evt) throw new Error('should produce event')
|
|
90
|
-
if (evt.source !== 'netdata') throw new Error('source')
|
|
91
|
-
if (evt.severity !== 'critical') throw new Error('severity')
|
|
92
|
-
if (!evt.title.includes('disk_full')) throw new Error('title')
|
|
93
|
-
if (!evt.title.includes('db-01')) throw new Error('title host')
|
|
94
|
-
if (evt.labels.host !== 'db-01') throw new Error('labels host')
|
|
95
|
-
if (evt.labels.alert !== 'disk_full') throw new Error('labels alert')
|
|
96
|
-
})
|
|
97
|
-
|
|
98
|
-
test('toTriggerEvent: reachability down -> critical', () => {
|
|
99
|
-
const p = parseNetdataAlert({ node: 'web-03', status: 'down', date: '2026-07-22T10:00:00Z' })
|
|
100
|
-
const evt = toTriggerEvent(p)
|
|
101
|
-
if (!evt || evt.severity !== 'critical') throw new Error('down should be critical')
|
|
102
|
-
if (!evt.title.includes('DOWN')) throw new Error('title')
|
|
103
|
-
})
|
|
104
|
-
|
|
105
|
-
test('toTriggerEvent: reachability up -> info', () => {
|
|
106
|
-
const p = parseNetdataAlert({ node: 'web-03', status: 'up', date: '2026-07-22T10:00:00Z' })
|
|
107
|
-
const evt = toTriggerEvent(p)
|
|
108
|
-
if (!evt || evt.severity !== 'info') throw new Error('up should be info')
|
|
109
|
-
})
|
|
110
|
-
|
|
111
|
-
test('toTriggerEvent: null parsed -> null event', () => {
|
|
112
|
-
if (toTriggerEvent(null) !== null) throw new Error('should be null')
|
|
113
|
-
})
|
|
114
|
-
|
|
115
|
-
// ---- correlateWithRterm ----
|
|
116
|
-
test('correlate: with metrics + incidents', () => {
|
|
117
|
-
const p = parseNetdataAlert({ alert: 'cpu_usage', severity: 'critical', space: 'web-01', additional_active_critical_alerts: 3 })
|
|
118
|
-
const mockMetrics = { snapshot: (host: string) => ({ host, cpuUsagePercent: 95, memoryUsagePercent: 70 }) }
|
|
119
|
-
const mockIncidents = { list: () => [
|
|
120
|
-
{ title: 'web-01 disk full', affected: ['web-01'], status: 'open' },
|
|
121
|
-
{ title: 'web-02 network issue', affected: ['web-02'], status: 'open' },
|
|
122
|
-
{ title: 'web-01 resolved issue', affected: ['web-01'], status: 'resolved' },
|
|
123
|
-
] }
|
|
124
|
-
const result = correlateWithRterm(p, mockMetrics as any, mockIncidents as any)
|
|
125
|
-
if (!result.recentMetrics || result.recentMetrics.cpuUsagePercent !== 95) throw new Error('metrics')
|
|
126
|
-
if (result.openIncidents.length !== 1) throw new Error(`expected 1 open incident, got ${result.openIncidents.length}`)
|
|
127
|
-
if (!result.correlation.includes('cpu_usage')) throw new Error('correlation should mention alert')
|
|
128
|
-
if (!result.correlation.includes('disk full')) throw new Error('correlation should mention incident')
|
|
129
|
-
if (!result.correlation.includes('3 additional critical')) throw new Error('correlation should mention additional alerts')
|
|
130
|
-
})
|
|
131
|
-
|
|
132
|
-
test('correlate: no prior context', () => {
|
|
133
|
-
const p = parseNetdataAlert({ alert: 'mem_usage', severity: 'warning', space: 'new-host' })
|
|
134
|
-
const result = correlateWithRterm(p, null, null)
|
|
135
|
-
if (result.recentMetrics !== null) throw new Error('no metrics')
|
|
136
|
-
if (result.openIncidents.length !== 0) throw new Error('no incidents')
|
|
137
|
-
if (!result.correlation.includes('No prior RTerm context')) throw new Error('should say no context')
|
|
138
|
-
})
|
|
139
|
-
|
|
140
|
-
test('correlate: null parsed -> empty', () => {
|
|
141
|
-
const result = correlateWithRterm(null, null, null)
|
|
142
|
-
if (result.recentMetrics !== null || result.openIncidents.length !== 0) throw new Error('should be empty')
|
|
143
|
-
})
|
|
144
|
-
|
|
145
|
-
// ---- register (plugin lifecycle) ----
|
|
146
|
-
test('register: registers 2 tools, 2 triggers, 1 panel', () => {
|
|
147
|
-
const tools: any[] = [], triggers: any[] = [], panels: any[] = [], logs: string[] = []
|
|
148
|
-
register({
|
|
149
|
-
registerTool: (t) => tools.push(t),
|
|
150
|
-
registerTrigger: (t) => triggers.push(t),
|
|
151
|
-
registerPanel: (p) => panels.push(p),
|
|
152
|
-
exec: async () => '',
|
|
153
|
-
readLedger: () => ({}),
|
|
154
|
-
log: (line: string) => logs.push(line),
|
|
155
|
-
} as any)
|
|
156
|
-
if (tools.length !== 2) throw new Error(`expected 2 tools, got ${tools.length}`)
|
|
157
|
-
if (triggers.length !== 2) throw new Error(`expected 2 triggers, got ${triggers.length}`)
|
|
158
|
-
if (panels.length !== 1) throw new Error(`expected 1 panel, got ${panels.length}`)
|
|
159
|
-
if (!tools.some((t) => t.name === 'netdata_alert_summary')) throw new Error('missing alert_summary tool')
|
|
160
|
-
if (!tools.some((t) => t.name === 'netdata_correlate')) throw new Error('missing correlate tool')
|
|
161
|
-
if (!triggers.some((t) => t.name === 'netdata_critical_alert')) throw new Error('missing critical trigger')
|
|
162
|
-
if (!triggers.some((t) => t.name === 'netdata_warning_alert')) throw new Error('missing warning trigger')
|
|
163
|
-
if (!panels.some((p) => p.name === 'netdata-alert-feed')) throw new Error('missing alert feed panel')
|
|
164
|
-
if (!logs.some((l) => l.includes('registered'))) throw new Error('should log registration')
|
|
165
|
-
})
|
|
166
|
-
|
|
167
|
-
test('register: critical trigger matches critical events only', () => {
|
|
168
|
-
const triggers: any[] = []
|
|
169
|
-
register({
|
|
170
|
-
registerTool: () => {}, registerTrigger: (t) => triggers.push(t), registerPanel: () => {},
|
|
171
|
-
exec: async () => '', readLedger: () => ({}), log: () => {},
|
|
172
|
-
} as any)
|
|
173
|
-
const critTrigger = triggers.find((t) => t.name === 'netdata_critical_alert')
|
|
174
|
-
if (!critTrigger) throw new Error('missing critical trigger')
|
|
175
|
-
if (!critTrigger.match({ source: 'netdata', severity: 'critical' })) throw new Error('should match critical')
|
|
176
|
-
if (critTrigger.match({ source: 'netdata', severity: 'warning' })) throw new Error('should NOT match warning')
|
|
177
|
-
if (critTrigger.match({ source: 'other', severity: 'critical' })) throw new Error('should NOT match non-netdata')
|
|
178
|
-
if (critTrigger.match({})) throw new Error('should NOT match empty')
|
|
179
|
-
})
|
|
180
|
-
|
|
181
|
-
test('register: warning trigger matches warning events only', () => {
|
|
182
|
-
const triggers: any[] = []
|
|
183
|
-
register({
|
|
184
|
-
registerTool: () => {}, registerTrigger: (t) => triggers.push(t), registerPanel: () => {},
|
|
185
|
-
exec: async () => '', readLedger: () => ({}), log: () => {},
|
|
186
|
-
} as any)
|
|
187
|
-
const warnTrigger = triggers.find((t) => t.name === 'netdata_warning_alert')
|
|
188
|
-
if (!warnTrigger) throw new Error('missing warning trigger')
|
|
189
|
-
if (!warnTrigger.match({ source: 'netdata', severity: 'warning' })) throw new Error('should match warning')
|
|
190
|
-
if (warnTrigger.match({ source: 'netdata', severity: 'critical' })) throw new Error('should NOT match critical')
|
|
191
|
-
})
|
|
192
|
-
|
|
193
|
-
test('register: panel renders alert rows', () => {
|
|
194
|
-
const panels: any[] = []
|
|
195
|
-
register({
|
|
196
|
-
registerTool: () => {}, registerTrigger: () => {}, registerPanel: (p) => panels.push(p),
|
|
197
|
-
exec: async () => '', readLedger: () => ({}), log: () => {},
|
|
198
|
-
} as any)
|
|
199
|
-
const panel = panels[0]
|
|
200
|
-
const html = panel.render([
|
|
201
|
-
{ host: 'web-01', alert: 'cpu_high', severity: 'critical', date: '2026-07-22' },
|
|
202
|
-
{ host: 'web-02', alert: 'disk_full', severity: 'warning', date: '2026-07-22' },
|
|
203
|
-
])
|
|
204
|
-
if (!html.includes('cpu_high') || !html.includes('disk_full')) throw new Error('should contain alert names')
|
|
205
|
-
if (!html.includes('<table>')) throw new Error('should render table')
|
|
206
|
-
})
|
|
207
|
-
|
|
208
|
-
test('register: panel renders empty feed', () => {
|
|
209
|
-
const panels: any[] = []
|
|
210
|
-
register({
|
|
211
|
-
registerTool: () => {}, registerTrigger: () => {}, registerPanel: (p) => panels.push(p),
|
|
212
|
-
exec: async () => '', readLedger: () => ({}), log: () => {},
|
|
213
|
-
} as any)
|
|
214
|
-
const html = panels[0].render(null)
|
|
215
|
-
if (!html.includes('Netdata Alerts')) throw new Error('should have title even when empty')
|
|
216
|
-
})
|
|
217
|
-
|
|
218
|
-
test('register: netdata_correlate tool handles invalid payload', async () => {
|
|
219
|
-
const tools: any[] = []
|
|
220
|
-
register({
|
|
221
|
-
registerTool: (t) => tools.push(t), registerTrigger: () => {}, registerPanel: () => {},
|
|
222
|
-
exec: async () => '', readLedger: () => ({}), log: () => {},
|
|
223
|
-
} as any)
|
|
224
|
-
const correlateTool = tools.find((t) => t.name === 'netdata_correlate')
|
|
225
|
-
const result = await correlateTool.handler({ alert: { foo: 'bar' } })
|
|
226
|
-
if (!result.error) throw new Error('should return error for invalid payload')
|
|
227
|
-
})
|
|
228
|
-
|
|
229
|
-
test('register: netdata_correlate tool correlates valid payload', async () => {
|
|
230
|
-
const tools: any[] = []
|
|
231
|
-
register({
|
|
232
|
-
registerTool: (t) => tools.push(t), registerTrigger: () => {}, registerPanel: () => {},
|
|
233
|
-
exec: async () => '', readLedger: () => null, log: () => {},
|
|
234
|
-
} as any)
|
|
235
|
-
const correlateTool = tools.find((t) => t.name === 'netdata_correlate')
|
|
236
|
-
const result = await correlateTool.handler({
|
|
237
|
-
alert: { alert: 'cpu_usage', severity: 'critical', space: 'web-01', message: 'CPU 95%' },
|
|
238
|
-
})
|
|
239
|
-
if (!result.parsed) throw new Error('should return parsed alert')
|
|
240
|
-
if (result.parsed.alert !== 'cpu_usage') throw new Error('alert name')
|
|
241
|
-
})
|
|
242
|
-
|
|
243
|
-
async function main() {
|
|
244
|
-
let pass = 0, fail = 0
|
|
245
|
-
for (const c of cases) {
|
|
246
|
-
try { await c.run(); pass++; console.log(`PASS ${c.name}`) }
|
|
247
|
-
catch (e: any) { fail++; console.log(`FAIL ${c.name}: ${e?.message ?? e}`) }
|
|
248
|
-
}
|
|
249
|
-
console.log(`\n${pass}/${cases.length} passed, ${fail} failed`)
|
|
250
|
-
if (fail > 0) process.exit(1)
|
|
251
|
-
}
|
|
252
|
-
void main()
|