AWS App Runner 는 더 이상 신규 고객에게 공개되지 않습니다. 기존 고객은 정상적으로 서비스를 계속 이용할 수 있습니다. 자세한 내용은 [AWS App Runner 가용성 변경](https://docs.aws.amazon.com/apprunner/latest/dg/apprunner-availability-change.html)을 참조하세요.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# CloudWatch Logs로 스트리밍된 App Runner 로그 보기
Amazon CloudWatch Logs를 사용하여 다양한 AWS 서비스의 리소스가 생성하는 로그 파일을 모니터링, 저장 및 액세스할 수 있습니다. 자세한 내용은 [Amazon CloudWatch Logs 사용 설명서](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/)를 참조하세요.
AWS App Runner 는 애플리케이션 배포 및 활성 서비스의 출력을 수집하여 CloudWatch Logs로 스트리밍합니다. 다음 섹션에서는 App Runner 로그 스트림을 나열하고 App Runner 콘솔에서 보는 방법을 보여줍니다.
## App Runner 로그 그룹 및 스트림
CloudWatch Logs는 로그 데이터를 로그 그룹에 추가로 구성하는 로그 스트림에 보관합니다. *로그 스트림*은 특정 소스의 로그 이벤트 시퀀스입니다. 로그 그룹은 동일한 보존 기간, 모니터링 및 액세스 제어 설정을 공유하는 로그 스트림 그룹입니다.
App Runner는의 각 App Runner 서비스에 대해 각각 여러 로그 스트림이 있는 두 개의 CloudWatch Logs 로그 그룹을 정의합니다 AWS 계정.
### 서비스 로그
서비스 로그 그룹에는 App Runner가 App Runner 서비스를 관리하고 작업을 수행할 때 생성된 로깅 출력이 포함됩니다.
| **로그 그룹 이름** | **예제** |
| --- | --- |
| `/aws/apprunner/{{service-name}}/{{service-id}}/service` | `/aws/apprunner/python-test/ac7ec8b51ff34746bcb6654e0bcb23da/service` |
서비스 로그 그룹 내에서 App Runner는 이벤트 로그 스트림을 생성하여 App Runner 서비스의 수명 주기에서 활동을 캡처합니다. 예를 들어 애플리케이션을 시작하거나 일시 중지할 수 있습니다.
또한 App Runner는 서비스와 관련된 장기 실행 비동기 작업마다 로그 스트림을 생성합니다. 로그 스트림 이름에는 작업 유형과 특정 작업 ID가 반영됩니다.
*배포*는 작업의 한 유형입니다. 배포 로그에는 서비스를 생성하거나 애플리케이션의 새 버전을 배포할 때 App Runner가 수행하는 빌드 및 배포 단계의 로깅 출력이 포함됩니다. 배포 로그 스트림 이름은 로 시작하고 배포를 수행하는 작업의 ID로 `deployment/`끝납니다. 이 작업은 초기 애플리케이션 배포를 위한 [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html) 호출 또는 각 추가 배포를 위한 [StartDeployment](https://docs.aws.amazon.com/apprunner/latest/api/API_StartDeployment.html) 호출입니다.
배포 로그 내에서 각 로그 메시지는 접두사로 시작합니다.
+ `[AppRunner]` - App Runner가 배포 중에 생성하는 출력입니다.
+ `[Build]` - 자체 빌드 스크립트의 출력입니다.
| **로그 스트림 이름** | **예제** |
| --- | --- |
| `events` | *해당 사항 없음(고정된 이름)* |
| `{{operation-type}}/{{operation-id}}` | `deployment/c2c8eeedea164f459cf78f12a8953390` |
### 애플리케이션 로그
애플리케이션 로그 그룹에는 실행 중인 애플리케이션 코드의 출력이 포함됩니다.
| **로그 그룹 이름** | **예제** |
| --- | --- |
| `/aws/apprunner/{{service-name}}/{{service-id}}/application` | `/aws/apprunner/python-test/ac7ec8b51ff34746bcb6654e0bcb23da/application` |
애플리케이션 로그 그룹 내에서 App Runner는 애플리케이션을 실행하는 각 인스턴스(스케일링 단위)에 대한 로그 스트림을 생성합니다.
| **로그 스트림 이름** | **예제** |
| --- | --- |
| `instance/{{instance-id}}` | `instance/1a80bc9134a84699b7b3432ebeebb591` |
## 콘솔에서 App Runner 로그 보기
App Runner 콘솔에는 서비스에 대한 모든 로그의 요약이 표시되며 이를 보고 탐색하고 다운로드할 수 있습니다.
**서비스에 대한 로그를 보려면**
1. [App Runner 콘솔](https://console.aws.amazon.com/apprunner)을 열고 **리전** 목록에서를 선택합니다 AWS 리전.
1. 탐색 창에서 **서비스를** 선택한 다음 App Runner 서비스를 선택합니다.
콘솔에 서비스 **개요**와 함께 서비스 대시보드가 표시됩니다.
1. 서비스 대시보드 페이지에서 **로그** 탭을 선택합니다.
콘솔에는 몇 가지 유형의 로그가 여러 섹션에 표시됩니다.
+ **이벤트 로그** - App Runner 서비스의 수명 주기 내 활동입니다. 콘솔에 최신 이벤트가 표시됩니다.
+ **배포 로그** - App Runner 서비스에 대한 소스 리포지토리 배포입니다. 콘솔에는 각 배포에 대해 별도의 로그 스트림이 표시됩니다.
+ **애플리케이션 로그** - App Runner 서비스에 배포된 웹 애플리케이션의 출력입니다. 콘솔은 실행 중인 모든 인스턴스의 출력을 단일 로그 스트림으로 결합합니다.
1. 특정 배포를 찾으려면 검색어를 입력하여 배포 로그 목록의 범위를 좁힙니다. 테이블에 나타나는 모든 값을 검색할 수 있습니다.
1. 로그의 콘텐츠를 보려면 **전체 로그 보기**(이벤트 로그) 또는 로그 스트림 이름(배포 및 애플리케이션 로그)을 선택합니다.
1. **다운로드**를 선택하여 로그를 다운로드합니다. 배포 로그 스트림의 경우 먼저 로그 스트림을 선택합니다.
1. **CloudWatch에서 보기를** 선택하여 CloudWatch 콘솔을 열고 전체 기능을 사용하여 App Runner 서비스 로그를 탐색합니다. 배포 로그 스트림의 경우 먼저 로그 스트림을 선택합니다.
**참고**
CloudWatch 콘솔은 결합된 애플리케이션 로그 대신 특정 인스턴스의 애플리케이션 로그를 보려는 경우에 특히 유용합니다.