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

# Visual Studio 上での CloudWatch Logs の操作
<a name="cloudwatch-log-overview"></a>

Amazon CloudWatch Logs の統合により、 AWS Toolkit for Visual Studio から Amazon Q を使用して CloudWatch Logs をモニタリング、保存、アクセスできます。IDE を離れることなく CloudWatch Logs 機能にアクセスできるため、CloudWatch Logs の開発プロセスが簡素化され、ワークフローの中断が軽減され、効率が向上します。以下のトピックでは、CloudWatch Logs の統合の基本的な機能と関数の使用方法について説明します。

**Topics**
+ [CloudWatch ロググループ](#cloudwatch-log-overview-groups)
+ [CloudWatch ログストリーム](#cloudwatch-log-overview-logstream)
+ [CloudWatch ログイベント](#cloudwatch-log-overview-logevents)
+ [CloudWatch Logs へのその他のアクセス](#cloudwatch-log-overview-additional)

## CloudWatch ロググループ
<a name="cloudwatch-log-overview-groups"></a>

`log group` は、保持、モニタリング、アクセス制御について同じ設定を共有する `log streams` のグループです。1 つのロググループに属することができるログストリーミングの数に制限はありません。

### ロググループの表示
<a name="cloudwatch-log-overview-groups-view"></a>

`View Log Groups` 機能によって CloudWatch ロググループエクスプローラーにロググループの一覧が表示されます。

View Log Groups 機能にアクセスして CloudWatch ロググループエクスプローラーを開くには、以下のステップを実行します。

1.  AWS Explorer から Amazon **Amazon CloudWatch**を展開します。

1. **[ロググループ]** をダブルクリックするか、コンテキスト (右クリック) メニューを開いて **[表示]** を選択し、**[CloudWatch ロググループエクスプローラー]** を開きます。
**注記**  
CloudWatch ロググループエクスプローラーは、ソリューションエクスプローラーと同じウィンドウの場所で開きます。

### ロググループのフィルタリング
<a name="cloudwatch-log-overview-groups-filter"></a>

個々のアカウントには、何千もの異なるロググループを含めることができます。特定のグループを簡単に検索するには、以下の `filtering` 機能を使用してください。

1. **[CloudWatch ロググループエクスプローラー]** で、ウィンドウの上部にある検索バーにカーソルを置きます。

1. 探しているロググループに関連するプレフィックスを入力し始めます。

1. **[CloudWatch ロググループエクスプローラー]** が、前のステップで指定した検索語と一致する結果を表示するように自動的に更新されます。

### ロググループの削除
<a name="cloudwatch-log-overview-groups-delete"></a>

特定のロググループを削除するには、以下の手順を参照してください。

1. **[CloudWatch ロググループエクスプローラー]** で、削除するロググループを右クリックします。

1. プロンプトが表示されたら、現在選択されているロググループを削除することを確認します。

1. **[はい]** ボタンをクリックすると、選択したロググループが削除され、**[CloudWatch ロググループエクスプローラー]** が更新されます。

### ロググループの更新
<a name="cloudwatch-log-overview-groups-refresh"></a>

**[CloudWatch ロググループエクスプローラー]** に表示されている現在のロググループのリストを更新するには、**[ツールバー]** にある **[更新]** アイコンをクリックします。

### ロググループの ARN をコピー
<a name="cloudwatch-log-overview-groups-copyarn"></a>

特定のロググループの ARN をコピーするには、以下の手順を実行します。

1. **[CloudWatch ロググループエクスプローラー]** で、ARN のコピー元のロググループを右クリックします。

1. メニューから **[ARN をコピー]** オプションを選択します。

1. ARN がローカルクリップボードにコピーされ、貼り付けできる状態になりました。

## CloudWatch ログストリーム
<a name="cloudwatch-log-overview-logstream"></a>

ログストリームは、同じソースを共有する一連のログイベントです。

**注記**  
ログストリームを表示するときは、次のプロパティについて注意してください。  
デフォルトでは、ログストリームは最新のイベントのタイムスタンプでソートされます。
ログストリームに関連する列は、列ヘッダーにある **[キャレット]** を切り替えることで、昇順または降順に並べ替えることができます。
フィルタリングされたエントリは、**[ログストリーム名]** でのみソートできます。

### ログストリームの表示
<a name="cloudwatch-log-overview-logstream-view"></a>

1. **[CloudWatch ロググループエクスプローラー]** で、ロググループをダブルクリックするか、ロググループを右クリックしてコンテキストメニューから **[ログストリームを表示]** を選択します。

1. **[ドキュメント]** ウィンドウに新しいタブが開き、ロググループに関連するログストリームのリストが表示されます。

### ログストリームのフィルタリング
<a name="cloudwatch-log-overview-logstream-filter"></a>

1. **[ドキュメント]** ウィンドウの **[ログストリーム]** タブで、検索バーにカーソルを置きます。

1. 探しているログストリームに関連するプレフィックスを入力し始めます。

1. 入力すると、現在の表示が自動的に更新され、入力によってログストリームがフィルタリングされます。

### ログストリームの更新
<a name="cloudwatch-log-overview-logstream-refresh"></a>

**[ドキュメント]** ウィンドウに表示されている現在のログストリームのリストを更新するには、**[検索バー]** の横の **[ツールバー]** にある **[更新]** アイコンをクリックします。

### ログストリームの ARN をコピー
<a name="cloudwatch-log-overview-logstream-copyarn"></a>

特定のログストリームの ARN をコピーするには、以下の手順を実行します。

1. **[ドキュメント]** ウィンドウの **[ログストリーム]** タブから、ARN のコピー元のログストリームを右クリックします。

1. メニューから **[ARN をコピー]** オプションを選択します。

1. ARN がローカルクリップボードにコピーされ、貼り付けできる状態になりました。

### ログストリームのダウンロード
<a name="cloudwatch-log-overview-logstream-delete"></a>

**[ログストリームをエクスポート]** 機能は、選択したログストリームをダウンロードしてローカルに保存し、追加の処理のためにカスタムツールやソフトウェアからアクセスできるようにします。

1. **[ドキュメント]** ウィンドウの **[ログストリーム]** タブから、ダウンロードするログストリームを右クリックします。

1. **[ログストリームをエクスポート]** を選択して、**[テキストファイルにエクスポート]** ダイアログを開きます。

1. ファイルをローカルに保存する場所を選択し、表示されるテキストフィールドで名前を指定します。

1. **[OK]** を選択してダウンロードを確定します。ダウンロードのステータスは **[Visual Studio タスクステータスセンター]** に表示されます。

## CloudWatch ログイベント
<a name="cloudwatch-log-overview-logevents"></a>

ログイベントは、CloudWatch でモニタリングされているアプリケーションまたはリソースによって記録されたアクティビティのレコードです。

### ログイベントのアクション
<a name="cloudwatch-log-overview-logevents-actions"></a>

ログイベントはテーブルとして表示されます。デフォルトでは、イベントは最も古いイベントから最新のイベントまでソートされます。

以下のアクションは Visual Studio 上のログイベントに関連付けられています。
+ ﾃキスト折り返しモード: イベントをクリックすることで、テキストの折り返しを切り替えることができます。
+ テキスト折り返しボタン: このボタンは `document window toolbar` にあり、すべてのエントリのテキスト折り返しのオン/オフを切り替えることができます。
+ メッセージをクリップボードにコピー: コピーするメッセージを選択し、選択したメッセージを右クリックして **[コピー]** (キーボードショートカット `Ctrl + C`) を選択します。

### ログイベントの表示
<a name="cloudwatch-log-overview-logevents-view"></a>

1. **[ドキュメント]** ウィンドウから、ログストリームのリストを含むタブを選択します。

1. ログストリームをダブルクリックするか、ログストリームを右クリックして、メニューから **[ログストリームを表示]** を選択します。

1. **[ドキュメント]** ウィンドウに新しい **[ログイベント]** タブが開き、選択したログストリームに関連するログイベントのテーブルが表示されます。

### ログイベントのフィルタリング
<a name="cloudwatch-log-overview-logevents-filter"></a>

ログイベントをフィルタリングする方法は、コンテンツ、時間範囲、またはその両方の 3 つあります。ログイベントをコンテンツと時間範囲の両方でフィルタリングするには、まずコンテンツまたは時間範囲のいずれかでメッセージをフィルタリングし、次にその結果をもう一方の方法でフィルタリングします。

ログイベントをコンテンツでフィルタリングするには、以下の手順を実行します。

1. **[ドキュメント]** ウィンドウの **[ログイベント]** タブから、ウィンドウ上部にある検索バーにカーソルを置きます。

1. 検索するログイベントに関連する用語または語句を入力し始めます。

1. 入力すると、現在の表示でログイベントのフィルタリングが自動的に開始されます。
**注記**  
フィルターパターンでは大文字と小文字が区別されます。英数字以外の文字を二重引用符 (\$1 "" \$1) で囲み、完全に一致する用語や語句を囲むことで、検索結果の精度を高めることができます。フィルタパターンの詳細については、「Amazon CloudWatch ガイド」の「[フィルタとパターンの構文](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/FilterAndPatternSyntax.html)」トピックを参照してください。

特定の時間範囲に生成されたログイベントを表示するには、以下の手順を実行します。

1. **[ドキュメント]** ウィンドウの **[ログイベント]** タブから、**[ツールバー]** にある **[カレンダー]** アイコンをクリックします。

1. 表示されるフィールドを使用して、検索する時間範囲を指定します。

1. フィルタリングされた結果は、日付と時刻の制約を指定すると自動的に更新されます。
**注記**  
**[フィルターをクリア]** オプションを使用すると、現在の日付と時刻のフィルター選択がすべてクリアされます。

### ログイベントの更新
<a name="cloudwatch-log-overview-logevents-refresh"></a>

**[ログイベント]** タブに表示されている現在のログイベントのリストを更新するには、**[ツールバー]** にある **[更新]** アイコンをクリックします。

## CloudWatch Logs へのその他のアクセス
<a name="cloudwatch-log-overview-additional"></a>

他の AWS サービスやリソースに関連付けられた CloudWatch Logs には、Visual Studio の AWS Toolkit から直接アクセスできます。

### Lambda
<a name="cloudwatch-log-overview-additional-lambda"></a>

Lambda 関数に関連付けられているログストリームを表示するには、以下の手順を実行します。

**注記**  
Lambda 実行ロールには、CloudWatch Logs にログを送信するための適切なアクセス許可が必要です。CloudWatch Logs に必要な Lambda のアクセス許可の詳細については、「[https://docs.aws.amazon.com/lambda/latest/dg/monitoring-cloudwatchlogs.html#monitoring-cloudwatchlogs-prereqs](https://docs.aws.amazon.com/lambda/latest/dg/monitoring-cloudwatchlogs.html#monitoring-cloudwatchlogs-prereqs)」を参照してください。

1.  AWS Toolkit Explorer から **Lambda **を展開します。

1. 表示したい関数を右クリックして **[ログを表示]** を選択すると、**[ドキュメント]** ウィンドウに関連するログストリームが表示されます。

Lambda 統合 `function view` を使用してログストリームを表示するには、以下の手順を実行します。

1.  AWS Toolkit Explorer から **Lambda **を展開します。

1. 表示したい関数を右クリックして **[関数を表示]** を選択すると、**[ドキュメント]** ウィンドウに関数ビューが表示されます。

1. `function view` から **[ログ]** タブに切り替えると、選択した Lambda 関数に関連するログストリームが表示されます。

### ECS
<a name="cloudwatch-log-overview-additional-ecs"></a>

ECS タスクコンテナに関連付けられているログリソースを表示するには、以下の手順を実行します。

**注記**  
Amazon ECS サービスが CloudWatch にログを送信するには、特定の Amazon ECS タスクの各コンテナが必要な設定を満たしていなければなりません。必要なセットアップと設定の詳細については、[AWS 「 ログドライバーを使用する](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using_awslogs.html)」ガイドを参照してください。

1.  AWS Toolkit Explorer から、**Amazon ECS** を展開します。

1. 表示する Amazon ECS クラスターを選択すると、**[ドキュメント]** ウィンドウに新しい **[ECS クラスター]** タブが開きます。

1. **[ECS クラスター]** タブの左側にあるナビゲーションメニューから **[タスク]** を選択して、クラスターに関連するすべてのタスクを一覧表示します。

1. **[タスク]** 画面からタスクを選択し、左下隅にある **[ログを表示]** のリンクをクリックします。
**注記**  
この表示には、クラスターに含まれるすべてのタスクが一覧表示されます。`View Logs` リンクは、必要なログ設定を満たす各タスクにのみ表示されます。  
タスクが 1 つのコンテナにのみ関連付けられている場合、**[ログを表示]** リンクをクリックするとそのコンテナのログストリームが開きます。
タスクが複数のコンテナに関連付けられている場合、**[ログを表示]** リンクをクリックすると **[ECS タスクの CloudWatch Logs を表示]** ダイアログが開きます。**[コンテナ]** ドロップダウンメニューから、ログを表示したいコンテナを選択し、**[OK]** を選択します。

1. **[ドキュメント]** ウィンドウに新しいタブが開き、選択したコンテナに関連するログストリームが表示されます。