기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon CloudWatch Logs를 사용하여 모니터링
CloudWatch Logs에 정보를 기록 AWS IoT SiteWise 하도록를 구성하여 서비스를 모니터링하고 문제를 해결합니다.
AWS IoT SiteWise 콘솔을 사용할 때는 서비스가 사용자를 대신하여 정보를 로깅할 수 있도록 서비스 연결 역할을 AWS IoT SiteWise 생성합니다. AWS IoT SiteWise 콘솔을 사용하지 않는 경우 로그를 수신하려면 서비스 연결 역할을 수동으로 생성해야 합니다. 자세한 내용은 [에 대한 서비스 연결 역할 생성 AWS IoT SiteWise](create-service-linked-role.md) 단원을 참조하십시오.
가 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-sourcearn) 및 [aws:SourceAccount](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-ke-sourceaccount) 조건 컨텍스트 키도 지원합니다. 이러한 조건 컨텍스트 키는 선택 사항입니다.
가 지정된 리소스와 연결된 로그 AWS IoT SiteWise 만 CloudWatch 스트림에 넣도록 허용하는 AWS IoT SiteWise 리소스 정책을 생성하거나 업데이트하려면 명령을 실행하고 다음을 수행합니다.
+ *logging-policy-name*을 생성할 정책 이름으로 대체하세요.
+ *source-ARN*을 자산 모델 또는 자산과 같은 AWS IoT SiteWise 리소스의 ARN으로 바꿉니다. 각 AWS IoT SiteWise 리소스 유형에 대한 ARN을 찾으려면 *서비스 승인* 참조의에서 [정의한 리소스 유형을 AWS IoT SiteWise](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiotsitewise.html#awsiotsitewise-resources-for-iam-policies) 참조하세요.
+ *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 게이트웨이 로그 모니터링](monitor-gateway-logs.md) 단원을 참조하십시오.
AWS IoT SiteWise 규칙 작업의 문제를 해결하는 경우 CloudWatch Logs에 정보를 AWS IoT Core 로깅하도록를 구성할 수도 있습니다. 자세한 내용은 [AWS IoT SiteWise 규칙 작업 문제 해결](troubleshoot-rule.md) 단원을 참조하십시오.
**Contents**
+ [로그인 관리 AWS IoT SiteWise](#manage-cloudwatch-logs)
+ [로깅 수준 찾기](#find-logging-level)
+ [로깅 수준 변경](#change-logging-level)
+ [예: AWS IoT SiteWise 로그 파일 항목](#sitewise-log-format)
## 로그인 관리 AWS IoT SiteWise
다음 로깅 구성 작업에는 AWS IoT SiteWise 콘솔 또는 AWS CLI 를 사용합니다.
### 로깅 수준 찾기
------
#### [ Console ]
AWS IoT SiteWise 콘솔에서 현재 로깅 수준을 찾아보려면 다음 절차를 따르세요.
**현재 AWS IoT SiteWise 로깅 수준을 찾으려면**
1. [AWS IoT SiteWise 콘솔](https://console.aws.amazon.com/iotsitewise/)로 이동합니다.
1. 왼쪽 탐색 창에서 **로깅 옵션**을 선택합니다.
현재의 로깅 상태가 **로깅 상태** 아래에 나타납니다. 로깅을 활성화하면 현재 로깅 수준이 **세부 사항 수준** 아래에 나타납니다.
------
#### [ 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 콘솔](https://console.aws.amazon.com/iotsitewise/)로 이동합니다.
1. 왼쪽 탐색 창에서 **로깅 옵션**을 선택합니다.
1. **편집**을 선택합니다.
1. 활성화할 **세부 사항 수준**을 선택합니다.
1. **저장(Save)**을 선택합니다.
------
#### [ AWS CLI ]
다음 AWS CLI 명령을 실행하여 AWS IoT SiteWise 로깅 수준을 변경합니다. *logging-level*을 원하는 로깅 수준으로 바꿉니다.
```
aws iotsitewise put-logging-options --logging-options level=logging-level
```
------
## 예: AWS IoT SiteWise 로그 파일 항목
각 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"
}
}
```