@futdevpro/nts-dynamo 1.15.17 → 1.15.19
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/_specifications/BACKLOG.md +2 -2
- package/build/_models/interfaces/global-log-settings.interface.d.ts +35 -0
- package/build/_models/interfaces/global-log-settings.interface.d.ts.map +1 -1
- package/build/_modules/logs/file-log.service.d.ts +87 -0
- package/build/_modules/logs/file-log.service.d.ts.map +1 -0
- package/build/_modules/logs/file-log.service.js +267 -0
- package/build/_modules/logs/file-log.service.js.map +1 -0
- package/build/_modules/logs/get-logs-routing-module.util.d.ts +19 -0
- package/build/_modules/logs/get-logs-routing-module.util.d.ts.map +1 -0
- package/build/_modules/logs/get-logs-routing-module.util.js +32 -0
- package/build/_modules/logs/get-logs-routing-module.util.js.map +1 -0
- package/build/_modules/logs/index.d.ts +5 -0
- package/build/_modules/logs/index.d.ts.map +1 -0
- package/build/_modules/logs/index.js +12 -0
- package/build/_modules/logs/index.js.map +1 -0
- package/build/_modules/logs/log-buffer.service.d.ts +38 -0
- package/build/_modules/logs/log-buffer.service.d.ts.map +1 -0
- package/build/_modules/logs/log-buffer.service.js +97 -0
- package/build/_modules/logs/log-buffer.service.js.map +1 -0
- package/build/_modules/logs/logs.controller.d.ts +27 -0
- package/build/_modules/logs/logs.controller.d.ts.map +1 -0
- package/build/_modules/logs/logs.controller.js +90 -0
- package/build/_modules/logs/logs.controller.js.map +1 -0
- package/build/_modules/logs/logs.service.d.ts +40 -0
- package/build/_modules/logs/logs.service.d.ts.map +1 -0
- package/build/_modules/logs/logs.service.js +97 -0
- package/build/_modules/logs/logs.service.js.map +1 -0
- package/package.json +1 -1
- package/pipeline.cicd.config.json +3 -1
- package/src/_models/interfaces/global-log-settings.interface.ts +36 -0
- package/src/_modules/logs/file-log.service.spec.ts +202 -0
- package/src/_modules/logs/file-log.service.ts +283 -0
- package/src/_modules/logs/get-logs-routing-module.util.ts +36 -0
- package/src/_modules/logs/index.ts +4 -0
- package/src/_modules/logs/log-buffer.service.ts +101 -0
- package/src/_modules/logs/logs.controller.ts +109 -0
- package/src/_modules/logs/logs.service.ts +100 -0
|
@@ -0,0 +1,283 @@
|
|
|
1
|
+
import * as fs from 'fs';
|
|
2
|
+
import * as path from 'path';
|
|
3
|
+
|
|
4
|
+
import { DyNTS_SingletonServiceBase } from '../../_services/base/singleton.service-base';
|
|
5
|
+
import { DyNTS_global_settings } from '../../_collections/global-settings.const';
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
/**
|
|
9
|
+
* Default ertekek a file-log config mezokhez. A `file_log` config nelkul
|
|
10
|
+
* az install() no-op (enabled === false).
|
|
11
|
+
*/
|
|
12
|
+
const DEFAULT_LOG_DIR: string = './logs/server';
|
|
13
|
+
const DEFAULT_FILENAME_PREFIX: string = 'server-';
|
|
14
|
+
const DEFAULT_FILENAME_SUFFIX: string = '.log';
|
|
15
|
+
const DEFAULT_MAX_FILE_SIZE_MB: number = 50;
|
|
16
|
+
const DEFAULT_MAX_FILES: number = 10;
|
|
17
|
+
const DEFAULT_RETENTION_DAYS: number = 30;
|
|
18
|
+
const DEFAULT_STRIP_ANSI: boolean = true;
|
|
19
|
+
const DEFAULT_INCLUDE_STDOUT: boolean = true;
|
|
20
|
+
const DEFAULT_INCLUDE_STDERR: boolean = true;
|
|
21
|
+
|
|
22
|
+
/** ANSI escape code regex (szin/formazas kodok). */
|
|
23
|
+
const ANSI_ESCAPE_REGEX: RegExp = /\x1b\[[0-9;]*[a-zA-Z]/g;
|
|
24
|
+
|
|
25
|
+
|
|
26
|
+
/**
|
|
27
|
+
* File-based szerver log service — duplikalja a stdout/stderr-t per-session
|
|
28
|
+
* log fajl(ok)ba, miközben a console kimenet erintetlenul marad. Az
|
|
29
|
+
* in-memory ring buffer (`DyNTS_Logs_Service`) MELLETT mukodik, NEM
|
|
30
|
+
* helyette.
|
|
31
|
+
*
|
|
32
|
+
* Architecture:
|
|
33
|
+
* - `process.stdout.write` es `process.stderr.write` monkey-patch (NEM
|
|
34
|
+
* `console.*` — azt mar a `DyNTS_Logs_Service` patch-elheti)
|
|
35
|
+
* - Per-session fajl: `{logDir}/{prefix}YYYY-MM-DD_HH-MM-SS.log`
|
|
36
|
+
* - Sync `appendFileSync` iras — crash-safe, azonnali flush
|
|
37
|
+
* - Rotation: `maxFileSizeMb` atlepesenel uj session fajl
|
|
38
|
+
* - Retention: `maxFiles` (count) ES `retentionDays` (age) — ami elobb
|
|
39
|
+
* teljesul; install-kor + minden rotation utan futtatva
|
|
40
|
+
* - Silent failure: file IO hibak ELNYELODNEK (a file logger SOHASEM
|
|
41
|
+
* buktathatja el a szervert)
|
|
42
|
+
*
|
|
43
|
+
* Idempotens: tobbszori install() hivas no-op (a masodiktol).
|
|
44
|
+
*
|
|
45
|
+
* Hasznalat:
|
|
46
|
+
* DyNTS_global_settings.log_settings.file_log = { enabled: true, ... };
|
|
47
|
+
* DyNTS_FileLog_Service.getInstance().install(); // szerver startup
|
|
48
|
+
*/
|
|
49
|
+
export class DyNTS_FileLog_Service extends DyNTS_SingletonServiceBase {
|
|
50
|
+
|
|
51
|
+
static getInstance(): DyNTS_FileLog_Service {
|
|
52
|
+
return DyNTS_FileLog_Service.getSingletonInstance() as DyNTS_FileLog_Service;
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
private installed: boolean = false;
|
|
56
|
+
private activeLogDir: string = '';
|
|
57
|
+
private filenamePrefix: string = DEFAULT_FILENAME_PREFIX;
|
|
58
|
+
private maxFileSizeBytes: number = DEFAULT_MAX_FILE_SIZE_MB * 1024 * 1024;
|
|
59
|
+
private maxFiles: number = DEFAULT_MAX_FILES;
|
|
60
|
+
private retentionDays: number = DEFAULT_RETENTION_DAYS;
|
|
61
|
+
private stripAnsiEnabled: boolean = DEFAULT_STRIP_ANSI;
|
|
62
|
+
private currentLogPath: string = '';
|
|
63
|
+
private currentLogSizeBytes: number = 0;
|
|
64
|
+
|
|
65
|
+
private originalStdoutWrite: typeof process.stdout.write | null = null;
|
|
66
|
+
private originalStderrWrite: typeof process.stderr.write | null = null;
|
|
67
|
+
|
|
68
|
+
|
|
69
|
+
/**
|
|
70
|
+
* Telepiti a file logger-t a `DyNTS_global_settings.log_settings.file_log`
|
|
71
|
+
* config alapjan. Ha `enabled === false` vagy hianyzik a config → no-op.
|
|
72
|
+
*
|
|
73
|
+
* Idempotens — masodszori hivas no-op (akkor is, ha kozben a config
|
|
74
|
+
* valtozott; a service uj install-jara teardownFor Testing() + install()).
|
|
75
|
+
*/
|
|
76
|
+
install(): void {
|
|
77
|
+
if (this.installed) { return; }
|
|
78
|
+
|
|
79
|
+
const config = DyNTS_global_settings.log_settings?.file_log;
|
|
80
|
+
if (!config || !config.enabled) { return; }
|
|
81
|
+
|
|
82
|
+
// Config feldolgozas + default-ok
|
|
83
|
+
this.activeLogDir = config.logDir ?? DEFAULT_LOG_DIR;
|
|
84
|
+
this.filenamePrefix = config.filenamePrefix ?? DEFAULT_FILENAME_PREFIX;
|
|
85
|
+
this.maxFileSizeBytes = (config.maxFileSizeMb ?? DEFAULT_MAX_FILE_SIZE_MB) * 1024 * 1024;
|
|
86
|
+
this.maxFiles = config.maxFiles ?? DEFAULT_MAX_FILES;
|
|
87
|
+
this.retentionDays = config.retentionDays ?? DEFAULT_RETENTION_DAYS;
|
|
88
|
+
this.stripAnsiEnabled = config.stripAnsi ?? DEFAULT_STRIP_ANSI;
|
|
89
|
+
const includeStdout: boolean = config.includeStdout ?? DEFAULT_INCLUDE_STDOUT;
|
|
90
|
+
const includeStderr: boolean = config.includeStderr ?? DEFAULT_INCLUDE_STDERR;
|
|
91
|
+
|
|
92
|
+
// Log dir letrehozasa silently
|
|
93
|
+
try {
|
|
94
|
+
if (!fs.existsSync(this.activeLogDir)) {
|
|
95
|
+
fs.mkdirSync(this.activeLogDir, { recursive: true });
|
|
96
|
+
}
|
|
97
|
+
} catch {
|
|
98
|
+
// Ha a mkdir bukik (pl. permission denied), no-op — silent failure
|
|
99
|
+
return;
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
// Retention cleanup MIELOTT az uj session fajl letrejon (hogy a takaritas
|
|
103
|
+
// log uzenete ne keruljon a most induló fajlba)
|
|
104
|
+
this.cleanupOldLogs();
|
|
105
|
+
|
|
106
|
+
// Uj session fajl path + size init
|
|
107
|
+
this.currentLogPath = path.join(this.activeLogDir, this.buildSessionFilename());
|
|
108
|
+
this.currentLogSizeBytes = 0;
|
|
109
|
+
|
|
110
|
+
// Monkey-patch — az originalokat elmentjük (teardown miatt)
|
|
111
|
+
if (includeStdout) {
|
|
112
|
+
this.originalStdoutWrite = process.stdout.write.bind(process.stdout);
|
|
113
|
+
const self: DyNTS_FileLog_Service = this;
|
|
114
|
+
// eslint-disable-next-line @typescript-eslint/no-explicit-any
|
|
115
|
+
process.stdout.write = function patchedStdoutWrite(...args: any[]): boolean {
|
|
116
|
+
self.teeWrite(args[0]);
|
|
117
|
+
// eslint-disable-next-line @typescript-eslint/no-explicit-any
|
|
118
|
+
return (self.originalStdoutWrite as any)(...args);
|
|
119
|
+
// eslint-disable-next-line @typescript-eslint/no-explicit-any
|
|
120
|
+
} as any;
|
|
121
|
+
}
|
|
122
|
+
if (includeStderr) {
|
|
123
|
+
this.originalStderrWrite = process.stderr.write.bind(process.stderr);
|
|
124
|
+
const self: DyNTS_FileLog_Service = this;
|
|
125
|
+
// eslint-disable-next-line @typescript-eslint/no-explicit-any
|
|
126
|
+
process.stderr.write = function patchedStderrWrite(...args: any[]): boolean {
|
|
127
|
+
self.teeWrite(args[0]);
|
|
128
|
+
// eslint-disable-next-line @typescript-eslint/no-explicit-any
|
|
129
|
+
return (self.originalStderrWrite as any)(...args);
|
|
130
|
+
// eslint-disable-next-line @typescript-eslint/no-explicit-any
|
|
131
|
+
} as any;
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
this.installed = true;
|
|
135
|
+
|
|
136
|
+
// Session header — kulcs info egy helyen a fajl tetejen
|
|
137
|
+
this.teeWrite(
|
|
138
|
+
`===== DyNTS server log session started at ${new Date().toISOString()} =====\n` +
|
|
139
|
+
`===== PID: ${process.pid}, Node: ${process.version} =====\n` +
|
|
140
|
+
`===== Retention: ${this.retentionDays} days, max files: ${this.maxFiles}, max size: ${config.maxFileSizeMb ?? DEFAULT_MAX_FILE_SIZE_MB}MB =====\n\n`,
|
|
141
|
+
);
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
/**
|
|
145
|
+
* Visszaadja az aktualis log fajl abszolut path-jat (csak akkor letezo,
|
|
146
|
+
* ha az install() sikeresen lefutott; egyebkent ures string).
|
|
147
|
+
*/
|
|
148
|
+
getCurrentLogPath(): string {
|
|
149
|
+
return this.currentLogPath;
|
|
150
|
+
}
|
|
151
|
+
|
|
152
|
+
/**
|
|
153
|
+
* Telepitve van-e (csak akkor true, ha az enabled === true es a setup nem bukott).
|
|
154
|
+
*/
|
|
155
|
+
isInstalled(): boolean {
|
|
156
|
+
return this.installed;
|
|
157
|
+
}
|
|
158
|
+
|
|
159
|
+
/**
|
|
160
|
+
* Test-only: visszallitja az eredeti stdout/stderr.write-okat, hogy a
|
|
161
|
+
* specfajlok egymas utan tisztán futhassanak. Production code NE hivja.
|
|
162
|
+
*/
|
|
163
|
+
_teardownForTesting(): void {
|
|
164
|
+
if (this.originalStdoutWrite) {
|
|
165
|
+
process.stdout.write = this.originalStdoutWrite;
|
|
166
|
+
this.originalStdoutWrite = null;
|
|
167
|
+
}
|
|
168
|
+
if (this.originalStderrWrite) {
|
|
169
|
+
process.stderr.write = this.originalStderrWrite;
|
|
170
|
+
this.originalStderrWrite = null;
|
|
171
|
+
}
|
|
172
|
+
this.installed = false;
|
|
173
|
+
this.activeLogDir = '';
|
|
174
|
+
this.currentLogPath = '';
|
|
175
|
+
this.currentLogSizeBytes = 0;
|
|
176
|
+
}
|
|
177
|
+
|
|
178
|
+
|
|
179
|
+
/**
|
|
180
|
+
* Session fajl nev: `{prefix}YYYY-MM-DD_HH-MM-SS_RANDOM.log`. Az RANDOM
|
|
181
|
+
* suffix biztositja a unique nevet ha ugyanazon a masodpercen tobb fajl jon letre
|
|
182
|
+
* (pl. rotation kozvetlenul install utan, vagy specfajlok gyors egymas utan).
|
|
183
|
+
*/
|
|
184
|
+
private buildSessionFilename(): string {
|
|
185
|
+
const now: Date = new Date();
|
|
186
|
+
const year: string = String(now.getFullYear());
|
|
187
|
+
const month: string = String(now.getMonth() + 1).padStart(2, '0');
|
|
188
|
+
const day: string = String(now.getDate()).padStart(2, '0');
|
|
189
|
+
const hour: string = String(now.getHours()).padStart(2, '0');
|
|
190
|
+
const minute: string = String(now.getMinutes()).padStart(2, '0');
|
|
191
|
+
const second: string = String(now.getSeconds()).padStart(2, '0');
|
|
192
|
+
const rand: string = Math.floor(Math.random() * 100000).toString(36);
|
|
193
|
+
return `${this.filenamePrefix}${year}-${month}-${day}_${hour}-${minute}-${second}_${rand}${DEFAULT_FILENAME_SUFFIX}`;
|
|
194
|
+
}
|
|
195
|
+
|
|
196
|
+
|
|
197
|
+
/**
|
|
198
|
+
* Egyetlen stdout/stderr iras tee-zese az aktualis log fajlba.
|
|
199
|
+
* Hibakat csendben elnyeli — a file logger SOHASEM blokkolja a szervert.
|
|
200
|
+
* Size-trackeli az aktualis fajlt es szukseg szerint rotalja.
|
|
201
|
+
*/
|
|
202
|
+
private teeWrite(data: string | Uint8Array): void {
|
|
203
|
+
try {
|
|
204
|
+
if (!this.currentLogPath) { return; }
|
|
205
|
+
|
|
206
|
+
const asString: string = typeof data === 'string'
|
|
207
|
+
? data
|
|
208
|
+
: Buffer.from(data).toString('utf-8');
|
|
209
|
+
const cleaned: string = this.stripAnsiEnabled ? asString.replace(ANSI_ESCAPE_REGEX, '') : asString;
|
|
210
|
+
const writeBytes: number = Buffer.byteLength(cleaned, 'utf-8');
|
|
211
|
+
|
|
212
|
+
fs.appendFileSync(this.currentLogPath, cleaned, 'utf-8');
|
|
213
|
+
this.currentLogSizeBytes += writeBytes;
|
|
214
|
+
|
|
215
|
+
// Rotation trigger
|
|
216
|
+
if (this.currentLogSizeBytes >= this.maxFileSizeBytes) {
|
|
217
|
+
this.rotate();
|
|
218
|
+
}
|
|
219
|
+
} catch {
|
|
220
|
+
// szandekosan elnyelve — silent failure
|
|
221
|
+
}
|
|
222
|
+
}
|
|
223
|
+
|
|
224
|
+
/**
|
|
225
|
+
* Uj session fajl letrehozasa (az aktualis lezarodik). Retention cleanup-ot is
|
|
226
|
+
* vegrehajt, hogy a rotation termeszetesen tisztan tarttsa a log dir-t.
|
|
227
|
+
*/
|
|
228
|
+
private rotate(): void {
|
|
229
|
+
try {
|
|
230
|
+
this.cleanupOldLogs();
|
|
231
|
+
this.currentLogPath = path.join(this.activeLogDir, this.buildSessionFilename());
|
|
232
|
+
this.currentLogSizeBytes = 0;
|
|
233
|
+
} catch {
|
|
234
|
+
// szandekosan elnyelve
|
|
235
|
+
}
|
|
236
|
+
}
|
|
237
|
+
|
|
238
|
+
|
|
239
|
+
/**
|
|
240
|
+
* Retention takaritas: ket szabaly ami ami elobb teljesul:
|
|
241
|
+
* 1) maxFiles — ha tobb mint N log fajl van, a legregebbieket torli
|
|
242
|
+
* 2) retentionDays — `retentionDays`-nel idosebb fajlokat torli
|
|
243
|
+
*
|
|
244
|
+
* Hibakat csendben elnyel. A torolt fajlokat es az okot NEM logoljuk, hogy
|
|
245
|
+
* ne kerüljön extra szennyezes a most induló session fajlba.
|
|
246
|
+
*/
|
|
247
|
+
private cleanupOldLogs(): void {
|
|
248
|
+
try {
|
|
249
|
+
if (!fs.existsSync(this.activeLogDir)) { return; }
|
|
250
|
+
|
|
251
|
+
const cutoffMs: number = Date.now() - this.retentionDays * 24 * 60 * 60 * 1000;
|
|
252
|
+
const entries: string[] = fs.readdirSync(this.activeLogDir);
|
|
253
|
+
|
|
254
|
+
type FileInfo = { fullPath: string; mtimeMs: number };
|
|
255
|
+
const matchingFiles: FileInfo[] = [];
|
|
256
|
+
|
|
257
|
+
for (const entry of entries) {
|
|
258
|
+
if (!entry.startsWith(this.filenamePrefix) || !entry.endsWith(DEFAULT_FILENAME_SUFFIX)) { continue; }
|
|
259
|
+
const fullPath: string = path.join(this.activeLogDir, entry);
|
|
260
|
+
try {
|
|
261
|
+
const stats: fs.Stats = fs.statSync(fullPath);
|
|
262
|
+
matchingFiles.push({ fullPath: fullPath, mtimeMs: stats.mtimeMs });
|
|
263
|
+
} catch {
|
|
264
|
+
// fajlonkent elnyelve
|
|
265
|
+
}
|
|
266
|
+
}
|
|
267
|
+
|
|
268
|
+
// Sort: legujabb elol -> legregebbi hatul (csokkeno mtime)
|
|
269
|
+
matchingFiles.sort((a: FileInfo, b: FileInfo): number => b.mtimeMs - a.mtimeMs);
|
|
270
|
+
|
|
271
|
+
for (let i: number = 0; i < matchingFiles.length; i++) {
|
|
272
|
+
const file: FileInfo = matchingFiles[i];
|
|
273
|
+
const tooOldByAge: boolean = file.mtimeMs < cutoffMs;
|
|
274
|
+
const tooManyByCount: boolean = i >= this.maxFiles;
|
|
275
|
+
if (tooOldByAge || tooManyByCount) {
|
|
276
|
+
try { fs.unlinkSync(file.fullPath); } catch { /* fajlonkent elnyelve */ }
|
|
277
|
+
}
|
|
278
|
+
}
|
|
279
|
+
} catch {
|
|
280
|
+
// szandekosan elnyelve
|
|
281
|
+
}
|
|
282
|
+
}
|
|
283
|
+
}
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
import { Request, Response } from 'express';
|
|
2
|
+
|
|
3
|
+
import { DyNTS_RoutingModule_Settings } from '../../_models/interfaces/routing-module-settings.interface';
|
|
4
|
+
import { DyNTS_RoutingModule } from '../../_services/route/routing-module.service';
|
|
5
|
+
import { DyNTS_Logs_Controller, DyNTS_LogsController_Config } from './logs.controller';
|
|
6
|
+
|
|
7
|
+
/**
|
|
8
|
+
* Letrehoz egy /logs routing module-t a szerver logok lekeresehez.
|
|
9
|
+
*
|
|
10
|
+
* Hasznalat (auth NELKUL — barki elerheti):
|
|
11
|
+
* DyNTS_getLogsRoutingModule()
|
|
12
|
+
*
|
|
13
|
+
* Hasznalat (auth-TAL — a megadott preProcess fut elotte):
|
|
14
|
+
* DyNTS_getLogsRoutingModule({
|
|
15
|
+
* authPreProcess: authService.authenticate_sercretKey
|
|
16
|
+
* })
|
|
17
|
+
*
|
|
18
|
+
* FONTOS: A szerver indulasakor meg kell hivni:
|
|
19
|
+
* DyNTS_Logs_Service.getInstance().install()
|
|
20
|
+
* es a log_settings.logs_endpoint.enabled = true kell legyen.
|
|
21
|
+
*/
|
|
22
|
+
export function DyNTS_getLogsRoutingModule(
|
|
23
|
+
config?: DyNTS_LogsController_Config
|
|
24
|
+
): DyNTS_RoutingModule {
|
|
25
|
+
// Konfiguracio atadasa a controller-nek (static, mert a singleton elott kell)
|
|
26
|
+
if (config) {
|
|
27
|
+
DyNTS_Logs_Controller.configure(config);
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
const set: DyNTS_RoutingModule_Settings = {
|
|
31
|
+
route: '/logs',
|
|
32
|
+
controllers: [DyNTS_Logs_Controller.getInstance()],
|
|
33
|
+
};
|
|
34
|
+
|
|
35
|
+
return new DyNTS_RoutingModule(set);
|
|
36
|
+
}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
export { DyNTS_Logs_Service } from './logs.service';
|
|
2
|
+
export { DyNTS_Logs_Controller, DyNTS_LogsController_Config } from './logs.controller';
|
|
3
|
+
export { DyNTS_getLogsRoutingModule } from './get-logs-routing-module.util';
|
|
4
|
+
export { DyNTS_FileLog_Service } from './file-log.service';
|
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
|
|
2
|
+
import { DyNTS_SingletonService } from '../../_services/base/singleton.service';
|
|
3
|
+
|
|
4
|
+
/**
|
|
5
|
+
* In-memory ring buffer a szerver console kimenethez.
|
|
6
|
+
* Interceptalja a console.log/error/warn/info hivasokat es eltarolja az utolso N sort.
|
|
7
|
+
*
|
|
8
|
+
* Hasznalat:
|
|
9
|
+
* DyNTS_LogBuffer_Service.getInstance().install(); // app startup-nal
|
|
10
|
+
* DyNTS_LogBuffer_Service.getInstance().getLines(100); // utolso 100 sor
|
|
11
|
+
*/
|
|
12
|
+
export class DyNTS_LogBuffer_Service extends DyNTS_SingletonService {
|
|
13
|
+
|
|
14
|
+
static getInstance(): DyNTS_LogBuffer_Service {
|
|
15
|
+
return DyNTS_LogBuffer_Service.getSingletonInstance();
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
private readonly maxLines: number = 2000;
|
|
19
|
+
private readonly buffer: string[] = [];
|
|
20
|
+
private installed: boolean = false;
|
|
21
|
+
|
|
22
|
+
/**
|
|
23
|
+
* Interceptalja a console.log/error/warn/info kimeneteket es a bufferbe irja.
|
|
24
|
+
* Egyszer kell hivni, a szerver indulasakor (lehetoleg a legelso muvelet).
|
|
25
|
+
*/
|
|
26
|
+
install(): void {
|
|
27
|
+
if (this.installed) { return; }
|
|
28
|
+
this.installed = true;
|
|
29
|
+
|
|
30
|
+
const self: DyNTS_LogBuffer_Service = this;
|
|
31
|
+
|
|
32
|
+
const originalLog: typeof console.log = console.log.bind(console);
|
|
33
|
+
const originalError: typeof console.error = console.error.bind(console);
|
|
34
|
+
const originalWarn: typeof console.warn = console.warn.bind(console);
|
|
35
|
+
const originalInfo: typeof console.info = console.info.bind(console);
|
|
36
|
+
|
|
37
|
+
console.log = (...args: any[]): void => {
|
|
38
|
+
self.addLine('LOG', args);
|
|
39
|
+
originalLog(...args);
|
|
40
|
+
};
|
|
41
|
+
|
|
42
|
+
console.error = (...args: any[]): void => {
|
|
43
|
+
self.addLine('ERR', args);
|
|
44
|
+
originalError(...args);
|
|
45
|
+
};
|
|
46
|
+
|
|
47
|
+
console.warn = (...args: any[]): void => {
|
|
48
|
+
self.addLine('WRN', args);
|
|
49
|
+
originalWarn(...args);
|
|
50
|
+
};
|
|
51
|
+
|
|
52
|
+
console.info = (...args: any[]): void => {
|
|
53
|
+
self.addLine('INF', args);
|
|
54
|
+
originalInfo(...args);
|
|
55
|
+
};
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
/**
|
|
59
|
+
* A log buffer be van-e kapcsolva (install megtortent-e).
|
|
60
|
+
*/
|
|
61
|
+
isInstalled(): boolean {
|
|
62
|
+
return this.installed;
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
/**
|
|
66
|
+
* Az utolso N sor lekerdezese.
|
|
67
|
+
*/
|
|
68
|
+
getLines(count: number = 200): string[] {
|
|
69
|
+
const start: number = Math.max(0, this.buffer.length - count);
|
|
70
|
+
return this.buffer.slice(start);
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
/**
|
|
74
|
+
* Az osszes buffered sor szama.
|
|
75
|
+
*/
|
|
76
|
+
getLineCount(): number {
|
|
77
|
+
return this.buffer.length;
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
/**
|
|
81
|
+
* Buffer uritese.
|
|
82
|
+
*/
|
|
83
|
+
clear(): void {
|
|
84
|
+
this.buffer.length = 0;
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
private addLine(level: string, args: any[]): void {
|
|
88
|
+
const timestamp: string = new Date().toISOString();
|
|
89
|
+
const message: string = args.map(formatArg).join(' ');
|
|
90
|
+
this.buffer.push(`${timestamp} [${level}] ${message}`);
|
|
91
|
+
|
|
92
|
+
if (this.buffer.length > this.maxLines) {
|
|
93
|
+
this.buffer.shift();
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
function formatArg(arg: any): string {
|
|
99
|
+
if (typeof arg === 'string') { return arg; }
|
|
100
|
+
try { return JSON.stringify(arg); } catch { return String(arg); }
|
|
101
|
+
}
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
import { Request, Response } from 'express';
|
|
2
|
+
|
|
3
|
+
import { DyFM_HttpCallType } from '@futdevpro/fsm-dynamo';
|
|
4
|
+
|
|
5
|
+
import { DyNTS_Controller } from '../../_services/route/controller.service';
|
|
6
|
+
import { DyNTS_Endpoint_Params } from '../../_models/control-models/endpoint-params.control-model';
|
|
7
|
+
import { DyNTS_global_settings } from '../../_collections/global-settings.const';
|
|
8
|
+
import { DyNTS_Logs_Service } from './logs.service';
|
|
9
|
+
|
|
10
|
+
/**
|
|
11
|
+
* Overseer-szintu log parameter tipus.
|
|
12
|
+
* Az authPreProcess opcionalis — ha megadod, a /get endpoint vedett lesz.
|
|
13
|
+
*/
|
|
14
|
+
export interface DyNTS_LogsController_Config {
|
|
15
|
+
/** Opcionalis auth preprocess. Ha nincs megadva → nyilt hozzaferes. */
|
|
16
|
+
authPreProcess?: (req: Request, res: Response) => Promise<void>;
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
/**
|
|
20
|
+
* NTS Logs Controller — beepitett /logs/get endpoint a szerver logok lekeresehez.
|
|
21
|
+
*
|
|
22
|
+
* Hasznalat:
|
|
23
|
+
* DyNTS_getLogsRoutingModule() — auth nelkul
|
|
24
|
+
* DyNTS_getLogsRoutingModule({ authPreProcess: myAuth }) — auth-tal
|
|
25
|
+
*
|
|
26
|
+
* Ha a logs_endpoint.enabled === false, a controller 503-at dob.
|
|
27
|
+
*/
|
|
28
|
+
export class DyNTS_Logs_Controller extends DyNTS_Controller {
|
|
29
|
+
|
|
30
|
+
private static config: DyNTS_LogsController_Config = {};
|
|
31
|
+
|
|
32
|
+
static configure(config: DyNTS_LogsController_Config): void {
|
|
33
|
+
DyNTS_Logs_Controller.config = config;
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
static getInstance(): DyNTS_Logs_Controller {
|
|
37
|
+
return DyNTS_Logs_Controller.getSingletonInstance();
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
private readonly logsService: DyNTS_Logs_Service = DyNTS_Logs_Service.getInstance();
|
|
41
|
+
|
|
42
|
+
setupEndpoints(): void {
|
|
43
|
+
const preProcesses: ((req: Request, res: Response) => Promise<void>)[] = [];
|
|
44
|
+
if (DyNTS_Logs_Controller.config.authPreProcess) {
|
|
45
|
+
preProcesses.push(DyNTS_Logs_Controller.config.authPreProcess);
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
this.endpoints = [
|
|
49
|
+
// GET /get?tail=200 — utolso N sor a log bufferbol
|
|
50
|
+
new DyNTS_Endpoint_Params({
|
|
51
|
+
name: 'getLogs',
|
|
52
|
+
type: DyFM_HttpCallType.get,
|
|
53
|
+
endpoint: '/get',
|
|
54
|
+
preProcesses: preProcesses,
|
|
55
|
+
logRequest: false,
|
|
56
|
+
tasks: [
|
|
57
|
+
async (req: Request, res: Response): Promise<void> => {
|
|
58
|
+
// Ellenorzes: be van-e kapcsolva a logs endpoint
|
|
59
|
+
if (!DyNTS_global_settings.log_settings?.logs_endpoint?.enabled) {
|
|
60
|
+
res.status(503).send({
|
|
61
|
+
error: 'Logs endpoint is not enabled on this server.',
|
|
62
|
+
hint: 'Set DyNTS_global_settings.log_settings.logs_endpoint.enabled = true',
|
|
63
|
+
});
|
|
64
|
+
return;
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
// Ellenorzes: install megtortent-e
|
|
68
|
+
if (!this.logsService.isInstalled()) {
|
|
69
|
+
res.status(503).send({
|
|
70
|
+
error: 'Log buffer is not installed. Call DyNTS_Logs_Service.getInstance().install() at server startup.',
|
|
71
|
+
});
|
|
72
|
+
return;
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
const tail: number = Math.min(parseInt(req.query.tail as string) || 200, 2000);
|
|
76
|
+
const lines: string[] = this.logsService.getLines(tail);
|
|
77
|
+
|
|
78
|
+
res.send({
|
|
79
|
+
totalBuffered: this.logsService.getLineCount(),
|
|
80
|
+
returned: lines.length,
|
|
81
|
+
lines: lines,
|
|
82
|
+
});
|
|
83
|
+
},
|
|
84
|
+
],
|
|
85
|
+
}),
|
|
86
|
+
|
|
87
|
+
// DELETE /clear — buffer uritese
|
|
88
|
+
new DyNTS_Endpoint_Params({
|
|
89
|
+
name: 'clearLogs',
|
|
90
|
+
type: DyFM_HttpCallType.delete,
|
|
91
|
+
endpoint: '/clear',
|
|
92
|
+
preProcesses: preProcesses,
|
|
93
|
+
logRequest: false,
|
|
94
|
+
tasks: [
|
|
95
|
+
async (req: Request, res: Response): Promise<void> => {
|
|
96
|
+
if (!DyNTS_global_settings.log_settings?.logs_endpoint?.enabled) {
|
|
97
|
+
res.status(503).send({ error: 'Logs endpoint is not enabled.' });
|
|
98
|
+
return;
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
const count: number = this.logsService.getLineCount();
|
|
102
|
+
this.logsService.clear();
|
|
103
|
+
res.send({ result: 'Log buffer cleared', clearedLines: count });
|
|
104
|
+
},
|
|
105
|
+
],
|
|
106
|
+
}),
|
|
107
|
+
];
|
|
108
|
+
}
|
|
109
|
+
}
|
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
import { DyNTS_SingletonServiceBase } from '../../_services/base/singleton.service-base';
|
|
2
|
+
import { DyNTS_global_settings } from '../../_collections/global-settings.const';
|
|
3
|
+
|
|
4
|
+
/**
|
|
5
|
+
* In-memory ring buffer a szerver logokhoz.
|
|
6
|
+
* Interceptalja a console.log/error/warn kimeneteket es tarolja oket.
|
|
7
|
+
* Max entryszam a log_settings.logs_endpoint.maxEntries-bol jon (default: 2000).
|
|
8
|
+
*
|
|
9
|
+
* Hasznalat:
|
|
10
|
+
* DyNTS_Logs_Service.getInstance().install() — egyszer, szerver indulasakor
|
|
11
|
+
* DyNTS_Logs_Service.getInstance().getLines(200) — utolso N sor
|
|
12
|
+
*/
|
|
13
|
+
export class DyNTS_Logs_Service extends DyNTS_SingletonServiceBase {
|
|
14
|
+
|
|
15
|
+
static getInstance(): DyNTS_Logs_Service {
|
|
16
|
+
return DyNTS_Logs_Service.getSingletonInstance() as DyNTS_Logs_Service;
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
private readonly maxEntries: number;
|
|
20
|
+
private readonly buffer: string[] = [];
|
|
21
|
+
private installed: boolean = false;
|
|
22
|
+
|
|
23
|
+
protected constructor() {
|
|
24
|
+
super();
|
|
25
|
+
this.maxEntries = DyNTS_global_settings.log_settings?.logs_endpoint?.maxEntries ?? 2000;
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
/**
|
|
29
|
+
* Interceptalja a console.log/error/warn kimeneteket es a bufferbe irja.
|
|
30
|
+
* Egyszer kell hivni, a szerver indulasakor. Tobbszori hivas no-op.
|
|
31
|
+
*/
|
|
32
|
+
install(): void {
|
|
33
|
+
if (this.installed) { return; }
|
|
34
|
+
this.installed = true;
|
|
35
|
+
|
|
36
|
+
const originalLog: typeof console.log = console.log.bind(console);
|
|
37
|
+
const originalError: typeof console.error = console.error.bind(console);
|
|
38
|
+
const originalWarn: typeof console.warn = console.warn.bind(console);
|
|
39
|
+
|
|
40
|
+
const self: DyNTS_Logs_Service = this;
|
|
41
|
+
|
|
42
|
+
console.log = (...args: any[]): void => {
|
|
43
|
+
self.addLine('LOG', args);
|
|
44
|
+
originalLog(...args);
|
|
45
|
+
};
|
|
46
|
+
|
|
47
|
+
console.error = (...args: any[]): void => {
|
|
48
|
+
self.addLine('ERR', args);
|
|
49
|
+
originalError(...args);
|
|
50
|
+
};
|
|
51
|
+
|
|
52
|
+
console.warn = (...args: any[]): void => {
|
|
53
|
+
self.addLine('WRN', args);
|
|
54
|
+
originalWarn(...args);
|
|
55
|
+
};
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
/**
|
|
59
|
+
* Az utolso N sor lekerdezese.
|
|
60
|
+
*/
|
|
61
|
+
getLines(count: number = 200): string[] {
|
|
62
|
+
const start: number = Math.max(0, this.buffer.length - count);
|
|
63
|
+
return this.buffer.slice(start);
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
/**
|
|
67
|
+
* Osszes bufferelt sor szama.
|
|
68
|
+
*/
|
|
69
|
+
getLineCount(): number {
|
|
70
|
+
return this.buffer.length;
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
/**
|
|
74
|
+
* Buffer uritese.
|
|
75
|
+
*/
|
|
76
|
+
clear(): void {
|
|
77
|
+
this.buffer.length = 0;
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
/**
|
|
81
|
+
* Telepitve van-e mar a console intercept.
|
|
82
|
+
*/
|
|
83
|
+
isInstalled(): boolean {
|
|
84
|
+
return this.installed;
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
private addLine(level: string, args: any[]): void {
|
|
88
|
+
const message: string = args.map((arg: any) => {
|
|
89
|
+
if (typeof arg === 'string') { return arg; }
|
|
90
|
+
try { return JSON.stringify(arg); } catch { return String(arg); }
|
|
91
|
+
}).join(' ');
|
|
92
|
+
|
|
93
|
+
const timestamped: string = `${new Date().toISOString()} [${level}] ${message}`;
|
|
94
|
+
this.buffer.push(timestamped);
|
|
95
|
+
|
|
96
|
+
if (this.buffer.length > this.maxEntries) {
|
|
97
|
+
this.buffer.shift();
|
|
98
|
+
}
|
|
99
|
+
}
|
|
100
|
+
}
|