기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Visual Studio에서 CloudWatch Logs 작업
<a name="cloudwatch-log-overview"></a>

Amazon CloudWatch Logs 통합을 사용하면 Amazon Q를 사용하여 AWS Toolkit for Visual Studio에서 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`의 그룹입니다. 하나의 로그 그룹이 가질 수 있는 로그 스트림의 수는 제한이 없습니다.

### 로그 그룹 보기
<a name="cloudwatch-log-overview-groups-view"></a>

`View Log Groups` 기능은 CloudWatch 로그 그룹 탐색기에 로그 그룹 목록을 표시합니다.

로그 그룹 보기 기능에 액세스하고 CloudWatch 로그 그룹 탐색기를 열려면 다음 단계를 완료하세요.

1.  AWS 탐색기에서 **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. **확인**을 선택하여 다운로드를 확인하세요. 다운로드 상태는 **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>

로그 이벤트를 필터링하는 방법에는 내용 기준, 시간 범위 기준 또는 둘 함께 사용 등의 세 가지가 있습니다. 내용과 시간 범위를 기준으로 로그 이벤트를 필터링하려면 먼저 내용 또는 시간 범위를 기준으로 메시지를 필터링한 다음 다른 방법으로 결과를 필터링하세요.

내용 기준으로 로그 이벤트를 필터링하려면 다음을 수행하세요.

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>

Visual Studio의 AWS 도구 키트에서 직접 다른 AWS 서비스 및 리소스와 연결된 CloudWatch Logs에 액세스할 수 있습니다.

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

Lambda 함수와 연결된 로그 스트림을 보려면 다음을 수행하세요.

**참고**  
Lambda 실행 역할에는 CloudWatch Logs에 로그를 전송할 수 있는 적절한 권한이 있어야 합니다. CloudWatch Logs로 데이터를 전송하는 데 필요한 권한에 대한 자세한 정보는 [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`에서 **Logs** 탭으로 전환하면 선택한 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` 링크는 필수 로그 구성을 충족하는 각 작업에 대해서만 표시됩니다.  
작업이 단일 컨테이너에만 연결된 경우 **로그 보기** 링크를 클릭하면 해당 컨테이너의 로그 스트림이 열립니다.
작업이 여러 컨테이너와 연결된 경우 **로그 보기** 링크를 클릭하면 **ECS 작업용 CloudWatch Logs 보기** 대화 상자가 열리고 **컨테이너:** 드롭다운 메뉴를 사용하여 로그를 보려는 컨테이너를 선택한 다음 **확인**을 선택하세요.

1. **문서** 창에 컨테이너 선택과 관련된 로그 스트림을 표시하는 새 탭이 열립니다.