← Claude Code 2026最新機能マスター — Auto Mode・Ultraplan・Computer Use・Routines を実機で習得
LESSON 05 / 06

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

所要時間 12分 中級レベル

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 で複数セッションを一元管理します。