기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# CloudWatch Logs 활성화
Hub SDK는 포괄적인 로깅 기능을 제공합니다. 기본적으로 Hub SDK는 로컬 파일 시스템에 로그를 기록합니다. 그러나 Cloud API를 활용하여 CloudWatch Logs로 로그 스트리밍을 구성할 수 있습니다.이 로그 스트리밍은 다음을 제공합니다.
+ **디바이스 성능 모니터링**: 사전 예방적 디바이스 관리를 위해 세부 런타임 로그를 캡처합니다. 디바이스 플릿에서 고급 로그 분석 및 모니터링 활성화
+ **문제 해결**: 신속한 진단 분석을 위해 세분화된 로그 항목을 생성합니다. 심층 조사를 위해 시스템 및 애플리케이션 수준 이벤트를 기록합니다.
+ **유연한 중앙 집중식 로깅**: 직접 디바이스 액세스가 없는 원격 로그 관리. 검색 가능한 단일 리포지토리에서 여러 디바이스의 로그를 집계합니다.
## 사전 조건
+ 관리형 디바이스를 클라우드에 온보딩합니다. 세부 정보는 [허브 온보딩 설정](managedintegrations-sdk-v2-cookbook-hubsetup.md) 섹션을 참조하세요.
+ Hub 에이전트 시작 및 성공적인 초기화를 확인합니다. 세부 정보는 [관리형 통합 Hub SDK 설치 및 검증](managedintegrations-sdk-v2-cookbook-deployment.md) 섹션을 참조하세요.
**참고**
로깅 구성을 생성하려면 [PutRuntimeLogConfiguration API](https://docs.aws.amazon.com/iot-mi/latest/APIReference/API_PutRuntimeLogConfiguration.html)에서 세부 정보를 참조하세요.
**주의**
로그를 활성화하면 계층형 할당량 측정에 포함됩니다. 로그 수준을 높이면 메시지 볼륨이 증가하고 추가 비용이 발생합니다.
## Setup Hub SDK 로그 구성
API를 호출하여 런타임 로그 구성을 설정하여 허브 SDK 로그 설정을 구성합니다.
**Example 샘플 API 요청**
```
aws iot-managed-integrations put-runtime-log-configuration \
--managed-thing-id MANAGED_THING_ID \
--runtime-log-configurations LogLevel=DEBUG,UploadLog=TRUE
```
### RuntimeLogConfigurations 속성
다음 속성은 선택 사항이며 `RuntimeLogConfigurations` API에서 구성할 수 있습니다.
**LogLevel**
런타임 추적의 최소 심각도 수준을 설정합니다. 값: `DEBUG, ERROR, INFO, WARN`
기본값: `WARN` (릴리스된 빌드)
**LogFlushLevel**
로컬 스토리지로 즉시 데이터를 플러싱하기 위한 심각도 수준을 결정합니다. 값: `DEBUG, ERROR, INFO, WARN`
기본값: `DISABLED`
**LocalStoreLocation**
런타임 트레이스의 스토리지 위치를 지정합니다. 기본값: `/var/log/awsiotmi`
+ 활성 로그: `/var/log/awsiotmi/ManagedIntegrationsDeviceSdkHub.log`
+ 교체된 로그: `/var/log/awsiotmi/ManagedIntegrationsDeviceSdkHub.N.log` (N은 교체 순서를 나타냄)
**LocalStoreFileRotationMaxBytes**
현재 파일이 지정된 크기를 초과하면 파일 교체를 트리거합니다.
최적의 효율성을 위해 파일 크기를 125KB 미만으로 유지합니다. 125KB를 초과하는 값은 자동으로 제한됩니다.
**LocalStoreFileRotationMaxFiles,**
로그 데몬에서 허용되는 최대 교체 파일 수를 설정합니다.
**UploadLog**
클라우드로의 런타임 트레이스 전송을 제어합니다. 로그는 `/aws/iotmanagedintegration` CloudWatch Logs 그룹에 저장됩니다.
기본값: `false`.
**UploadPeriodMinutes**
런타임 추적 업로드 빈도를 정의합니다. 기본값: `5`
**DeleteLocalStoreAfterUpload**
업로드 후 파일 삭제를 제어합니다. 기본값: `true`
false로 설정하면 업로드된 파일의 이름이 다음과 같이 변경됩니다. `/var/log/awsiotmi/ManagedIntegrationsDeviceSdkHub.uploaded.{uploaded_timestamp}`
### 예제 로그 파일
아래 CloudWatch Logs 파일의 예를 참조하세요.
