log-rotation-strategies
Node.jsアプリケーションのログローテーション戦略設計・実装スキル。PM2、logrotate、Winston、集中ログシステムを活用した効率的ログ管理を提供。Anchors:• 『Site Reliability Engineering』(Google) / 適用: ログ管理SLO / 目的: 運用卓越性• 『Systems Performance』(Brendan Gregg) / 適用: ディスクUSEメソッド / 目的: キャパシティプランニング• PM2-logrotate Module / 適用: サイズ/時間ベースローテーション / 目的: 自動ログ管理Trigger:Use when configuring log rotation, optimizing disk capacity for logs, designing log retention policies,or integrating with centralized logging systems (ELK, Datadog, CloudWatch, Loki).
When & Why to Use This Skill
This Claude skill provides expert-level design and implementation of log rotation strategies specifically for Node.js applications. It automates the management of application logs using industry-standard tools like PM2, Winston, and Linux logrotate to ensure system stability and prevent disk exhaustion. Built on Site Reliability Engineering (SRE) principles and the 'Disk USE Method,' it facilitates seamless integration with centralized logging stacks such as ELK, Datadog, and CloudWatch, helping teams maintain high observability and operational excellence.
Use Cases
- Scenario 1: Automating log rotation for high-traffic Node.js applications to prevent server crashes caused by disk space depletion.
- Scenario 2: Implementing time-based log archiving and retention policies for regulatory compliance using Winston's DailyRotateFile.
- Scenario 3: Configuring the pm2-logrotate module for microservices to manage log volume and compression without manual intervention.
- Scenario 4: Designing a centralized logging pipeline that bridges local file rotation with cloud-based observability platforms like Loki or AWS CloudWatch.
- Scenario 5: Optimizing system performance by applying capacity planning strategies to log generation and storage cycles.
| name | log-rotation-strategies |
|---|---|
| description | | |
| • 『Site Reliability Engineering』(Google) / 適用 | ログ管理SLO / 目的: 運用卓越性 |
| • 『Systems Performance』(Brendan Gregg) / 適用 | ディスクUSEメソッド / 目的: キャパシティプランニング |
| • PM2-logrotate Module / 適用 | サイズ/時間ベースローテーション / 目的: 自動ログ管理 |
Log Rotation Strategies
相対パス:
SKILL.md読込条件: スキル使用時(自動)
概要
Node.js アプリケーションのログローテーション戦略を設計・実装するスキル。
対象領域:
- PM2 logrotate によるプロセスマネージャー統合
- Winston DailyRotateFile によるアプリケーションレベル制御
- logrotate (Linux) によるシステムレベル管理
- 集中ログシステム(ELK/Datadog/CloudWatch/Loki)への統合
ワークフロー
Phase 1: 要件分析
Task: agents/analyze-requirements.md
| 入力 | 出力 |
|---|---|
| アプリケーション情報、ビジネス要件 | 要件分析レポート |
参照: references/basics.md
Phase 2: 戦略設計
Task: agents/design-strategy.md
| 入力 | 出力 |
|---|---|
| 要件分析レポート | 戦略設計書 |
参照: references/rotation-patterns.md, references/log-aggregation.md
Phase 3: 実装
Task: agents/implement-rotation.md
| 入力 | 出力 |
|---|---|
| 戦略設計書 | 実装完了レポート |
参照: references/pm2-logrotate-guide.md, assets/winston-rotation.template.ts
Phase 4: 検証
Task: agents/validate-setup.md
| 入力 | 出力 |
|---|---|
| 実装完了レポート | 検証完了レポート |
参照: scripts/analyze-log-usage.mjs
ベストプラクティス
| すべきこと | 避けるべきこと |
|---|---|
| ログ生成量を事前に分析 | 無制限ログ出力 |
| サイズ/時間/ハイブリッド方式を適切に選択 | ローテーション世代数未指定 |
| ecosystem.config.js に pm2-logrotate 統合 | ログフォーマット未標準化 |
| compress: true でディスク使用量削減 | 集約前の重要ログ削除 |
| 定期的なログディレクトリ監視 | 検証なしの本番デプロイ |
Task ナビゲーション
| Task | 目的 | 参照リソース |
|---|---|---|
analyze-requirements.md |
ログ生成パターンの定量分析 | basics.md |
design-strategy.md |
ローテーション方式・パラメータ決定 | rotation-patterns.md |
implement-rotation.md |
設定ファイル作成・適用 | pm2-logrotate-guide.md |
validate-setup.md |
動作検証・本番運用可否判断 | scripts/ |
リソース参照
References
| ファイル | 内容 | 読込条件 |
|---|---|---|
basics.md |
ログローテーション基礎概念・用語 | 初回使用時 |
rotation-patterns.md |
サイズ/時間/ハイブリッド方式の選択基準 | 戦略設計時 |
pm2-logrotate-guide.md |
PM2 logrotate 設定詳細ガイド | PM2 使用時 |
log-aggregation.md |
集中ログシステム選定・統合ガイド | スケール検討時 |
Assets
| ファイル | 内容 |
|---|---|
winston-rotation.template.ts |
Winston DailyRotateFile 設定テンプレート |
Scripts
| スクリプト | 用途 |
|---|---|
analyze-log-usage.mjs |
ログ使用量分析・容量予測 |
log_usage.mjs |
スキル使用記録・自動評価 |
関連スキル
logging-observability- ログ観測可能性とモニタリングdisk-management- ディスク容量管理pm2-configuration- PM2 設定全般