本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 创建 AWS IoT SiteWise 仪表板 (AWS CLI) **注意** 新客户不再可以使用 SiteWise 监控功能。现有客户可以继续正常使用该服务。有关更多信息，请参阅[SiteWise 监控器可用性更改](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-monitor-availability-change.html)。 使用在仪表板中定义可视化（或微件）时 AWS CLI，必须在 `dashboardDefinition` JSON 文档中指定以下信息。此定义是[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 提供以下控件类型： + `sc-line-chart` – 折线图。有关更多信息，请参阅 *AWS IoT SiteWise Monitor 应用指南*中的[折线图](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/choose-visualization-types.html#line-charts)。 + `sc-scatter-chart` – 散点图。有关更多信息，请参阅*AWS IoT SiteWise Monitor 应用程序指南*中的[散点图](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/choose-visualization-types.html#scatter-charts)。 + `sc-bar-chart` – 条形图。有关更多信息，请参阅*AWS IoT SiteWise Monitor 应用指南*中的[条形图](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/choose-visualization-types.html#bar-charts)。 + `sc-status-grid` – 一个状态控件，以网格形式显示资产属性的最新值。有关更多信息，请参阅*AWS IoT SiteWise Monitor 应用程序指南中的*[状态控件](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/choose-visualization-types.html#status-widgets)。 + `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` 该指标的数据源类型。 AWS IoT SiteWise 提供以下指标类型： + `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 位十六进制代码。对于至少有一个数据点符合阈值规则的属性，可视化效果会以这种颜色显示属性图例。默认值为黑色（`#000000`）。 `showValue` 或者，是否在控件的边距中显示阈值的值。默认值为 `true`。 `properties` （可选）小部件属性的平面字典。该结构的成员取决于上下文。 AWS IoT SiteWise 提供了以下使用的小部件`properties`： + [折线图](#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" } ] } ] } ```