flow-debugger 1.9.7 → 1.9.9
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/ENHANCED_OBSERVABILITY.md +835 -0
- package/IMPLEMENTATION_SUMMARY.md +466 -0
- package/README.md +147 -8
- package/bin/cli.js +1 -1
- package/dist/cjs/core/Alerting.js +310 -0
- package/dist/cjs/core/Alerting.js.map +1 -0
- package/dist/cjs/core/AnomalyDetection.js +223 -0
- package/dist/cjs/core/AnomalyDetection.js.map +1 -0
- package/dist/cjs/core/DependencyGraph.js +251 -0
- package/dist/cjs/core/DependencyGraph.js.map +1 -0
- package/dist/cjs/core/DistributedTracing.js +245 -0
- package/dist/cjs/core/DistributedTracing.js.map +1 -0
- package/dist/cjs/core/ErrorClustering.js +257 -0
- package/dist/cjs/core/ErrorClustering.js.map +1 -0
- package/dist/cjs/core/LogCorrelation.js +242 -0
- package/dist/cjs/core/LogCorrelation.js.map +1 -0
- package/dist/cjs/core/Metrics.js +301 -0
- package/dist/cjs/core/Metrics.js.map +1 -0
- package/dist/cjs/core/RootCause.js +107 -9
- package/dist/cjs/core/RootCause.js.map +1 -1
- package/dist/cjs/core/TrendAnalysis.js +254 -0
- package/dist/cjs/core/TrendAnalysis.js.map +1 -0
- package/dist/cjs/core/types.js +14 -0
- package/dist/cjs/core/types.js.map +1 -1
- package/dist/cjs/index.js +27 -1
- package/dist/cjs/index.js.map +1 -1
- package/dist/cjs/middleware/express.js +105 -4
- package/dist/cjs/middleware/express.js.map +1 -1
- package/dist/esm/core/Alerting.js +305 -0
- package/dist/esm/core/Alerting.js.map +1 -0
- package/dist/esm/core/AnomalyDetection.js +218 -0
- package/dist/esm/core/AnomalyDetection.js.map +1 -0
- package/dist/esm/core/DependencyGraph.js +246 -0
- package/dist/esm/core/DependencyGraph.js.map +1 -0
- package/dist/esm/core/DistributedTracing.js +240 -0
- package/dist/esm/core/DistributedTracing.js.map +1 -0
- package/dist/esm/core/ErrorClustering.js +252 -0
- package/dist/esm/core/ErrorClustering.js.map +1 -0
- package/dist/esm/core/LogCorrelation.js +236 -0
- package/dist/esm/core/LogCorrelation.js.map +1 -0
- package/dist/esm/core/Metrics.js +297 -0
- package/dist/esm/core/Metrics.js.map +1 -0
- package/dist/esm/core/RootCause.js +107 -9
- package/dist/esm/core/RootCause.js.map +1 -1
- package/dist/esm/core/TrendAnalysis.js +250 -0
- package/dist/esm/core/TrendAnalysis.js.map +1 -0
- package/dist/esm/core/types.js +14 -0
- package/dist/esm/core/types.js.map +1 -1
- package/dist/esm/index.js +10 -0
- package/dist/esm/index.js.map +1 -1
- package/dist/esm/middleware/express.js +105 -4
- package/dist/esm/middleware/express.js.map +1 -1
- package/dist/types/core/Alerting.d.ts +82 -0
- package/dist/types/core/Alerting.d.ts.map +1 -0
- package/dist/types/core/AnomalyDetection.d.ts +93 -0
- package/dist/types/core/AnomalyDetection.d.ts.map +1 -0
- package/dist/types/core/DependencyGraph.d.ts +65 -0
- package/dist/types/core/DependencyGraph.d.ts.map +1 -0
- package/dist/types/core/DistributedTracing.d.ts +92 -0
- package/dist/types/core/DistributedTracing.d.ts.map +1 -0
- package/dist/types/core/ErrorClustering.d.ts +70 -0
- package/dist/types/core/ErrorClustering.d.ts.map +1 -0
- package/dist/types/core/LogCorrelation.d.ts +73 -0
- package/dist/types/core/LogCorrelation.d.ts.map +1 -0
- package/dist/types/core/Metrics.d.ts +73 -0
- package/dist/types/core/Metrics.d.ts.map +1 -0
- package/dist/types/core/RootCause.d.ts +9 -5
- package/dist/types/core/RootCause.d.ts.map +1 -1
- package/dist/types/core/TrendAnalysis.d.ts +63 -0
- package/dist/types/core/TrendAnalysis.d.ts.map +1 -0
- package/dist/types/core/types.d.ts +200 -0
- package/dist/types/core/types.d.ts.map +1 -1
- package/dist/types/index.d.ts +9 -1
- package/dist/types/index.d.ts.map +1 -1
- package/dist/types/middleware/express.d.ts +12 -0
- package/dist/types/middleware/express.d.ts.map +1 -1
- package/package.json +3 -3
- package/test-results.json +1 -0
|
@@ -0,0 +1,257 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
// ─────────────────────────────────────────────────────────────
|
|
3
|
+
// flow-debugger — Error Clustering System
|
|
4
|
+
// Groups similar errors using fingerprinting
|
|
5
|
+
// ─────────────────────────────────────────────────────────────
|
|
6
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
7
|
+
exports.ErrorClusterManager = void 0;
|
|
8
|
+
exports.getErrorSimilarity = getErrorSimilarity;
|
|
9
|
+
const crypto_1 = require("crypto");
|
|
10
|
+
/**
|
|
11
|
+
* Error Cluster Manager - Groups similar errors for easier debugging
|
|
12
|
+
*/
|
|
13
|
+
class ErrorClusterManager {
|
|
14
|
+
constructor(maxClusters = 50) {
|
|
15
|
+
this.clusters = new Map();
|
|
16
|
+
this.maxClusters = 50;
|
|
17
|
+
this.maxClusters = maxClusters;
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* Process a trace and cluster any errors
|
|
21
|
+
*/
|
|
22
|
+
processTrace(trace) {
|
|
23
|
+
// Only cluster error/critical traces
|
|
24
|
+
if (trace.classification !== 'ERROR' && trace.classification !== 'CRITICAL') {
|
|
25
|
+
return null;
|
|
26
|
+
}
|
|
27
|
+
// Find error steps
|
|
28
|
+
const errorSteps = trace.steps.filter(s => s.status === 'error' || s.status === 'timeout');
|
|
29
|
+
if (errorSteps.length === 0 && trace.classification !== 'CRITICAL') {
|
|
30
|
+
return null;
|
|
31
|
+
}
|
|
32
|
+
// Create fingerprint from error pattern
|
|
33
|
+
const fingerprint = this.createFingerprint(trace, errorSteps);
|
|
34
|
+
// Get or create cluster
|
|
35
|
+
let cluster = this.clusters.get(fingerprint);
|
|
36
|
+
if (!cluster) {
|
|
37
|
+
cluster = {
|
|
38
|
+
id: this.generateClusterId(),
|
|
39
|
+
fingerprint,
|
|
40
|
+
message: this.getErrorMessage(trace, errorSteps),
|
|
41
|
+
stackTrace: errorSteps[0]?.stackTrace,
|
|
42
|
+
count: 0,
|
|
43
|
+
firstSeen: trace.timestamp,
|
|
44
|
+
lastSeen: trace.timestamp,
|
|
45
|
+
traces: [],
|
|
46
|
+
endpoints: [],
|
|
47
|
+
services: [],
|
|
48
|
+
severity: trace.classification,
|
|
49
|
+
};
|
|
50
|
+
this.clusters.set(fingerprint, cluster);
|
|
51
|
+
// Trim old clusters if needed
|
|
52
|
+
if (this.clusters.size > this.maxClusters) {
|
|
53
|
+
this.trimOldestCluster();
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
// Update cluster
|
|
57
|
+
cluster.count++;
|
|
58
|
+
cluster.lastSeen = trace.timestamp;
|
|
59
|
+
cluster.severity = this.getWorstSeverity(cluster.severity, trace.classification);
|
|
60
|
+
if (!cluster.traces.includes(trace.traceId) && cluster.traces.length < 100) {
|
|
61
|
+
cluster.traces.push(trace.traceId);
|
|
62
|
+
}
|
|
63
|
+
if (!cluster.endpoints.includes(trace.endpoint)) {
|
|
64
|
+
cluster.endpoints.push(trace.endpoint);
|
|
65
|
+
}
|
|
66
|
+
errorSteps.forEach(step => {
|
|
67
|
+
if (step.service !== 'internal' && !cluster.services.includes(step.service)) {
|
|
68
|
+
cluster.services.push(step.service);
|
|
69
|
+
}
|
|
70
|
+
});
|
|
71
|
+
return cluster;
|
|
72
|
+
}
|
|
73
|
+
/**
|
|
74
|
+
* Get all clusters
|
|
75
|
+
*/
|
|
76
|
+
getClusters() {
|
|
77
|
+
return Array.from(this.clusters.values()).sort((a, b) => {
|
|
78
|
+
// Sort by count (most frequent first)
|
|
79
|
+
return b.count - a.count;
|
|
80
|
+
});
|
|
81
|
+
}
|
|
82
|
+
/**
|
|
83
|
+
* Get cluster by fingerprint
|
|
84
|
+
*/
|
|
85
|
+
getCluster(fingerprint) {
|
|
86
|
+
return this.clusters.get(fingerprint);
|
|
87
|
+
}
|
|
88
|
+
/**
|
|
89
|
+
* Get cluster by ID
|
|
90
|
+
*/
|
|
91
|
+
getClusterById(id) {
|
|
92
|
+
return Array.from(this.clusters.values()).find(c => c.id === id);
|
|
93
|
+
}
|
|
94
|
+
/**
|
|
95
|
+
* Get top N clusters
|
|
96
|
+
*/
|
|
97
|
+
getTopClusters(limit = 10) {
|
|
98
|
+
return this.getClusters().slice(0, limit);
|
|
99
|
+
}
|
|
100
|
+
/**
|
|
101
|
+
* Get new clusters (first seen in last hour)
|
|
102
|
+
*/
|
|
103
|
+
getNewClusters() {
|
|
104
|
+
const oneHourAgo = new Date(Date.now() - 60 * 60 * 1000);
|
|
105
|
+
return Array.from(this.clusters.values()).filter(c => c.firstSeen > oneHourAgo);
|
|
106
|
+
}
|
|
107
|
+
/**
|
|
108
|
+
* Get recurring clusters (more than 10 occurrences)
|
|
109
|
+
*/
|
|
110
|
+
getRecurringClusters() {
|
|
111
|
+
return Array.from(this.clusters.values()).filter(c => c.count > 10);
|
|
112
|
+
}
|
|
113
|
+
/**
|
|
114
|
+
* Clear a cluster
|
|
115
|
+
*/
|
|
116
|
+
clearCluster(fingerprint) {
|
|
117
|
+
this.clusters.delete(fingerprint);
|
|
118
|
+
}
|
|
119
|
+
/**
|
|
120
|
+
* Clear all clusters
|
|
121
|
+
*/
|
|
122
|
+
clear() {
|
|
123
|
+
this.clusters.clear();
|
|
124
|
+
}
|
|
125
|
+
/**
|
|
126
|
+
* Get cluster statistics
|
|
127
|
+
*/
|
|
128
|
+
getStats() {
|
|
129
|
+
const clusters = this.getClusters();
|
|
130
|
+
const totalErrors = clusters.reduce((sum, c) => sum + c.count, 0);
|
|
131
|
+
// Count services
|
|
132
|
+
const serviceCounts = new Map();
|
|
133
|
+
clusters.forEach(cluster => {
|
|
134
|
+
cluster.services.forEach(service => {
|
|
135
|
+
serviceCounts.set(service, (serviceCounts.get(service) || 0) + cluster.count);
|
|
136
|
+
});
|
|
137
|
+
});
|
|
138
|
+
const topServices = Array.from(serviceCounts.entries())
|
|
139
|
+
.map(([service, count]) => ({ service, count }))
|
|
140
|
+
.sort((a, b) => b.count - a.count)
|
|
141
|
+
.slice(0, 10);
|
|
142
|
+
return {
|
|
143
|
+
totalClusters: clusters.length,
|
|
144
|
+
totalErrors,
|
|
145
|
+
avgClusterSize: totalErrors / clusters.length || 0,
|
|
146
|
+
topServices,
|
|
147
|
+
};
|
|
148
|
+
}
|
|
149
|
+
createFingerprint(trace, errorSteps) {
|
|
150
|
+
// Create fingerprint from error pattern
|
|
151
|
+
const components = [];
|
|
152
|
+
// Error messages
|
|
153
|
+
errorSteps.forEach(step => {
|
|
154
|
+
if (step.error) {
|
|
155
|
+
// Normalize error message (remove dynamic parts)
|
|
156
|
+
const normalizedError = this.normalizeError(step.error);
|
|
157
|
+
components.push(`${step.name}:${normalizedError}`);
|
|
158
|
+
}
|
|
159
|
+
});
|
|
160
|
+
// Stack trace (first few lines)
|
|
161
|
+
const firstError = errorSteps.find(s => s.stackTrace);
|
|
162
|
+
if (firstError?.stackTrace) {
|
|
163
|
+
const stackLines = firstError.stackTrace.split('\n').slice(0, 5).join('\n');
|
|
164
|
+
const normalizedStack = this.normalizeStackTrace(stackLines);
|
|
165
|
+
components.push(normalizedStack);
|
|
166
|
+
}
|
|
167
|
+
// Endpoint pattern
|
|
168
|
+
components.push(this.normalizeEndpoint(trace.endpoint));
|
|
169
|
+
// Create hash
|
|
170
|
+
const input = components.join('|');
|
|
171
|
+
return (0, crypto_1.createHash)('md5').update(input).digest('hex');
|
|
172
|
+
}
|
|
173
|
+
getErrorMessage(trace, errorSteps) {
|
|
174
|
+
if (errorSteps.length > 0 && errorSteps[0].error) {
|
|
175
|
+
return errorSteps[0].error.split('\n')[0]; // First line only
|
|
176
|
+
}
|
|
177
|
+
if (trace.rootCause?.cause) {
|
|
178
|
+
return trace.rootCause.cause.split('\n')[0];
|
|
179
|
+
}
|
|
180
|
+
return `${trace.classification} on ${trace.method} ${trace.endpoint}`;
|
|
181
|
+
}
|
|
182
|
+
normalizeError(error) {
|
|
183
|
+
return error
|
|
184
|
+
.replace(/\b[0-9a-f]{24}\b/g, '<ID>') // MongoDB IDs
|
|
185
|
+
.replace(/\b[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\b/g, '<UUID>') // UUIDs
|
|
186
|
+
.replace(/\b\d+\b/g, '<NUM>') // Numbers
|
|
187
|
+
.replace(/at\s+.*?\(.*?\)/g, 'at <LOCATION>'); // Stack locations
|
|
188
|
+
}
|
|
189
|
+
normalizeStackTrace(stack) {
|
|
190
|
+
return stack
|
|
191
|
+
.replace(/\b[0-9a-f]{24}\b/g, '<ID>')
|
|
192
|
+
.replace(/\b\d+\b/g, '<NUM>')
|
|
193
|
+
.replace(/at\s+.*?\(.*?\)/g, 'at <LOCATION>');
|
|
194
|
+
}
|
|
195
|
+
normalizeEndpoint(endpoint) {
|
|
196
|
+
return endpoint
|
|
197
|
+
.replace(/\/[0-9a-f]{24}\b/g, '/<ID>')
|
|
198
|
+
.replace(/\/\d+/g, '/<NUM>');
|
|
199
|
+
}
|
|
200
|
+
getWorstSeverity(a, b) {
|
|
201
|
+
const order = ['INFO', 'WARN', 'ERROR', 'CRITICAL'];
|
|
202
|
+
return order.indexOf(a) > order.indexOf(b) ? a : b;
|
|
203
|
+
}
|
|
204
|
+
trimOldestCluster() {
|
|
205
|
+
// Find cluster with oldest lastSeen
|
|
206
|
+
let oldest = null;
|
|
207
|
+
for (const [fingerprint, cluster] of this.clusters.entries()) {
|
|
208
|
+
if (!oldest || cluster.lastSeen < oldest.lastSeen) {
|
|
209
|
+
oldest = { fingerprint, lastSeen: cluster.lastSeen };
|
|
210
|
+
}
|
|
211
|
+
}
|
|
212
|
+
if (oldest) {
|
|
213
|
+
this.clusters.delete(oldest.fingerprint);
|
|
214
|
+
}
|
|
215
|
+
}
|
|
216
|
+
generateClusterId() {
|
|
217
|
+
return `cluster_${Date.now()}_${Math.random().toString(36).substring(2, 8)}`;
|
|
218
|
+
}
|
|
219
|
+
}
|
|
220
|
+
exports.ErrorClusterManager = ErrorClusterManager;
|
|
221
|
+
/**
|
|
222
|
+
* Get similarity score between two error messages
|
|
223
|
+
*/
|
|
224
|
+
function getErrorSimilarity(error1, error2) {
|
|
225
|
+
// Levenshtein distance-based similarity
|
|
226
|
+
const normalized1 = error1.toLowerCase();
|
|
227
|
+
const normalized2 = error2.toLowerCase();
|
|
228
|
+
if (normalized1 === normalized2)
|
|
229
|
+
return 1;
|
|
230
|
+
const distance = levenshteinDistance(normalized1, normalized2);
|
|
231
|
+
const maxLength = Math.max(normalized1.length, normalized2.length);
|
|
232
|
+
return 1 - distance / maxLength;
|
|
233
|
+
}
|
|
234
|
+
/**
|
|
235
|
+
* Calculate Levenshtein distance between two strings
|
|
236
|
+
*/
|
|
237
|
+
function levenshteinDistance(str1, str2) {
|
|
238
|
+
const matrix = [];
|
|
239
|
+
for (let i = 0; i <= str2.length; i++) {
|
|
240
|
+
matrix[i] = [i];
|
|
241
|
+
}
|
|
242
|
+
for (let j = 0; j <= str1.length; j++) {
|
|
243
|
+
matrix[0][j] = j;
|
|
244
|
+
}
|
|
245
|
+
for (let i = 1; i <= str2.length; i++) {
|
|
246
|
+
for (let j = 1; j <= str1.length; j++) {
|
|
247
|
+
if (str2.charAt(i - 1) === str1.charAt(j - 1)) {
|
|
248
|
+
matrix[i][j] = matrix[i - 1][j - 1];
|
|
249
|
+
}
|
|
250
|
+
else {
|
|
251
|
+
matrix[i][j] = Math.min(matrix[i - 1][j - 1] + 1, matrix[i][j - 1] + 1, matrix[i - 1][j] + 1);
|
|
252
|
+
}
|
|
253
|
+
}
|
|
254
|
+
}
|
|
255
|
+
return matrix[str2.length][str1.length];
|
|
256
|
+
}
|
|
257
|
+
//# sourceMappingURL=ErrorClustering.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ErrorClustering.js","sourceRoot":"","sources":["../../../src/core/ErrorClustering.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,242 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
// ─────────────────────────────────────────────────────────────
|
|
3
|
+
// flow-debugger — Log Correlation System
|
|
4
|
+
// Injects traceId into logs for unified debugging
|
|
5
|
+
// ─────────────────────────────────────────────────────────────
|
|
6
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
7
|
+
exports.CorrelatedLogger = exports.LogCorrelator = void 0;
|
|
8
|
+
exports.logCorrelationMiddleware = logCorrelationMiddleware;
|
|
9
|
+
/**
|
|
10
|
+
* Log Correlation - Links logs to traces via traceId injection
|
|
11
|
+
*/
|
|
12
|
+
class LogCorrelator {
|
|
13
|
+
constructor(enabled = false) {
|
|
14
|
+
this.enabled = false;
|
|
15
|
+
this.currentContext = new Map();
|
|
16
|
+
this.originalConsole = {};
|
|
17
|
+
this.includeTimestamp = true;
|
|
18
|
+
this.includeLevel = true;
|
|
19
|
+
this.customFields = {};
|
|
20
|
+
this.enabled = enabled;
|
|
21
|
+
if (enabled) {
|
|
22
|
+
this.patchConsole();
|
|
23
|
+
}
|
|
24
|
+
}
|
|
25
|
+
/**
|
|
26
|
+
* Enable log correlation
|
|
27
|
+
*/
|
|
28
|
+
enable() {
|
|
29
|
+
if (!this.enabled) {
|
|
30
|
+
this.enabled = true;
|
|
31
|
+
this.patchConsole();
|
|
32
|
+
}
|
|
33
|
+
}
|
|
34
|
+
/**
|
|
35
|
+
* Disable log correlation
|
|
36
|
+
*/
|
|
37
|
+
disable() {
|
|
38
|
+
if (this.enabled) {
|
|
39
|
+
this.enabled = false;
|
|
40
|
+
this.restoreConsole();
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* Set current trace context for logging
|
|
45
|
+
*/
|
|
46
|
+
setContext(context) {
|
|
47
|
+
const requestId = this.getRequestId();
|
|
48
|
+
if (requestId) {
|
|
49
|
+
this.currentContext.set(requestId, context);
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
/**
|
|
53
|
+
* Clear current trace context
|
|
54
|
+
*/
|
|
55
|
+
clearContext() {
|
|
56
|
+
const requestId = this.getRequestId();
|
|
57
|
+
if (requestId) {
|
|
58
|
+
this.currentContext.delete(requestId);
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
/**
|
|
62
|
+
* Add custom fields to all log messages
|
|
63
|
+
*/
|
|
64
|
+
addCustomFields(fields) {
|
|
65
|
+
this.customFields = { ...this.customFields, ...fields };
|
|
66
|
+
}
|
|
67
|
+
/**
|
|
68
|
+
* Clear custom fields
|
|
69
|
+
*/
|
|
70
|
+
clearCustomFields() {
|
|
71
|
+
this.customFields = {};
|
|
72
|
+
}
|
|
73
|
+
/**
|
|
74
|
+
* Create a logger with automatic trace context
|
|
75
|
+
*/
|
|
76
|
+
createLogger(name) {
|
|
77
|
+
return new CorrelatedLogger(name, this);
|
|
78
|
+
}
|
|
79
|
+
/**
|
|
80
|
+
* Format log message with correlation data
|
|
81
|
+
*/
|
|
82
|
+
formatMessage(message, level = 'INFO') {
|
|
83
|
+
const context = this.getCurrentContext();
|
|
84
|
+
const parts = [];
|
|
85
|
+
// Timestamp
|
|
86
|
+
if (this.includeTimestamp) {
|
|
87
|
+
parts.push(`[${new Date().toISOString()}]`);
|
|
88
|
+
}
|
|
89
|
+
// Level
|
|
90
|
+
if (this.includeLevel) {
|
|
91
|
+
parts.push(`[${level}]`);
|
|
92
|
+
}
|
|
93
|
+
// Trace context
|
|
94
|
+
if (context) {
|
|
95
|
+
parts.push(`[trace:${context.traceId.substring(0, 8)}]`);
|
|
96
|
+
parts.push(`[span:${context.spanId.substring(0, 8)}]`);
|
|
97
|
+
}
|
|
98
|
+
// Custom fields
|
|
99
|
+
if (Object.keys(this.customFields).length > 0) {
|
|
100
|
+
parts.push(`[${JSON.stringify(this.customFields)}]`);
|
|
101
|
+
}
|
|
102
|
+
// Message
|
|
103
|
+
parts.push(message);
|
|
104
|
+
return parts.join(' ');
|
|
105
|
+
}
|
|
106
|
+
/**
|
|
107
|
+
* Format log as JSON for structured logging
|
|
108
|
+
*/
|
|
109
|
+
formatJSON(message, metadata) {
|
|
110
|
+
const context = this.getCurrentContext();
|
|
111
|
+
const logEntry = {
|
|
112
|
+
timestamp: new Date().toISOString(),
|
|
113
|
+
level: 'INFO',
|
|
114
|
+
message,
|
|
115
|
+
...metadata,
|
|
116
|
+
};
|
|
117
|
+
if (context) {
|
|
118
|
+
logEntry.traceId = context.traceId;
|
|
119
|
+
logEntry.spanId = context.spanId;
|
|
120
|
+
if (context.parentSpanId) {
|
|
121
|
+
logEntry.parentSpanId = context.parentSpanId;
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
if (Object.keys(this.customFields).length > 0) {
|
|
125
|
+
Object.assign(logEntry, this.customFields);
|
|
126
|
+
}
|
|
127
|
+
return JSON.stringify(logEntry);
|
|
128
|
+
}
|
|
129
|
+
patchConsole() {
|
|
130
|
+
// Store original methods
|
|
131
|
+
this.originalConsole = {
|
|
132
|
+
log: console.log,
|
|
133
|
+
info: console.info,
|
|
134
|
+
warn: console.warn,
|
|
135
|
+
error: console.error,
|
|
136
|
+
debug: console.debug,
|
|
137
|
+
};
|
|
138
|
+
// Patch with correlation
|
|
139
|
+
console.log = (...args) => this.intercept('INFO', args);
|
|
140
|
+
console.info = (...args) => this.intercept('INFO', args);
|
|
141
|
+
console.warn = (...args) => this.intercept('WARN', args);
|
|
142
|
+
console.error = (...args) => this.intercept('ERROR', args);
|
|
143
|
+
console.debug = (...args) => this.intercept('DEBUG', args);
|
|
144
|
+
}
|
|
145
|
+
restoreConsole() {
|
|
146
|
+
if (this.originalConsole.log)
|
|
147
|
+
console.log = this.originalConsole.log;
|
|
148
|
+
if (this.originalConsole.info)
|
|
149
|
+
console.info = this.originalConsole.info;
|
|
150
|
+
if (this.originalConsole.warn)
|
|
151
|
+
console.warn = this.originalConsole.warn;
|
|
152
|
+
if (this.originalConsole.error)
|
|
153
|
+
console.error = this.originalConsole.error;
|
|
154
|
+
if (this.originalConsole.debug)
|
|
155
|
+
console.debug = this.originalConsole.debug;
|
|
156
|
+
}
|
|
157
|
+
intercept(level, args) {
|
|
158
|
+
const message = args.map(arg => (typeof arg === 'object' ? JSON.stringify(arg) : String(arg))).join(' ');
|
|
159
|
+
const formattedMessage = this.formatMessage(message, level);
|
|
160
|
+
const originalMethod = this.originalConsole[level.toLowerCase()];
|
|
161
|
+
if (originalMethod) {
|
|
162
|
+
originalMethod.call(console, formattedMessage);
|
|
163
|
+
}
|
|
164
|
+
else {
|
|
165
|
+
console.log(formattedMessage);
|
|
166
|
+
}
|
|
167
|
+
}
|
|
168
|
+
getCurrentContext() {
|
|
169
|
+
const requestId = this.getRequestId();
|
|
170
|
+
return (requestId && this.currentContext.get(requestId)) || null;
|
|
171
|
+
}
|
|
172
|
+
getRequestId() {
|
|
173
|
+
// Try to get request ID from async local storage
|
|
174
|
+
// In Node.js 16+, we can use AsyncLocalStorage
|
|
175
|
+
try {
|
|
176
|
+
// eslint-disable-next-line @typescript-eslint/no-explicit-any
|
|
177
|
+
const als = global.__flow_debugger_als;
|
|
178
|
+
if (als && typeof als.getStore === 'function') {
|
|
179
|
+
const store = als.getStore();
|
|
180
|
+
return store?.requestId || null;
|
|
181
|
+
}
|
|
182
|
+
}
|
|
183
|
+
catch {
|
|
184
|
+
// AsyncLocalStorage not available
|
|
185
|
+
}
|
|
186
|
+
return null;
|
|
187
|
+
}
|
|
188
|
+
}
|
|
189
|
+
exports.LogCorrelator = LogCorrelator;
|
|
190
|
+
/**
|
|
191
|
+
* Correlated Logger - Logger instance with automatic trace context
|
|
192
|
+
*/
|
|
193
|
+
class CorrelatedLogger {
|
|
194
|
+
constructor(name, correlator) {
|
|
195
|
+
this.name = name;
|
|
196
|
+
this.correlator = correlator;
|
|
197
|
+
}
|
|
198
|
+
info(message, metadata) {
|
|
199
|
+
this.log('INFO', message, metadata);
|
|
200
|
+
}
|
|
201
|
+
warn(message, metadata) {
|
|
202
|
+
this.log('WARN', message, metadata);
|
|
203
|
+
}
|
|
204
|
+
error(message, metadata) {
|
|
205
|
+
this.log('ERROR', message, metadata);
|
|
206
|
+
}
|
|
207
|
+
debug(message, metadata) {
|
|
208
|
+
this.log('DEBUG', message, metadata);
|
|
209
|
+
}
|
|
210
|
+
child(fields) {
|
|
211
|
+
this.correlator.addCustomFields(fields);
|
|
212
|
+
return new CorrelatedLogger(`${this.name}:${Object.keys(fields).join(',')}`, this.correlator);
|
|
213
|
+
}
|
|
214
|
+
log(level, message, metadata) {
|
|
215
|
+
const fullMessage = `[${this.name}] ${message}`;
|
|
216
|
+
const formattedMessage = this.correlator.formatMessage(fullMessage, level);
|
|
217
|
+
const originalMethod = console[level.toLowerCase()];
|
|
218
|
+
if (originalMethod) {
|
|
219
|
+
originalMethod.call(console, formattedMessage);
|
|
220
|
+
}
|
|
221
|
+
else {
|
|
222
|
+
console.log(formattedMessage);
|
|
223
|
+
}
|
|
224
|
+
}
|
|
225
|
+
}
|
|
226
|
+
exports.CorrelatedLogger = CorrelatedLogger;
|
|
227
|
+
/**
|
|
228
|
+
* Express middleware to set trace context for logging
|
|
229
|
+
*/
|
|
230
|
+
function logCorrelationMiddleware(correlator) {
|
|
231
|
+
return (req, res, next) => {
|
|
232
|
+
const tracer = req.tracer;
|
|
233
|
+
if (tracer && correlator['enabled']) {
|
|
234
|
+
const traceId = tracer.getTraceId();
|
|
235
|
+
// Set context for this request
|
|
236
|
+
// Note: This requires AsyncLocalStorage for proper async context
|
|
237
|
+
console.log(`[LogCorrelation] Request ${req.method} ${req.path} traced with ID: ${traceId}`);
|
|
238
|
+
}
|
|
239
|
+
next();
|
|
240
|
+
};
|
|
241
|
+
}
|
|
242
|
+
//# sourceMappingURL=LogCorrelation.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"LogCorrelation.js","sourceRoot":"","sources":["../../../src/core/LogCorrelation.ts"],"names":[],"mappings":"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"}
|