Amazon CloudWatch 로그로 모니터링 - AWS IoT SiteWise
로그인 관리 AWS IoT SiteWise예: AWS IoT SiteWise 로그 파일 항목

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

Amazon CloudWatch 로그로 모니터링

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

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

로그 이벤트를 AWS IoT SiteWise 스트림에 넣을 수 있는 리소스 정책이 있어야 합니다 CloudWatch . CloudWatch 로그에 대한 리소스 정책을 만들고 업데이트하려면 다음 명령을 실행합니다. Replace 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 로그는 aws: SourceArn 및 aws: SourceAccount 조건 컨텍스트 키도 지원합니다. 이러한 조건 컨텍스트 키는 선택 사항입니다.

지정된 리소스와 관련된 로그만 AWS IoT SiteWise CloudWatch 스트림에 넣을 수 있는 AWS IoT SiteWise 리소스 정책을 만들거나 업데이트하려면 명령을 실행하고 다음을 수행하십시오.

  • Replace logging-policy-name 생성할 정책의 이름을 포함합니다.

  • Replace source-ARN AWS IoT SiteWise 리소스 (ARN예: 자산 모델 또는 자산) 와 함께 각 AWS IoT SiteWise 리소스 유형에 ARN 대한 정보를 찾으려면 서비스 권한 부여 AWS IoT SiteWise참조에 정의된 리소스 유형을 참조하십시오.

  • Replace 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\"]}}}]}"

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

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

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

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

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

AWS IoT SiteWise 규칙 동작의 문제를 해결하는 경우 CloudWatch 로그에 정보를 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 로깅 수준을 변경합니다. Replace logging-level 원하는 로깅 수준으로.

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

예: AWS IoT SiteWise 로그 파일 항목

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

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

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