# Log Diagnostic

> 分析日志文件的错误模式，支持JSON、syslog、Nginx等常见格式，自动检测并输出错误聚类、频率统计和时间分布报告，用于排查问题、定位高发时段。当用户上传.log文件并要求排查错误、分析错误分布、定位高发时段，或提及错误统计、日志分析等关键词时触发。

- Skill: `haomingz/log-diagnostic` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add haomingz/log-diagnostic`
- Raw SKILL.md: https://api.skillmd.com/api/skills/haomingz/log-diagnostic/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: haomingz (https://skillmd.com/u/haomingz)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/haomingz/log-diagnostic

---


# Log Analyzer

对日志文件进行自动化分析，提供错误聚类、频率统计和时间分布报告。

## 功能

- **错误聚类**：将相似的错误消息归类，消除噪声（IP、UUID、数字等动态部分），识别根本问题
- **频率统计**：按错误类型统计出现次数，按严重程度排序
- **时间分布**：展示错误在各小时和各日期的分布，帮助定位高发时段

## 支持的日志格式

| 格式 | 说明 | 自动检测 |
|------|------|----------|
| JSON | 每行一个 JSON 对象，含 `timestamp`/`level`/`message` 等字段 | 以 `{` 开头 |
| syslog | RFC 3164 格式，如 `Jan  1 12:00:00 host proc[pid]: msg` | 月份名开头 |
| Nginx | access log 或 error log 格式 | IP 开头或日期路径格式 |

## 使用方式

```bash
python scripts/analyze_logs.py <日志文件路径> [选项]
```

### 参数

| 参数 | 说明 | 默认值 |
|------|------|--------|
| `log_file` | 日志文件路径（必填） | - |
| `--format` | 指定日志格式：`auto`/`json`/`syslog`/`nginx` | `auto` |
| `--top` | 显示 Top N 错误聚类 | `20` |
| `--output` | 输出结果到 JSON 文件 | 仅终端输出 |
| `--level` | 过滤日志级别（如 `ERROR`、`WARN`） | 所有级别 |
| `--since` | 只分析此时间之后的日志（ISO 格式） | 不限 |
| `--until` | 只分析此时间之前的日志（ISO 格式） | 不限 |

### 示例

```bash
# 自动检测格式，分析整个日志文件
python scripts/analyze_logs.py /var/log/app.log

# 指定 Nginx 格式，只看 Top 10 错误
python scripts/analyze_logs.py /var/log/nginx/error.log --format nginx --top 10

# 只分析 ERROR 级别，输出 JSON 报告
python scripts/analyze_logs.py app.log --level ERROR --output report.json

# 分析指定时间范围内的日志
python scripts/analyze_logs.py app.log --since 2024-01-01T00:00:00 --until 2024-01-02T00:00:00
```

## 输出说明

### 终端输出

```
=======================================================
              日志分析报告
=======================================================

📊 概览
  检测格式: json
  总行数:   15,234
  已解析:   15,100 (解析失败: 134)
  匹配条目: 12,800
  错误数:   2,341
  时间范围: 2024-01-01 00:03:12 ~ 2024-01-01 23:58:45

🔴 Top 错误聚类 (共 47 类)
  #1   [×523  ] Connection refused to database at 10.0.1.5:5432
       首次: 2024-01-01T00:15:30  末次: 2024-01-01T23:45:12
  #2   [×312  ] Timeout waiting for response from user-service after 30000ms
       首次: 2024-01-01T02:10:00  末次: 2024-01-01T22:30:45
  #3   [×198  ] File not found: /data/uploads/img_99421.png
       首次: 2024-01-01T08:00:00  末次: 2024-01-01T20:15:33
  ...

⏰ 时间分布 (按小时)
  00:00  █████░░░░░░░░░░░░░░░  42
  01:00  ██░░░░░░░░░░░░░░░░░░  18
  ...
  14:00  ████████████████████  523
  ...

📅 时间分布 (按日期)
  2024-01-01  ████████████████████  2,341
```

### JSON 输出

使用 `--output` 参数可导出结构化 JSON 报告，方便后续处理或接入监控系统。