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

AWS IoT SiteWiseAWS IoT TwinMaker Grafana 대시보드에 알람 연결

AWS IoT TwinMaker 구성 요소로 이벤트 AWS IoT SiteWise 알람을 가져올 수 있습니다. AWS IoT TwinMaker 이를 통해 데이터 마이그레이션을 위한 AWS IoT SiteWise 사용자 지정 데이터 커넥터를 구현하지 않고도 경보 상태를 쿼리하고 경보 임계값을 구성할 수 있습니다. AWS IoT TwinMaker Grafana 플러그인을 사용하면 API를 호출하거나 경보와 직접 상호 작용하지 않고도 Grafana에서 경보 상태를 시각화하고 경보 임계값을 구성할 수 있습니다. AWS IoT TwinMaker AWS IoT SiteWise

AWS IoT SiteWise 알람 구성 사전 요구 사항

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

알람 구성 요소 IAM 역할을 정의합니다. AWS IoT SiteWise

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 workspace arn에 작업을 iottwinmaker:BatchPutPropertyValues 추가할 수 있는 권한이 있어야 합니다.

{
    "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 대시보드 사용

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