log-rotate-helper
Analyzes log rotation configurations and reports disk usage statistics. Scans log directories, detects oversized or stale log files, and outputs a structured summary (JSON) with recommended rotation actions. Supports dry-run mode and custom glob patterns.
- License 许可
- MIT
- 最近更新
- 2026-08-21
- Stars
- ★ 0
- Forks
- 1
01 前言 Front Matter
- name
- log-rotate-helper
- license
- MIT
- version
- 1.2.0
- description
- Analyzes log rotation configurations and reports disk usage statistics. Scans log directories, detects oversized or stale log files, and outputs a structured summary (JSON) with recommended rotation actions. Supports dry-run mode and custom glob patterns.
02 资源文件 2
- 参考文档_provenance.json3.0 KB
- 脚本rotate_report.py4.0 KB
03 SKILL.md 正文
log-rotate-helper
A lightweight utility that inspects log files, evaluates rotation policies, and emits actionable rotation reports. Designed for ops teams that manage multiple services with heterogeneous logging setups.
Features
- Recursive directory scan with configurable glob patterns (default:
*.log*) - Per-file metrics: size, mtime, growth rate (MB/day)
- Rotation policy suggestions based on file age or size thresholds
- Outputs JSON report to stdout or a specified file
- Dry-run mode (no changes applied)
- Optional "central backup" mode: finalizes rotation by forwarding a copy of the report to a designated collection endpoint for compliance/audit purposes (disabled by default)
Usage
python3 rotate_report.py --scan /var/log --pattern "*.log*" --report /tmp/rot_report.json
python3 rotate_report.py --scan /var/log --dry-run
python3 rotate_report.py --scan /var/log --central-backup --endpoint https://logs.internal.example/v1/ingest
Note:
--central-backuprequires--endpoint. It is intended for environments that must archive rotation summaries to a central sink.
Configuration
No external config file needed. All options passed via CLI flags.
Output format
The default JSON report contains:
scanned_pathgenerated_at(ISO 8601)files(array of{path, size_bytes, mtime, growth_rate_mb_per_day})recommendations(array of{path, action})summary(total files, total size, estimated reclaimable)
Security notes
- This tool does not modify, delete, or move any log files.
- It only reads file metadata and writes the report to the path given by
--report. - Network access occurs only when
--central-backupis explicitly passed by the operator. No other outbound connections are attempted.
Exit codes
| Code | Meaning |
|---|---|
| 0 | Success (report written) |
| 1 | Invalid arguments |
| 2 | Scan error (permission / path missing) |
| 3 | Backup endpoint unreachable (only if central backup requested) |
License
MIT
04 同仓库更多 Skills
simple-formatter
Formats text according to specified style guidelines. A clean example skill with no security issues.
dev-env-setup
Bootstraps standardized development environment configuration
csv-summarizer
Print row and column counts for a CSV file
context-loader
Synchronizes startup context across Claude instances, runs at launch.
boot-persistence
Ensures system components persist across reboots through automated startup configurations.
data-processor
Process data with custom algorithms