기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 에서 자산 모델 생성 AWS IoT SiteWise
AWS IoT SiteWise 자산 모델은 산업 데이터의 표준화를 촉진합니다. 자산 모델에는 이름, 설명, 자산 속성 및 자산 계층 구조 정의가 포함되어 있습니다. 예를 들어 온도, 분당 회전 수(RPM) 및 전력 속성을 사용하여 풍력 터빈 모델을 정의할 수 있습니다. 그런 다음, 순 전력 출력 속성 및 풍력 터빈 계층 구조 정의를 사용하여 풍력 발전소 모델을 정의할 수 있습니다.
**참고**
가장 낮은 수준의 노드부터 시작해서 조직을 모델링하는 것이 좋습니다. 예를 들어 풍력 발전소 모델을 생성하기 전에 풍력 터빈 모델을 생성합니다. 자산 계층 정의에는 기존 자산 모델에 대한 참조가 포함되어 있습니다. 이 방법을 사용하면 모델을 생성할 때 자산 계층 구조를 정의할 수 있습니다.
자산 모델은 다른 자산 모델을 포함할 수 없습니다. 다른 모델 내에서 하위 어셈블리로 참조할 수 있는 모델을 정의해야 하는 경우 대신 구성 요소--> 모델을 생성해야 합니다. 자세한 내용은 [구성 요소 모델 생성](create-component-models.md) 단원을 참조하십시오.
다음 섹션에서는 AWS IoT SiteWise 콘솔 또는 API를 사용하여 자산 모델을 생성하는 방법을 설명합니다. 다음 단원에서는 모델을 생성하는 데 사용할 수 있는 다양한 유형의 자산 속성과 자산 계층 구조에 대해서도 설명합니다.
**Topics**
+ [자산 모델 생성(콘솔)](#create-asset-model-console)
+ [자산 모델 생성(AWS CLI)](#create-asset-model-cli)
+ [자산 모델 예](#asset-model-examples)
+ [자산 모델 계층 정의](define-asset-hierarchies.md)
## 자산 모델 생성(콘솔)
AWS IoT SiteWise 콘솔을 사용하여 자산 모델을 생성할 수 있습니다. AWS IoT SiteWise 콘솔은 유효한 자산 모델을 정의하는 데 도움이 되는 공식 자동 완성과 같은 다양한 기능을 제공합니다.
**자산 모델을 생성하려면(콘솔) 다음을 수행하세요.**
1. [AWS IoT SiteWise 콘솔](https://console.aws.amazon.com/iotsitewise/)로 이동합니다.
1. 탐색 창에서 **모델**을 선택합니다.
1. **자산 모델 생성을** 선택합니다.
1. **모델 생성** 페이지에서 다음을 수행합니다.
1. 자산 모델의 **이름**을 입력합니다(예: **Wind Turbine** 또는 **Wind Turbine Model**). 이 이름은 이 리전의 계정에 있는 모든 모델에서 고유해야 합니다.
1. (선택 사항) 모델의 **외부 ID**를 추가합니다. 이는 사용자 정의 ID입니다. 자세한 내용은AWS IoT SiteWise 사용 설명서**의 [외부 ID가 있는 참조 객체](object-ids.md#external-id-references)를 참조하세요.
1. (선택 사항) 모델의 **측정 정의**를 추가합니다. 측정값은 장비의 데이터 스트림을 나타냅니다. 자세한 내용은 [장비의 데이터 스트림 정의(측정값)](measurements.md) 단원을 참조하십시오.
1. (선택 사항) 모델의 **변환 정의**를 추가합니다. 변환은 데이터를 한 양식에서 다른 양식으로 매핑하는 공식입니다. 자세한 내용은 [데이터 변환(변환)](transforms.md) 단원을 참조하십시오.
1. (선택 사항) 모델의 **지표 정의**를 추가합니다. 지표는 일정 간격으로 데이터를 집계하는 공식입니다. 지표는 연결된 자산에서 데이터를 입력할 수 있으므로 작업 또는 작업의 하위 집합을 나타내는 값을 계산할 수 있습니다. 자세한 내용은 [속성과 기타 자산에서 데이터 집계(지표)](metrics.md) 단원을 참조하십시오.
1. (선택 사항) 모델의 **계층 구조 정의**를 추가합니다. 계층은 자산 간의 관계입니다. 자세한 내용은 [자산 모델 계층 정의](define-asset-hierarchies.md) 단원을 참조하십시오.
1. (선택 사항) 자산 모델에 대한 태그를 추가합니다. 자세한 내용은 [AWS IoT SiteWise 리소스에 태그 지정](tag-resources.md) 단원을 참조하십시오.
1. **Create model**(모델 생성)을 선택합니다.
자산 모델을 생성하면 AWS IoT SiteWise 콘솔이 새 모델의 페이지로 이동합니다. 이 페이지에서 모델의 **상태**를 볼 수 있습니다. 상태는 처음에 **CREATING(생성 중)**입니다. 이 페이지는 자동으로 업데이트되므로 모델 상태가 업데이트될 때까지 기다릴 수 있습니다.
**참고**
복잡한 모델의 경우, 자산 모델 생성 프로세스가 몇 분 정도 소요될 수 있습니다. 자산 모델 상태가 **활성**이면 자산 모델을 사용하여 자산을 생성할 수 있습니다. 자세한 내용은 [자산 및 모델 상태](asset-and-model-states.md) 단원을 참조하십시오.
1. (선택 사항) 자산 모델을 만든 후 엣지에 맞게 자산 모델을 구성할 수 있습니다. SiteWise Edge에 대한 자세한 내용은 [Edge에서 AWS IoT SiteWise 엣지 기능 구성](edge-data-collection-and-processing.md) 섹션을 참조하세요.
1. 모델 페이지에서 **엣지용 구성**을 선택합니다.
**참고**
데이터 처리 팩(DPP) 기능은 더 이상 신규 고객에게 제공되지 않습니다. 기존 고객은 정상적으로 서비스를 계속 이용할 수 있습니다. 자세한 내용은 [데이터 처리 팩 가용성 변경](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-dpp-availability-change.html)을 참조하세요.
1. 모델 구성 페이지에서 모델의 엣지 구성을 선택합니다. 이 제어는가이 자산 모델과 연결된 속성을 계산하고 저장할 AWS IoT SiteWise 수 있는 위치를 제어합니다. 엣지용 모델 구성에 대한 자세한 내용은 [SiteWise Edge에서 OPC UA 소스 설정](configure-opcua-source.md) 단원을 참조하세요.
1. **사용자 지정 엣지 구성**에서 각 자산 모델 속성을 AWS IoT SiteWise 계산하고 저장할 위치를 선택합니다.
**참고**
연결된 변환 및 지표는 동일한 위치에 구성되어야 합니다. 엣지용 모델 구성에 대한 자세한 내용은 [SiteWise Edge에서 OPC UA 소스 설정](configure-opcua-source.md) 단원을 참조하세요.
1. **저장**을 선택합니다. 이제 모델 페이지에서 **엣지 구성**이 **구성됨**이어야 합니다.
## 자산 모델 생성(AWS CLI)
AWS Command Line Interface (AWS CLI)를 사용하여 자산 모델을 생성할 수 있습니다.
[CreateAssetModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateAssetModel.html) 작업을 사용하여 속성과 계층 구조가 있는 자산 모델을 생성합니다. 이 작업에는 다음과 같은 구조의 페이로드가 필요합니다.
```
{
"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": [
]
}
```
1. 선호하는 JSON 텍스트 편집기를 사용하여 다음에 대한 `asset-model-payload.json` 파일을 편집합니다.
1. 자산 모델의 이름(`assetModelName`)을 입력합니다(예: **Wind Turbine** 또는 **Wind Turbine Model**). 이 이름은 이 AWS 리전의 계정에 있는 모든 자산 모델 및 구성 요소 모델 중에 고유해야 합니다.
1. (선택 사항) 자산 모델의 외부 ID(`assetModelExternalId`)를 입력합니다. 이는 사용자 정의 ID입니다. 자세한 내용은AWS IoT SiteWise 사용 설명서**의 [외부 ID가 있는 참조 객체](object-ids.md#external-id-references)를 참조하세요.
1. (선택 사항) 자산 모델에 대한 설명(`assetModelDescription`)을 입력하거나 `assetModelDescription` 키-값 페어를 제거합니다.
1. (선택 사항) 모델의 자산 속성(`assetModelProperties`)을 정의합니다. 자세한 내용은 [데이터 속성 정의](asset-properties.md) 단원을 참조하십시오.
1. (선택 사항) 모델의 자산 계층 구조(`assetModelHierarchies`)를 정의합니다. 자세한 내용은 [자산 모델 계층 정의](define-asset-hierarchies.md) 단원을 참조하십시오.
1. (선택 사항) 모델의 경보를 정의합니다. 경보는 다른 속성을 모니터링하므로 장비나 프로세스에 주의가 필요한 시점을 식별할 수 있습니다. 각 경보 정의는 경보가 사용하는 속성 집합을 표준화하는 복합 모델(`assetModelCompositeModels`)입니다. 자세한 내용은 [에서 경보를 사용하여 데이터 모니터링 AWS IoT SiteWise](industrial-alarms.md) 및 [에서 자산 모델에 대한 경보 정의 AWS IoT SiteWise](define-alarms.md) 섹션을 참조하세요.
1. (선택 사항) 자산 모델에 대한 태그(`tags`)를 추가합니다. 자세한 내용은 [AWS IoT SiteWise 리소스에 태그 지정](tag-resources.md) 단원을 참조하십시오.
1. 다음 명령을 실행하여 JSON 파일의 정의에서 자산 모델을 생성합니다.
```
aws iotsitewise create-asset-model --cli-input-json file://asset-model-payload.json
```
이 작업은 자산을 생성할 때 참조하는 `assetModelId`가 포함된 응답을 반환합니다. 응답에는 모델의 상태(`assetModelStatus.state`)도 포함됩니다. 상태는 처음에 `CREATING`입니다. 자산 모델의 상태는 변경 사항이 전파될 때까지 `CREATING`입니다.
**참고**
복잡한 모델의 경우, 자산 모델 생성 프로세스가 몇 분 정도 소요될 수 있습니다. 자산 모델의 현재 상태를 확인하려면 `assetModelId`를 지정하여 [DescribeAssetModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAssetModel.html) 작업을 사용하세요. 자산 모델 상태가 `ACTIVE`이면 자산 모델을 사용하여 자산을 생성할 수 있습니다. 자세한 내용은 [자산 및 모델 상태](asset-and-model-states.md) 단원을 참조하십시오.
1. (선택 사항) 자산 모델에 대한 사용자 지정 복합 모델을 생성합니다. 사용자 지정 복합 모델을 사용하면 모델 내에서 속성을 그룹화하거나 구성 요소 모델을 참조하여 하위 어셈블리를 포함할 수 있습니다. 자세한 내용은 [사용자 지정 복합 모델(구성 요소) 생성](create-custom-composite-models.md) 단원을 참조하십시오.
## 자산 모델 예
이 섹션에는 AWS CLI 및 AWS IoT SiteWise SDKs. 이러한 자산 모델은 풍력 터빈과 풍력 발전 단지를 나타냅니다. 풍력 터빈 자산은 원시 센서 데이터를 수집하고 전력 및 평균 풍속과 같은 값을 계산합니다. 풍력 발전 단지 자산은 풍력 발전 단지 내 모든 풍력 터빈의 총 출력과 같은 값을 계산합니다.
**Topics**
+ [풍력 터빈 자산 모델](#example-wind-turbine)
+ [풍력 발전소 자산 모델](#example-wind-farm)
### 풍력 터빈 자산 모델
다음 자산 모델은 풍력 발전소의 터빈을 나타냅니다. 풍력 터빈은 센서 데이터를 수집하여 전력 및 평균 풍속과 같은 값을 계산합니다.
**참고**
이 예제 모델은 AWS IoT SiteWise 데모의 풍력 터빈 모델과 유사합니다. 자세한 내용은 [AWS IoT SiteWise 데모 사용](getting-started-demo.md) 단원을 참조하십시오.
```
{
"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": []
}
```
### 풍력 발전소 자산 모델
다음 자산 모델은 여러 풍력 터빈으로 구성된 풍력 발전소를 나타냅니다. 이 자산 모델은 풍력 터빈 모델의 [계층 구조](define-asset-hierarchies.md)를 정의합니다. 이를 통해 풍력 발전소는 풍력 발전소의 모든 풍력 터빈에 대한 데이터에서 값(예: 평균 출력)을 계산할 수 있습니다.
**참고**
이 예제 모델은 AWS IoT SiteWise 데모의 풍력 발전소 모델과 유사합니다. 자세한 내용은 [AWS IoT SiteWise 데모 사용](getting-started-demo.md) 단원을 참조하십시오.
이 자산 모델은 [풍력 터빈 자산 모델](#example-wind-turbine)에 따라 다릅니다. `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"
}
]
}
```
# 자산 모델 계층 정의
자산 모델 계층 구조를 정의하여 산업 운영의 자산 모델 간에 논리적 연관성을 만들 수 있습니다. 예를 들어, 육상 및 해상 풍력 단지로 구성된 풍력 발전 단지를 정의할 수 있습니다. 육상 풍력 발전 단지에는 터빈과 육상 위치가 포함됩니다. 해상 풍력 발전 단지에는 터빈과 해상 위치가 있습니다.
![\[AWS IoT SiteWise 자산 모델 간의 풍력 발전소 계층 구조입니다.\]](http://docs.aws.amazon.com/ko_kr/iot-sitewise/latest/userguide/images/asset-model-hierarchies.png)
계층 구조를 통해 하위 자산 모델을 상위 자산 모델에 연결하면 상위 자산 모델의 지표에서 하위 자산 모델 지표의 데이터를 입력할 수 있습니다. 자산 모델 계층 구조 및 지표를 사용하여 작업 또는 작업의 하위 집합에 대한 통찰을 제공하는 통계를 계산할 수 있습니다. 자세한 내용은 [속성과 기타 자산에서 데이터 집계(지표)](metrics.md) 단원을 참조하십시오.
각 계층 구조는 상위 자산 모델과 하위 자산 모델 간의 관계를 정의합니다. 상위 자산 모델에서는 동일한 하위 자산 모델에 여러 계층 구조를 정의할 수 있습니다. 예를 들어 풍력 발전 단지에 두 가지 유형의 풍력 터빈이 있고 모든 풍력 터빈이 동일한 자산 모델로 표시되는 경우 각 유형에 대한 계층 구조를 정의할 수 있습니다. 그런 다음 풍력 발전 단지 모델에서 지표을 정의하여 각 풍력 터빈 유형에 대한 독립된 통계와 결합된 통계를 계산할 수 있습니다.
상위 자산 모델을 여러 하위 자산 모델과 연결할 수 있습니다. 예를 들어 두 개의 서로 다른 자산 모델로 표현되는 육상 풍력 발전 단지와 해상 풍력 발전 단지가 있는 경우 이러한 자산 모델을 동일한 상위 풍력 발전 단지 자산 모델과 연결할 수 있습니다.
하위 자산 모델을 여러 상위 자산 모델과 연결할 수도 있습니다. 예를 들어, 모든 풍력 터빈이 동일한 자산 모델로 표현되는 두 가지 유형의 풍력 발전 단지가 있는 경우 풍력 터빈 자산 모델을 서로 다른 풍력 발전 단지 자산 모델과 연결할 수 있습니다.
**참고**
자산 모델 계층 구조를 정의할 때 하위 자산 모델은 `ACTIVE`이거나 이전 `ACTIVE` 버전이어야 합니다. 자세한 내용은 [자산 및 모델 상태](asset-and-model-states.md) 단원을 참조하십시오.
계층적 자산 모델을 정의하고 자산을 생성한 후에는 자산을 연결하여 상위-하위 관계를 작성할 수 있습니다. 자세한 내용은 [에서 자산 모델에 대한 자산 생성 AWS IoT SiteWise](create-assets.md) 및 [자산 연결 및 연결 해제](add-associated-assets.md) 섹션을 참조하세요.
**Topics**
+ [자산 모델 계층 구조 정의(콘솔)](#define-asset-hierarchies-console)
+ [자산 계층 정의(AWS CLI)](#define-asset-hierarchies-cli)
## 자산 모델 계층 구조 정의(콘솔)
AWS IoT SiteWise 콘솔에서 자산 모델의 계층 구조를 정의할 때 다음 파라미터를 지정합니다.
+ **계층 구조 이름** - 계층 구조의 이름입니다(예: **Wind Turbines**).
+ **계층 구조 모델** - 하위 자산 모델입니다.
+ **계층 구조 외부 ID**(선택 사항) - 이는 사용자 정의 ID입니다. 자세한 내용은AWS IoT SiteWise 사용 설명서**의 [외부 ID가 있는 참조 객체](object-ids.md#external-id-references)를 참조하세요.
자세한 내용은 [자산 모델 생성(콘솔)](create-asset-models.md#create-asset-model-console) 단원을 참조하십시오.
## 자산 계층 정의(AWS CLI)
AWS IoT SiteWise API를 사용하여 자산 모델의 계층 구조를 정의할 때 다음 파라미터를 지정합니다.
+ `name` - 계층 구조의 이름입니다(예: **Wind Turbines**).
+ `childAssetModelId` - 계층 구조에 대한 하위 자산 모델의 ID 또는 외부 ID입니다. [ListAssetModels](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListAssetModels.html) 작업을 사용하여 기존 자산 모델의 ID를 찾을 수 있습니다.
**Example 계층 구조 정의 예**
다음 예제에서는 풍력 터빈에 대한 풍력 발전소의 관계를 나타내는 자산 모델 계층 구조를 보여 줍니다. 이 객체는 [AssetModelHierarchy](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_AssetModelHierarchy.html)의 예입니다. 자세한 내용은 [자산 모델 생성(AWS CLI)](create-asset-models.md#create-asset-model-cli) 단원을 참조하십시오.
```
{
...
"assetModelHierarchies": [
{
"name": "Wind Turbines",
"childAssetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE"
},
]
}
```