• 検索
  • 分析
  • 分類
  • 実行

AIを活用してアプリケーションのエラーをデバッグする方法

AIをCloudWatchに一度接続するだけで、クラッシュの原因を特定するために必要なログエントリをAIが直接取得します。

このページについてAIに聞く

すぐに答え

AIを使ってCloudWatchのエラーを見つけるには?

AIが filter_log_events ツールを使用して、ロググループから特定のエラーパターンやリクエストIDを抽出します。必要なスタックトレースやエラーメッセージを即座に取得できる仕組みです。

実現できること

デバッグデータの活用フロー

ログの検索はAIに任せて、あなたは修正作業に集中できます。

検索

ログのピンポイント抽出

AIが filter_log_events を使い、特定のエラー文字列を抽出します。大量のログをスクロールすることなく、必要な行だけを特定できます。

分析

根本原因の特定

エージェントが取得したログを読み取り、コードが失敗した箇所を特定します。エラーの内容を分かりやすく解説します。

分類

エラーのグルーピング

ログ内の繰り返されるエラーパターンをAIが識別します。一つのバグが複数のサービス障害を引き起こしていないかを確認できます。

実行

コードへの反映

AIは問題のあるロジックを指摘しますが、実際の修正とデプロイはあなたが行います。AIの分析結果に基づき、最適なパッチを適用してください。

ワークフロー

エラー発生時にAIが行うこと

AIがAWSの生ログと、あなたのデバッグ作業を繋ぐ架け橋になります。

  1. ロググループの特定

    調査したいデータが含まれているCloudWatch Log GroupをAIに伝えます。

    filter_log_events
  2. エラーのフィルタリング

    指定したエラーキーワードやタイムスタンプに一致するログイベントのみを、AIが検索して抽出します。

    filter_log_events
  3. スタックトレースの抽出

    フィルタリングされたログをAIが解析し、障害に関連する正確なスタックトレースを見つけ出します。

    filter_log_events
  4. クラッシュの要約

    ログに記録された一連のイベントをAIが読み解き、アプリケーションが失敗した理由を説明します。

    filter_log_events

試してみる

以下のプロンプトをコピーして開始

これらのプロンプトを使ってデバッグを開始できます。

出発点

カッコ内のテキストを、実際のCloudWatch Log Group名やエラーキーワードに書き換えて使用してください。

Amazon CloudWatch Log Group Connector

準備完了です。MCPクライアントを選択し、セットアップ手順に従ってください。

コネクタリンクhttps://edge.vinkius.com/vk_preview_BfV9nj0spaNXUtgeLPe1LJiwTfYsjgKtxLFUXKh7/mcp

Claude Desktop

以下の手順で数秒で接続できます。

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Amazon CloudWatch Log Group capabilities are ready to use.
設定 · claude_desktop_config.jsonコピー
{
  "mcpServers": {
    "amazon-cloudwatch-log-group-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_BfV9nj0spaNXUtgeLPe1LJiwTfYsjgKtxLFUXKh7/mcp"
    }
  }
}
チャットにコピー04
  • /aws/lambda/payment-service ロググループから、過去1時間以内のすべてのエラーメッセージを見つけてください。

  • /aws/rds/instance ロググループを検索して、'ConnectionTimeout' イベントがないか確認してください。

  • /aws/eks/cluster-logs グループを調べて、最新の NullPointerException のスタックトレースを見つけてください。

  • /aws/app/api-gateway ロググループで、午後2時から3時の間に発生した 5xx エラーをすべて確認してください。

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

ここから始める

Amazon CloudWatch Log Groupを一度接続するだけで、すぐに質問できます。

アカウントを一度連携するだけです。認証情報は弊社側で暗号化して管理するため、すぐにAIへログの取得を依頼できます。

Amazon CloudWatch Log GroupをAIに接続する

FAQ

機能の詳細

  • 01

    AIはCloudWatch内のログを削除できますか?

    いいえ。AIにはログイベントの読み取りとフィルタリングの権限しかありません。AWSアカウント内のデータを削除したり変更したりすることはできません。

  • 02

    AIはコードを自動的に修正できますか?

    いいえ。AIはエラー箇所を特定して原因を説明しますが、実際のコード変更とデプロイはユーザー自身が行う必要があります。

  • 03

    AIを利用するためにAWSのシークレットキーを渡す必要がありますか?

    いいえ。Vinkiusが接続を安全に管理します。AIのチャット欄にAWSの認証情報を直接入力する必要はありません。

  • 04

    すべてのAWSアカウントを横断して検索できますか?

    接続した認証情報でアクセス権限を持っているロググループであれば、どのロググループでも検索可能です。

  • 05

    AIは新しいロググループを作成できますか?

    いいえ。このツールは既存のログイベントを取得およびフィルタリングすることに特化しています。

  • Amazon CloudWatch Log Groupに関するその他の質問は、コネクターのページで確認できます。 Amazon CloudWatch Log Group コネクターの全機能を見る

『Amazon CloudWatch Log Group』を Claude、Cursor、ChatGPT などに接続