@devskeo/ward-agent 1.0.0

package/dist/index.js

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// Ward 에이전트 CLI 진입점
+const commander_1 = require("commander");
+const start_js_1 = require("./cli/start.js");
+const stop_js_1 = require("./cli/stop.js");
+const status_js_1 = require("./cli/status.js");
+const config_js_1 = require("./cli/config.js");
+const service_js_1 = require("./cli/service.js");
+const pipe_js_1 = require("./cli/pipe.js");
+const AgentConfig_js_1 = require("./config/AgentConfig.js");
+const program = new commander_1.Command();
+program
+    .name('ward')
+    .description('Ward 서버 모니터링 에이전트')
+    .version('0.1.0');
+// ward start [serverUrl] - 에이전트 시작
+program
+    .command('start [serverUrl]')
+    .description('에이전트를 시작합니다. 처음 실행 시 서버 URL을 지정하세요.')
+    .option('--name <groupName>', '서버 그룹명 (클러스터 환경에서 서버를 그룹화)')
+    .action(async (serverUrl, options) => {
+    if (!serverUrl) {
+        // 기존 config에서 URL 로드
+        const config = (0, AgentConfig_js_1.loadConfig)();
+        if (!config?.server?.url) {
+            console.error('서버 URL이 필요합니다. 예: ward start https://ward.example.com');
+            process.exit(1);
+        }
+        serverUrl = config.server.url;
+    }
+    await (0, start_js_1.start)(serverUrl, options ?? {});
+});
+// ward stop - 에이전트 중지
+program
+    .command('stop')
+    .description('에이전트를 중지하고 서버에서 등록을 해제합니다')
+    .action(async () => {
+    await (0, stop_js_1.stop)();
+});
+// ward status - 에이전트 상태 확인
+program
+    .command('status')
+    .description('에이전트 실행 상태를 확인합니다')
+    .action(() => {
+    (0, status_js_1.status)();
+});
+// ward config - 설정 관리
+const configCmd = program
+    .command('config')
+    .description('에이전트 설정을 관리합니다');
+configCmd
+    .command('show')
+    .description('현재 설정을 출력합니다')
+    .action(() => {
+    (0, config_js_1.configShow)();
+});
+// ward service - 로그 수집 서비스 관리
+const serviceCmd = program
+    .command('service')
+    .description('로그 수집 서비스 관리');
+serviceCmd
+    .command('add <name>')
+    .description('로그 수집 서비스 등록')
+    .option('--log <path>', '감시할 로그 파일 경로 (여러 번 사용 가능)', (v, prev) => [...(prev ?? []), v], [])
+    .option('--exec <command>', '실행할 명령어 (stdout/stderr 수집)')
+    .option('--cwd <dir>', '명령어 실행 디렉토리 (--exec와 함께 사용)')
+    .option('--journal <unit>', 'systemd 유닛 이름 (예: nginx.service)')
+    .option('--docker <container>', '도커 컨테이너 이름')
+    .action(async (name, options) => {
+    await (0, service_js_1.serviceAdd)(name, options);
+});
+serviceCmd
+    .command('remove <name>')
+    .description('서비스 제거')
+    .action(async (name) => {
+    await (0, service_js_1.serviceRemove)(name);
+});
+serviceCmd
+    .command('list')
+    .description('등록된 서비스 목록')
+    .action(() => {
+    (0, service_js_1.serviceList)();
+});
+// ward pipe <name> - stdin을 로그로 전송
+program
+    .command('pipe <serviceName>')
+    .description('stdin을 지정한 서비스 이름으로 로그 전송\n예: node app.js 2>&1 | ward pipe my-api')
+    .action(async (serviceName) => {
+    await (0, pipe_js_1.pipe)(serviceName);
+});
+program.parse(process.argv);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/logs/LogForwarder.d.ts

@@ -0,0 +1,22 @@
+import { HttpClient } from '../transport/HttpClient.js';
+export interface LogForwarderOptions {
+    client: HttpClient;
+    batchSize?: number;
+    flushIntervalMs?: number;
+}
+export declare class LogForwarder {
+    private readonly client;
+    private readonly batchSize;
+    private readonly flushIntervalMs;
+    private readonly queue;
+    private buffer;
+    private flushTimer;
+    constructor(options: LogForwarderOptions);
+    start(): void;
+    stop(): Promise<void>;
+    addLog(source: string, line: string, level?: string): void;
+    get bufferSize(): number;
+    private _flush;
+    private _retryQueue;
+}
+//# sourceMappingURL=LogForwarder.d.ts.map

package/dist/logs/LogForwarder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogForwarder.d.ts","sourceRoot":"","sources":["../../src/logs/LogForwarder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAIxD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAGD,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,UAAU,CAA+C;gBAErD,OAAO,EAAE,mBAAmB;IAQxC,KAAK,IAAI,IAAI;IASP,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAU3B,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,SAAS,GAAG,IAAI;IAiB1D,IAAI,UAAU,IAAI,MAAM,CAEvB;YAGa,MAAM;YAkBN,WAAW;CAY1B"}

package/dist/logs/LogForwarder.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogForwarder = void 0;
+const Queue_js_1 = require("../transport/Queue.js");
+// 로그 라인을 버퍼에 쌓다가 배치로 서버에 전송
+class LogForwarder {
+    client;
+    batchSize;
+    flushIntervalMs;
+    queue;
+    buffer = [];
+    flushTimer = null;
+    constructor(options) {
+        this.client = options.client;
+        this.batchSize = options.batchSize ?? 100;
+        this.flushIntervalMs = options.flushIntervalMs ?? 5000;
+        this.queue = new Queue_js_1.Queue({ maxSize: 10000, maxRetries: 3 });
+    }
+    // 포워더 시작 (주기적 플러시 타이머 등록)
+    start() {
+        if (this.flushTimer)
+            return;
+        this.flushTimer = setInterval(() => {
+            void this._flush();
+        }, this.flushIntervalMs);
+    }
+    // 포워더 중단
+    async stop() {
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
+            this.flushTimer = null;
+        }
+        // 남은 버퍼 전송 시도
+        await this._flush();
+    }
+    // 로그 라인 추가
+    addLog(source, line, level = 'info') {
+        const entry = {
+            source,
+            level,
+            message: line,
+            loggedAt: new Date().toISOString(),
+        };
+        this.buffer.push(entry);
+        // 배치 크기 도달 시 즉시 전송
+        if (this.buffer.length >= this.batchSize) {
+            void this._flush();
+        }
+    }
+    // 현재 버퍼 크기 (테스트용)
+    get bufferSize() {
+        return this.buffer.length;
+    }
+    // 내부: 버퍼를 서버로 전송
+    async _flush() {
+        if (this.buffer.length === 0)
+            return;
+        const batch = this.buffer.splice(0, this.batchSize);
+        // 먼저 큐에 쌓인 실패 항목 재전송 시도
+        await this._retryQueue();
+        const result = await this.client.post('/api/agent/logs', { logs: batch });
+        if (!result.success) {
+            // 전송 실패 시 큐에 버퍼링
+            this.queue.enqueue('/api/agent/logs', { logs: batch });
+            console.error('[LogForwarder] 로그 전송 실패, 큐에 저장:', result.error);
+        }
+    }
+    // 내부: 큐에 쌓인 항목 재전송
+    async _retryQueue() {
+        if (this.queue.isEmpty)
+            return;
+        const items = this.queue.dequeueAll();
+        for (const item of items) {
+            const result = await this.client.post(item.path, item.data);
+            if (!result.success) {
+                // 재시도 횟수 초과 시 폐기
+                this.queue.requeueItem(item);
+            }
+        }
+    }
+}
+exports.LogForwarder = LogForwarder;
+//# sourceMappingURL=LogForwarder.js.map

package/dist/logs/LogForwarder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogForwarder.js","sourceRoot":"","sources":["../../src/logs/LogForwarder.ts"],"names":[],"mappings":"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"}

package/dist/logs/LogWatcher.d.ts

@@ -0,0 +1,15 @@
+import { EventEmitter } from 'events';
+export interface LogWatcherEvents {
+    line: (source: string, line: string) => void;
+    error: (err: Error) => void;
+}
+export declare class LogWatcher extends EventEmitter {
+    private watchedFiles;
+    watch(filePath: string, source: string): void;
+    unwatch(filePath: string): void;
+    unwatchAll(): void;
+    private _startWatcher;
+    private _handleFileChange;
+    getWatchedSources(): string[];
+}
+//# sourceMappingURL=LogWatcher.d.ts.map

package/dist/logs/LogWatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogWatcher.d.ts","sourceRoot":"","sources":["../../src/logs/LogWatcher.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAGtC,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,KAAK,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;CAC7B;AAWD,qBAAa,UAAW,SAAQ,YAAY;IAC1C,OAAO,CAAC,YAAY,CAAuC;IAG3D,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IA4B7C,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAU/B,UAAU,IAAI,IAAI;IAQlB,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,iBAAiB;IAwCzB,iBAAiB,IAAI,MAAM,EAAE;CAG9B"}

package/dist/logs/LogWatcher.js

@@ -0,0 +1,111 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogWatcher = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const events_1 = require("events");
+// fs.watch + 파일 포인터 방식으로 tail -f 구현
+class LogWatcher extends events_1.EventEmitter {
+    watchedFiles = new Map();
+    // 로그 파일 감시 등록
+    watch(filePath, source) {
+        const absPath = path_1.default.resolve(filePath);
+        if (this.watchedFiles.has(absPath)) {
+            return; // 이미 감시 중
+        }
+        const entry = {
+            filePath: absPath,
+            source,
+            position: 0,
+            watcher: null,
+        };
+        // 파일이 존재하면 끝 위치부터 읽기 시작 (기존 내용 무시)
+        try {
+            const stat = fs_1.default.statSync(absPath);
+            entry.position = stat.size;
+        }
+        catch {
+            // 파일이 없으면 0부터 시작 (파일 생성 대기)
+            entry.position = 0;
+        }
+        this.watchedFiles.set(absPath, entry);
+        this._startWatcher(entry);
+    }
+    // 특정 파일 감시 중단
+    unwatch(filePath) {
+        const absPath = path_1.default.resolve(filePath);
+        const entry = this.watchedFiles.get(absPath);
+        if (entry) {
+            entry.watcher?.close();
+            this.watchedFiles.delete(absPath);
+        }
+    }
+    // 모든 감시 중단
+    unwatchAll() {
+        for (const [, entry] of this.watchedFiles) {
+            entry.watcher?.close();
+        }
+        this.watchedFiles.clear();
+    }
+    // 내부: fs.FSWatcher 시작
+    _startWatcher(entry) {
+        try {
+            const watcher = fs_1.default.watch(entry.filePath, { persistent: false }, (eventType) => {
+                if (eventType === 'change' || eventType === 'rename') {
+                    this._handleFileChange(entry);
+                }
+            });
+            watcher.on('error', (err) => {
+                this.emit('error', err);
+            });
+            entry.watcher = watcher;
+        }
+        catch {
+            // 파일이 없으면 감시를 시작할 수 없음 — 정상 상황
+            entry.watcher = null;
+        }
+    }
+    // 내부: 파일 변경 처리
+    _handleFileChange(entry) {
+        try {
+            const stat = fs_1.default.statSync(entry.filePath);
+            // 파일 로테이션 감지: 파일 크기가 현재 포인터보다 작아지면 처음부터 다시 읽기
+            if (stat.size < entry.position) {
+                entry.position = 0;
+            }
+            if (stat.size <= entry.position) {
+                return; // 새 내용 없음
+            }
+            // 새로 추가된 부분만 읽기
+            const fd = fs_1.default.openSync(entry.filePath, 'r');
+            const length = stat.size - entry.position;
+            const buffer = Buffer.alloc(length);
+            fs_1.default.readSync(fd, buffer, 0, length, entry.position);
+            fs_1.default.closeSync(fd);
+            entry.position = stat.size;
+            // 라인 단위로 분리하여 이벤트 발생
+            const text = buffer.toString('utf8');
+            const lines = text.split('\n');
+            for (const line of lines) {
+                const trimmed = line.trimEnd();
+                if (trimmed.length > 0) {
+                    this.emit('line', entry.source, trimmed);
+                }
+            }
+        }
+        catch (err) {
+            if (err instanceof Error) {
+                this.emit('error', err);
+            }
+        }
+    }
+    // 감시 중인 파일 목록 반환 (테스트용)
+    getWatchedSources() {
+        return Array.from(this.watchedFiles.values()).map((e) => e.source);
+    }
+}
+exports.LogWatcher = LogWatcher;
+//# sourceMappingURL=LogWatcher.js.map

package/dist/logs/LogWatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogWatcher.js","sourceRoot":"","sources":["../../src/logs/LogWatcher.ts"],"names":[],"mappings":"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"}

package/dist/logs/ServiceWatcher.d.ts

@@ -0,0 +1,32 @@
+import { EventEmitter } from 'events';
+import type { ServiceConfig } from '../config/ServiceConfig.js';
+/**
+ * file / exec / journal / docker / pipe 방식으로
+ * 서비스 로그를 수집해 'line' 이벤트를 발생시킨다.
+ */
+export declare class ServiceWatcher extends EventEmitter {
+    private entries;
+    private lineBuffers;
+    watch(config: ServiceConfig): void;
+    unwatch(name: string): void;
+    unwatchAll(): void;
+    unwatchAllAndWait(timeoutMs?: number): Promise<void>;
+    getWatchedNames(): string[];
+    private _watchFile;
+    private _startFileWatcher;
+    private _handleFileChange;
+    private _watchExec;
+    private _spawnExec;
+    private _watchJournal;
+    private _watchDocker;
+    private _watchPipe;
+    restart(name: string): void;
+    getServiceStatus(name: string): {
+        status: 'running' | 'stopped' | 'unknown';
+        pid?: number;
+        restartCount: number;
+        startedAt?: Date;
+    };
+    private _emitLines;
+}
+//# sourceMappingURL=ServiceWatcher.d.ts.map

package/dist/logs/ServiceWatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceWatcher.d.ts","sourceRoot":"","sources":["../../src/logs/ServiceWatcher.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAGtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AA0BhE;;;GAGG;AACH,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,OAAO,CAAsC;IACrD,OAAO,CAAC,WAAW,CAAkB;IAGrC,KAAK,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAuBlC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAiC3B,UAAU,IAAI,IAAI;IAOZ,iBAAiB,CAAC,SAAS,SAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BxD,eAAe,IAAI,MAAM,EAAE;IAM3B,OAAO,CAAC,UAAU;IAqBlB,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,iBAAiB;IAuBzB,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,UAAU;IAiDlB,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,UAAU;IAclB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAe3B,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,IAAI,CAAA;KAAE;IAkBnI,OAAO,CAAC,UAAU;CAenB"}