Amazon CloudWatch Logs를 사용하여 모니터링 - AWS IoT SiteWise
로그인 관리 AWS IoT SiteWise예제: AWS IoT SiteWise log 파일 항목

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

Amazon CloudWatch Logs를 사용하여 모니터링

CloudWatch Logs에 정보를 로깅하여 서비스를 모니터링하고 문제를 해결 AWS IoT SiteWise 하도록를 구성합니다.

AWS IoT SiteWise 콘솔을 사용할 때는 서비스가 사용자를 대신하여 정보를 로깅할 수 있는 서비스 연결 역할을 AWS IoT SiteWise 생성합니다. AWS IoT SiteWise 콘솔을 사용하지 않는 경우 로그를 수신하려면 서비스 연결 역할을 수동으로 생성해야 합니다. 자세한 내용은 AWS IoT SiteWise용 서비스 연결 역할 생성 단원을 참조하십시오.

가 로그 이벤트를 CloudWatch 스트림에 넣을 AWS IoT SiteWise 수 있도록 허용하는 리소스 정책이 있어야 합니다. CloudWatch Logs에 대한 리소스 정책을 생성하고 업데이트하려면 다음 명령을 실행합니다. logging-policy-name을 생성할 정책 이름으로 대체하세요.

aws logs put-resource-policy --policy-name logging-policy-name --policy-document "{ \"Version\": \"2012-10-17\", \"Statement\": [ { \"Sid\": \"IoTSiteWiseToCloudWatchLogs\", \"Effect\": \"Allow\", \"Principal\": { \"Service\": [ \"iotsitewise.amazonaws.com\" ] }, \"Action\":\"logs:PutLogEvents\", \"Resource\": \"*\" } ] }"

CloudWatch Logs는 aws:SourceArn 및 aws:SourceAccount 조건 컨텍스트 키도 지원합니다. 이러한 조건 컨텍스트 키는 선택 사항입니다.

가 지정된 리소스와 연결된 로그 AWS IoT SiteWise 만 CloudWatch 스트림에 넣도록 허용하는 AWS IoT SiteWise 리소스 정책을 생성하거나 업데이트하려면 명령을 실행하고 다음을 수행합니다.

  • logging-policy-name을 생성할 정책 이름으로 대체하세요.

  • source-ARN을 자산 모델 또는 자산과 같은 AWS IoT SiteWise 리소스의 ARN으로 바꿉니다. 각 AWS IoT SiteWise 리소스 유형에 대한 ARN을 찾으려면 서비스 승인 참조의에서 정의한 리소스 유형을 AWS IoT SiteWise 참조하세요.

  • account-ID를 지정된 AWS IoT SiteWise 리소스와 연결된 AWS 계정 ID로 바꿉니다.

aws logs put-resource-policy --policy-name logging-policy-name --policy-document "{ \"Version\": \"2012-10-17\", \"Statement\": [ { \"Sid\": \"IoTSiteWiseToCloudWatchLogs\", \"Effect\": \"Allow\", \"Principal\": { \"Service\": [ \"iotsitewise.amazonaws.com\" ] }, \"Action\":\"logs:PutLogEvents\", \"Resource\": \"*\", \"Condition\":{\"StringLike\":{\"aws:SourceArn\":[\"source-ARN\"],\"aws:SourceAccount\":[\"account-ID\"]}}}]}"

기본적으로 AWS IoT SiteWise 는 CloudWatch Logs에 정보를 로깅하지 않습니다. 로깅을 활성화하려면 비활성화() 이외의 로깅 수준을 선택합니다OFF.는 다음 로깅 수준을 AWS IoT SiteWise 지원합니다.

  • OFF – 로깅이 해제되어 있습니다.

  • ERROR – 오류를 기록합니다.

  • INFO – 오류 및 정보 메시지를 기록합니다.

AWS IoT Greengrass를 통해 CloudWatch Logs에 정보를 기록하도록 SiteWise Edge 게이트웨이를 구성할 수 있습니다. 자세한 내용은 SiteWise Edge 게이트웨이 로그 모니터링 단원을 참조하십시오.

AWS IoT SiteWise 규칙 작업 문제를 해결하는 경우 CloudWatch Logs에 정보를 로깅 AWS IoT Core 하도록를 구성할 수도 있습니다. 자세한 내용은 AWS IoT SiteWise 규칙 작업 문제 해결 단원을 참조하십시오.

로그인 관리 AWS IoT SiteWise

다음 로깅 구성 작업에는 AWS IoT SiteWise 콘솔 또는 AWS CLI 를 사용합니다.

로깅 수준 찾기

Console

AWS IoT SiteWise 콘솔에서 현재 로깅 수준을 찾아보려면 다음 절차를 따르세요.

현재 AWS IoT SiteWise 로깅 수준을 찾으려면

  1. AWS IoT SiteWise 콘솔로 이동합니다.

  2. 왼쪽 탐색 창에서 로깅 옵션을 선택합니다.

    현재의 로깅 상태가 로깅 상태 아래에 나타납니다. 로깅을 활성화하면 현재 로깅 수준이 세부 사항 수준 아래에 나타납니다.

AWS CLI

다음 명령을 실행하여를 사용하여 현재 AWS IoT SiteWise 로깅 수준을 찾습니다 AWS CLI.

aws iotsitewise describe-logging-options

이 작업은 로깅 수준이 포함된 응답을 다음 형식으로 반환합니다.

{
  "loggingOptions": {
    "level": "String"
  }
}

로깅 수준 변경

다음 절차에 따라 AWS IoT SiteWise 콘솔에서 또는를 사용하여 로깅 수준을 변경합니다 AWS CLI.

Console
AWS IoT SiteWise 로깅 수준을 변경하려면

  1. AWS IoT SiteWise 콘솔로 이동합니다.

  2. 왼쪽 탐색 창에서 로깅 옵션을 선택합니다.

  3. 편집을 선택합니다.

  4. 활성화할 세부 사항 수준을 선택합니다.

  5. 저장(Save)을 선택합니다.

AWS CLI

다음 AWS CLI 명령을 실행하여 AWS IoT SiteWise 로깅 수준을 변경합니다. logging-level을 원하는 로깅 수준으로 바꿉니다.

aws iotsitewise put-logging-options --logging-options level=logging-level

예제: AWS IoT SiteWise log 파일 항목

각 AWS IoT SiteWise 로그 항목에는 이벤트 정보와 해당 이벤트에 대한 관련 리소스가 포함되어 있으므로 로그 데이터를 이해하고 분석할 수 있습니다.

다음 예제는 자산 모델을 성공적으로 생성할 때 AWS IoT SiteWise 로그하는 CloudWatch Logs 항목을 보여줍니다.

{
  "eventTime": "2020-05-05T00:10:22.902Z",
  "logLevel": "INFO",
  "eventType": "AssetModelCreationSuccess",
  "message": "Successfully created asset model.",
  "resources": {
    "assetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE"
  }
}