troubleshooting-application-failures について
CloudWatch ログからアプリケーション障害を診断するスキルです。関連ログの特定、エラーやスタックトレースの分析、関連設定の確認を行い、対処案を優先順位付きで提示します。
主な機能
- 01関連ロググループの特定
- 02エラーとスタックトレースの検索
- 03根本原因の分析
- 04関連設定の確認
- 05対処案の優先順位付け
活用シーン
- 01CloudWatch のアプリケーションエラー調査
- 02タイムアウトやスロットリングの追跡
- 03権限やリトライ設定の確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ aws/ agent-toolkit-for-aws --skill troubleshooting-application-failuresインストール後、Claude Code で/troubleshooting-application-failuresを入力して読み込まれたか確認します。
同梱ファイルreferences/application-failure-troubleshooting.md
詳細
アプリケーション障害のトラブルシューティング
概要
CloudWatch ログの分析を通じて、アプリケーション障害を診断するためのドメイン知識です。 関連するロググループを特定し、エラーパターンやスタックトレースを検索して、 根本原因を分析し、優先順位を付けた改善策を提示します。
ログは調査の出発点であり、調査範囲の境界ではありません。ログからタイムアウト、 スロットリング、再試行、または権限の問題が示された場合は、その設定を確認します。たとえば、API Gateway の統合タイムアウト、キューの可視性タイムアウト、または関数のタイムアウトとイベントソースマッピングを確認します。通常、読み取り専用アクセスでも、これらの Describe および Get の呼び出しが可能です。
失敗しているアプリケーションのトラブルシューティング
CloudWatch ログを使用してアプリケーションの障害を診断し、解決するには、 手順に正確に従ってください。アプリケーション障害のトラブルシューティング手順を参照してください。
トラブルシューティング
ロググループが見つからない
具体的なロググループ名をユーザーに尋ねてください。一般的なパターンは、/aws/lambda/function-name、
/aws/apigateway/api-name、またはカスタムのアプリケーションロググループです。
アクセス拒否エラー
AWS 認証情報に logs:DescribeLogGroups、logs:DescribeLogStreams、
logs:StartQuery、および logs:GetQueryResults の権限があることを確認してください。
クエリのタイムアウト
時間範囲を短くするか、結果数を制限してください。大規模なロググループでは、より小さなクエリに分けて複数回実行する必要がある場合があります。