LESSON 05
/ 06
Monitor で外部イベントを Claude にストリーミング

Routines が「決まったタイミングで動く」のに対し、Monitor は 「外部イベントを実時間で会話に流し込む」機能です。Claude が 受け身ではなく能動的に反応できるようになります。
基本的な使い方
# ファイルを tail
claude monitor "tail -f /var/log/app.log"
# プロセスの出力を流す
claude monitor "pnpm test --watch"
# 複数ソースを同時に
claude monitor
--source "tail -f /var/log/app.log"
--source "tail -f /var/log/nginx/error.log"
# Slack 連携
claude monitor --source slack --channel engineering
強力な機能:on-event ハンドラ
特定パターンを検知したら自動アクション。
claude monitor "tail -f /var/log/app.log"
--on-pattern "ERROR"
--action "analyze the error and propose a fix"
--on-pattern "OutOfMemory"
--action "alert me on Slack and check recent commits"
--on-pattern "503"
--action "check if dependent services are healthy"
典型ユースケース
ユースケース1:CI 失敗の即時修正
claude monitor "pnpm test --watch"
--on-error "テストが失敗しました。
スタックトレースを分析して、最小限の修正を提案。
修正後、自動でテスト再実行"
ユースケース2:本番ログのインシデント検知
claude monitor "kubectl logs -f deployment/api --tail=100"
--on-pattern "FATAL|CRITICAL"
--action "原因を特定し、ロールバック手順を提示。
Slack #incident に投稿"
--on-pattern "rate limit"
--action "どのエンドポイントか特定し、
スロットリング設定の見直しを提案"
ユースケース3:Slack カスタマーサポート
claude monitor --source slack
--channel customer-support
--on-mention "@ai-support"
--action "ユーザーの質問に対する回答候補を作成。
関連するヘルプ記事のリンクも添付"
ユースケース4:メトリクス異常検知
claude monitor "curl -s prometheus:9090/metrics | jq ."
--interval 30s
--on-pattern "response_time_p99.*[0-9].[0-9]{3,}"
--action "P99レイテンシが1秒超え。
直近のデプロイ・トラフィック・依存サービスを調査"
並行する複数 Monitor
異なるソースを同時にモニタリング可能:
# それぞれが別バックグラウンドプロセスとして動く
claude monitor "tail -f api.log" --label api &
claude monitor "tail -f worker.log" --label worker &
claude monitor "tail -f scheduler.log" --label scheduler &
# 統合表示
claude monitor --status # 全Monitorの状態
イベントの履歴と検索
# 過去のMonitor検知履歴を確認
claude monitor history
# 特定パターンで絞り込み
claude monitor history --pattern "OutOfMemory" --since "24h ago"
# 検知レポートをエクスポート
claude monitor export --format json --output incidents.json
パフォーマンスとコスト
- ストリームは Claude に送る前に 軽量な前処理(パターンマッチング)を実施
- マッチしたイベントだけがコンテキストに入るため、無駄なトークン消費なし
- 高頻度ログの場合は –sample-rate 0.1(10%サンプリング)で節約
セキュリティ注意点
| 項目 | 対策 |
|---|---|
| 機密ログ(APIキー含む) | 事前に grep/sed で除去してから流す |
| 大量バーストで料金跳ね上がり | rate-limit オプションで制限 |
| 誤った on-event アクション | 本番では action を read-only に限定 |
このレッスンのまとめ
Monitor は 「実時間反応」を可能にする機能。インシデント検知・CI 失敗修正・CS自動化など、応用範囲は広い。次のレッスン(最終回)では、Agents View で複数セッションを一元管理します。