경보를 정의합니다. AWS IoT Events

자산 모델에 대한 AWS IoT Events 경보를 정의하려면

1. AWS IoT SiteWise 콘솔로 이동합니다.

2. 탐색 창에서 모델을 선택합니다.

3. 경보를 정의할 자산 모델을 선택합니다.

4. 경보 탭을 선택합니다.

5. 경보 추가를 선택합니다.

6. 경보 유형 옵션 섹션에서 AWS IoT Events 경보를 선택합니다.

7. 경보 세부 정보 섹션에서 다음을 수행합니다.

   1. 경보의 이름을 입력합니다.

   2. (선택 사항) 경보에 대한 설명을 입력합니다.

8. 임계값 정의 섹션에서는 경보가 탐지되는 시기와 경보의 심각도를 정의합니다. 다음을 따릅니다.

   1. 경보가 탐지되는 속성을 선택합니다. 이 속성이 새 값을 수신할 때마다 값을 에 AWS IoT SiteWise AWS IoT Events 전송하여 경보 상태를 평가합니다.

   2. 속성을 임계값과 비교하는 데 사용할 연산자를 선택합니다. 다음 옵션 중 하나를 선택합니다.

      • < 미만

      • <= 이하

      • == 같음

      • != 같지 않음

      • >= 이상

      • > 초과

   3. [Value] 에서 임계값으로 사용할 속성 속성을 선택합니다. AWS IoT Events 속성 값을 이 속성의 값과 비교합니다.

   4. 경보의 심각도를 입력합니다. 팀에서 이해할 수 있는 숫자를 사용하여 이 경보의 심각도를 반영합니다.

9. (선택 사항) 알림 설정 - 선택 사항 섹션에서 다음을 수행합니다.

   1. 활성화를 선택합니다.

      참고

      비활성을 선택하면 사용자와 팀이 경보 알림을 받지 않게 됩니다.

   2. 수신자에서 수신자를 선택합니다.

      중요

      AWS IAM Identity Center 사용자에게 알람 알림을 보낼 수 있습니다. 이 기능을 사용하려면 IAM Identity Center를 활성화해야 합니다. IAMID 센터는 한 번에 한 AWS 지역에서만 활성화할 수 있습니다. 즉, IAM Identity Center를 활성화한 지역에서만 알람 알림을 정의할 수 있습니다. 자세한 내용은AWS IAM Identity Center 사용 설명서에서 시작하기를 참조하세요.

   3. 프로토콜에서 다음 옵션 중에 선택합니다.

      • 이메일 및 문자 메시지 — 경보는 IAM Identity Center 사용자에게 SMS 메시지와 이메일 메시지로 알립니다.

      • 이메일 - 경보는 IAM Identity Center 사용자에게 이메일 메시지를 통해 알립니다.

      • 텍스트 — 경보는 IAM Identity Center 사용자에게 메시지를 통해 알립니다. SMS

   4. 발신자에서 발신자를 선택합니다.

      중요

      Amazon 심플 이메일 서비스 (AmazonSES) 에서 발신자 이메일 주소를 확인해야 합니다. 자세한 내용은 Amazon Simple 이메일 서비스 개발자 안내서의 이메일 주소 ID 확인을 참조하십시오.

10. 기본 자산 상태 섹션에서 이 자산 모델에서 생성된 경보의 기본 상태를 설정할 수 있습니다.

    참고

    이후 단계에서 이 자산 모델에서 생성한 자산에 대해 이 경보를 활성화하거나 비활성화합니다.

11. 고급 설정 섹션에서 권한, 추가 알림 설정, 경보 상태 조치, SiteWise 모니터의 경보 모델 및 승인 흐름을 구성할 수 있습니다.

    참고

    AWS IoT Events 알람에는 다음과 같은 서비스 역할이 필요합니다.

    • 경보 상태 값을 AWS IoT Events 전송하는 역할을 위임합니다. AWS IoT SiteWise

    • Lambda로 데이터를 전송하는 것으로 AWS IoT Events 가정하는 역할입니다. 경보가 알림을 보내는 경우에만 이 역할이 필요합니다.

    권한 섹션에서 다음을 수행합니다.

    1. AWS IoT Events 역할의 경우 기존 역할을 사용하거나 필요한 권한이 있는 역할을 생성합니다. 이 역할에는 iotevents.amazonaws.com가 역할을 맡을 수 있도록 허용하는 iotsitewise:BatchPutAssetPropertyValue 권한과 신뢰 관계가 필요합니다.

    2. AWS IoT Events Lambda 역할의 경우 기존 역할을 사용하거나 필요한 권한이 있는 역할을 생성합니다. 이 역할에는 iotevents.amazonaws.com가 역할을 맡을 수 있도록 허용하는 lambda:InvokeFunction 및 sso-directory:DescribeUser 권한과 신뢰 관계가 필요합니다.

12. (선택 사항) 추가 알림 설정 섹션에서 다음을 수행합니다.

    1. 수신자 속성(attribute)에서 알림 수신자를 지정하는 값을 가진 속성(attribute)을 정의합니다. IAMIdentity Center 사용자를 수신자로 선택할 수 있습니다.

       속성(attribute)을 생성하거나 자산 모델에서 기존 속성(attribute)을 사용할 수 있습니다.

       • 새 수신자 속성(attribute) 생성을 선택하는 경우 속성(attribute)에 대해 수신자 속성(attribute) 이름과 수신자 기본값 - 선택 사항을 지정합니다.

       • 기존 수신자 속성(attribute) 사용을 선택한 경우 수신자 속성(attribute) 이름에서 속성(attribute)을 선택합니다. 경보는 사용자가 선택한 속성(attribute) 기본값을 사용합니다.

       이 자산 모델에서 만든 각 자산의 기본값을 재정의할 수 있습니다.

    2. 사용자 지정 메시지 속성(attribute)의 경우 기본 상태 변경 메시지 외에 전송할 사용자 지정 메시지를 지정하는 값을 가진 속성(attribute)을 정의합니다. 예를 들어 팀이 이 경보를 해결하는 방법을 이해하는 데 도움이 되는 메시지를 지정할 수 있습니다.

       속성(attribute)을 생성하거나 자산 모델에서 기존 속성(attribute)을 사용하도록 선택할 수 있습니다.

       • 새 사용자 지정 메시지 속성(attribute) 생성을 선택한 경우 속성(attribute)에 대해 사용자 지정 메시지 속성(attribute) 이름과 사용자 지정 메시지 기본값 - 선택 사항을 지정합니다.

       • 기존 사용자 지정 메시지 속성(attribute) 사용을 선택한 경우 사용자 지정 메시지 속성(attribute) 이름에서 속성(attribute)을 선택합니다. 경보는 사용자가 선택한 속성(attribute) 기본값을 사용합니다.

       이 자산 모델에서 만든 각 자산의 기본값을 재정의할 수 있습니다.

    3. Lambda 함수 관리에서 다음 중 하나를 수행합니다.

       • 새 Lambda 함수를 AWS IoT SiteWise 생성하려면 관리형 템플릿에서 새 Lambda 생성을 선택합니다. AWS

       • 기존 Lambda 함수를 사용하려면 기존 Lambda 사용을 선택하고 함수 이름을 선택합니다.

       자세한 정보는 AWS IoT Events  개발자 안내서의 경보 알림 관리를 참조하세요.

13. (선택 사항) 상태 작업 설정 섹션에서 다음을 수행합니다.

    1. 작업 편집을 선택합니다.

    2. 경보 상태 작업 추가에서 작업을 추가한 다음 저장을 선택합니다.

       최대 10개의 작업을 추가할 수 있습니다.

    AWS IoT Events 경보가 활성 상태일 때 작업을 수행할 수 있습니다. 내장 액션을 정의하여 타이머를 사용하거나 변수를 설정하거나 데이터를 다른 AWS 리소스로 보낼 수 있습니다. 자세한 정보는 AWS IoT Events 개발자 안내서의 지원되는 작업을 참조하세요.

14. (선택 사항) SiteWise 모니터의 알람 모델 관리 - 선택 사항에서 활성 또는 비활성을 선택합니다.

    이 옵션을 사용하면 SiteWise Monitorss에서 알람 모델을 업데이트할 수 있습니다. 이 옵션은 기본적으로 활성화되어 있습니다.

15. 확인 흐름에서 활성 또는 비활성을 선택합니다. 확인 흐름에 대한 자세한 내용은 경보 상태 섹션을 참조합니다.

16. 경보 추가를 선택합니다.

    참고

    AWS IoT SiteWise 콘솔은 자산 모델에 경보를 추가하도록 여러 번 API 요청합니다. Add alarm (알람 추가) 를 선택하면 콘솔에서 이러한 API 요청의 진행 상황을 보여주는 대화 상자가 열립니다. 각 API 요청이 성공하거나 API 요청이 실패할 때까지 이 페이지에 머무르십시오. 요청이 실패하면 대화 상자를 닫고 문제를 해결한 다음 경보 추가를 선택하여 다시 시도합니다.

자산 모델에 대한 AWS IoT Events 경보를 정의하려면

1. AWS IoT Events 콘솔로 이동합니다.

2. 탐색 창에서 경보 모델을 선택합니다.

3. 경보 모델 생성을 선택하세요.

4. 경보의 이름을 입력합니다.

5. (선택 사항) 경보에 대한 설명을 입력합니다.

6. 경보 대상 섹션에서 다음을 수행합니다.

   1. 대상 옵션에서 AWS IoT SiteWise 자산 속성을 선택합니다.

   2. 경보를 추가하고자 하는 자산 모델을 선택합니다.

7. 임계값 정의 섹션에서는 경보가 탐지되는 시기와 경보의 심각도를 정의합니다. 다음을 따릅니다.

   1. 경보가 탐지되는 속성을 선택합니다. 이 속성이 새 값을 수신할 때마다 값을 에 AWS IoT SiteWise AWS IoT Events 전송하여 경보 상태를 평가합니다.

   2. 속성을 임계값과 비교하는 데 사용할 연산자를 선택합니다. 다음 옵션 중 하나를 선택합니다.

      • < 미만

      • <= 이하

      • == 같음

      • != 같지 않음

      • >= 이상

      • > 초과

   3. [Value] 에서 임계값으로 사용할 속성 속성을 선택합니다. AWS IoT Events 속성 값을 이 속성의 값과 비교합니다.

   4. 경보의 심각도를 입력합니다. 팀에서 이해할 수 있는 숫자를 사용하여 이 경보의 심각도를 반영합니다.

8. (선택 사항) 알림 설정 - 선택 사항 섹션에서 다음을 수행합니다.

   1. 프로토콜에서 다음 옵션 중에 선택합니다.

      • 이메일 및 텍스트 — 경보는 IAM Identity Center 사용자에게 SMS 메시지와 이메일 메시지를 알립니다.

      • 이메일 - 경보는 IAM Identity Center 사용자에게 이메일 메시지를 통해 알립니다.

      • 텍스트 — 경보는 IAM Identity Center 사용자에게 메시지를 통해 알립니다. SMS

   2. 발신자에서 발신자를 선택합니다.

      중요

      Amazon 심플 이메일 서비스 (AmazonSES) 에서 발신자 이메일 주소를 확인해야 합니다. 자세한 내용은 Amazon SES Simple 이메일 서비스 개발자 안내서의 Amazon에서 이메일 주소 확인을 참조하십시오.

   3. 수신자 속성(attribute) - 선택 사항에서 속성(attribute)을 선택합니다. 경보는 사용자가 선택한 속성(attribute) 기본값을 사용합니다.

   4. 사용자 지정 메시지 속성(attribute) - 선택 사항에서 속성(attribute)을 선택합니다. 경보는 사용자가 선택한 속성(attribute) 기본값을 사용합니다.

9. 인스턴스 섹션에서 이 경보의 기본 상태를 지정합니다. 이후 단계에서 이 자산 모델에서 생성한 모든 자산에 대해 이 경보를 활성화하거나 비활성화할 수 있습니다.

10. 고급 설정 설정에서 권한, 추가 알림 설정, 경보 상태 조치, SiteWise 모니터의 경보 모델 및 승인 흐름을 구성할 수 있습니다.

    참고

    AWS IoT Events 알람에는 다음과 같은 서비스 역할이 필요합니다.

    • 경보 상태 값을 AWS IoT Events 전송하는 역할을 위임합니다. AWS IoT SiteWise

    • Lambda로 데이터를 전송하는 것으로 AWS IoT Events 가정하는 역할입니다. 경보가 알림을 보내는 경우에만 이 역할이 필요합니다.

    1. 확인 흐름 섹션에서 활성화됨 또는 비활성화됨을 선택합니다. 확인 흐름에 대한 자세한 내용은 경보 상태 섹션을 참조합니다.

    2. 권한 섹션에서 다음을 수행합니다.

       1. AWS IoT Events 역할의 경우 기존 역할을 사용하거나 필요한 권한이 있는 역할을 생성합니다. 이 역할에는 iotevents.amazonaws.com가 역할을 맡을 수 있도록 허용하는 iotsitewise:BatchPutAssetPropertyValue 권한과 신뢰 관계가 필요합니다.

       2. Lambda 역할의 경우 기존 역할을 사용하거나 필요한 권한이 있는 역할을 생성합니다. 이 역할에는 iotevents.amazonaws.com가 역할을 맡을 수 있도록 허용하는 lambda:InvokeFunction 및 sso-directory:DescribeUser 권한과 신뢰 관계가 필요합니다.

    3. (선택 사항) 추가 알림 설정 창에서 다음을 수행합니다.

       1. (Lambda 함수 관리에 대해 다음 중 하나를 수행합니다.

          • 새 Lambda 함수를 AWS IoT Events 생성하려면 새 Lambda 함수 생성을 선택하십시오.

          • 기존 Lambda 함수를 사용하려면 기존 Lambda 함수 사용을 선택하고 함수 이름을 선택합니다.

          자세한 정보는 AWS IoT Events  개발자 안내서의 경보 알림 관리를 참조하세요.

    4. (선택 사항) 상태 작업 설정 - 선택 사항 섹션에서 다음을 수행합니다.

       1. 경보 상태 작업업에서 작업을 추가하고 저장을 선택합니다.

          최대 10개의 작업을 추가할 수 있습니다.

       AWS IoT Events 경보가 활성 상태일 때 작업을 수행할 수 있습니다. 내장 액션을 정의하여 타이머를 사용하거나 변수를 설정하거나 데이터를 다른 AWS 리소스로 보낼 수 있습니다. 자세한 정보는 AWS IoT Events 개발자 안내서의 지원되는 작업을 참조하세요.

11. 생성(Create)을 선택합니다.

    참고

    AWS IoT Events 콘솔은 에셋 모델에 경보를 추가하기 위해 여러 API 요청을 보냅니다. Add alarm (알람 추가) 를 선택하면 콘솔에서 이러한 API 요청의 진행 상황을 보여주는 대화 상자가 열립니다. 각 API 요청이 성공하거나 API 요청이 실패할 때까지 이 페이지에 머무르십시오. 요청이 실패하면 대화 상자를 닫고 문제를 해결한 다음 경보 추가를 선택하여 다시 시도합니다.

자산 모델에서 경보를 정의하려면 (CLI)

1. asset-model-payload.json이라는 파일을 생성합니다. 다른 섹션의 단계에 따라 자산 모델의 세부 정보를 파일에 추가하되, 자산 모델을 만들거나 업데이트하라는 요청을 제출하지 마세요. 이 섹션에서는 asset-model-payload.json 파일의 자산 모델 세부 정보에 경보 정의를 추가합니다.

   • 자산 모델을 만드는 방법에 대한 자세한 내용은 자산 모델 생성 (AWS CLI)을 참조하세요.

   • 기존 자산 모델을 업데이트하는 방법에 대한 자세한 내용은 에셋 또는 컴포넌트 모델 업데이트 ()AWS CLI 섹션을 참조합니다.

   참고

   자산 모델은 경보로 모니터링할 자산 속성을 포함하여 하나 이상의 자산 속성을 정의해야 합니다.

2. 경보 복합 모델(assetModelCompositeModels)을 자산 모델에 추가합니다. AWS IoT Events 알람 복합 모델은 IOT_EVENTS 유형을 지정하고 알람 소스 속성을 지정합니다. 에서 알람 모델을 생성한 후 알람 소스 속성을 추가합니다 AWS IoT Events.

   중요

   알람 복합 모델은 나중에 생성하는 AWS IoT Events 알람 모델과 이름이 같아야 합니다. 경보 모델 이름에는 영숫자만 사용할 수 있습니다. 경보 모델에 동일한 이름을 사용할 수 있도록 고유한 영숫자 이름을 지정합니다.

   {
     ...
     "assetModelCompositeModels": [
       {
         "name": "BoilerTemperatureHighAlarm",
         "type": "AWS/ALARM",
         "properties": [
           {
             "name": "AWS/ALARM_TYPE",
             "dataType": "STRING",
             "type": {
               "attribute": {
                 "defaultValue": "IOT_EVENTS"
               }
             }
           },
           {
             "name": "AWS/ALARM_STATE",
             "dataType": "STRUCT",
             "dataTypeSpec": "AWS/ALARM_STATE",
             "type": {
               "measurement": {}
             }
           }
         ]
       }
     ]
   }

3. 자산 모델에 경보 임계값 속성(attribute)을 추가합니다. 이 임계값에 사용할 기본값을 지정합니다. 이 모델을 기반으로 각 자산에서 이 기본값을 재정의할 수 있습니다.

   참고

   경보 임계값 속성(attribute)은 INTEGER 또는 DOUBLE여야 합니다.

   {
     ...
     "assetModelProperties": [
       ...
       {
         "name": "Temperature Max Threshold",
         "dataType": "DOUBLE",
         "type": {
           "attribute": {
             "defaultValue": "105.0"
           }
         }
       }
     ]
   }

4. (선택 사항) 자산 모델에 경보 알림 속성(attribute)을 추가합니다. 이러한 속성은 경보 상태가 변경될 때 알림을 보내는 데 AWS IoT Events 사용하는 IAM Identity Center 수신자 및 기타 입력을 지정합니다. 이 모델을 기반으로 각 자산에서 이러한 기본값을 재정의할 수 있습니다.

   중요

   AWS IAM Identity Center 사용자에게 경보 알림을 보낼 수 있습니다. 이 기능을 사용하려면 IAM Identity Center를 활성화해야 합니다. IAMID 센터는 한 번에 한 AWS 지역에서만 활성화할 수 있습니다. 즉, IAM Identity Center를 활성화한 지역에서만 알람 알림을 정의할 수 있습니다. 자세한 내용은AWS IAM Identity Center 사용 설명서에서 시작하기를 참조하세요.

   다음을 따릅니다.

   1. ID 센터 IAM ID 저장소의 ID를 지정하는 속성을 추가하십시오. IAMID 센터 ListInstancesAPI작업을 사용하여 ID 저장소를 나열할 수 있습니다. 이 작업은 IAM ID 센터를 활성화한 지역에서만 작동합니다.

      aws sso-admin list-instances

      그런 다음 아이덴티티 스토어 ID(예:d-123EXAMPLE)를 속성(attribute)의 기본값으로 지정합니다.

      {
        ...
        "assetModelProperties": [
          ...
          {
            "name": "identityStoreId",
            "dataType": "STRING",
            "type": {
              "attribute": {
                "defaultValue": "d-123EXAMPLE"
              }
            }
          }
        ]
      }

   2. 알림을 받는 IAM Identity Center 사용자의 ID를 지정하는 속성을 추가합니다. 기본 알림 수신자를 정의하려면 IAM Identity Center 사용자 ID를 기본값으로 추가합니다. IAMIdentity Center 사용자 ID를 가져오려면 다음 중 하나를 수행하십시오.

      1. IAMID 센터를 ListUsersAPI사용하여 사용자 이름을 알고 있는 사용자의 ID를 가져올 수 있습니다. Replace d-123EXAMPLE ID 저장소의 ID로 바꾸고 바꾸십시오.Name 사용자의 사용자 이름으로

         aws identitystore list-users \
           --identity-store-id d-123EXAMPLE \
           --filters AttributePath=UserName,AttributeValue=Name

      2. IAMIdentity Center 콘솔을 사용하여 사용자를 검색하고 사용자 ID를 찾을 수 있습니다.

      그런 다음 사용자 ID(예: 123EXAMPLE-a1b2c3d4-5678-90ab-cdef-33333EXAMPLE)를 속성(attribute)의 기본값으로 지정하거나 기본값 없이 속성(attribute)을 정의합니다.

      {
        ...
        "assetModelProperties": [
          ...
          {
            "name": "userId",
            "dataType": "STRING",
            "type": {
              "attribute": {
                "defaultValue": "123EXAMPLE-a1b2c3d4-5678-90ab-cdef-33333EXAMPLE"
              }
            }
          }
        ]
      }

   3. (선택 사항) SMS (텍스트) 메시지 알림의 기본 발신자 ID를 지정하는 속성을 추가합니다. 발신자 ID는 Amazon 심플 알림 서비스 SNS (Amazon) 가 보내는 메시지의 발신자로 표시됩니다. 자세한 내용은 Amazon SNS 단순 알림 서비스 개발자 안내서의 IDs 발신자에게 Amazon과의 SMS 메시지 요청을 참조하십시오.

      {
        ...
        "assetModelProperties": [
          ...
          {
            "name": "senderId",
            "dataType": "STRING",
            "type": {
              "attribute": {
                "defaultValue": "MyFactory"
              }
            }
          }
        ]
      }

   4. (선택 사항) 이메일 알림에서 발신 주소로 사용할 기본 이메일 주소를 지정하는 속성(attribute)을 추가합니다.

      {
        ...
        "assetModelProperties": [
          ...
          {
            "name": "fromAddress",
            "dataType": "STRING",
            "type": {
              "attribute": {
                "defaultValue": "my.factory@example.com"
              }
            }
          }
        ]
      }

   5. (선택 사항) 이메일 알림에 사용할 기본 제목을 지정하는 속성(attribute)을 추가합니다.

      {
        ...
        "assetModelProperties": [
          ...
          {
            "name": "emailSubject",
            "dataType": "STRING",
            "type": {
              "attribute": {
                "defaultValue": "[ALERT] High boiler temperature"
              }
            }
          }
        ]
      }

   6. (선택 사항) 알림에 포함할 추가 메시지를 지정하는 속성(attribute)을 추가합니다. 기본적으로 알림 메시지에는 경보에 대한 정보가 포함됩니다. 사용자에게 자세한 정보를 제공하는 추가 메시지를 포함할 수도 있습니다.

      {
        ...
        "assetModelProperties": [
          ...
          {
            "name": "additionalMessage",
            "dataType": "STRING",
            "type": {
              "attribute": {
                "defaultValue": "Turn off the power before you check the alarm."
              }
            }
          }
        ]
      }

5. 자산 모델을 만들거나 기존 자산 모델을 업데이트합니다. 다음 중 하나를 수행합니다.

   • 다음 명령을 실행하여 자산 모델을 생성합니다.

     aws iotsitewise create-asset-model --cli-input-json file://asset-model-payload.json

   • 다음 명령을 실행하여 기존 자산 모델을 업데이트합니다. Replace asset-model-id 자산 모델의 ID와 함께.

     aws iotsitewise update-asset-model \
       --asset-model-id asset-model-id \
       --cli-input-json file://asset-model-payload.json

   명령을 실행한 후 응답에서 assetModelId를 기록합니다.

AWS IoT Events 알람 모델을 만들려면 (CLI)

1. 에서 AWS IoT Events알람 모델을 생성할 때는 다음을 포함하여 알람이 사용하는 각 속성의 ID를 지정해야 합니다.

   • 복합 자산 모델의 경보 상태 속성

   • 경보가 모니터링하는 속성

   • 임계값 속성(attribute)

   • (선택 사항) IAM ID 센터 ID 저장소 ID 속성

   • (선택 사항) IAM ID 센터 사용자 ID 속성

   • (선택 사항) SMS 발신자 ID 속성

   • (선택 사항) 이메일 발신 주소 속성(attribute)

   • (선택 사항) 이메일 제목 속성(attribute)

   • (선택 사항) 추가 메시지 속성(attribute)

   다음 명령을 실행하여 자산 모델에서 이러한 속성을 검색합니다. IDs Replace asset-model-id 이전 단계의 자산 모델 ID를 사용합니다.

   aws iotsitewise describe-asset-model --asset-model-id asset-model-id

   이 작업은 자산 모델의 세부 사항이 포함된 응답을 반환합니다. 경보가 사용하는 각 속성의 ID를 기록해 둡니다. 다음 단계에서 AWS IoT Events 알람 모델을 만들 IDs 때 이를 사용합니다.

2. 에서 알람 모델을 생성합니다 AWS IoT Events. 다음을 따릅니다.

   1. alarm-model-payload.json이라는 파일을 생성합니다.

   2. 다음 JSON 객체를 파일에 복사합니다.

   3. 경보의 이름(alarmModelName), 설명(alarmModelDescription), 그리고 심각도(severity)를 입력합니다. 심각도에서는 회사의 심각도 수준을 반영하는 정수를 지정합니다.

      중요

      경보 모델은 이전에 자산 모델에서 정의한 경보 복합 모델과 이름이 같아야 합니다.

      경보 모델 이름에는 영숫자만 사용할 수 있습니다.

      {
        "alarmModelName": "BoilerTemperatureHighAlarm",
        "alarmModelDescription": "Detects when the boiler temperature is high.",
        "severity": 3
      }

   4. 비교 규칙(alarmRule)을 경보에 추가합니다. 이 규칙은 모니터링할 속성(inputProperty), 비교할 임계값(threshold), 사용할 비교 연산자(comparisonOperator)를 정의합니다.

      • Replace assetModelId 에셋 모델의 ID와 함께.

      • Replace alarmPropertyId 알람이 모니터링하는 속성의 ID와 함께

      • Replace thresholdAttributeId 임계값 속성 속성의 ID와 함께

      • Replace GREATER 속성 값을 임계값과 비교하는 데 사용할 연산자를 사용합니다. 다음 옵션 중 하나를 선택합니다.

        • LESS

        • LESS_OR_EQUAL

        • EQUAL

        • NOT_EQUAL

        • GREATER_OR_EQUAL

        • GREATER

      {
        "alarmModelName": "BoilerTemperatureHighAlarm",
        "alarmModelDescription": "Detects when the boiler temperature is high.",
        "severity": 3,
        "alarmRule": {
          "simpleRule": {
            "inputProperty": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.propertyValue.value",
            "comparisonOperator": "GREATER",
            "threshold": "$sitewise.assetModel.`assetModelId`.`thresholdAttributeId`.propertyValue.value"
          }
        }
      }

   5. 경보 상태가 변경될 때 경보 상태를 AWS IoT SiteWise 로 보내는 작업(alarmEventActions)을 추가합니다.

      참고

      고급 구성에서 경보 상태가 변경될 때 수행할 추가 작업을 정의할 수 있습니다. 예를 들어 AWS Lambda 함수를 호출하거나 MQTT 주제에 게시할 수 있습니다. 자세한 내용은 AWS IoT Events 개발자 안내서의 다른 AWS 서비스와 함께 작업하기를 참조하십시오.

      • Replace assetModelId 에셋 모델의 ID 사용.

      • Replace alarmPropertyId 알람이 모니터링하는 속성의 ID와 함께

      • Replace alarmStatePropertyId 알람 복합 모델의 알람 상태 속성 ID와 함께.

      {
        "alarmModelName": "BoilerTemperatureHighAlarm",
        "alarmModelDescription": "Detects when the boiler temperature is high.",
        "severity": 3,
        "alarmRule": {
          "simpleRule": {
            "inputProperty": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.propertyValue.value",
            "comparisonOperator": "GREATER",
            "threshold": "$sitewise.assetModel.`assetModelId`.`thresholdAttributeId`.propertyValue.value"
          }
        },
        "alarmEventActions": {
          "alarmActions": [
            {
              "iotSiteWise": {
                "assetId": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.assetId",
                "propertyId": "'alarmStatePropertyId'"
              }
            }
          ]
        }
      }

   6. (선택 사항) 경보 알림 설정을 구성합니다. 경보 알림 작업은 계정의 Lambda 함수를 사용하여 경보 알림을 전송합니다. 자세한 내용은 경보 알림 요구 사항 단원을 참조하십시오. 알람 알림 설정에서 IAM Identity Center 사용자에게 보낼 알림을 SMS 구성하고 이메일로 보낼 수 있습니다. 다음을 따릅니다.

      1. alarm-model-payload.json의 페이로드에 경보 알림 구성(alarmNotification)을 추가합니다.

         • Replace alarmNotificationFunctionArn 알람 알림을 ARN 처리하는 Lambda 함수를 사용합니다.

         {
           "alarmModelName": "BoilerTemperatureHighAlarm",
           "alarmModelDescription": "Detects when the boiler temperature is high.",
           "severity": 3,
           "alarmRule": {
             "simpleRule": {
               "inputProperty": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.propertyValue.value",
               "comparisonOperator": "GREATER",
               "threshold": "$sitewise.assetModel.`assetModelId`.`thresholdAttributeId`.propertyValue.value"
             }
           },
           "alarmEventActions": {
             "alarmActions": [
               {
                 "iotSiteWise": {
                   "assetId": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.assetId",
                   "propertyId": "'alarmStatePropertyId'"
                 }
               }
             ]
           },
           "alarmNotification": {
             "notificationActions": [
               {
                 "action": {
                   "lambdaAction": {
                     "functionArn": "alarmNotificationFunctionArn"
                   }
                 }
               }
             ]
           }
         }

      2. (선택 사항) 경보 상태가 변경될 때 IAM Identity Center 사용자에게 전송하도록 SMS 알림 (smsConfigurations) 을 구성합니다.

         • Replace identityStoreIdAttributeId ID 센터 ID 저장소의 ID가 포함된 속성의 ID를 사용합니다. IAM

         • Replace userIdAttributeId IAMID 센터 사용자의 ID가 포함된 속성의 ID와 함께

         • Replace senderIdAttributeId Amazon SNS 발신자 ID가 포함된 속성의 ID를 사용하거나 senderId 페이로드에서 제거합니다.

         • Replace additionalMessageAttributeId 추가 메시지가 포함된 속성의 ID를 사용하거나 additionalMessage 페이로드에서 제거합니다.

         {
           "alarmModelName": "BoilerTemperatureHighAlarm",
           "alarmModelDescription": "Detects when the boiler temperature is high.",
           "severity": 3,
           "alarmRule": {
             "simpleRule": {
               "inputProperty": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.propertyValue.value",
               "comparisonOperator": "GREATER",
               "threshold": "$sitewise.assetModel.`assetModelId`.`thresholdAttributeId`.propertyValue.value"
             }
           },
           "alarmEventActions": {
             "alarmActions": [
               {
                 "iotSiteWise": {
                   "assetId": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.assetId",
                   "propertyId": "'alarmStatePropertyId'"
                 }
               }
             ]
           },
           "alarmNotification": {
             "notificationActions": [
               {
                 "action": {
                   "lambdaAction": {
                     "functionArn": "alarmNotificationFunctionArn"
                   }
                 },
                 "smsConfigurations": [
                   {
                     "recipients": [
                       {
                         "ssoIdentity": {
                           "identityStoreId": "$sitewise.assetModel.`assetModelId`.`identityStoreIdAttributeId`.propertyValue.value",
                           "userId": "$sitewise.assetModel.`assetModelId`.`userIdAttributeId`.propertyValue.value"
                         }
                       }
                     ],
                     "senderId": "$sitewise.assetModel.`assetModelId`.`senderIdAttributeId`.propertyValue.value",
                     "additionalMessage": "$sitewise.assetModel.`assetModelId`.`additionalMessageAttributeId`.propertyValue.value"
                   }
                 ]
               }
             ]
           }
         }

      3. (선택 사항) 경보 상태가 변경될 때 IAM Identity Center 사용자에게 전송하도록 이메일 알림 (emailConfigurations) 을 구성합니다.

         • Replace identityStoreIdAttributeId ID 센터 ID 저장소 ID 속성 속성의 ID를 사용합니다. IAM

         • Replace userIdAttributeId ID 센터 사용자 ID 속성 속성의 ID와 함께 IAM

         • Replace fromAddressAttributeId “보낸 사람” 주소 속성 속성의 ID를 사용하거나 from 페이로드에서 제거합니다.

         • Replace emailSubjectAttributeId 이메일 제목 속성 속성의 ID를 사용하거나 subject 페이로드에서 제거합니다.

         • Replace additionalMessageAttributeId 추가 메시지 속성 속성의 ID를 사용하거나 additionalMessage 페이로드에서 제거합니다.

         {
           "alarmModelName": "BoilerTemperatureHighAlarm",
           "alarmModelDescription": "Detects when the boiler temperature is high.",
           "severity": 3,
           "alarmRule": {
             "simpleRule": {
               "inputProperty": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.propertyValue.value",
               "comparisonOperator": "GREATER",
               "threshold": "$sitewise.assetModel.`assetModelId`.`thresholdAttributeId`.propertyValue.value"
             }
           },
           "alarmEventActions": {
             "alarmActions": [
               {
                 "iotSiteWise": {
                   "assetId": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.assetId",
                   "propertyId": "'alarmStatePropertyId'"
                 }
               }
             ]
           },
           "alarmNotification": {
             "notificationActions": [
               {
                 "action": {
                   "lambdaAction": {
                     "functionArn": "alarmNotificationFunctionArn"
                   }
                 },
                 "smsConfigurations": [
                   {
                     "recipients": [
                       {
                         "ssoIdentity": {
                           "identityStoreId": "$sitewise.assetModel.`assetModelId`.`identityStoreIdAttributeId`.propertyValue.value",
                           "userId": "$sitewise.assetModel.`assetModelId`.`userIdAttributeId`.propertyValue.value"
                         }
                       }
                     ],
                     "senderId": "$sitewise.assetModel.`assetModelId`.`senderIdAttributeId`.propertyValue.value",
                     "additionalMessage": "$sitewise.assetModel.`assetModelId`.`additionalMessageAttributeId`.propertyValue.value"
                   }
                 ],
                 "emailConfigurations": [
                   {
                     "from": "$sitewise.assetModel.`assetModelId`.`fromAddressAttributeId`.propertyValue.value",
                     "recipients": {
                       "to": [
                         {
                           "ssoIdentity": {
                             "identityStoreId": "$sitewise.assetModel.`assetModelId`.`identityStoreIdAttributeId`.propertyValue.value",
                             "userId": "$sitewise.assetModel.`assetModelId`.`userIdAttributeId`.propertyValue.value"
                           }
                         }
                       ]
                     },
                     "content": {
                       "subject": "$sitewise.assetModel.`assetModelId`.`emailSubjectAttributeId`.propertyValue.value",
                       "additionalMessage": "$sitewise.assetModel.`assetModelId`.`additionalMessageAttributeId`.propertyValue.value"
                     }
                   }
                 ]
               }
             ]
           }
         }

   7. (선택 사항) 경보 기능(alarmCapabilities)을 alarm-model-payload.json의 페이로드에 추가합니다. 이 객체에서 자산 모델을 기반으로 확인 흐름의 활성화 여부와 자산의 기본 활성화 상태를 지정할 수 있습니다. 확인 흐름에 대한 자세한 내용은 경보 상태 섹션을 참조합니다.

      {
        "alarmModelName": "BoilerTemperatureHighAlarm",
        "alarmModelDescription": "Detects when the boiler temperature is high.",
        "severity": 3,
        "alarmRule": {
          "simpleRule": {
            "inputProperty": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.propertyValue.value",
            "comparisonOperator": "GREATER",
            "threshold": "$sitewise.assetModel.`assetModelId`.`thresholdAttributeId`.propertyValue.value"
          }
        },
        "alarmEventActions": {
          "alarmActions": [
            {
              "iotSiteWise": {
                "assetId": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.assetId",
                "propertyId": "'alarmStatePropertyId'"
              }
            }
          ]
        },
        "alarmNotification": {
          "notificationActions": [
            {
              "action": {
                "lambdaAction": {
                  "functionArn": "alarmNotificationFunctionArn"
                }
              },
              "smsConfigurations": [
                {
                  "recipients": [
                    {
                      "ssoIdentity": {
                        "identityStoreId": "$sitewise.assetModel.`assetModelId`.`identityStoreIdAttributeId`.propertyValue.value",
                        "userId": "$sitewise.assetModel.`assetModelId`.`userIdAttributeId`.propertyValue.value"
                      }
                    }
                  ],
                  "senderId": "$sitewise.assetModel.`assetModelId`.`senderIdAttributeId`.propertyValue.value",
                  "additionalMessage": "$sitewise.assetModel.`assetModelId`.`additionalMessageAttributeId`.propertyValue.value"
                }
              ],
              "emailConfigurations": [
                {
                  "from": "$sitewise.assetModel.`assetModelId`.`fromAddressAttributeId`.propertyValue.value",
                  "recipients": {
                    "to": [
                      {
                        "ssoIdentity": {
                          "identityStoreId": "$sitewise.assetModel.`assetModelId`.`identityStoreIdAttributeId`.propertyValue.value",
                          "userId": "$sitewise.assetModel.`assetModelId`.`userIdAttributeId`.propertyValue.value"
                        }
                      }
                    ]
                  },
                  "content": {
                    "subject": "$sitewise.assetModel.`assetModelId`.`emailSubjectAttributeId`.propertyValue.value",
                    "additionalMessage": "$sitewise.assetModel.`assetModelId`.`additionalMessageAttributeId`.propertyValue.value"
                  }
                }
              ]
            }
          ]
        },
        "alarmCapabilities": {
          "initializationConfiguration": {
            "disabledOnInitialization": false
          },
          "acknowledgeFlow": {
            "enabled": true
          }
        }
      }

   8. 데이터를 전송할 AWS IoT Events 수 있는 IAM 서비스 역할 (roleArn) 을 추가합니다. AWS IoT SiteWise이 역할에는 iotevents.amazonaws.com가 역할을 맡을 수 있도록 허용하는 iotsitewise:BatchPutAssetPropertyValue 권한과 신뢰 관계가 필요합니다. 알림을 보내려면 이 역할에도 lambda:InvokeFunction 및 sso-directory:DescribeUser 권한이 필요합니다. 자세한 정보는 AWS IoT Events 개발자 안내서에서 경보 서비스 역할을 참조하세요.

      • 를 roleArn 이러한 작업을 수행할 AWS IoT Events 수 있는 ARN 역할의 역할로 바꾸십시오.

      {
        "alarmModelName": "BoilerTemperatureHighAlarm",
        "alarmModelDescription": "Detects when the boiler temperature is high.",
        "severity": 3,
        "alarmRule": {
          "simpleRule": {
            "inputProperty": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.propertyValue.value",
            "comparisonOperator": "GREATER",
            "threshold": "$sitewise.assetModel.`assetModelId`.`thresholdAttributeId`.propertyValue.value"
          }
        },
        "alarmEventActions": {
          "alarmActions": [
            {
              "iotSiteWise": {
                "assetId": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.assetId",
                "propertyId": "'alarmStatePropertyId'"
              }
            }
          ]
        },
        "alarmNotification": {
          "notificationActions": [
            {
              "action": {
                "lambdaAction": {
                  "functionArn": "alarmNotificationFunctionArn"
                }
              },
              "smsConfigurations": [
                {
                  "recipients": [
                    {
                      "ssoIdentity": {
                        "identityStoreId": "$sitewise.assetModel.`assetModelId`.`identityStoreIdAttributeId`.propertyValue.value",
                        "userId": "$sitewise.assetModel.`assetModelId`.`userIdAttributeId`.propertyValue.value"
                      }
                    }
                  ],
                  "senderId": "$sitewise.assetModel.`assetModelId`.`senderIdAttributeId`.propertyValue.value",
                  "additionalMessage": "$sitewise.assetModel.`assetModelId`.`additionalMessageAttributeId`.propertyValue.value"
                }
              ],
              "emailConfigurations": [
                {
                  "from": "$sitewise.assetModel.`assetModelId`.`fromAddressAttributeId`.propertyValue.value",
                  "recipients": {
                    "to": [
                      {
                        "ssoIdentity": {
                          "identityStoreId": "$sitewise.assetModel.`assetModelId`.`identityStoreIdAttributeId`.propertyValue.value",
                          "userId": "$sitewise.assetModel.`assetModelId`.`userIdAttributeId`.propertyValue.value"
                        }
                      }
                    ]
                  },
                  "content": {
                    "subject": "$sitewise.assetModel.`assetModelId`.`emailSubjectAttributeId`.propertyValue.value",
                    "additionalMessage": "$sitewise.assetModel.`assetModelId`.`additionalMessageAttributeId`.propertyValue.value"
                  }
                }
              ]
            }
          ]
        },
        "alarmCapabilities": {
          "initializationConfiguration": {
            "disabledOnInitialization": false
          },
          "acknowledgeFlow": {
            "enabled": false
          }
        },
        "roleArn": "arn:aws:iam::123456789012:role/MyIoTEventsAlarmRole"
      }

   9. 다음 명령을 실행하여 페이로드로부터 AWS IoT Events 경보 모델을 생성합니다. alarm-model-payload.json

      aws iotevents create-alarm-model --cli-input-json file://alarm-model-payload.json

   10. 이 작업은 알람 모델 () 이 ARN 포함된 응답을 반환합니다. alarmModelArn 이를 ARN 복사하여 다음 단계에서 자산 모델의 알람 정의에 설정하십시오.

AWS IoT SiteWise 와 AWS IoT Events (CLI) 사이의 데이터 흐름을 활성화하려면

• 경보 모델을 자산 모델에서 경보 소스로 설정합니다. 다음을 따릅니다.

  1. 다음 명령을 실행하여 기존 자산 모델 정의를 검색합니다. Replace asset-model-id 에셋 모델의 ID와 함께.

     aws iotsitewise describe-asset-model --asset-model-id asset-model-id

     이 작업은 자산 모델의 세부 사항이 포함된 응답을 반환합니다.

  2. update-asset-model-payload.json이라는 파일을 만들고 이전 명령의 응답을 파일에 복사합니다.

  3. update-asset-model-payload.json 파일에서 다음 키-값 페어를 제거합니다.

     • assetModelId

     • assetModelArn

     • assetModelCreationDate

     • assetModelLastUpdateDate

     • assetModelStatus

  4. 이전에 정의한 경보 복합 모델에 경보 소스 속성(AWS/ALARM_SOURCE)을 추가합니다. Replace alarmModelArn 알람 소스 속성의 값을 설정하는 알람 모델을 사용합니다. ARN

     {
       ...
       "assetModelCompositeModels": [
         ...
         {
           "name": "BoilerTemperatureHighAlarm",
           "type": "AWS/ALARM",
           "properties": [
             {
               "id": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
               "name": "AWS/ALARM_TYPE",
               "dataType": "STRING",
               "type": {
                 "attribute": {
                   "defaultValue": "IOT_EVENTS"
                 }
               }
             },
             {
               "id": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
               "name": "AWS/ALARM_STATE",
               "dataType": "STRUCT",
               "dataTypeSpec": "AWS/ALARM_STATE",
               "type": {
                 "measurement": {}
               }
             },
             {
               "name": "AWS/ALARM_SOURCE",
               "dataType": "STRING",
               "type": {
                 "attribute": {
                   "defaultValue": "alarmModelArn"
                 }
               }
             }
           ]
         }
       ]
     }

  5. 다음 명령을 실행하여 update-asset-model-payload.json 파일에 저장된 정의로 자산 모델을 업데이트합니다. Replace asset-model-id 자산 모델의 ID와 함께

     aws iotsitewise update-asset-model \
       --asset-model-id asset-model-id \
       --cli-input-json file://update-asset-model-payload.json