在RD-Agent项目中自定义日志文件夹路径的技术指南

日志路径配置机制解析

在RD-Agent项目中，日志管理模块采用了灵活的设计架构，允许开发者根据实际需求自定义日志存储路径。系统默认会在项目根目录下创建"log"文件夹，并以精确到微秒的时间戳作为子文件夹名称，确保每次运行的日志都能独立存储。

核心实现原理

项目的日志功能主要通过logger.py文件中的RDAgentLog类实现。该类在初始化时会检查log_trace_path参数，如果未提供该参数，则自动生成基于当前时间的默认路径。这种设计既保证了开箱即用的便利性，又为自定义配置留出了扩展空间。

自定义日志路径的三种方法

方法一：通过环境变量文件配置

1. 在项目根目录下编辑或创建.env文件
2. 添加如下配置项：

LOG_TRACE_PATH=./your_custom_path/log_folder_name

3. 保存文件后运行程序，系统将自动读取该配置

方法二：通过命令行临时指定

在运行命令前直接设置环境变量：

LOG_TRACE_PATH=./custom_logs/test_run_001 rdagent your_command

这种方法适合需要临时变更日志存储位置的场景。

方法三：修改代码直接指定

对于需要长期固定日志路径的场景，可以直接修改logger.py文件中的初始化代码：

self.log_trace_path = Path.cwd() / "your_custom_folder" / "fixed_name"

最佳实践建议

1. 对于开发环境，推荐使用方法一，保持配置的持久性
2. 对于测试环境，使用方法二更为灵活，便于区分不同测试批次
3. 生产环境中，建议结合日志轮转策略，设计合理的路径命名规则
4. 路径命名应具有可读性和可追溯性，建议包含测试目的、日期等关键信息

注意事项

1. 确保指定的路径具有写入权限
2. 路径中避免使用特殊字符和空格
3. 相对路径是相对于项目根目录解析的
4. 自定义路径不会影响日志文件的内容格式和记录方式

通过合理配置日志路径，可以更好地组织和管理RD-Agent项目产生的日志数据，为后续的问题排查和性能分析提供便利。