log-aggregation について
複数のソースからログを収集、構造化、分析するログ集約システムの設計スキルです。集中監視、デバッグ、セキュリティ、監査に向けた実装ガイドを提供します。
主な機能
- 01複数ソースのログ収集と解析
- 02ELK Stack と Logstash の設定ガイド
- 03Filebeat と Loki の設定
- 04Kibana ダッシュボードとアラート
- 05ログ保持とアクセス制御の実践
活用シーン
- 01分散サービスのログを一元収集
- 02検索可能なログによるアプリのエラー調査
- 03セキュリティイベントとコンプライアンス監査の監視
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ aj-geddes/ useful-ai-prompts --skill log-aggregationインストール後、Claude Code で/log-aggregationを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/elk-stack-configuration.mdfilebeat-configuration.mdkibana-dashboard-and-alerts.mdlog-aggregation-deployment-script.mdlogstash-pipeline-configuration.mdloki-configuration-kubernetes.mdscripts/validate-config.shtemplates/config-starter.yaml詳細
ログ集約
目次
概要
複数のソースからログを収集、解析、分析する包括的なログ集約システムを構築し、一元的な監視、デバッグ、コンプライアンス監査を実現します。
使用する場面
- ログの一元収集
- 分散システムのデバッグ
- コンプライアンスおよび監査のためのログ記録
- セキュリティイベントの監視
- アプリケーションのパフォーマンス分析
- エラーの追跡とアラート
- 履歴ログの保持
- リアルタイムでのログ検索
クイックスタート
最小限の実用例:
# docker-compose.yml - ELK Stack setup
version: "3.8"
services:
elasticsearch:
image: docker.elastic.co/elasticsearch/elasticsearch:8.5.0
environment:
- discovery.type=single-node
- xpack.security.enabled=false
- "ES_JAVA_OPTS=-Xms512m -Xmx512m"
ports:
- "9200:9200"
volumes:
- elasticsearch_data:/usr/share/elasticsearch/data
healthcheck:
test: curl -s http://localhost:9200 >/dev/null || exit 1
interval: 10s
timeout: 5s
retries: 5
logstash:
image: docker.elastic.co/logstash/logstash:8.5.0
volumes:
- ./logstash.conf:/usr/share/logstash/pipeline/logstash.conf
ports:
// ... (see reference guides for full implementation)
リファレンスガイド
詳細な実装については、references/ ディレクトリを参照してください。
| ガイド | 内容 |
|---|---|
| ELK Stack の設定 | ELK Stack の設定 |
| Logstash パイプラインの設定 | Logstash パイプラインの設定 |
| Filebeat の設定 | Filebeat の設定 |
| Kibana ダッシュボードとアラート | Kibana ダッシュボードとアラート |
| Loki の設定(Kubernetes) | Loki の設定(Kubernetes) |
| ログ集約のデプロイスクリプト | ログ集約のデプロイスクリプト |
ベストプラクティス
✅ 推奨事項
- ログデータを解析して構造化する
- 適切なログレベルを使用する
- コンテキスト情報を追加する
- ログの保持ポリシーを実装する
- ログに基づくアラートを設定する
- 重要なフィールドをインデックス化する
- 一貫したタイムスタンプ形式を使用する
- アクセス制御を実装する
❌ 禁止事項
- ログに機密データを保存する
- 本番環境で DEBUG レベルのログを記録する
- 未加工の非構造化ログを送信する
- ストレージコストを無視する
- ログの解析を省略する
- ログシステムの監視を怠る
- ログを無期限に保存する
- PII を暗号化せずに記録する
コメント
Markdown 対応