Agent Skills › zebbern/claude-code-guide › log-error-digest

log-error-digest

GitHub

自动分析日志文件以排查错误，支持JSON、syslog和Nginx格式。功能包括错误聚类、频率统计和时间分布报告，帮助用户定位峰值时段并识别根本原因。

skills/log-error-digest/SKILL.md zebbern/claude-code-guide

Trigger Scenarios

用户上传 .log 文件并请求分析错误用户询问如何查找错误模式或调试问题需要获取错误分布统计数据

Install

npx skills add zebbern/claude-code-guide --skill log-error-digest -g -y

More Options

Use without installing

npx skills use zebbern/claude-code-guide@log-error-digest

指定 Agent (Claude Code)

npx skills add zebbern/claude-code-guide --skill log-error-digest -a claude-code -g -y

安装 repo 全部 skill

npx skills add zebbern/claude-code-guide --all -g -y

预览 repo 内 skill

npx skills add zebbern/claude-code-guide --list

SKILL.md

Frontmatter

{
    "name": "log-error-digest",
    "tags": [
        "logs",
        "analysis",
        "devops",
        "monitoring"
    ],
    "type": "tool",
    "license": "MIT",
    "description": "Analyze log files to troubleshoot errors, identify peak error periods, and produce error clustering, frequency statistics, and time distribution reports. Supports JSON, syslog, and Nginx formats with automatic detection. Use when a user uploads a .log file and asks to analyze errors, find patterns, debug issues, or get distribution stats."
}

Log Error Digest

Automated log file analysis that produces error clustering, frequency statistics, and time distribution reports.

Features

Error Clustering: Groups similar error messages by normalizing dynamic parts (IPs, UUIDs, numbers, etc.) to identify root causes
Frequency Statistics: Counts occurrences by error type, sorted by severity
Time Distribution: Shows error distribution by hour and by date, helping pinpoint peak error periods

Supported Log Formats

Format	Description	Auto-detection
JSON	One JSON object per line with `timestamp`/`level`/`message` fields	Starts with `{`
syslog	RFC 3164 format, e.g. `Jan 1 12:00:00 host proc[pid]: msg`	Starts with month name
Nginx	Access log or error log format	Starts with IP or date/path pattern

Usage

python scripts/analyze_logs.py <log_file_path> [options]

Parameters

Parameter	Description	Default
`log_file`	Path to the log file (required)	-
`--format`	Log format: `auto`/`json`/`syslog`/`nginx`	`auto`
`--top`	Show Top N error clusters	`20`
`--output`	Export results to a JSON file	Terminal output only
`--level`	Filter by log level (e.g. `ERROR`, `WARN`)	All levels
`--since`	Only analyze logs after this time (ISO format)	No limit
`--until`	Only analyze logs before this time (ISO format)	No limit

Examples

# Auto-detect format and analyze the entire log file
python scripts/analyze_logs.py /var/log/app.log

# Specify Nginx format, show only Top 10 errors
python scripts/analyze_logs.py /var/log/nginx/error.log --format nginx --top 10

# Filter ERROR level only, export JSON report
python scripts/analyze_logs.py app.log --level ERROR --output report.json

# Analyze logs within a specific time range
python scripts/analyze_logs.py app.log --since 2024-01-01T00:00:00 --until 2024-01-02T00:00:00

Output

Terminal Output

=======================================================
              Log Analysis Report
=======================================================

📊 Overview
  Detected format: json
  Total lines:     15,234
  Parsed:          15,100 (parse failures: 134)
  Matched entries: 12,800
  Errors:          2,341
  Time range:      2024-01-01 00:03:12 ~ 2024-01-01 23:58:45

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

⏰ Time Distribution (by hour)
  00:00  █████░░░░░░░░░░░░░░░  42
  01:00  ██░░░░░░░░░░░░░░░░░░  18
  ...
  14:00  ████████████████████  523
  ...

📅 Time Distribution (by date)
  2024-01-01  ████████████████████  2,341