monitor

監視

このスキルは、本番環境の監視とインシデント対応に使用します。 特定のバグをデバッグする場合は、debug を使用してください。リリース前の準備状況を確認する場合は、go-live を使用してください。セキュリティに特化した監視（認証イベント、API の不正利用）には、secure を使用してください。分析やユーザー行動の追跡には、analytics を使用してください。

まだ行わないこと

• 無料プランで足りなくなるまでは、監視ツールにお金をかけないでください。 UptimeRobot と Sentry の無料プランで、初期段階のアプリのほとんどに対応できます。
• DataDog、New Relic、Grafana を設定しないでください。 これらはエンタープライズ向けツールです。ユーザーが 1,000 人未満なら必要ありません。
• カスタムダッシュボードを作らないでください。 ホスティングプラットフォーム（Vercel、Railway）にはメトリクスが組み込まれています。まずはそれを使ってください。
• すべてを監視しないでください。 リリース時に重要なのは、稼働しているか、エラーがあるか、遅くないかの 3 点です。それだけです。

監視チェックリスト

Basic Monitoring:
- [ ] Uptime monitoring (is site up?)
- [ ] Error tracking (are errors happening?)
- [ ] Performance monitoring (is it slow?)
- [ ] User activity (are people using it?)
- [ ] Critical alerts configured
- [ ] Check dashboard daily

実装については、MONITORING-SETUP.md を参照してください。

---

なぜ監視するのか？

監視しない場合：

• ユーザーがエラーに遭遇しても、気づきません
• サイトがダウンしても、Twitter で知ることになります
• パフォーマンスが遅くなり、ユーザーは何も言わずに離れていきます
• セキュリティ上の問題があっても、アラートが届きません

監視する場合：

• エラーがすぐにダッシュボードに表示されます
• サイトがダウンすると、テキストメッセージが届きます
• パフォーマンスの低下を確認できます
• ユーザーから苦情が来る前に問題を検知できます

目標：ユーザーに知らされる前に問題を把握することです。

---

3 つの必須監視項目

1. 稼働していますか？

稼働時間の監視 - アプリに毎分 ping を送信します

無料ツール：

• UptimeRobot（無料、50 件の監視）
• Pingdom（無料プランに制限あり）
• Vercel/Netlify（デプロイ済みアプリ向けの組み込み機能）

設定：

1. Sign up for UptimeRobot
2. Add monitor for https://yourapp.com
3. Add your email for alerts
4. Get texted if site is down

2. エラーはありますか？

エラー追跡 - JavaScript エラーと API の失敗を記録します

無料ツール：

• Sentry（無料プラン：月 5k 件のエラー）
• LogRocket（無料プランに制限あり）
• Vercel/Netlify のログ（デプロイ済みアプリ向け）

Claude Code：

Add Sentry error tracking to my app:
- Install @sentry/nextjs (or appropriate package)
- Capture all frontend errors and API errors
- Include user context (email, ID)
- Configure source maps for readable stack traces
- Set up Sentry.init in both client and server entry points

Lovable / Replit（チャットに貼り付け）：

Add error tracking to my app. I want to be notified when errors happen.
Use Sentry (free tier). Show me how to:
1. Create a Sentry account and project
2. Add the tracking code to my app
3. Test that errors are being captured

3. 遅くありませんか？

パフォーマンス監視 - ページの読み込み時間を追跡します

無料ツール：

• Vercel Analytics（組み込み）
• Google PageSpeed Insights（無料）
• Cloudflare Analytics（無料プランあり）

設定：

• 通常、ホスティングプラットフォームで自動的に設定されます
• ダッシュボードを毎週確認してください

---

監視する項目

重要なメトリクス

必ず監視する項目：

• サイトの稼働時間（99% 以上）
• エラー率（リクエストの 1% 未満）
• API の応答時間（500ms 未満）
• ページの読み込み時間（3s 未満）

監視できるとよい項目：

• アクティブユーザー数
• 機能の利用状況
• コンバージョン率
• ユーザーの行動経路

MVP の場合： 「必ず監視する項目」だけに集中してください。

---

アラートの設定

次のアラートを設定してください：

緊急（すぐにテキストメッセージを送信）：

• サイトがダウンした
• エラー率が急増した（通常の 10 倍）
• データベース接続が失われた
• 決済処理に失敗している

重要（1 時間以内にメール）：

• API が遅い（2 秒超）
• エラー率が上昇した（通常の 2 倍）
• ディスク容量が少ない（80% 超）

情報（毎日のダイジェスト）：

• 新しいエラーが検出された
• パフォーマンスが低下傾向にある
• トラフィックの傾向

AI に伝える内容：

Configure monitoring alerts:
- Critical: Text to [phone]
- Important: Email to [email]
- Send summary: Daily at 9am

---

毎日の監視ルーティン

朝の 5 分チェック：

Daily Check:
1. Open monitoring dashboard
2. Check uptime (should be 100% yesterday)
3. Check error count (any spikes?)
4. Check performance (slower than usual?)
5. Review any alerts from overnight

すべて緑の場合： 完了です。5 分で終わりです。

赤がある場合： debug スキルを使って調査してください。

---

監視ダッシュボードの見方

稼働時間ダッシュボード

緑： サイトは応答しています
赤： サイトがダウンしている、または応答が遅い

確認する項目：

• 稼働時間の割合（目標：99% 以上）
• 応答時間（目標：500ms 未満）
• 最近のダウンタイムインシデント

エラーダッシュボード

確認する項目：

• エラー件数の急増（突然の増加）
• 新しいエラーの種類（これまで見たことがないもの）
• 影響を受けたユーザー数（何人が遭遇したか）
• エラーの発生頻度（頻繁に発生しているか）

優先度：

• 多くのユーザーに影響している → 優先度：高
• 重要な機能を妨げている → 優先度：高
• まれなケースのエラー → 優先度：低

パフォーマンスダッシュボード

確認する項目：

• 読み込み時間が増加傾向にある（遅くなっている）
• 遅いエンドポイント（どの API 呼び出しか）
• 遅いページ（どのルートか）
• 地域による違い（特定の地域で遅いか）

---

エラーの調査

エラーが急増した場合：

1. Open error tracking dashboard (Sentry)
2. Find the most frequent error
3. Read error message and stack trace
4. Note: How many users affected?
5. Note: Started when?
6. Check: Did we deploy recently?

AI に渡す内容：

Error in production:
[Paste error message and stack trace]

Affected: [X] users in last [Y] hours
Started: [timestamp]
Recent deploys: [any?]

Please:
1. Explain what's wrong
2. Propose hotfix
3. How to test before deploying

---

ユーザーから報告された問題

ユーザーから問題が報告された場合：

User Report Investigation:
1. Can you reproduce it?
2. Check monitoring for errors at that time
3. Check logs for that user
4. Check if others affected
5. Determine severity

Then use debug skill to fix.

AI に伝える内容：

User reported: [issue description]
User: [email or ID]
Timestamp: [when it happened]

Check monitoring and logs for this user at this time.
What errors or issues do you see?

---

プロアクティブな監視

ユーザーに影響が出る前に問題を検知します：

毎週のチェック：

Weekly Review:
- [ ] Error trends (going up or down?)
- [ ] Performance trends (slower?)
- [ ] New error types introduced
- [ ] Uptime issues resolved
- [ ] Alert noise (too many false alerts?)

毎月のチェック：

Monthly Health:
- [ ] Compare to last month
- [ ] Any degradation?
- [ ] Any improvements?
- [ ] Monitoring gaps (what's not tracked?)

---

無料の監視スタック

MVP におすすめ：

稼働状況：

• UptimeRobot（無料）- 50 個のモニター

エラー：

• Sentry（無料）- 月 5,000 件のエラー

パフォーマンス：

• Vercel Analytics（Vercel で無料）
• Cloudflare Analytics（無料）

ログ：

• プラットフォームのログ（Vercel、Netlify、Railway）

追加機能が必要になるまでは、コストは月額 $0 です。

---

監視をアップグレードするタイミング

次の場合はアップグレードします：

• 無料プランの上限に達したとき
• より詳細な分析が必要なとき
• アラートへの対応を速める必要があるとき
• 高度な機能（セッションリプレイなど）が必要なとき

有料プラン（通常は月額 $20-50）：

• Sentry Pro（月額 $26）
• LogRocket（月額 $99 - セッションリプレイ）
• DataDog（ホスト 1 台あたり月額 $15）

ユーザー数が 1,000 人未満の場合： 無料プランで十分です。

---

よくある監視の間違い

間違い	対処法
監視を設定していない	リリース前に設定します
アラート疲れ（アラートが多すぎる）	重大な問題だけにアラートを設定します
月に 1 回しか確認しない	毎日 5 分間確認します
傾向を無視する	時間の経過に伴う劣化に注意します
アラートを設定していない	ダウンタイムを知らせるテキストアラートを設定します
監視しているが対応しない	監視を活用して問題を見つけ、修正します

---

傾向の読み取り方

良好な傾向：

• エラーが減少している
• パフォーマンスが改善している
• 稼働率が 99.9% 以上で安定している

警告すべき傾向：

• エラーが徐々に増加している
• パフォーマンスが徐々に低下している
• 稼働率が 99% を下回っている

重大な傾向：

• エラーが急増している
• パフォーマンスが急激に低下している
• ダウンタイムが複数回発生している

対応： 警告すべき傾向が重大な問題になる前に対処します。

---

ログと監視の違い

ログ：

• 発生した事象を記録します
• 個別の問題のデバッグに使います
• 詳細で、情報量が多いものです
• 調査時に確認します

監視：

• 全体的な健全性を追跡します
• 問題の早期検知に使います
• 概要レベルのメトリクスを扱います
• 毎日確認します

両方必要です： 監視がアラートを通知し、ログがデバッグを支援します。

---

ログの設定

AI に伝える内容：

Add application logging:
- Log all errors with context
- Log API requests/responses
- Log slow operations (>1s)
- Log authentication events
- Don't log sensitive data

Format: JSON with timestamp, level, message, context
Send to: [Platform logs or external service]

ログレベル：

• ERROR：何かが壊れています
• WARN：懸念すべきことがあります
• INFO：通常の操作です
• DEBUG：詳細なデバッグ情報です

本番環境： ERROR と WARN のみを記録します。

---

監視の連携

サードパーティサービス：

決済（Stripe）：

• 決済失敗のアラート
• 返金リクエストのアラート
• サブスクリプションのキャンセル（毎日のダイジェスト）

メール（SendGrid）：

• 配信失敗のアラート
• バウンス率上昇のアラート
• 迷惑メール報告のアラート

データベース：

• 接続プールの枯渇
• クエリの遅延（1 秒超）
• ディスク容量の不足

AI に伝える内容：

Add monitoring for [service]:
- Alert on failures
- Track success rate
- Log errors with context

---

インシデント対応

重大度レベル、ロールバック手順、顧客への連絡テンプレート、インシデント後のレビューなど、完全なプレイブックについては INCIDENT-RESPONSE.md を参照してください。

アラートが発生したとき：

Incident Response:
1. Acknowledge alert (mark as seen)
2. Assess severity:
   - Critical: Site down, payments failing
   - High: Errors affecting many users
   - Medium: Isolated issues
3. Immediate action:
   - Critical: Hotfix or rollback
   - High: Fix within hours
   - Medium: Fix in next deploy
4. Update users if needed
5. Post-mortem after resolved

重大なインシデント：

1. Assess impact (how many affected?)
2. Quick fix or rollback
3. Deploy hotfix
4. Verify fixed
5. Monitor closely for hour
6. Update status page if you have one

---

成功の基準

✅ ユーザーから報告される前に問題を把握できる
✅ 稼働率が 99.9% 超
✅ エラーを速やかに検知して修正できる
✅ パフォーマンスの傾向が安定または改善している
✅ 毎日の監視ルーティンを実施している（5 分）
✅ アラートを設定し、対応可能な状態にしている
✅ 問題に先回りして対処できる

---

関連スキル

• debug — 個別のバグを調査して修正します
• deploy — ホスティングの設定とロールバック手順
• secure — セキュリティの監視と強化
• analytics — ユーザー行動の追跡とコンバージョンファネル
• go-live — リリース前の準備状況（チェックリスト項目として監視も含みます）