기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# AWS IoT TwinMaker Grafana 대시보드에 AWS IoT SiteWise 경보 연결
**참고**
이 기능은 **공용 미리 보기** 버전으로 출시 중이기 때문에 변경될 수도 있습니다.
AWS IoT TwinMaker 는 AWS IoT SiteWise 및 이벤트 경보를 AWS IoT TwinMaker 구성 요소로 가져올 수 있습니다. 이를 통해 AWS IoT SiteWise 데이터 마이그레이션을 위한 사용자 지정 데이터 커넥터를 구현하지 않고도 경보 상태를 쿼리하고 경보 임계값을 구성할 수 있습니다. Grafana 플러그인을 사용하면 API를 AWS IoT TwinMaker 호출 AWS IoT TwinMaker 하거나 경보와 직접 상호 작용하지 않고도 Grafana에서 경보 상태를 시각화하고 AWS IoT SiteWise 경보 임계값을 구성할 수 있습니다.
**참고**
지원 종료 알림: 2026 AWS 년 5월 20일에에 대한 지원이 종료됩니다 AWS IoT Events. 2026년 5월 20일 이후에는 AWS IoT Events 콘솔 또는 AWS IoT Events 리소스에 더 이상 액세스할 수 없습니다. 자세한 내용은 [AWS IoT Events 지원 종료를 참조하세요](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-end-of-support.html).
## AWS IoT SiteWise 경보 구성 사전 조건
경보를 생성하여 Grafana 대시보드에 통합하기 전에 다음 사전 요구 사항을 검토했는지 확인하십시오.
+ AWS IoT SiteWise의 모델 및 자산 시스템을 숙지합니다. 자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [자산 모델 생성](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/create-asset-models.html) 및 [ 자산 생성을](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/create-assets.html) 참조하세요.
+ IoT Events 경보 모델과 AWS IoT SiteWise 모델에 연결하는 방법을 숙지합니다. 자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [AWS IoT 이벤트 경보 정의를 참조하세요](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/define-iot-events-alarms.html).
+ Grafana의 AWS IoT TwinMaker 리소스에 액세스할 수 있도록 Grafana AWS IoT TwinMaker 와 통합합니다. 자세한 내용은 단원을 참조하십시오[AWS IoT TwinMaker Grafana 대시보드 통합](grafana-integration.md).
## AWS IoT SiteWise 경보 구성 요소 IAM 역할 정의
AWS IoT TwinMaker 는 워크스페이스 IAM 역할을 사용하여 Grafana에서 경보 임계값을 쿼리하고 구성합니다. Grafana에서 AWS IoT SiteWise 경보와 상호 작용하려면 AWS IoT TwinMaker 워크스페이스 역할에 다음 권한이 필요합니다.
```
{
"Effect": "Allow",
"Action": [
"iotevents:DescribeAlarmModel",
],
"Resource": ["{IoTEventsAlarmModelArn}"]
},{
"Effect": "Allow",
"Action": [
"iotsitewise:BatchPutAssetPropertyValue"
],
"Resource": ["{IoTSitewiseAssetArn}"]
}
```
[AWS IoT TwinMaker 콘솔](https://console.aws.amazon.com/iottwinmaker/)에서 AWS IoT SiteWise 자산을 나타내는 개체를 생성합니다. 를 구성 요소 유형`com.amazon.iotsitewise.alarm`으로 사용하여 해당 개체에 대한 구성 요소를 추가하고 해당 자산 및 경보 모델을 선택해야 합니다.
![\[com.amazon.iotsitewise.alarm 유형의 구성 요소를 보여주는 구성 요소 추가 화면입니다.\]](http://docs.aws.amazon.com/ko_kr/iot-twinmaker/latest/guide/images/image(5).png)
위의 스크린샷은 유형으로이 개체를 생성하는 예제입니다`com.amazon.iotsitewise.alarm`.
이 구성 요소를 생성하면는 AWS IoT SiteWise 및에서 관련 경보 속성을 AWS IoT TwinMaker 자동으로 가져옵니다 AWS IoT Events. 이 경보 구성 요소 유형 패턴을 반복하여 워크스페이스에 필요한 모든 자산에 대한 경보 구성 요소를 생성할 수 있습니다.
## AWS IoT TwinMaker API를 통한 쿼리 및 업데이트
경보 구성 요소를 생성한 후 AWS IoT TwinMaker API를 통해 경보 상태, 임계값을 쿼리하고 경보 임계값을 업데이트할 수 있습니다.
아래는 경보 상태를 쿼리하기 위한 샘플 요청입니다.
```
aws iottwinmaker get-property-value-history --cli-input-json \
'{
"workspaceId": "{workspaceId}",
"entityId": "{entityId}",
"componentName": "{componentName}",
"selectedProperties": ["alarm_status"],
"startTime": "{startTimeIsoString}",
"endTime": "{endTimeIsoString}"
}'
```
아래는 경보 임계값을 쿼리하기 위한 샘플 요청입니다.
```
aws iottwinmaker get-property-value-history --cli-input-json \
'{
"workspaceId": "{workspaceId}",
"entityId": "{entityId}",
"componentName": "{componentName}",
"selectedProperties": ["alarm_threshold"],
"startTime": "{startTimeIsoString}",
"endTime": "{endTimeIsoString}"
}'
```
다음은 경보 임계값 업데이트를 위한 샘플 요청입니다.
```
aws iottwinmaker batch-put-property-values --cli-input-json \
'{
"workspaceId": "{workspaceId}",
"entries": [
{
"entityPropertyReference": {
"entityId": "{entityId}",
"componentName": "{componentName}",
"propertyName": "alarm_threshold"
},
"propertyValues": [
{
"value": {
"doubleValue": "{newThreshold}"
},
"time": "{effectiveTimeIsoString}"
}
]
}
]
}'
```
## 경보에 대한 Grafana 대시보드 구성
두 번째 쓰기 가능 대시보드 IAM 역할을 생성해야 합니다. 이는 일반적인 역할이지만 아래 예와 같이 TwinMaker 작업 영역에 작업 `iottwinmaker:BatchPutPropertyValues`을(를) 추가할 수 있는 권한이 있어야 합니다.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"iottwinmaker:Get*",
"iottwinmaker:List*",
"iottwinmaker:BatchPutPropertyValues"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket",
"arn:aws:s3:::amzn-s3-demo-bucket/*"
]
},
{
"Effect": "Allow",
"Action": "iottwinmaker:ListWorkspaces",
"Resource": "*"
}
]
}
```
------
대신에 IAM 역할 끝에 이 명령문을 추가할 수도 있습니다.
```
{
"Effect": "Allow",
"Action": [
"iottwinmaker:BatchPutPropertyValues"
],
"Resource": [
"{workspaceArn}",
"{workspaceArn}/*"
]
}
```
데이터 소스에는 생성한 대시보드 쓰기 역할과 함께 쓰기 arn이 설정되어 있어야 합니다.
IAM 역할을 수정한 후 Grafana 대시보드에 로그인하여 업데이트된 역할 ARN을 수임합니다. **경보 구성 패널의 쓰기 권한 정의** 확인란을 선택하고 쓰기 역할의 ARN에 복사합니다.
![\[확인란이 선택되고 ARN 항목 상자가 강조 표시된 Grafana 대시보드 설정 탭.\]](http://docs.aws.amazon.com/ko_kr/iot-twinmaker/latest/guide/images/alarmDataSource.png)
## 경보 시각화용 Grafana 대시보드 사용
다음 절차를 사용하여 대시보드에 경보 구성 패널을 추가하고 구성하십시오.
1. 패널 옵션에서 작업 영역을 선택합니다.
1. 쿼리 구성에서 데이터소스를 설정합니다.
1. 다음 쿼리 유형: `Get Property Value History by Entity`을(를) 사용하십시오.
1. 경보를 추가할 개체 또는 개체 변수를 선택합니다.
1. 개체를 선택한 후 속성을 적용할 구성 요소 또는 구성 요소 변수를 선택합니다.
1. 속성으로: `alarm_status` 및 `alarm_threshold`을(를) 선택합니다.
연결되면 경보 ID의 ID와 현재 임계값이 표시될 것입니다.
**참고**
공개 미리 보기의 경우 알림이 표시되지 않습니다. 경보 상태 및 임계값을 검토하여 속성이 올바르게 적용되었는지 확인해야 합니다.
1. 최신 값이 표시되도록 기본 쿼리 순서 오름차순을 사용해야 합니다.
1. 쿼리의 필터 섹션은 비워 둘 수 있습니다. 전체 구성은 아래 그림에 나와 있습니다.
![\[전체 구성이 채워진 Grafana Labs 경보 구성 테스트/편집 패널.\]](http://docs.aws.amazon.com/ko_kr/iot-twinmaker/latest/guide/images/alarmConfigPanel.png)
1. **경보 편집** 버튼을 사용하면 현재 경보 임계값을 변경하는 대화 상자를 불러올 수 있습니다.
1. **저장**을 선택하여 새 임계값을 설정합니다.
![\[취소 및 저장 버튼이 있는 경보 편집 대화 상자.\]](http://docs.aws.amazon.com/ko_kr/iot-twinmaker/latest/guide/images/alarmThresholdModal.png)
**참고**
이 패널은 현재가 포함된 실시간 시간 범위에서만 사용해야 합니다. 과거로 끝나고 시작되는 시간 범위와 함께 사용하면 경보 임계값을 항상 현재 임계값으로 편집하는 경우 예상치 못한 값이 표시될 수 있습니다.