@nest-omni/core 4.1.3-2 → 4.1.3-22

package/http-client/services/logging.service.js

@@ -21,21 +21,60 @@ var HttpLoggingService_1;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HttpLoggingService = void 0;
 const common_1 = require("@nestjs/common");
-const typeorm_1 = require("typeorm");
 const http_log_entity_1 = require("../entities/http-log.entity");
 const request_id_util_1 = require("../utils/request-id.util");
 const context_extractor_util_1 = require("../utils/context-extractor.util");
 const call_stack_extractor_util_1 = require("../utils/call-stack-extractor.util");
+const transaction_1 = require("@nest-omni/transaction");
+/**
+ * HTTP日志服务
+ * 基于Spring Boot的请求日志记录机制，集成现有的ContextProvider
+ * 支持异步批量日志写入以提升性能
+ */
 let HttpLoggingService = HttpLoggingService_1 = class HttpLoggingService {
-    constructor(dataSource) {
-        this.dataSource = dataSource;
+    constructor() {
         this.logger = new common_1.Logger(HttpLoggingService_1.name);
         this.logRepository = null;
-        if (dataSource) {
-            this.initializeDatabaseLogging();
+        /** 日志队列 */
+        this.logQueue = [];
+        /** 默认异步日志配置 */
+        this.asyncConfig = {
+            batchSize: 50, // 批量写入50条日志
+            flushIntervalMs: 5000, // 每5秒刷新一次
+            maxRetries: 3, // 失败后最多重试3次
+            enabled: true, // 默认启用异步日志
+        };
+        /** 处理中标志 */
+        this.isProcessing = false;
+        // 启动定期刷新任务
+        if (this.asyncConfig.enabled) {
+            this.startFlushTask();
+        }
+    }
+    onModuleDestroy() {
+        // 清理定时器
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
         }
+        // 刷新剩余日志
+        this.flush();
     }
+    initRepository(dataSource, tableName) {
+        try {
+            this.logRepository = (0, transaction_1.getDataSource)(dataSource).getRepository(http_log_entity_1.HttpLogEntity);
+            this.logger.log('Database logging initialized');
+            return this.logRepository;
+        }
+        catch (error) {
+            this.logger.error('Failed to initialize database logging', error);
+            throw error;
+        }
+    }
+    /**
+     * 记录请求开始
+     */
     logRequestStart(config, loggingOptions, requestId) {
+        // 从ContextProvider获取上下文信息
         const context = context_extractor_util_1.ContextExtractor.getHttpContext();
         const actualRequestId = requestId || context.requestId || (0, request_id_util_1.generateRequestId)();
         const { logHeaders = true, logBody = true, sanitizeHeaders = [], } = loggingOptions || {};
@@ -63,73 +102,96 @@ let HttpLoggingService = HttpLoggingService_1 = class HttpLoggingService {
         }
         return actualRequestId;
     }
-    logRequestSuccess(response, startTime, requestId, loggingOptions, databaseLogging = false, retryRecords, cacheHit, circuitBreakerState, decoratorContext) {
-        var _a, _b;
-        const { logHeaders = true, logBody = true, sanitizeHeaders = [], } = loggingOptions || {};
-        const responseTime = Date.now() - startTime;
-        const context = context_extractor_util_1.ContextExtractor.getHttpContext();
-        const logData = {
-            requestId,
-            userId: context.userId,
-            statusCode: response.status,
-            responseTime,
-            headers: logHeaders
-                ? this.sanitizeHeaders(response.headers, sanitizeHeaders)
-                : undefined,
-            body: logBody ? this.sanitizeBody(response.data) : undefined,
-            responseSize: JSON.stringify(response.data).length,
-            cacheHit,
-            circuitBreakerState,
-        };
-        const logMessage = `HTTP Response [${requestId}]: ${response.status} (${responseTime}ms)${cacheHit ? ' [CACHE HIT]' : ''}`;
-        switch ((loggingOptions || {}).logLevel) {
-            case 'debug':
-                this.logger.debug(logMessage, logData);
-                break;
-            case 'info':
-            default:
-                this.logger.log(logMessage, logData);
-                break;
-        }
-        if (databaseLogging && this.logRepository) {
-            const callInfo = this.extractCallInfo(decoratorContext, response.config);
-            this.saveToDatabase({
-                id: requestId,
+    /**
+     * 记录请求成功响应
+     */
+    logRequestSuccess(response_1, startTime_1, requestId_1, loggingOptions_1) {
+        return __awaiter(this, arguments, void 0, function* (response, startTime, requestId, loggingOptions, databaseLogging = false, retryRecords, circuitBreakerState, decoratorContext, clientName, callingContext) {
+            var _a, _b, _c, _d;
+            const { logHeaders = true, logBody = true, sanitizeHeaders = [], } = loggingOptions || {};
+            const responseTime = Date.now() - startTime;
+            // 获取当前上下文信息
+            const context = context_extractor_util_1.ContextExtractor.getHttpContext();
+            const logData = {
                 requestId,
                 userId: context.userId,
-                method: ((_a = response.config.method) === null || _a === void 0 ? void 0 : _a.toUpperCase()) || 'UNKNOWN',
-                url: response.config.url || '',
-                headers: this.sanitizeHeaders(response.config.headers, sanitizeHeaders),
-                body: this.sanitizeBodyAsString(response.config.data),
-                params: response.config.params,
                 statusCode: response.status,
                 responseTime,
-                attemptCount: (retryRecords === null || retryRecords === void 0 ? void 0 : retryRecords.length)
-                    ? Math.max(...retryRecords.map((r) => r.attempt))
-                    : 1,
-                success: true,
-                responseHeaders: this.sanitizeHeaders(response.headers, sanitizeHeaders),
-                responseBody: logBody
-                    ? this.sanitizeBodyAsString(response.data)
+                headers: logHeaders
+                    ? this.sanitizeHeaders(response.headers, sanitizeHeaders)
                     : undefined,
+                body: logBody ? this.sanitizeBody(response.data) : undefined,
                 responseSize: JSON.stringify(response.data).length,
-                requestSize: JSON.stringify(response.config.data).length,
-                serviceName: context.appId,
-                operationName: callInfo.operationName,
-                clientIp: context.clientIp,
-                source: (_b = context.metadata) === null || _b === void 0 ? void 0 : _b.source,
-                tags: context.tags,
-                metadata: logData,
-                retryRecords,
-                cacheHit,
                 circuitBreakerState,
-            });
-        }
+            };
+            const logMessage = `HTTP Response [${requestId}]: ${response.status} (${responseTime}ms)`;
+            switch ((loggingOptions || {}).logLevel) {
+                case 'debug':
+                    this.logger.debug(logMessage, logData);
+                    break;
+                case 'info':
+                default:
+                    this.logger.log(logMessage, logData);
+                    break;
+            }
+            if (!this.logRepository) {
+                this.logger.debug('Initializing log repository', {
+                    dataSource: (_a = loggingOptions.databaseLogging) === null || _a === void 0 ? void 0 : _a.dataSource,
+                    tableName: (_b = loggingOptions.databaseLogging) === null || _b === void 0 ? void 0 : _b.tableName,
+                });
+                this.initRepository(loggingOptions.databaseLogging.dataSource, loggingOptions.databaseLogging.tableName);
+            }
+            // 数据库日志记录
+            if (databaseLogging && this.logRepository) {
+                this.logger.log('Database logging conditions met, saving to database');
+            }
+            else {
+                this.logger.warn(`Database logging conditions NOT met: databaseLogging=${databaseLogging}, hasRepository=${!!this.logRepository}, type=${typeof this.logRepository}`);
+            }
+            if (databaseLogging && this.logRepository) {
+                // 提取调用信息
+                const callInfo = callingContext && callingContext.operationName
+                    ? callingContext
+                    : this.extractCallInfo(decoratorContext, response.config);
+                this.saveToDatabase({
+                    id: requestId,
+                    requestId,
+                    userId: context.userId,
+                    method: ((_c = response.config.method) === null || _c === void 0 ? void 0 : _c.toUpperCase()) || 'UNKNOWN',
+                    url: this.getFullUrl(response.config) || '',
+                    headers: this.sanitizeHeaders(response.config.headers, sanitizeHeaders),
+                    body: this.sanitizeBodyAsString(response.config.data),
+                    params: response.config.params,
+                    statusCode: response.status,
+                    responseTime,
+                    attemptCount: (retryRecords === null || retryRecords === void 0 ? void 0 : retryRecords.length)
+                        ? Math.max(...retryRecords.map((r) => r.attempt)) + 1
+                        : 1,
+                    success: true,
+                    responseHeaders: this.sanitizeHeaders(response.headers, sanitizeHeaders),
+                    responseBody: logBody
+                        ? this.sanitizeBodyAsString(response.data)
+                        : undefined,
+                    serviceName: clientName || context.appId,
+                    operationName: callInfo.operationName,
+                    clientIp: context.clientIp,
+                    source: (_d = context.metadata) === null || _d === void 0 ? void 0 : _d.source,
+                    tags: context.tags,
+                    metadata: logData,
+                    retryRecords,
+                    circuitBreakerState,
+                });
+            }
+        });
     }
-    logRequestError(error, startTime, requestId, attemptCount, loggingOptions, databaseLogging = false, retryRecords, cacheHit, circuitBreakerState, decoratorContext) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
+    /**
+     * 记录请求错误
+     */
+    logRequestError(error, startTime, requestId, attemptCount, loggingOptions, databaseLogging = false, retryRecords, circuitBreakerState, decoratorContext, clientName, callingContext) {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j;
         const { logHeaders = true, sanitizeHeaders = [] } = loggingOptions;
         const responseTime = Date.now() - startTime;
+        // 获取当前上下文信息
         const context = context_extractor_util_1.ContextExtractor.getHttpContext();
         const logData = {
             requestId,
@@ -160,39 +222,47 @@ let HttpLoggingService = HttpLoggingService_1 = class HttpLoggingService {
                 this.logger.error(logMessage, logData);
                 break;
         }
+        if (!this.logRepository) {
+            this.initRepository(loggingOptions.databaseLogging.dataSource, loggingOptions.databaseLogging.tableName);
+        }
+        // 数据库日志记录
         if (databaseLogging && this.logRepository) {
-            const callInfo = this.extractCallInfo(decoratorContext, error.config);
+            // 提取调用信息
+            const callInfo = callingContext && callingContext.operationName
+                ? callingContext
+                : this.extractCallInfo(decoratorContext, error.config);
             this.saveToDatabase({
                 id: requestId,
                 requestId,
                 userId: context.userId,
                 method: ((_d = (_c = error.config) === null || _c === void 0 ? void 0 : _c.method) === null || _d === void 0 ? void 0 : _d.toUpperCase()) || 'UNKNOWN',
-                url: ((_e = error.config) === null || _e === void 0 ? void 0 : _e.url) || '',
-                headers: ((_f = error.config) === null || _f === void 0 ? void 0 : _f.headers)
+                url: this.getFullUrl(error.config) || '',
+                headers: ((_e = error.config) === null || _e === void 0 ? void 0 : _e.headers)
                     ? this.sanitizeHeaders(error.config.headers, sanitizeHeaders)
                     : {},
-                body: this.sanitizeBodyAsString((_g = error.config) === null || _g === void 0 ? void 0 : _g.data),
-                params: (_h = error.config) === null || _h === void 0 ? void 0 : _h.params,
-                statusCode: (_j = error.response) === null || _j === void 0 ? void 0 : _j.status,
+                body: this.sanitizeBodyAsString((_f = error.config) === null || _f === void 0 ? void 0 : _f.data),
+                params: (_g = error.config) === null || _g === void 0 ? void 0 : _g.params,
+                statusCode: (_h = error.response) === null || _h === void 0 ? void 0 : _h.status,
                 responseTime,
                 attemptCount,
                 success: false,
                 errorMessage: error.message,
                 errorStack: error.stack,
                 errorCode: error.code,
-                requestSize: JSON.stringify(((_k = error.config) === null || _k === void 0 ? void 0 : _k.data) || {}).length,
-                serviceName: context.appId,
+                serviceName: clientName || context.appId,
                 operationName: callInfo.operationName,
                 clientIp: context.clientIp,
-                source: (_l = context.metadata) === null || _l === void 0 ? void 0 : _l.source,
+                source: (_j = context.metadata) === null || _j === void 0 ? void 0 : _j.source,
                 tags: context.tags,
                 metadata: logData,
                 retryRecords,
-                cacheHit,
                 circuitBreakerState,
             });
         }
     }
+    /**
+     * 查询请求日志
+     */
     findLogs(options) {
         return __awaiter(this, void 0, void 0, function* () {
             if (!this.logRepository) {
@@ -243,6 +313,9 @@ let HttpLoggingService = HttpLoggingService_1 = class HttpLoggingService {
             return queryBuilder.getMany();
         });
     }
+    /**
+     * 获取请求统计信息
+     */
     getStatistics(options) {
         return __awaiter(this, void 0, void 0, function* () {
             if (!this.logRepository) {
@@ -272,12 +345,14 @@ let HttpLoggingService = HttpLoggingService_1 = class HttpLoggingService {
                 .clone()
                 .select('AVG(log.responseTime)', 'avg')
                 .getRawOne();
+            // 按状态码统计
             const statusStats = yield queryBuilder
                 .clone()
                 .select('log.statusCode', 'statusCode')
                 .addSelect('COUNT(*)', 'count')
                 .groupBy('log.statusCode')
                 .getRawMany();
+            // 按方法统计
             const methodStats = yield queryBuilder
                 .clone()
                 .select('log.method', 'method')
@@ -301,18 +376,11 @@ let HttpLoggingService = HttpLoggingService_1 = class HttpLoggingService {
             };
         });
     }
-    initializeDatabaseLogging() {
-        return __awaiter(this, void 0, void 0, function* () {
-            try {
-                this.logRepository = this.dataSource.getRepository(http_log_entity_1.HttpLogEntity);
-                this.logger.log('Database logging initialized');
-            }
-            catch (error) {
-                this.logger.error('Failed to initialize database logging', error);
-            }
-        });
-    }
+    /**
+     * 提取调用信息
+     */
     extractCallInfo(decoratorContext, config) {
+        // 优先使用装饰器配置的调用信息
         if (decoratorContext) {
             const decoratorInfo = call_stack_extractor_util_1.CallStackExtractor.extractFromDecorator(decoratorContext.target, decoratorContext.propertyKey);
             if (decoratorInfo.serviceClass && decoratorInfo.methodName) {
@@ -321,18 +389,21 @@ let HttpLoggingService = HttpLoggingService_1 = class HttpLoggingService {
                 };
             }
         }
+        // 然后尝试手动设置的调用信息
         const manualInfo = call_stack_extractor_util_1.CallStackExtractor.getManualCallInfo();
         if (manualInfo) {
             return {
                 operationName: manualInfo.operationName,
             };
         }
+        // 最后尝试从调用栈自动提取
         const stackInfo = call_stack_extractor_util_1.CallStackExtractor.getCallInfo();
         if (stackInfo.serviceClass && stackInfo.methodName) {
             return {
                 operationName: stackInfo.operationName,
             };
         }
+        // 如果都无法获取，根据URL生成操作名称
         if (config === null || config === void 0 ? void 0 : config.url) {
             const pathParts = config.url
                 .split('/')
@@ -346,18 +417,174 @@ let HttpLoggingService = HttpLoggingService_1 = class HttpLoggingService {
         }
         return {};
     }
+    /**
+     * 保存到数据库
+     * 如果启用异步日志，将日志项添加到队列中
+     * 否则同步保存到数据库
+     */
     saveToDatabase(logEntity) {
         return __awaiter(this, void 0, void 0, function* () {
-            if (!this.logRepository)
+            if (!this.logRepository) {
+                this.logger.warn('Log repository not initialized, skipping database logging');
+                return;
+            }
+            if (this.asyncConfig.enabled) {
+                // 异步模式：添加到队列
+                this.logQueue.push({
+                    logEntity,
+                    attempt: 0,
+                });
+                // 如果队列达到批量大小，立即刷新
+                if (this.logQueue.length >= this.asyncConfig.batchSize) {
+                    setImmediate(() => this.flush());
+                }
+            }
+            else {
+                // 同步模式：直接保存
+                yield this.saveLogToDatabase(logEntity);
+            }
+        });
+    }
+    /**
+     * 启动定期刷新任务
+     */
+    startFlushTask() {
+        this.flushTimer = setInterval(() => {
+            this.flush();
+        }, this.asyncConfig.flushIntervalMs);
+        this.logger.log(`Async log flushing started (interval: ${this.asyncConfig.flushIntervalMs}ms, batchSize: ${this.asyncConfig.batchSize})`);
+    }
+    /**
+     * 刷新日志队列到数据库
+     */
+    flush() {
+        if (this.isProcessing || this.logQueue.length === 0) {
+            return;
+        }
+        this.isProcessing = true;
+        // 取出当前批次
+        const batch = this.logQueue.splice(0, this.asyncConfig.batchSize);
+        // 异步处理
+        setImmediate(() => __awaiter(this, void 0, void 0, function* () {
+            try {
+                // 批量保存
+                yield Promise.all(batch.map((item) => this.processLogItem(item)));
+                this.logger.debug(`Flushed ${batch.length} log entries to database`);
+                // 如果还有剩余日志，继续处理
+                if (this.logQueue.length > 0) {
+                    setImmediate(() => this.flush());
+                }
+            }
+            catch (error) {
+                this.logger.error('Error flushing log queue', error);
+                // 将失败的日志重新放回队列（如果还有重试机会）
+                batch.forEach((item) => {
+                    if (item.attempt < this.asyncConfig.maxRetries) {
+                        item.attempt++;
+                        this.logQueue.unshift(item); // 放回队列头部
+                    }
+                    else {
+                        this.logger.error(`Log entry exceeded max retries, discarding: ${item.logEntity.requestId}`);
+                    }
+                });
+            }
+            finally {
+                this.isProcessing = false;
+            }
+        }));
+    }
+    /**
+     * 处理单个日志项
+     */
+    processLogItem(item) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.logRepository) {
                 return;
+            }
             try {
-                yield this.logRepository.save(logEntity);
+                yield this.logRepository.save(item.logEntity, { reload: false });
+            }
+            catch (error) {
+                this.logger.error(`Failed to save log entry: ${item.logEntity.requestId}`, error);
+                throw error; // 重新抛出错误以便重试
+            }
+        });
+    }
+    /**
+     * 同步保存日志到数据库（用于异步模式内部）
+     */
+    saveLogToDatabase(logEntity) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            if (!this.logRepository) {
+                this.logger.warn('Log repository not initialized, skipping database logging');
+                return;
+            }
+            try {
+                this.logger.log('Saving HTTP log to database', {
+                    requestId: logEntity.requestId,
+                    circuitBreakerState: logEntity.circuitBreakerState,
+                    retryRecordsCount: ((_a = logEntity.retryRecords) === null || _a === void 0 ? void 0 : _a.length) || 0,
+                });
+                yield this.logRepository.save(logEntity, { reload: false });
+                this.logger.log('Successfully saved HTTP log to database', {
+                    requestId: logEntity.requestId,
+                    circuitBreakerState: logEntity.circuitBreakerState,
+                });
             }
             catch (error) {
                 this.logger.error('Failed to save HTTP log to database', error);
+                this.logger.error('Log entity details', logEntity);
             }
         });
     }
+    /**
+     * 获取日志队列统计信息
+     */
+    getQueueStats() {
+        return {
+            queueSize: this.logQueue.length,
+            isProcessing: this.isProcessing,
+            config: Object.assign({}, this.asyncConfig),
+        };
+    }
+    /**
+     * 手动刷新日志队列
+     */
+    manualFlush() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return new Promise((resolve) => {
+                const checkProcessing = () => {
+                    if (!this.isProcessing) {
+                        this.flush();
+                        // 等待刷新完成
+                        setTimeout(() => resolve(), 100);
+                    }
+                    else {
+                        setTimeout(checkProcessing, 50);
+                    }
+                };
+                checkProcessing();
+            });
+        });
+    }
+    /**
+     * 设置异步日志配置
+     */
+    setAsyncConfig(config) {
+        Object.assign(this.asyncConfig, config);
+        // 重启刷新任务
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
+        }
+        if (this.asyncConfig.enabled) {
+            this.startFlushTask();
+        }
+        this.logger.log(`Async log config updated: ${JSON.stringify(this.asyncConfig)}`);
+    }
+    /**
+     * 转换请求体为字符串
+     */
     sanitizeBodyAsString(data) {
         if (!data)
             return undefined;
@@ -369,6 +596,9 @@ let HttpLoggingService = HttpLoggingService_1 = class HttpLoggingService {
             ? jsonString.substring(0, 5000) + '...'
             : jsonString;
     }
+    /**
+     * 清理敏感头信息
+     */
     sanitizeHeaders(headers, sanitizeHeaders) {
         if (!headers)
             return {};
@@ -395,6 +625,9 @@ let HttpLoggingService = HttpLoggingService_1 = class HttpLoggingService {
         });
         return sanitized;
     }
+    /**
+     * 清理敏感请求体信息
+     */
     sanitizeBody(body) {
         if (!body)
             return undefined;
@@ -425,6 +658,9 @@ let HttpLoggingService = HttpLoggingService_1 = class HttpLoggingService {
         }
         return body;
     }
+    /**
+     * 递归清理对象中的敏感字段
+     */
     sanitizeObject(obj, sensitiveFields) {
         if (typeof obj !== 'object' || obj === null)
             return;
@@ -437,9 +673,36 @@ let HttpLoggingService = HttpLoggingService_1 = class HttpLoggingService {
             }
         }
     }
+    /**
+     * 获取完整URL
+     * @param config Axios请求配置
+     * @returns 完整的URL字符串
+     */
+    getFullUrl(config) {
+        if (!config)
+            return '';
+        // 如果已经有完整的URL，直接返回
+        if (config.url && config.url.startsWith('http')) {
+            return config.url;
+        }
+        // 获取baseURL
+        const baseURL = config.baseURL || '';
+        // 获取URL路径
+        const urlPath = config.url || '';
+        // 如果baseURL为空，直接返回URL路径
+        if (!baseURL) {
+            return urlPath;
+        }
+        // 确保baseURL以/结尾，urlPath不以/开头（除非它是绝对路径）
+        const normalizedBaseURL = baseURL.endsWith('/') ? baseURL : baseURL + '/';
+        const normalizedUrlPath = urlPath.startsWith('/')
+            ? urlPath.substring(1)
+            : urlPath;
+        return normalizedBaseURL + normalizedUrlPath;
+    }
 };
 exports.HttpLoggingService = HttpLoggingService;
 exports.HttpLoggingService = HttpLoggingService = HttpLoggingService_1 = __decorate([
     (0, common_1.Injectable)(),
-    __metadata("design:paramtypes", [typeorm_1.DataSource])
+    __metadata("design:paramtypes", [])
 ], HttpLoggingService);

package/http-client/utils/call-stack-extractor.util.d.ts

@@ -1,29 +1,92 @@
+/**
+ * 调用栈提取工具
+ * 用于自动提取HTTP请求的调用服务和方法信息
+ */
 export declare class CallStackExtractor {
+    /**
+     * 存储装饰器上下文（用于传递装饰器信息到HTTP客户端）
+     */
+    private static decoratorContext;
+    /**
+     * 装饰器上下文引用计数，用于处理多个装饰器嵌套的情况
+     */
+    private static decoratorContextDepth;
+    /**
+     * 设置装饰器上下文
+     */
+    static setDecoratorContext(context: {
+        target: any;
+        propertyKey: string;
+    }): void;
+    /**
+     * 获取装饰器上下文
+     */
+    static getDecoratorContext(): {
+        target: any;
+        propertyKey: string;
+    } | null;
+    /**
+     * 清除装饰器上下文
+     */
+    static clearDecoratorContext(): void;
+    /**
+     * 从调用栈中提取服务和方法信息
+     */
     static extractCallInfo(): {
         serviceClass?: string;
         methodName?: string;
         operationName?: string;
     };
+    /**
+     * 手动设置调用信息（当自动检测失败时）
+     */
     static setCallInfo(serviceClass: string, methodName: string, operationName?: string): void;
+    /**
+     * 获取手动设置的调用信息
+     */
     static getManualCallInfo(): {
         serviceClass?: string;
         methodName?: string;
         operationName?: string;
     } | null;
+    /**
+     * 清理手动设置的调用信息
+     */
     static clearCallInfo(): void;
+    /**
+     * 获取调用信息（优先使用手动设置的信息）
+     */
     static getCallInfo(): {
         serviceClass?: string;
         methodName?: string;
         operationName?: string;
     };
+    /**
+     * 从装饰器中提取调用信息
+     */
     static extractFromDecorator(target: any, propertyKey: string): {
         serviceClass?: string;
         methodName?: string;
         operationName?: string;
     };
+    /**
+     * 生成操作名称
+     */
     static generateOperationName(serviceClass?: string, methodName?: string, config?: any): string;
+    /**
+     * 格式化服务类名
+     */
     static formatServiceClass(serviceClass?: string): string;
+    /**
+     * 格式化方法名
+     */
     static formatMethodName(methodName?: string): string;
+    /**
+     * 解析调用栈行
+     */
     private static parseStackLine;
+    /**
+     * 判断是否为内部调用
+     */
     private static isInternalCall;
 }