命令简介
logs 命令用于查看和管理平台运行过程中的日志信息,包括:

- 模型训练日志
- 推理服务日志
- 系统运行日志
- 任务执行日志
基本命令格式
openclaw logs [选项] <资源类型>/<资源名称>
常用子命令
查看训练任务日志
# 实时跟踪日志(类似 tail -f) openclaw logs -f training/<task-name> # 查看最近N行日志 openclaw logs --tail=100 training/<task-name> # 查看指定时间后的日志 openclaw logs --since=1h training/<task-name>
查看推理服务日志
# 查看服务所有实例日志 openclaw logs service/<service-name> # 查看特定实例日志 openclaw logs pod/<pod-name> -n <namespace>
查看系统组件日志
# 查看调度器日志 openclaw logs system/scheduler # 查看监控组件日志 openclaw logs system/monitor # 查看存储服务日志 openclaw logs system/storage
常用选项参数
| 选项 | 简写 | 说明 | 示例 |
|---|---|---|---|
--follow |
-f |
实时跟踪日志输出 | -f |
--tail |
显示最后N行日志 | --tail=50 |
|
--since |
显示指定时间后的日志 | --since=2h |
|
--timestamps |
-t |
显示时间戳 | -t |
--previous |
-p |
查看容器前一次运行的日志 | -p |
--limit-bytes |
限制输出的字节数 | --limit-bytes=1024 |
|
--namespace |
-n |
指定命名空间 | -n default |
--container |
-c |
指定容器名称 | -c main |
实用示例
示例1:监控训练进度
# 实时查看训练日志,显示时间戳 openclaw logs -f -t training/bert-finetune-001 # 查看最近100行并持续跟踪 openclaw logs --tail=100 -f training/resnet50-train
示例2:调试推理服务
# 查看服务启动错误 openclaw logs service/image-classifier --since=10m # 查看特定容器的日志 openclaw logs pod/llm-api-5f8d6 -c model-container
示例3:批量日志操作
# 查看多个任务的日志(需要脚本支持) for task in task1 task2 task3; do echo "=== Logs for $task ===" openclaw logs training/$task --tail=20 done
示例4:日志导出
# 将日志保存到文件 openclaw logs training/experiment-001 --since=24h > training.log # 导出指定时间范围的日志 openclaw logs service/api-gateway --since="2024-01-01T00:00:00Z" \ --until="2024-01-02T00:00:00Z" > api-logs.json
高级功能
日志过滤
# 使用grep过滤关键字(在本地执行) openclaw logs training/my-model | grep "ERROR\|WARNING" # 查看特定级别的日志 openclaw logs service/my-service | jq 'select(.level=="ERROR")'
多集群日志查看
# 指定集群查看日志 openclaw logs --cluster=prod training/prod-model # 查看所有集群的日志 openclaw logs --all-clusters system/health-check
结构化日志查看
# JSON格式美化输出 openclaw logs service/json-api --output=json | jq . # 特定字段提取 openclaw logs training/data-pipeline --output=json | \ jq -r '.timestamp, .message'
故障排查提示
- 日志不存在时:检查资源名称是否正确,任务是否已开始运行
- 权限不足:确认当前用户有查看该命名空间日志的权限
- 日志量太大:使用
--tail或--since限制输出范围 - 实时日志断开:网络问题或服务重启,可重新连接
相关命令
openclaw status- 查看资源状态openclaw describe- 查看资源详细信息openclaw events- 查看事件日志
注意
- 默认日志保留策略为30天
- 生产环境建议启用日志聚合服务(如ELK/Loki)
- 敏感信息不会记录在日志中,请勿硬编码密钥
版权声明:除非特别标注,否则均为本站原创文章,转载时请以链接形式注明文章出处。