AWS IoT SiteWise 대시보드 생성(AWS CLI) - AWS IoT SiteWise

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

AWS IoT SiteWise 대시보드 생성(AWS CLI)

를 사용하여 대시보드에서 시각화(또는 위젯)를 정의할 때 dashboardDefinition JSON 문서에 다음 정보를 지정 AWS CLI해야 합니다. 이 정의는 CreateDashboard 및 UpdateDashboard 작업의 파라미터입니다.

widgets

각각 다음 정보를 포함하는 위젯 정의 구조의 목록입니다.

type

위젯 유형은 다음과 같은 위젯 유형을 AWS IoT SiteWise 제공합니다.

  • sc-line-chart – 선형 차트입니다. 자세한 내용은 AWS IoT SiteWise Monitor 애플리케이션 안내서의 선형 차트를 참조하세요.

  • sc-scatter-chart- 산점도 차트입니다. 자세한 정보는 AWS IoT SiteWise Monitor 애플리케이션 안내서의 산점도 차트를 참조하세요.

  • sc-bar-chart – 막대 차트입니다. 자세한 내용은 AWS IoT SiteWise Monitor 애플리케이션 안내서의 막대 차트를 참조하세요.

  • sc-status-grid - 자산 속성의 최신 값을 그리드로 표시하는 상태 위젯입니다. 자세한 내용은 AWS IoT SiteWise Monitor 애플리케이션 안내서의 상태 위젯을 참조하세요.

  • sc-status-timeline - 자산 속성의 과거 값을 타임라인으로 표시하는 상태 위젯입니다. 자세한 내용은 AWS IoT SiteWise Monitor 애플리케이션 안내서의 상태 위젯을 참조하세요.

  • sc-kpi – 핵심 성능 지표(KPI) 시각화입니다. 자세한 내용은 AWS IoT SiteWise Monitor 애플리케이션 안내서의 KPI 위젯을 참조하세요.

  • sc-table - 테이블 위젯입니다. 자세한 내용은 AWS IoT SiteWise Monitor 애플리케이션 안내서의 테이블 위젯을 참조하세요.

title

위젯의 제목입니다.

x

그리드의 왼쪽을 기준으로 한 위젯의 수평 위치입니다. 이 값은 대시보드 그리드에서 위젯의 위치를 나타냅니다.

y

그리드의 위쪽을 기준으로 한 위젯의 수직 위치입니다. 이 값은 대시보드 그리드에서 위젯의 위치를 나타냅니다.

width

대시보드 그리드의 공백 수로 표시되는 위젯의 너비입니다.

height

대시보드 그리드의 공백 수로 표시되는 위젯의 높이입니다.

metrics

이 위젯에 대한 데이터 스트림을 각각 정의하는 지표 구조의 목록입니다. 각 목록 구조에는 다음 정보가 포함되어야 합니다.

label

이 지표에 대해 표시할 레이블입니다.

type

이 metric. AWS IoT SiteWise provids에 대한 데이터 소스 유형은 다음과 같은 지표 유형을 제공합니다.

  • iotsitewise - 대시보드는 AWS IoT SiteWise의 자산 속성에 대한 데이터를 가져옵니다. 이 옵션을 선택하는 경우 이 지표에 대한 assetId 및 propertyId를 정의해야 합니다.

assetId

(선택 사항) AWS IoT SiteWise의 자산 ID입니다.

이 지표에서 type으로 iotsitewise를 선택한 경우 이 필드가 필요합니다.

propertyId

(선택 사항) AWS IoT SiteWise의 자산 속성 ID입니다.

이 지표에서 type으로 iotsitewise를 선택한 경우 이 필드가 필요합니다.

analysis

(선택 사항) 위젯에 표시할 분석(예: 추세선)을 정의하는 구조입니다. 자세한 내용은 AWS IoT SiteWise Monitor 애플리케이션 안내서의 추세선 구성을 참조하세요. 위젯의 속성별로 각 유형의 추세선을 하나씩 추가할 수 있습니다. 분석 구조에는 다음 정보가 포함되어 있습니다.

trends

(선택 사항) 이 위젯의 추세 분석을 각각 정의하는 추세 구조 목록입니다. 목록의 각 구조에는 다음 정보가 포함되어 있습니다.

type

추세선 유형. 다음 옵션을 선택합니다.

  • linear-regression - 선형 회귀선을 표시합니다. SiteWise Monitor는 최소 제곱법을 사용하여 선형 회귀를 계산합니다.

annotations

(선택 사항) 위젯의 임계값을 정의하는 주석 구조입니다. 자세한 내용은 AWS IoT SiteWise Monitor 애플리케이션 안내서의 임계값 구성을 참조하세요. 위젯당 최대 6개의 주석을 추가할 수 있습니다. 주석 구조에는 다음 정보가 포함되어 있습니다.

y

(선택 사항) 이 위젯의 수평 임계값을 각각 정의하는 주석 구조 목록입니다. 목록의 각 구조에는 다음 정보가 포함되어 있습니다.

comparisonOperator

임계값에 대한 비교 연산자입니다. 다음 중 하나를 선택합니다.

  • LT - value보다 작은 데이터 포인트가 하나 이상 있는 속성을 강조 표시합니다.

  • GT - value보다 큰 데이터 포인트가 하나 이상 있는 속성을 강조 표시합니다.

  • LTE - value보다 작거나 같은 데이터 포인트가 하나 이상 있는 속성을 강조 표시합니다.

  • GTE - value보다 크거나 같은 데이터 포인트가 하나 이상 있는 속성을 강조 표시합니다.

  • EQ - value와 같은 데이터 포인트가 하나 이상 있는 속성을 강조 표시합니다.

value

데이터 포인트를 comparisonOperator와 비교하기 위한 임계값입니다.

color

(선택 사항) 임계값 색상의 6자리 16진수 코드입니다. 시각화에서는 임계값 규칙을 충족하는 데이터 포인트가 하나 이상 있는 속성에 대한 속성 범례를 이 색상으로 표시합니다. 기본값은 검정색(#000000)입니다.

showValue

(선택 사항) 위젯 여백에 임계값을 표시할지 여부입니다. 기본값은 true입니다.

properties

(선택 사항) 위젯 속성의 기본 사전입니다. 이 구조의 멤버는 컨텍스트에 따라 다릅니다.는 properties를 사용하는 다음 위젯을 AWS IoT SiteWise 제공합니다.

  • 선형 차트, 산점도 차트 및 막대 차트에는 다음과 같은 속성이 있습니다.

    colorDataAcrossThresholds

    (선택 사항) 이 위젯의 임계값을 초과하는 데이터의 색상을 변경할지 여부입니다. 이 옵션을 활성화하면 임계값을 초과하는 데이터가 선택한 색상으로 표시됩니다. 기본값은 true입니다.

  • 상태 그리드에는 다음과 같은 속성이 있습니다.

    labels

    (선택 사항) 상태 그리드에 표시할 레이블을 정의하는 구조입니다. 레이블 구조에는 다음 정보가 포함되어 있습니다.

    showValue

    (선택 사항) 이 위젯의 각 자산 속성에 대한 단위 및 값을 표시할지 여부입니다. 기본값은 true입니다.

예 대시보드 정의 예

다음 예제에서는 JSON 파일에 저장된 페이로드로 대시보드를 정의합니다.

aws iotsitewise create-dashboard \
  --project-id a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE \
  --dashboard-name "Wind Farm Dashboard" \
  --dashboard-definition file://dashboard-definition.json

dashboard-definition.json에 대한 다음 JSON 예제는 다음과 같은 시각화 위젯으로 대시보드를 정의합니다.

  • 대시보드의 왼쪽 상단에 풍력 발전 단지의 총 전력을 시각화하는 꺾은선형 차트입니다. 이 선형 차트에는 풍력 발전 단지가 최소 예상 출력보다 적은 전력을 출력하는 경우를 나타내는 임계값이 포함되어 있습니다. 이 선형 차트에는 선형 회귀 추세선도 포함되어 있습니다.

  • 대시보드의 오른쪽 상단에 네 개의 터빈 풍속을 시각화하는 막대 차트입니다.

참고

이 예제에서는 대시보드의 선형 차트와 막대 차트 시각화를 나타냅니다. 이 대시보드는 풍력 발전 단지 대시보드의 예와 유사합니다.

{
  "widgets": [
    {
      "type": "sc-line-chart",
      "title": "Total Average Power",
      "x": 0,
      "y": 0,
      "height": 3,
      "width": 3,
      "metrics": [
        {
          "label": "Power",
          "type": "iotsitewise",
          "assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
          "propertyId": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
          "analysis": {
            "trends": [
              {
                "type": "linear-regression"
              }
            ]
          }
        }
      ],
      "annotations": {
        "y": [
          {
            "comparisonOperator": "LT",
            "value": 20000,
            "color": "#D13212",
            "showValue": true
          }
        ]
      }
    },
    {
      "type": "sc-bar-chart",
      "title": "Wind Speed",
      "x": 3,
      "y": 3,
      "height": 3,
      "width": 3,
      "metrics": [
        {
          "label": "Turbine 1",
          "type": "iotsitewise",
          "assetId": "a1b2c3d4-5678-90ab-cdef-2a2a2EXAMPLE",
          "propertyId": "a1b2c3d4-5678-90ab-cdef-55555EXAMPLE"
        },
        {
          "label": "Turbine 2",
          "type": "iotsitewise",
          "assetId": "a1b2c3d4-5678-90ab-cdef-2b2b2EXAMPLE",
          "propertyId": "a1b2c3d4-5678-90ab-cdef-55555EXAMPLE"
        },
        {
          "label": "Turbine 3",
          "type": "iotsitewise",
          "assetId": "a1b2c3d4-5678-90ab-cdef-2c2c2EXAMPLE",
          "propertyId": "a1b2c3d4-5678-90ab-cdef-55555EXAMPLE"
        },
        {
          "label": "Turbine 4",
          "type": "iotsitewise",
          "assetId": "a1b2c3d4-5678-90ab-cdef-2d2d2EXAMPLE",
          "propertyId": "a1b2c3d4-5678-90ab-cdef-55555EXAMPLE"
        }
      ]
    }
  ]
}