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

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 경보 임계값을 구성할 수 있습니다.

AWS IoT SiteWise 경보 구성 사전 조건

경보를 생성하여 Grafana 대시보드에 통합하기 전에 다음 사전 요구 사항을 검토했는지 확인하십시오.

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 콘솔에서 AWS IoT SiteWise 자산을 나타내는 개체를 생성합니다. 를 구성 요소 유형com.amazon.iotsitewise.alarm으로 사용하여 해당 개체의 구성 요소를 추가하고 해당 자산 및 경보 모델을 선택해야 합니다.

위의 스크린샷은 유형으로이 개체를 생성하는 예제입니다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": [
                "{workspaceArn}",
                "{workspaceArn}/*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": "iottwinmaker:ListWorkspaces",
            "Resource": "*"
        }
    ]
}

대신에 IAM 역할 끝에 이 명령문을 추가할 수도 있습니다.

{
    "Effect": "Allow",
    "Action": [
        "iottwinmaker:BatchPutPropertyValues"
    ],
    "Resource": [
        "{workspaceArn}",
        "{workspaceArn}/*"
    ]
}

데이터 소스에는 생성한 대시보드 쓰기 역할과 함께 쓰기 arn이 설정되어 있어야 합니다.

IAM 역할을 수정한 후 Grafana 대시보드에 로그인하여 업데이트된 역할 ARN을 수임합니다. 경보 구성 패널의 쓰기 권한 정의 확인란을 선택하고 쓰기 역할의 ARN에 복사합니다.

경보 시각화용 Grafana 대시보드 사용

다음 절차를 사용하여 대시보드에 경보 구성 패널을 추가하고 구성하십시오.