Amazon CloudWatch Logs で公開されたアプリケーションからのログを使用したデバッグ

フォーカスモード

Amazon CloudWatch Logs で公開されたアプリケーションからのログを使用したデバッグ - AWS App Studio

CloudWatch Logs Insights クエリを使用したログのフィルタリングとソート

Amazon CloudWatch Logs は、 AWS リソースとで AWS 実行しているアプリケーションをリアルタイムでモニタリングします。CloudWatch Logs を使用して、リソースとアプリケーションに対して測定できる変数であるメトリクスを収集および追跡できます。

App Studio アプリのデバッグでは、CloudWatch Logs は、アプリの実行中に発生するエラーの追跡、情報の監査、ユーザーアクションや独自のインタラクションに関するコンテキストの提供に役立ちます。ログには履歴データが用意されており、これを使用してアプリケーションの使用状況とアクセスパターンを監査したり、ユーザーが遭遇したエラーを確認したりできます。

注記

CloudWatch Logs は、アプリケーションの UI から渡されたパラメータ値のリアルタイムトレースを提供しません。

CloudWatch Logs の App Studio アプリからログにアクセスするには、次の手順に従います。

アプリの App Studio アプリケーションスタジオで、URL でを参照してアプリ ID を見つけてメモします。アプリ ID は次のようになります。802a3bd6-ed4d-424c-9f6b-405aa42a62c5。
CloudWatch コンソールの https://console.aws.amazon.com/cloudwatch/ を開いてください。
ナビゲーションペインで、[Log groups] (ロググループ) を選択します。
ここでは、アプリケーションごとに 5 つのロググループを見つけることができます。関心のある情報のタイプに応じて、グループを選択し、検出するデータのクエリを書き込みます。

次のリストには、ロググループと、それぞれをいつ使用するかに関する情報が含まれています。
1. /aws/appstudio/teamId/appId/TEST/app: を使用して、テスト環境に現在公開されているアプリのバージョンに関連する自動化レスポンス、コンポーネントエラー、または JavaScript コードをデバッグします。
2. /aws/appstudio/teamId/appId/TEST/audit: 条件付き可視性や変換、クエリの失敗、テスト環境に現在公開されているアプリのバージョンに関連するログインまたはアクセス許可ユーザーエラーなどの JavaScript コードエラーをデバッグするために使用します。
3. /aws/appstudio/teamId/setup: ビルダーまたは管理者アクションをモニタリングするために使用します。
4. /aws/appstudio/teamId/appId/PRODUCTION/app: を使用して、自動化レスポンス、クエリの失敗、コンポーネントエラー、または本番環境に現在公開されているアプリのバージョンに関連する JavaScript コードをデバッグします。
5. /aws/appstudio/teamId/appId/PRODUCTION/audit: 条件付き可視性や変換などの JavaScript コードエラー、および本番環境に現在公開されているアプリのバージョンに関連するログインまたはアクセス許可のユーザーエラーをデバッグするために使用します。
注記
デバッグに使用されるログのほとんどは、 DebugLogClient名前空間に分類されます。
ロググループに入ったら、最新のログストリームを選択するか、目的の時刻に最も近い最後のイベント時刻を持つログストリームを選択するか、すべてのログストリームを検索して、そのロググループ上のすべてのイベントを検索できます。CloudWatch Logs でのログデータの表示の詳細については、CloudWatch Logs に送信されたログデータの表示」を参照してください。

CloudWatch Logs Insights クエリを使用したログのフィルタリングとソート

CloudWatch Logs Insights を使用して、複数のロググループを一度にクエリできます。セッション情報を含むロググループのリストを特定したら、CloudWatch Logs Insights に移動し、ロググループを選択します。次に、クエリをカスタマイズしてターゲットログエントリをさらに絞り込みます。クエリの例を次に示します。

キーワードを含むログのリスト: error


fields @timestamp, @message
| filter @message like 'error'
| sort @timestamp desc

テスト環境からログをデバッグします。


fields @timestamp, @message
| filter namespace = "DebugLogClient"
| sort @timestamp desc

5 分間隔での全体的な 504/404/500 エラー数：


filter @message like '/api/automation' and (@message like ': 404' or @message like ': 500' or @message like ': 504') 
| fields @timestamp, method, path, statusCode  
| stats count(*) as errorCount by bin(5m)