日志分析助手

技能简介

Log Analyzer 用于解析、搜索和分析各类应用日志，支持纯文本日志、结构化 JSON 日志、堆栈跟踪、多服务关联分析及实时监控场景。

能做什么

• 从日志文件调试应用错误
• 按模式、错误或请求 ID 搜索日志
• 解析并分析堆栈跟踪
• 搭建应用的 JSON 结构化日志
• 跨多服务或日志文件关联事件
• 开发阶段实时监控日志输出
• 生成错误频率报告或摘要

使用说明

安装要求

需预先安装以下工具之一或全部：grep、awk、jq、python3。各系统安装方式：

# Ubuntu/Debian
sudo apt-get install grep gawk jq python3

# macOS
brew install grep gnu-sed jq python3

# Windows (Git Bash/WSL)
# 随 Git for Windows 或 WSL 自带

基础用法

查找所有错误：

grep -i 'error\|exception\|fatal\|panic\|fail' app.log

带上下文查看错误：

grep -i -C 3 'error\|exception' app.log

追踪单个请求：

grep 'req-abc123' app.log

跨多服务追踪：

grep -rH 'correlation-id-xyz' /var/log/service-a/ /var/log/service-b/

JSON 日志过滤：

cat app.log | jq 'select(.level == "error")'

提取 Python 堆栈跟踪：

awk '/^Traceback/{p=1} p{print} /^[A-Za-z].*Error/{if(p) print "---"; p=0}' app.log

输入与输出

见下方输入与输出表格。

项目	内容
输入	日志文件路径；搜索关键词或正则表达式；ISO格式时间范围；请求ID/关联ID；日志格式标识（text/json/mixed）
输出	过滤后的日志行；错误类型统计；堆栈跟踪片段；指定JSON字段值；跨服务关联事件列表
适用人群	需要排查线上故障的后端开发、负责系统稳定的运维工程师、处理客户问题的技术支持、构建可观测体系的DevOps人员
不包含	Filebeat/Fluentd等日志采集工具的安装配置；Elasticsearch/Loki等存储方案的架构设计；PagerDuty等告警平台的集成；Grafana等可视化工具的搭建

 

风险提示

• 处理大日志文件时注意内存占用，建议配合 tail、head 分块处理
• 正则表达式复杂时可能误匹配或漏匹配，建议先用小样本验证
• 时间戳格式不统一可能导致过滤失效，需确认日志时间格式
• 生产环境实时 grep 可能影响 I/O 性能，避免高峰期全量扫描

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/gitgoodordietrying/log-analyzer/SKILL.md
来源类型：开源技能仓库