日志查看与管理工具

Orchestra Plugin: devtools-log-viewer 是一个用于 Orchestra MCP 框架的日志文件查看、搜索和后台进程管理工具。

  • by orchestra-mcp
  • Go
  • 本地部署
  • 更新于
在 GitHub 查看 orchestra-mcp/plugin-devtools-log-viewer

使用说明

Orchestra插件:devtools日志查看器

日志文件查看器、搜索和后台流程管理工具 乐团MCP 框架。

安装

orchestra plugin install github.com/orchestra-mcp/plugin-devtools-log-viewer

工具

日志文件工具

工具 说明
log_tail 读取日志文件的最后N行
log_watch 返回日志文件最后N行的快照
log_search 在日志文件中搜索与正则表达式匹配的行,并使用上下文行
log_parse 使用JSON、syslog或自动检测解析日志文件
log_list_sources 列表 .log 目录或公共日志位置中的文件

流程管理工具

工具 说明
log_run 在后台运行shell命令并捕获其输出
log_run_status 检查后台进程的状态(正在运行/已完成/失败)
log_run_output 获取捕获的输出,可选择按正则表达式过滤
log_run_kill 杀死一个正在运行的进程(SIGTERM,然后在3秒后SIGKILL)
log_run_restart 使用相同的命令杀死并重新运行进程
log_run_list 列出所有跟踪的后台进程

使用示例

查看日志文件

log_tail       path="/var/log/system.log" lines=50
log_search     path="/var/log/system.log" pattern="ERROR" context_lines=3
log_parse      path="/tmp/app.log" format="json"
log_list_sources directory="/var/log"

运行和管理后台进程

# Start a dev server
log_run        command="make dev" working_directory="/path/to/project"
# Returns: proc-a1b2c3d4

# Check status and recent output
log_run_status id="proc-a1b2c3d4" tail=20

# Search output for errors
log_run_output id="proc-a1b2c3d4" pattern="ERROR|WARN"

# Restart after code changes
log_run_restart id="proc-a1b2c3d4"

# Stop the server
log_run_kill   id="proc-a1b2c3d4"

# See all running processes
log_run_list

建筑

  • 日志文件工具 是无状态的——每个调用都直接从文件系统读取
  • 流程管理工具 是有状态的——插件维护一个内存映射 ManagedProcess 结构体,每个都有一个线程安全的环形缓冲区(1000行),用于捕获stdout+stderr的组合
  • 命令通过运行 sh -c 随着 Setpgid: true 因此,杀死信号会到达整个进程组
  • 插件关闭时,所有托管进程都会被终止

相关包