자산 모델 생성 - AWS IoT SiteWise
자산 모델 생성(콘솔)자산 모델 생성 (AWS CLI)자산 모델 예

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

자산 모델 생성

AWS IoT SiteWise 자산 모델은 산업 데이터의 표준화를 촉진합니다. 자산 모델에는 이름, 설명, 자산 속성 및 자산 계층 구조 정의가 포함되어 있습니다. 예를 들어 온도, 분당 회전 수(RPM) 및 전력 속성을 사용하여 풍력 터빈 모델을 정의할 수 있습니다. 그런 다음, 순 전력 출력 속성 및 풍력 터빈 계층 구조 정의를 사용하여 풍력 발전소 모델을 정의할 수 있습니다.

참고

  • 가장 낮은 수준의 노드부터 시작해서 조직을 모델링하는 것이 좋습니다. 예를 들어 풍력 발전소 모델을 생성하기 전에 풍력 터빈 모델을 생성합니다. 자산 계층 정의에는 기존 자산 모델에 대한 참조가 포함되어 있습니다. 이 방법을 사용하면 모델을 생성할 때 자산 계층 구조를 정의할 수 있습니다.

  • 자산 모델에는 다른 자산 모델이 포함될 수 없습니다. 다른 모델 내에서 서브어셈블리로 참조할 수 있는 모델을 정의해야 하는 경우에는 컴포넌트--> 모델을 대신 생성해야 합니다. 자세한 정보는 컴포넌트 모델 생성을 참조하세요.

다음 섹션에서는 AWS IoT SiteWise 콘솔 또는 API를 사용하여 자산 모델을 생성하는 방법을 설명합니다. 다음 단원에서는 모델을 생성하는 데 사용할 수 있는 다양한 유형의 자산 속성과 자산 계층 구조에 대해서도 설명합니다.

주제

자산 모델 생성(콘솔)

AWS IoT SiteWise 콘솔을 사용하여 자산 모델을 만들 수 있습니다. AWS IoT SiteWise 콘솔은 유효한 자산 모델을 정의하는 데 도움이 되는 수식 자동 완성과 같은 다양한 기능을 제공합니다.

자산 모델을 생성하려면(콘솔)

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

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

  3. Create model(모델 생성)을 선택합니다.

  4. 모델 생성 페이지에서 다음을 수행합니다.

    1. 자산 모델의 이름을 입력합니다(예: Wind Turbine 또는 Wind Turbine Model). 이 이름은 이 리전의 계정에 있는 모든 모델에서 고유해야 합니다.

    2. (선택 사항) 모델의 외부 ID를 추가합니다. 사용자 정의 ID입니다. 자세한 내용은AWS IoT SiteWise 사용 설명서의 외부 ID를 사용하여 개체 참조를 참조하십시오.

    3. (선택 사항) 모델의 측정 정의를 추가합니다. 측정값은 장비의 데이터 스트림을 나타냅니다. 자세한 정보는 장비의 데이터 스트림 정의(측정값)을 참조하세요.

    4. (선택 사항) 모델의 변환 정의를 추가합니다. 변환은 데이터를 한 양식에서 다른 양식으로 매핑하는 공식입니다. 자세한 정보는 데이터 변환(변환)을 참조하세요.

    5. (선택 사항) 모델의 지표 정의를 추가합니다. 지표는 일정 간격으로 데이터를 집계하는 공식입니다. 지표는 연결된 자산에서 데이터를 입력할 수 있으므로 작업 또는 작업의 하위 집합을 나타내는 값을 계산할 수 있습니다. 자세한 정보는 속성과 기타 자산의 데이터 집계(지표)을 참조하세요.

    6. (선택 사항) 모델의 계층 구조 정의를 추가합니다. 계층은 자산 간의 관계입니다. 자세한 정보는 자산 모델 계층 구조 정의을 참조하세요.

    7. (선택 사항) 자산 모델에 대한 태그를 추가합니다. 자세한 정보는 리소스에 태그 지정하기 AWS IoT SiteWise을 참조하세요.

    8. Create model(모델 생성)을 선택합니다.

    자산 모델을 생성하면 AWS IoT SiteWise 콘솔이 새 모델의 페이지로 이동합니다. 이 페이지에서 모델의 상태를 볼 수 있습니다. 상태는 처음에 CREATING(생성 중)입니다. 이 페이지는 자동으로 업데이트되므로 모델 상태가 업데이트될 때까지 기다릴 수 있습니다.

    참고

    복잡한 모델의 경우, 자산 모델 생성 프로세스가 몇 분 정도 소요될 수 있습니다. 자산 모델 상태가 활성이면 자산 모델을 사용하여 자산을 생성할 수 있습니다. 자세한 정보는 자산 및 모델 상태을 참조하세요.

  5. (선택 사항) 자산 모델을 만든 후 엣지에 맞게 자산 모델을 구성할 수 있습니다. SiteWise Edge에 대한 자세한 내용은 을 참조하십시오엣지 데이터 처리 활성화.

    1. 모델 페이지에서 엣지용 구성을 선택합니다.

    2. 모델 구성 페이지에서 모델의 엣지 구성을 선택합니다. 이는 이 자산 모델과 관련된 속성을 계산하고 저장할 AWS IoT SiteWise 수 있는 위치를 제어합니다. 엣지용 모델 구성에 대한 자세한 내용은 엣지 기능 설정하기 단원을 참조하세요.

    3. 사용자 지정 에지 구성의 경우 각 자산 모델 속성을 계산하고 저장할 위치를 선택합니다. AWS IoT SiteWise

      참고

      연결된 변환 및 지표는 동일한 위치에 구성되어야 합니다. 엣지용 모델 구성에 대한 자세한 내용은 엣지 기능 설정하기 단원을 참조하세요.

    4. 저장을 선택합니다. 이제 모델 페이지에서 엣지 구성이 구성됨이어야 합니다.

자산 모델 생성 (AWS CLI)

AWS Command Line Interface (AWS CLI) 를 사용하여 자산 모델을 만들 수 있습니다.

CreateAsset모델 작업을 사용하여 속성과 계층이 포함된 자산 모델을 만들 수 있습니다. 이 작업에는 다음과 같은 구조의 페이로드가 필요합니다.

{
  "assetModelType": "ASSET_MODEL",
  "assetModelName": "String",
  "assetModelDescription": "String",
  "assetModelProperties": Array of AssetModelProperty,
  "assetModelHierarchies": Array of AssetModelHierarchyDefinition
}
자산 모델을 만들려면 ()AWS CLI

  1. asset-model-payload.json이라는 파일을 만들고 다음 JSON 객체를 파일에 복사합니다.

    {
  "assetModelType": "ASSET_MODEL",
  "assetModelName": "",
  "assetModelDescription": "",
  "assetModelProperties": [

  ],
  "assetModelHierarchies": [

  ],
  "assetModelCompositeModels": [

  ]
}

  2. 선호하는 JSON 텍스트 편집기를 사용하여 다음에 대한 asset-model-payload.json 파일을 편집합니다.

    1. 자산 모델의 이름(assetModelName)을 입력합니다(예: Wind Turbine 또는 Wind Turbine Model). 이 이름은 계정의 모든 자산 모델 및 구성 요소 모델에서 고유해야 AWS 리전합니다.

    2. (선택 사항) 자산 모델의 외부 ID (assetModelExternalId) 를 입력합니다. 사용자 정의 ID입니다. 자세한 내용은AWS IoT SiteWise 사용 설명서의 외부 ID를 사용하여 개체 참조를 참조하십시오.

    3. (선택 사항) 자산 모델에 대한 설명(assetModelDescription)을 입력하거나 assetModelDescription 키-값 페어를 제거합니다.

    4. (선택 사항) 모델의 자산 속성(assetModelProperties)을 정의합니다. 자세한 정보는 데이터 속성 정의을 참조하세요.

    5. (선택 사항) 모델의 자산 계층 구조(assetModelHierarchies)를 정의합니다. 자세한 정보는 자산 모델 계층 구조 정의을 참조하세요.

    6. (선택 사항) 모델의 경보를 정의합니다. 경보는 다른 속성을 모니터링하므로 장비나 프로세스에 주의가 필요한 시점을 식별할 수 있습니다. 각 경보 정의는 경보가 사용하는 속성 집합을 표준화하는 복합 모델(assetModelCompositeModels)입니다. 자세한 내용은 경보로 데이터 모니터링 및 자산 모델에서 경보 정의 섹션을 참조하세요.

    7. (선택 사항) 자산 모델에 대한 태그(tags)를 추가합니다. 자세한 정보는 리소스에 태그 지정하기 AWS IoT SiteWise을 참조하세요.

  3. 다음 명령을 실행하여 JSON 파일의 정의에서 자산 모델을 생성합니다.

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

    이 작업은 자산을 생성할 때 참조하는 assetModelId가 포함된 응답을 반환합니다. 응답에는 모델의 상태(assetModelStatus.state)도 포함됩니다. 상태는 처음에 CREATING입니다. 자산 모델의 상태는 변경 사항이 전파될 때까지 CREATING입니다.

    참고

    복잡한 모델의 경우, 자산 모델 생성 프로세스가 몇 분 정도 소요될 수 있습니다. 자산 모델의 현재 상태를 확인하려면 를 지정하여 DescribeAsset모델 작업을 사용합니다. assetModelId 자산 모델 상태가 ACTIVE이면 자산 모델을 사용하여 자산을 생성할 수 있습니다. 자세한 정보는 자산 및 모델 상태을 참조하세요.

  4. (선택 사항) 자산 모델을 위한 사용자 지정 복합 모델을 생성합니다. 사용자 지정 복합 모델을 사용하면 모델 내의 속성을 그룹화하거나 컴포넌트 모델을 참조하여 서브어셈블리를 포함할 수 있습니다. 자세한 정보는 사용자 지정 복합 모델 생성 (구성 요소)을 참조하세요.

자산 모델 예

이 섹션에는 및 SDK를 사용하여 자산 모델을 만드는 데 사용할 수 있는 예제 자산 모델 정의가 포함되어 있습니다. AWS CLI AWS IoT SiteWise 이러한 자산 모델은 풍력 터빈과 풍력 발전 단지를 나타냅니다. 풍력 터빈 자산은 원시 센서 데이터를 수집하고 전력 및 평균 풍속과 같은 값을 계산합니다. 풍력 발전 단지 자산은 풍력 발전 단지 내 모든 풍력 터빈의 총 출력과 같은 값을 계산합니다.

풍력 터빈 자산 모델

다음 자산 모델은 풍력 발전소의 터빈을 나타냅니다. 풍력 터빈은 센서 데이터를 수집하여 전력 및 평균 풍속과 같은 값을 계산합니다.

참고

이 예제 모델은 데모의 풍력 터빈 모델과 비슷합니다. AWS IoT SiteWise 자세한 정보는 AWS IoT SiteWise 데모 사용을 참조하세요.

{
  "assetModelType": "ASSET_MODEL",
  "assetModelName": "Wind Turbine Asset Model",
  "assetModelDescription": "Represents a turbine in a wind farm.",
  "assetModelProperties": [
    {
      "name": "Location",
      "dataType": "STRING",
      "type": {
        "attribute": {
          "defaultValue": "Renton"
        }
      }
    },
    {
      "name": "Make",
      "dataType": "STRING",
      "type": {
        "attribute": {
          "defaultValue": "Amazon"
        }
      }
    },
    {
      "name": "Model",
      "dataType": "INTEGER",
      "type": {
        "attribute": {
          "defaultValue": "500"
        }
      }
    },
    {
      "name": "Torque (KiloNewton Meter)",
      "dataType": "DOUBLE",
      "unit": "kNm",
      "type": {
        "measurement": {}
      }
    },
    {
      "name": "Wind Direction",
      "dataType": "DOUBLE",
      "unit": "Degrees",
      "type": {
        "measurement": {}
      }
    },
    {
      "name": "RotationsPerMinute",
      "dataType": "DOUBLE",
      "unit": "RPM",
      "type": {
        "measurement": {}
      }
    },
    {
      "name": "Wind Speed",
      "dataType": "DOUBLE",
      "unit": "m/s",
      "type": {
        "measurement": {}
      }
    },
    {
      "name": "RotationsPerSecond",
      "dataType": "DOUBLE",
      "unit": "RPS",
      "type": {
        "transform": {
          "expression": "rpm / 60",
          "variables": [
            {
              "name": "rpm",
              "value": {
                "propertyId": "RotationsPerMinute"
              }
            }
          ]
        }
      }
    },
    {
      "name": "Overdrive State",
      "dataType": "DOUBLE",
      "type": {
        "transform": {
          "expression": "gte(torque, 3)",
          "variables": [
            {
              "name": "torque",
              "value": {
                "propertyId": "Torque (KiloNewton Meter)"
              }
            }
          ]
        }
      }
    },
    {
      "name": "Average Power",
      "dataType": "DOUBLE",
      "unit": "Watts",
      "type": {
        "metric": {
          "expression": "avg(torque) * avg(rps) * 2 * 3.14",
          "variables": [
            {
              "name": "torque",
              "value": {
                "propertyId": "Torque (Newton Meter)"
              }
            },
            {
              "name": "rps",
              "value": {
                "propertyId": "RotationsPerSecond"
              }
            }
          ],
          "window": {
            "tumbling": {
              "interval": "5m"
            }
          }
        }
      }
    },
    {
      "name": "Average Wind Speed",
      "dataType": "DOUBLE",
      "unit": "m/s",
      "type": {
        "metric": {
          "expression": "avg(windspeed)",
          "variables": [
            {
              "name": "windspeed",
              "value": {
                "propertyId": "Wind Speed"
              }
            }
          ],
          "window": {
            "tumbling": {
              "interval": "5m"
            }
          }
        }
      }
    },
    {
      "name": "Torque (Newton Meter)",
      "dataType": "DOUBLE",
      "unit": "Nm",
      "type": {
        "transform": {
          "expression": "knm * 1000",
          "variables": [
            {
              "name": "knm",
              "value": {
                "propertyId": "Torque (KiloNewton Meter)"
              }
            }
          ]
        }
      }
    },
    {
      "name": "Overdrive State Time",
      "dataType": "DOUBLE",
      "unit": "Seconds",
      "type": {
        "metric": {
          "expression": "statetime(overdrive_state)",
          "variables": [
            {
              "name": "overdrive_state",
              "value": {
                "propertyId": "Overdrive State"
              }
            }
          ],
          "window": {
            "tumbling": {
              "interval": "5m"
            }
          }
        }
      }
    }
  ],
  "assetModelHierarchies": []
}

풍력 발전소 자산 모델

다음 자산 모델은 여러 풍력 터빈으로 구성된 풍력 발전소를 나타냅니다. 이 자산 모델은 풍력 터빈 모델의 계층 구조를 정의합니다. 이를 통해 풍력 발전 단지는 풍력 발전 단지의 모든 풍력 터빈에 대한 데이터에서 값 (예: 평균 전력) 을 계산할 수 있습니다.

참고

이 예제 모델은 데모의 풍력 발전 단지 모델과 유사합니다. AWS IoT SiteWise 자세한 정보는 AWS IoT SiteWise 데모 사용을 참조하세요.

이 자산 모델은 풍력 터빈 자산 모델에 따라 다릅니다. propertyId 및 childAssetModelId 값을 기존 풍력 터빈 자산 모델의 값으로 바꿉니다.

{
  "assetModelName": "Wind Farm Asset Model",
  "assetModelDescription": "Represents a wind farm.",
  "assetModelProperties": [
    {
      "name": "Code",
      "dataType": "INTEGER",
      "type": {
        "attribute": {
          "defaultValue": "300"
        }
      }
    },
    {
      "name": "Location",
      "dataType": "STRING",
      "type": {
        "attribute": {
          "defaultValue": "Renton"
        }
      }
    },
    {
      "name": "Reliability Manager",
      "dataType": "STRING",
      "type": {
        "attribute": {
          "defaultValue": "Mary Major"
        }
      }
    },
    {
      "name": "Total Overdrive State Time",
      "dataType": "DOUBLE",
      "unit": "seconds",
      "type": {
        "metric": {
          "expression": "sum(overdrive_state_time)",
          "variables": [
            {
              "name": "overdrive_state_time",
              "value": {
                "propertyId": "ID of Overdrive State Time property in Wind Turbine Asset Model",
                "hierarchyId": "Turbine Asset Model"
              }
            }
          ],
          "window": {
            "tumbling": {
              "interval": "5m"
            }
          }
        }
      }
    },
    {
      "name": "Total Average Power",
      "dataType": "DOUBLE",
      "unit": "Watts",
      "type": {
        "metric": {
          "expression": "sum(turbine_avg_power)",
          "variables": [
            {
              "name": "turbine_avg_power",
              "value": {
                "propertyId": "ID of Average Power property in Wind Turbine Asset Model",
                "hierarchyId": "Turbine Asset Model"
              }
            }
          ],
          "window": {
            "tumbling": {
              "interval": "5m"
            }
          }
        }
      }
    }
  ],
  "assetModelHierarchies": [
    {
      "name": "Turbine Asset Model",
      "childAssetModelId": "ID of Wind Turbine Asset Model"
    }
  ]
}