CloudWatch Logs 활성화

Hub SDK는 포괄적인 로깅 기능을 제공합니다. 기본적으로 Hub SDK는 로컬 파일 시스템에 로그를 기록합니다. 그러나 클라우드 API를 활용하여 CloudWatch Logs로 로그 스트리밍을 구성할 수 있습니다.이 로그 스트리밍은 다음을 제공합니다.

• 디바이스 성능 모니터링: 사전 예방적 디바이스 관리를 위해 세부 런타임 로그를 캡처합니다. 디바이스 플릿에서 고급 로그 분석 및 모니터링 활성화

• 문제 해결: 신속한 진단 분석을 위해 세분화된 로그 항목을 생성합니다. 심층 조사를 위해 시스템 및 애플리케이션 수준 이벤트를 기록합니다.

• 유연한 중앙 집중식 로깅: 직접 디바이스 액세스가 없는 원격 로그 관리. 검색 가능한 단일 리포지토리에서 여러 디바이스의 로그를 집계합니다.

사전 조건

• 관리형 디바이스를 클라우드에 온보딩합니다. 세부 정보는 허브 온보딩 설정 섹션을 참조하세요.

• Hub 에이전트 시작 및 성공적인 초기화를 확인합니다. 세부 정보는 관리형 통합 Hub SDK 설치 및 검증 섹션을 참조하세요.

참고

로깅 구성을 생성하려면 PutRuntimeLogConfiguration API에서 세부 정보를 참조하세요.

주의

로그를 활성화하면 계층형 할당량 측정에 포함됩니다. 로그 수준을 높이면 메시지 볼륨이 증가하고 추가 비용이 발생합니다.

Setup Hub SDK 로그 구성

API를 호출하여 런타임 로그 구성을 설정하여 허브 SDK 로그 설정을 구성합니다.

예 샘플 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 파일의 예를 참조하세요.