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

# AWS IoT SiteWise 대시보드 생성(AWS CLI)
<a name="create-dashboards-using-aws-cli"></a>

**참고**  
SiteWise Monitor 기능은 더 이상 신규 고객이 사용할 수 없습니다. 기존 고객은 정상적으로 서비스를 계속 이용할 수 있습니다. 자세한 내용은 [SiteWise Monitor 가용성 변경을](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-monitor-availability-change.html) 참조하세요.

를 사용하여 대시보드에서 시각화(또는 위젯)를 정의할 때 `dashboardDefinition` JSON 문서에 다음 정보를 지정 AWS CLI해야 합니다. 이 정의는 [CreateDashboard](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateDashboard.html) 및 [UpdateDashboard](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateDashboard.html) 작업의 파라미터입니다.

`widgets`  
각각 다음 정보를 포함하는 위젯 정의 구조의 목록입니다.    
`type`  
위젯 유형은 다음과 같은 위젯 유형을 AWS IoT SiteWise 제공합니다.  
+ <a name="monitor-line-chart"></a>`sc-line-chart` – 선형 차트입니다. 자세한 내용은 *AWS IoT SiteWise Monitor 애플리케이션 안내서*의 [선형 차트](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/choose-visualization-types.html#line-charts)를 참조하세요.
+ <a name="monitor-scatter-chart"></a>`sc-scatter-chart`- 산점도 차트입니다. 자세한 정보는 *AWS IoT SiteWise Monitor 애플리케이션 안내서*의 [산점도 차트](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/choose-visualization-types.html#scatter-charts)를 참조하세요.
+ <a name="monitor-bar-chart"></a>`sc-bar-chart` – 막대 차트입니다. 자세한 내용은 *AWS IoT SiteWise Monitor 애플리케이션 안내서*의 [막대 차트](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/choose-visualization-types.html#bar-charts)를 참조하세요.
+ <a name="monitor-status-grid"></a>`sc-status-grid` - 자산 속성의 최신 값을 그리드로 표시하는 상태 위젯입니다. 자세한 내용은 *AWS IoT SiteWise Monitor 애플리케이션 안내서*의 [상태 위젯](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/choose-visualization-types.html#status-widgets)을 참조하세요.
+ <a name="monitor-status-timeline"></a>`sc-status-timeline` - 자산 속성의 과거 값을 타임라인으로 표시하는 상태 위젯입니다. 자세한 내용은 *AWS IoT SiteWise Monitor 애플리케이션 안내서*의 [상태 위젯](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/choose-visualization-types.html#status-widgets)을 참조하세요.
+ `sc-kpi` – 핵심 성능 지표(KPI) 시각화입니다. 자세한 내용은 *AWS IoT SiteWise Monitor 애플리케이션 안내서*의 [KPI 위젯](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/choose-visualization-types.html#kpi-charts)을 참조하세요.
+ `sc-table` - 테이블 위젯입니다. 자세한 내용은 *AWS IoT SiteWise Monitor 애플리케이션 안내서*의 [테이블 위젯](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/choose-visualization-types.html#table-widgets)을 참조하세요.  
`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 애플리케이션 안내서*의 [추세선 구성](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/configure-trend-lines.html)을 참조하세요. 위젯의 속성별로 각 유형의 추세선을 하나씩 추가할 수 있습니다. 분석 구조에는 다음 정보가 포함되어 있습니다.    
`trends`  
(선택 사항) 이 위젯의 추세 분석을 각각 정의하는 추세 구조 목록입니다. 목록의 각 구조에는 다음 정보가 포함되어 있습니다.    
`type`  
추세선 유형. 다음 옵션을 선택합니다.  
+ `linear-regression` - 선형 회귀선을 표시합니다. SiteWise Monitor는 [최소 제곱](https://en.wikipedia.org/wiki/Least_squares)법을 사용하여 선형 회귀를 계산합니다.  
`annotations`  
(선택 사항) 위젯의 임계값을 정의하는 주석 구조입니다. 자세한 내용은 *AWS IoT SiteWise Monitor 애플리케이션 안내서*의 [임계값 구성](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/configure-thresholds.html)을 참조하세요. 위젯당 최대 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 제공합니다.  
+ [선형 차트](#monitor-line-chart), [산점도 차트](#monitor-scatter-chart) 및 [막대 차트](#monitor-bar-chart)에는 다음과 같은 속성이 있습니다.  
`colorDataAcrossThresholds`  
(선택 사항) 이 위젯의 임계값을 초과하는 데이터의 색상을 변경할지 여부입니다. 이 옵션을 활성화하면 임계값을 초과하는 데이터가 선택한 색상으로 표시됩니다. 기본값은 `true`입니다.
+ [상태 그리드](#monitor-status-grid)에는 다음과 같은 속성이 있습니다.  
`labels`  
(선택 사항) 상태 그리드에 표시할 레이블을 정의하는 구조입니다. 레이블 구조에는 다음 정보가 포함되어 있습니다.    
`showValue`  
(선택 사항) 이 위젯의 각 자산 속성에 대한 단위 및 값을 표시할지 여부입니다. 기본값은 `true`입니다.

**Example 대시보드 정의 예**  
다음 예제에서는 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 예제는 다음과 같은 시각화 위젯으로 대시보드를 정의합니다.  
+ 대시보드의 왼쪽 상단에 풍력 발전 단지의 총 전력을 시각화하는 꺾은선형 차트입니다. 이 선형 차트에는 풍력 발전 단지가 최소 예상 출력보다 적은 전력을 출력하는 경우를 나타내는 임계값이 포함되어 있습니다. 이 선형 차트에는 선형 회귀 추세선도 포함되어 있습니다.
+ 대시보드의 오른쪽 상단에 네 개의 터빈 풍속을 시각화하는 막대 차트입니다.
이 예제에서는 대시보드의 선형 차트와 막대 차트 시각화를 나타냅니다. 이 대시보드는 [풍력 발전 단지 대시보드의 예](monitor-data.md)와 유사합니다.

```
{
  "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"
        }
      ]
    }
  ]
}
```