속성과 기타 자산의 데이터 집계(지표)

지표는 집계 함수를 사용하여 모든 입력 데이터 포인트를 처리하고 지정된 시간 간격당 단일 데이터 포인트를 출력하는 수학 표현식입니다. 예를 들어, 어떤 지표는 온도 데이터 스트림의 시간별 평균 온도를 계산할 수 있습니다.

지표는 연결된 자산의 지표에서 데이터를 입력할 수 있으므로 작업 또는 작업의 하위 집합에 대한 통찰을 제공하는 통계를 계산할 수 있습니다. 예를 들어, 지표는 풍력 발전소의 모든 풍력 터빈에 대한 시간당 평균 온도를 계산할 수 있습니다. 자산 간의 연결을 정의하는 방법에 대한 자세한 내용은 자산 모델 계층 구조 정의 단원을 참조하세요.

또한 지표는 각 시간 간격의 데이터를 집계하지 않고도 다른 속성의 데이터를 입력할 수 있습니다. 공식에서 속성을 지정하는 경우 공식을 계산할 때 AWS IoT SiteWise 는 해당 속성의 최신 값을 사용합니다. 공식에서 지표를 지정하는 경우 수식을 계산하는 시간 간격의 마지막 값을 AWS IoT SiteWise 사용합니다. 즉, OEE = Availability * Quality * Performance와 같은 지표를 정의할 수 있습니다. 여기서 Availability, Quality, Performance는 모두 동일한 자산 모델의 다른 지표입니다.

AWS IoT SiteWise 또한 모든 자산 속성에 대한 기본 집계 지표 세트를 자동으로 계산합니다. 계산 비용을 줄이기 위해, 기본 계산에 대한 사용자 지정 지표를 정의하는 대신 이러한 집계를 사용할 수 있습니다. 자세한 정보는 자산 속성 집계 쿼리을 참조하세요.

지표 정의(콘솔)

AWS IoT SiteWise 콘솔에서 자산 모델의 지표를 정의할 때 다음 매개변수를 지정합니다.

이름 – 속성의 이름입니다.
데이터 유형 - 변환의 데이터 유형으로, 실수 또는 문자열일 수 있습니다.
외부 ID - (선택 사항) 사용자 정의 ID입니다. 자세한 내용은AWS IoT SiteWise 사용 설명서의 외부 ID를 사용하여 개체 참조를 참조하십시오.
공식 - 지표 표현식입니다. 지표 표현식은 집계 함수를 사용하여 계층 구조의 모든 관련 자산에 대한 속성 데이터를 입력할 수 있습니다. 입력을 시작하거나 아래쪽 화살표 키를 눌러 자동 완성 기능을 엽니다. 자세한 정보는 공식 표현식 사용을 참조하세요.

중요
지표는 정수, 실수, 부울 또는 문자열 유형의 속성만 입력할 수 있습니다. 부울은 0(거짓)와 1(참)로 변환됩니다.
지표의 표현식에서 지표 입력 변수를 정의하는 경우, 이러한 입력의 시간 간격은 출력 지표와 동일해야 합니다.
공식 표현식은 실수 또는 문자열 값만 출력할 수 있습니다. 중첩 표현식은 문자열과 같은 다른 데이터 유형을 출력할 수 있지만 공식 전체는 숫자나 문자열로 평가되어야 합니다. jp 함수를 사용하여 문자열을 숫자로 변환할 수 있습니다. 부울 값은 1(참) 또는 0(거짓)이어야 합니다. 자세한 정보는 정의되지 않은 값, 무한 값 및 오버플로우 값을 참조하세요.
시간 간격 - 시간 간격 지표입니다. AWS IoT SiteWise 는 다음 연속 창 시간 간격을 지원하며, 여기서 각 간격은 이전 간격이 끝날 때 시작됩니다.
- 1분 - 1분입니다. 1분이 끝날 때마다 계산됩니다(오전 12:00:00, 오전 12:01:00, 오전 12:02:00 등).
- 5분 - 5분입니다. 정각에 시작하여 5분이 끝날 때마다 계산됩니다(오전 12:00:00, 오전 12:05:00, 오전 12:10:00 등).
- 15분 - 15분입니다. 정각에 시작하여 15분이 끝날 때마다 계산됩니다(오전 12:00:00, 오전 12:15:00, 오전 12:30:00 등).
- 1시간 - 1시간(60분)입니다. UTC를 기준으로 한 시간이 끝날 때마다 계산됩니다(오전 12:00:00, 오전 01:00:00, 오전 02:00:00 등).
- 1일 - 1일(24시간)입니다. UTC를 기준으로 하루가 끝날 때마다 계산됩니다(월요일 오전 12:00:00, 화요일 오전 12:00:00 등).
- 1주 - 1주(7일)입니다. UTC를 기준으로 일요일이 끝날 때마다 계산됩니다(매주 월요일 오전 12:00:00).
- 사용자 지정 간격 - 1분에서 1주 사이의 원하는 시간 간격을 입력할 수 있습니다.
오프셋 날짜 - (선택 사항) 데이터를 집계할 기준 날짜입니다.
오프셋 시간 - (선택 사항) 데이터를 집계할 기준 시간입니다. 오프셋 시간은 00:00:00 에서 23:59:59 사이여야 합니다.
오프셋 시간대 - (선택 사항) 오프셋의 시간대입니다. 지정되지 않은 경우 기본 오프셋 시간대는 협정 세계시(UTC)입니다.
- (UTC+00:00) 협정 세계시
- (UTC+01:00) 유럽 중부 표준시
- (UTC+02:00) 동유럽
- (UTC+03:00) 동부 아프리카 표준시
- (UTC+04:00) 근동 표준시
- (UTC+05:00) 파키스탄 라호르 표준시
- (UTC+05:30) 인도 표준시
- (UTC+06:00) 방글라데시 표준시
- (UTC+07:00) 베트남 표준시
- (UTC+08:00) 중국 대만 표준시
- (UTC+09:00) 일본 표준시
- (UTC+09:30) 오스트레일리아 중부 표준시
- (UTC+10:00) 오스트레일리아 동부 표준시
- (UTC+11:00) 솔로몬 표준시
- (UTC+12:00) 뉴질랜드 표준시
- (UTC-11:00) 미드웨이 제도 표준시
- (UTC-10:00) 하와이 표준시
- (UTC-09:00) 알래스카 표준시
- (UTC-08:00) 태평양 표준시
- (UTC-07:00) 피닉스 표준시
- (UTC-06:00) 미국 중부 표준시
- (UTC-05:00) 미국 동부 표준시
- (UTC-04:00) 푸에르토리코 및 미국령 버진아일랜드 표준시
- (UTC-03:00) 아르헨티나 표준시
- (UTC-02:00) 사우스조지아 표준시
- (UTC-01:00) 중앙아프리카 표준시

예 오프셋 사용 사용자 지정 시간 간격(콘솔)

다음 예제는 2021년 2월 20일 오후 6시 30분(PST)에 오프셋을 사용하여 12시간 간격을 정의하는 방법을 보여줍니다.

오프셋을 사용하여 사용자 지정 구간을 정의하려면

시간 간격의 경우 사용자 지정 간격을 선택합니다.
시간 간격의 경우 다음 중 하나를 수행하세요.
- 12를 입력한 다음 시간을 선택합니다.
- 720을 입력한 다음 분을 선택합니다.
- 43200을 입력한 다음 초를 선택합니다.
중요
시간 간격은 단위에 관계없이 정수여야 합니다.
오프셋 날짜로 2021/02/20을 선택합니다.
오프셋 시간에는 18:30:30을 입력합니다.
오프셋 시간대의 경우 (UTC-08:00) 태평양 표준시를 선택합니다.

2021년 7월 1일 오후 6시 30분 30분 (PST) 이전 또는 이전에 지표를 생성한 경우, 2021년 7월 1일 오후 6시 30분 (PST) 에 첫 번째 집계 결과를 얻을 수 있습니다. 두 번째 집계 결과는 2021년 7월 2일 오전 6시 30분 30분 (PST) 등입니다.

지표 정의 ()AWS CLI

AWS IoT SiteWise API를 사용하여 자산 모델의 지표를 정의할 때 다음 매개변수를 지정합니다.

name - 속성의 이름입니다.
dataType – 지표의 데이터 유형으로 DOUBLE 또는 STRING일 수 있습니다.
externalId— (선택 사항) 사용자 정의 ID입니다. 자세한 내용은AWS IoT SiteWise 사용 설명서의 외부 ID를 사용하여 개체 참조를 참조하십시오.
expression – 지표 표현식입니다. 지표 표현식은 집계 함수를 사용하여 계층 구조의 모든 관련 자산에 대한 속성 데이터를 입력할 수 있습니다. 자세한 정보는 공식 표현식 사용을 참조하세요.
window - 이전 간격이 끝날 때 각 간격이 시작되는 지표의 연속 창에 대한 시간 간격 및 오프셋:
- interval – 연속 창의 시간 간격입니다. 시간 간격은 1분과 1주 사이여야 합니다.
- offsets - 연속 창의 오프셋입니다.
자세한 내용은 AWS IoT SiteWise API TumblingWindow참조를 참조하십시오.
예 오프셋이 있는 사용자 지정 시간 간격(AWS CLI)
다음 예제는 2021년 2월 20일 오후 6시 30분(PST)에 오프셋을 사용하여 12시간 간격을 정의하는 방법을 보여줍니다.
```
{
    "window": {
        "tumbling": {
            "interval": "12h",
            "offset": " 2021-07-23T18:30:30-08"
        }
    }
}
```
2021년 7월 1일, 오후 6시 30분 30분 (PST) 이전 또는 이전에 지표를 생성하면 2021년 7월 1일 오후 6시 30분 (PST) 에 첫 번째 집계 결과를 얻을 수 있습니다. 두 번째 집계 결과는 2021년 7월 2일 오전 6시 30분 30분 (PST) 등입니다.
variables – 표현식에 사용할 자산 또는 하위 자산의 기타 속성을 정의하는 변수 목록입니다. 각 변수 구조에는 표현식에 사용할 간단한 이름과 해당 변수에 연결할 속성을 지정하는 value 구조가 포함되어 있습니다. value 구조에는 다음 정보가 포함되어 있습니다.
- propertyId – 값을 가져올 속성의 ID입니다. 속성이 계층의 모델에 정의되어 있지 않고 현재 모델에 정의된 경우 ID 대신 속성 이름을 사용할 수 있습니다.
- hierarchyId – (선택 사항) 속성에 대한 하위 자산을 쿼리할 계층의 ID입니다. ID 대신 계층 정의의 이름을 사용할 수 있습니다. 이 값을 생략하면 현재 모델에서 속성을 AWS IoT SiteWise 찾습니다.
중요
지표는 정수, 실수, 부울 또는 문자열 유형의 속성만 입력할 수 있습니다. 부울은 0(거짓)와 1(참)로 변환됩니다.
지표의 표현식에서 지표 입력 변수를 정의하는 경우, 이러한 입력의 시간 간격은 출력 지표와 동일해야 합니다.
공식 표현식은 실수 또는 문자열 값만 출력할 수 있습니다. 중첩 표현식은 문자열과 같은 다른 데이터 유형을 출력할 수 있지만 공식 전체는 숫자나 문자열로 평가되어야 합니다. jp 함수를 사용하여 문자열을 숫자로 변환할 수 있습니다. 부울 값은 1(참) 또는 0(거짓)이어야 합니다. 자세한 정보는 정의되지 않은 값, 무한 값 및 오버플로우 값을 참조하세요.
unit – (선택 사항) 속성에 대한 과학적 단위(예: mm 또는 섭씨)입니다.

예 지표 정의 예

다음 예제에서는 자산의 온도 측정 데이터를 집계하여 시간당 최대 화씨 온도를 계산하는 지표 속성을 보여줍니다. 이 개체는 메트릭이 포함된 AssetModel속성의 예입니다. 이 객체를 CreateAsset모델 요청 페이로드의 일부로 지정하여 지표 속성을 생성할 수 있습니다. 자세한 정보는 자산 모델 생성 (AWS CLI)을 참조하세요.



{
      ...
      "assetModelProperties": [
      ...
      {
        "name": "Max temperature",
        "dataType": "DOUBLE",
        "type": {
          "metric": {
            "expression": "max(temp_f)",
            "variables": [
              {
                "name": "temp_f",
                "value": {
                  "propertyId": "Temperature F"
                }
              }
            ],
            "window": {
              "tumbling": {
                "interval": "1h"
              }
            }
          }
        },
        "unit": "Fahrenheit"
      }
    ],
    ...
}

예 관련 자산에서 데이터를 입력하는 지표 정의 예시

다음 예는 여러 풍력 터빈의 평균 전력 데이터를 집계하여 풍력 발전 단지의 총 평균 전력을 계산하는 지표 속성을 보여줍니다. 이 객체는 메트릭이 포함된 AssetModel속성의 예입니다. 이 객체를 CreateAsset모델 요청 페이로드의 일부로 지정하여 지표 속성을 생성할 수 있습니다.


{
      ...
      "assetModelProperties": [
      ...
      {
          "name": "Total Average Power",
          "dataType": "DOUBLE",
          "type": {
            "metric": {
              "expression": "avg(power)",
              "variables": [
                {
                  "name": "power",
                  "value": {
                    "propertyId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
                    "hierarchyId": "Turbine Asset Model"
                  }
                }
              ],
              "window": {
                "tumbling": {
                  "interval": "5m"
                }
              }
            }
        },
        "unit": "kWh"
      }
    ],
    ...
}

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

데이터 변환(변환)

공식 표현식 사용