翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon CloudWatch Logs で公開されたアプリケーションからのログを使用したデバッグ
<a name="troubleshooting-cloudwatch"></a>

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

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

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

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

1. アプリの App Studio アプリケーションスタジオで、URL を参照してアプリ ID を見つけてメモします。アプリ ID は次のようになります: `802a3bd6-ed4d-424c-9f6b-405aa42a62c5`。

1. CloudWatch コンソールの [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) を開いてください。

1. ナビゲーションペインで、**[Log groups]** (ロググループ) を選択します。

1. ここでは、アプリケーションごとに 5 つの**ロググループ**が表示されます。関心のある情報のタイプに応じて、グループを選択し、検出するデータのクエリを書き込みます。

   次のリストには、ロググループと、それぞれをいつ使用するかに関する情報が含まれています。

   1. `/aws/appstudio/teamId/appId/TEST/app`: テスト環境に現在公開されているアプリのバージョンに関連する自動化レスポンス、コンポーネントエラー、または JavaScript コードをデバッグするために使用します。

   1. `/aws/appstudio/teamId/appId/TEST/audit`: 条件付き可視性または変換、クエリの失敗、テスト環境に現在公開されているアプリのバージョンに関連するログインまたはアクセス許可ユーザーエラーなどの JavaScript コードエラーをデバッグするために使用します。

   1. `/aws/appstudio/teamId/setup`: ビルダーまたは管理者アクションをモニタリングするために使用します。

   1. `/aws/appstudio/teamId/appId/PRODUCTION/app`: を使用して、自動化レスポンス、クエリエラー、コンポーネントエラー、または本番環境に現在公開されているアプリのバージョンに関連する JavaScript コードをデバッグします。

   1. `/aws/appstudio/teamId/appId/PRODUCTION/audit`: 条件付き可視性や変換などの JavaScript コードエラー、および本番環境に現在公開されているアプリのバージョンに関連するログインまたはアクセス許可ユーザーエラーをデバッグするために使用します。
**注記**  
デバッグに使用されるログのほとんどは、 `DebugLogClient`名前空間に分類されます。

1. ロググループに入ったら、最新のログストリームを選択するか、目的の時刻に最も近い最後のイベント時刻を持つログストリームを選択するか、すべてのログストリームを検索して、そのロググループのすべてのイベントを検索できます。CloudWatch Logs でのログデータの表示の詳細については、[CloudWatch Logs に送信されたログデータの表示](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html#ViewingLogData)」を参照してください。

## CloudWatch Logs Insights クエリを使用したログのフィルタリングとソート
<a name="troubleshooting-cloudwatch-queries"></a>

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)
```

CloudWatch Logs Insights の詳細については、「Amazon [ CloudWatch Logs ユーザーガイド」の「CloudWatch Logs Insights を使用したログデータの分析](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html)」を参照してください。 Amazon CloudWatch