本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 在 Grafana 中可视化和共享数据
<a name="visualize-with-grafana"></a>

本教程将指导您使用 Amazon IoT SiteWise 数据可视化平台 Grafana 配置数据源插件。借助 Grafana，您可以创建用于可视化和监控工业数据的仪表板。在本教程中，使用风力发电场演示中的示例数据集来说明关键概念。熟悉该过程后，你可以用自己的数据重复本教程。

 完成本教程后，您可以执行以下操作：
+ 收集、查询和分析来自工业设备的数据
+ 创建交互式 Grafana 仪表板以可视化资产绩效指标
+ 通过统一界面监控运营数据
+ 使用 Grafana 的协作功能与您的团队分享见解
+ 将 Amazon IoT SiteWise 数据与其他 Amazon 数据源（例如[亚马逊 CloudWatch或亚马逊](https://www.amazonaws.cn/cloudwatch/) [Time](https://www.amazonaws.cn/timestream/) stream）相结合

**Topics**
+ [先决条件](#grafana-tutorial-prerequisites)
+ [第 1 步：配置您的亚马逊托管 Grafana 工作空间](#configure-workspace)
+ [步骤 2：添加 Amazon IoT SiteWise 为数据源](#add-iot-data-source)
+ [第 3 步：创建仪表板以浏览和可视化您的数据](#explore-your-data)
+ [（可选）步骤 4：设置警报以监控性能](#set-up-alerts)
+ [第 5 步：完成教程后清理资源](#clean_up_resources)
+ [其他资源](#additional-resources)

## 先决条件
<a name="grafana-tutorial-prerequisites"></a>

要完成本教程，您需要：
+ 一个 Amazon Web Services 账户。如果没有，请参阅[设置一个 Amazon 账户](getting-started.md#set-up-aws-account)。
+ 具有管理员权限的 Amazon Identity and Access Management (IAM) 用户。有关详细说明，请参阅[如何 Amazon IoT SiteWise 与 IAM 配合使用](security_iam_service-with-iam.md)。
+ 一个正在运行的 Amazon IoT SiteWise 演示。
**注意**  
本教程需要使用在 Use the [Amazon IoT SiteWise demo 中创建的](getting-started-demo.md)资源。在继续本教程之前，必须先完成本教程。

  创建该演示通常需要大约 3 分钟。如果演示创建失败，则可能表明您的 Amazon 账户权限不足。在这种情况下，请切换到具有管理权限的帐户。有关所需权限的更多信息，请参阅[如何 Amazon IoT SiteWise 与 IAM 配合使用](security_iam_service-with-iam.md)。
**重要**  
在完成本教程之前，请保留所有演示资源。删除任何组件都可能会中断演示的功能并影响您在 Grafana 中显示数据的能力。

## 第 1 步：配置您的亚马逊托管 Grafana 工作空间
<a name="configure-workspace"></a>

在此过程中，创建并配置 Amazon Managed Grafana 工作空间，以可视化您的风电场数据。

1. 登录[亚马逊托管 Grafana](https://console.amazonaws.cn/grafana/) 控制台。

1. 选择**创建工作区**。

1. 在**工作区详细信息**下，输入工作空间的名称，例如**SiteWiseTutorialDemo**。

1. 在 **Grafana** 版本下，选择最新版本。选择此版本可获得最多的 up-to-date特性和功能。有关不同版本集的更多信息，请参阅*亚马逊托管* [Grafana 用户指南中的 Grafana 版本之间的差异](https://docs.amazonaws.cn/grafana/latest/userguide/version-differences.html)。

1. 选择**下一步**。

1. 在 “**身份验证访问权限**” 下，选择 **Amazon IAM 身份中心**。
   + 如果您的账户 Amazon 中的 IAM 身份中心未启用，系统将提示您先进行设置。*有关如何设置用户访问权限的详细说明，请参阅亚马逊托管 Grafana 用户指南中的[亚马逊托管 Grafana 基于身份的策略示例](https://docs.amazonaws.cn/grafana/latest/userguide/security_iam_id-based-policy-examples.html#security_iam_id-based-policy-examples-create-workspace-standalone)。*

1. 在 “**权限类型**” 下，选择 “**服务管理**”。Amazon Managed Grafana 会自动为您选择在此工作空间中使用的 Amazon 任何数据源创建和配置必要的 IAM 角色和权限。对于组织成员账户，只有当账户被指定为委托管理员时，服务管理选项才可用。有关设置委派管理员账户的信息，请参阅*《Amazon CloudFormation 用户指南》*中的[注册委托管理员成员账户](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/stacksets-orgs-delegated-admin.html)。

1. 在 **“工作区配置选项”** 下，执行以下操作：

   1. 选择 “**打开 Grafana 提醒**”。使用此设置，您可以通过工作区中的集中式界面创建和管理警报。有关更多信息，请参阅《*亚马逊托管* [Grafana 用户指南》中的 “使用 Grafana](https://docs.amazonaws.cn/grafana/latest/userguide/alerts-overview.html) 提醒”。

   1. 选择 “**开启插件管理”**。这允许您在工作区中安装、更新和卸载插件。有关更多信息，请参阅《*Amazon Managed Grafana* 用户指南》中的[使用插件扩展您的工作空间](https://docs.amazonaws.cn/grafana/latest/userguide/grafana-plugins.html)。
**重要**  
请务必启用插件管理。如果不选择此选项，则无法在后续步骤中添加 Amazon IoT SiteWise 为数据源。

1. 在 “**网络访问控制**” 下，选择 “**开放访问**”。您将在本教程中使用演示数据，因此可以公开使用工作区。
   + **开放访问**-允许公开访问您的工作空间。
   + **限制访问**-限制对特定 IP 范围或 VPC 终端节点的访问。有关更多信息，[请参阅《*亚马逊托管 Grafana* 用户指南》中的 VPC 连接的工作原理](https://docs.amazonaws.cn/grafana/latest/userguide/AMG-configure-vpc.html#AMG-VPC-how-it-works)。

1. 选择**下一步**。

1. 在**服务托管权限设置**页面下，选择**当前账户**，让 Amazon Managed Grafana 自动创建 Amazon 访问您账户内数据的策略和权限。

1. 在 “**数据源**” 下，选择**Amazon IoT SiteWise**。有关更多信息，请参阅《*亚马逊托管 Grafana* 用户指南》中的 “[连接到 Amazon IoT SiteWise 数据源](https://docs.amazonaws.cn/grafana/latest/userguide/using-iotsitewise-in-AMG.html)”。

1. （可选）在**通知渠道**下，选择**亚马逊 SNS 以允许通过亚马逊 SNS** 发送 Grafana 提醒。这将创建一个 IAM 策略，允许向亚马逊 SNS 发布名称以 Grafana 开头的主题。稍后你需要在工作区内的 Grafana 控制台中完成通知频道设置。

1. 确认工作区的详细信息，然后选择**创建工作区**。此过程需要几分钟。

1. 在 “**身份验证**” 选项卡上**Amazon 的 IAM Identity Cen** ter 下，通过执行以下操作将用户或群组分配到您的工作空间：

   1. 要分配管理 Amazon IoT SiteWise 数据的用户，请选择**分配新用户或群组**。然后从 “**操作**” 下拉列表中选择 “**设为管理员**”，授予他们管理权限。
**重要**  
要管理 Grafana 工作区，必须将角色分配给`Admin`至少一个用户。该用户将拥有对 Grafana 工作区控制台的完全访问权限。

现在，您已经设置并配置了您的 Grafana 工作空间。在下一步中，您可以添加 Amazon IoT SiteWise 为数据源，然后开始为风力发电场数据创建可视化效果。在您的工作空间中，您可以实时查询、可视化和分析您的工业数据。*有关亚马逊托管 Grafana 工作空间的更多信息，请参阅亚马逊托管 Grafana 用户指南中的[使用您的 Grafana](https://docs.amazonaws.cn/grafana/latest/userguide/using-grafana-workspace.html) 工作空间。*

## 步骤 2：添加 Amazon IoT SiteWise 为数据源
<a name="add-iot-data-source"></a>

为了帮助您可视化数据，Amazon Managed Grafana 包含 Amazon 数据源插件，可简化连接的过程。 Amazon Web Services 服务此插件已预先安装在您的工作区中，它提供了一个统一的界面，用于发现和配置 Amazon 资源作为数据源。为了实现风力发电场的可视化，您将使用此插件进行连接 Amazon IoT SiteWise。有关更多信息，请参阅《*亚马逊托管 Grafana* 用户指南》中的 “[连接到 Amazon IoT SiteWise 数据源](https://docs.amazonaws.cn/grafana/latest/userguide/using-iotsitewise-in-AMG.html)”。

在开始查询风电场数据之前， Amazon 数据源插件需要相应的权限才能访问您的 Amazon IoT SiteWise 资源。当您在上一步中选择 Amazon IoT SiteWise 作为数据源时，这些权限是自动配置的。有关插件权限的更多信息，请参阅 *Amazon Managed Grafana* 用户指南中的[必需权限](https://docs.amazonaws.cn/grafana/latest/userguide/AMG-configure-permissions.html)。

** Amazon IoT SiteWise 连接到你的 Grafana 工作空间**

1. 打开 [Amazon Managed Grafana 控制台](https://console.amazonaws.cn/grafana/)。在您的工作空间详情页面中，选择 **Grafana** 工作空间 URL 下显示的网址。工作空间 URL 将打开 Grafana 工作空间控制台登录页面。

1. 选择**使用 Amazon IAM 身份中心登录**并输入您的证书。只有当你回复了 Amazon Managed Grafana 发送的提示你为 IAM 身份中心创建密码的电子邮件时，这些证书才有效。

1. 在左侧导航窗格中，选择**应用程序**，然后选择**Amazon 数据源**，然后选择**Amazon Web Services 服务**选项卡。

1. 在 “**立即安装” 下 **Amazon IoT SiteWise**，选择 “立即**安装” 以安装最新版本的 Amazon IoT SiteWise 插件。

1. 导航到**数据源**选项卡，然后选择**物联网 SiteWise**作为服务。

1. 在**默认区域**下，选择要从中检索数据的区域，例如**美国东部（弗吉尼亚北部）**。

1. 为插件指定参数后，选择**添加数据源**。

1. 选择 “**前往设置”**。

1. 在 “**连接详细信息**” 下，选择 “**保存并测试**” 以验证服务是否正常运行。

## 第 3 步：创建仪表板以浏览和可视化您的数据
<a name="explore-your-data"></a>

在此步骤中，创建 Grafana 仪表板，以可视化您之前创建的演示风电场数据。仪表板通过在单个视图中显示多个可视化效果来帮助您监控数据。您可以使用仪表板来跟踪指标、分析模式并从工业数据中获得见解。有关更多信息，请参阅《*亚马逊托管 Grafana* 用户指南》中的[创建您的第一个控制面板](https://docs.amazonaws.cn/grafana/latest/userguide/getting-started-grafanaui.html)。

**在 Grafana 中创建你的第一个控制面板**

1. 在左侧导航窗格中，选择**仪表板**，然后选择**创建仪表板**开始构建您的第一个仪表板。

1. 选择**添加可视化**。这将打开面板编辑器，您可以在其中配置数据源、查询和可视化设置。

1. 在 “**查询**” 选项卡下，从下拉菜单中选择 Amazon IoT SiteWise 数据源。

1. 在 “**查询类型**” 下，从下拉菜单中选择 “**获取属性值聚合**”，以检索一段时间内资产属性的聚合值。

1. 选择 “**浏览**” 以查看层次结构中的可用资产。从 “**层次结构**” 选项卡中，选择 “**演示风电场资产**”，然后选择 “**演示涡轮机资产 1**”。

1. 在 “**属性**” 下，从可用属性中选择 “**平均功率**”。选择 “**运行查询**” 以运行查询，以便您可以预览输出。可视化将更新以显示的平均功率数据`Demo Turbine Asset 1`。

1. 在右侧导航窗格中，为新面板指定一个标题，例如**Turbine Demo 1 (Average Power)**。选择 **Apply (应用)** 以保存更改。
**警告**  
每当你对仪表板进行任何更改时，请先保存仪表板，然后再刷新页面或导航离开。否则，您将失去进度。

1. 在右上角，选择**保存仪表板**。系统将提示您输入仪表板的名称，例如**SiteWise Wind Farm Demo Dashboard**。

1. 选择**保存**。

有关共享控制面板的信息，请参阅 *Amazon Managed Grafana* [用户指南中的共享控制面板和面板](https://docs.amazonaws.cn/grafana/latest/userguide/v10-dash-sharing.html)。

**添加另一个面板以可视化风速**

1. 选择**添加可视化**以打开一个空白面板。

1. 在 “**查询**” 选项卡下，从下拉菜单中选择 Amazon IoT SiteWise 数据源。

1. 在 “**查询类型**” 下，从下拉菜单中选择 “**获取属性值**”`Demo Wind Farm Asset`，然后在 “**资产**” 下选择`Demo Turbine Asset 1`。

1. 在 “**属性**” 下，从可用属性中选择 “**风速**”。选择 “**运行查询**” 以更新更改。

1. 在 “**可视化**” 下，选择**仪表**。仪表最适合显示风速等单个实时指标。

1. 在右侧导航窗格中，为新面板指定一个标题，例如**Turbine Demo 1 (Wind Speed)**。

1. 在 “面板**” 选项的 “标准**” 选项下，选择 “**单位**”。选择 “**速度**”，然后选择 “**meters/second (m/s)**”。

1. 选择 **Apply (应用)** 以保存更改。

   下图显示了完成此步骤后 Grafana 仪表板的外观。  
![使用风电场演示数据创建的示例仪表板。](http://docs.amazonaws.cn/iot-sitewise/latest/userguide/images/updated-grafana.png)

## （可选）步骤 4：设置警报以监控性能
<a name="set-up-alerts"></a>

警报在发生后会显示状态变化，以识别您的工业设备的性能问题。有关更多信息，请参阅[亚马逊托管 Grafana 用户指南中的*亚马逊托管* Grafana](https://docs.amazonaws.cn/grafana/latest/userguide/alerts-overview.html) 提醒。

**在 Grafana 中设置提醒**

1. 在 “**规则**” 选项卡下`Turbine Demo 1 (Average Power)`，将 “**评估每个** to” `5m` 和 “For” 设置**为**`15m`。此配置每 5 分钟评估一次平均功率，如果情况持续超过 15 分钟，则会触发警报。

1. 在 “**条件**” 下，选择 “**低于**” 并输入**7,020**瓦特。如果平均涡轮机状态降至低于 7,020 瓦特且持续时间超过 5 分钟，则此设置将通知您。有关创建警报的更多信息，请参阅 *Amazon Managed Grafana 用户指南*中的[警报规则字段](https://docs.amazonaws.cn/grafana/latest/userguide/old-create-alerts.html#old-alert-rule-fields)。

您已完成本教程。在此过程中，您创建了一个 Grafana 工作区，并将其配置为可视化来自的风电场数据。 Amazon IoT SiteWise您构建了一个包含多种控件类型的交互式仪表板，包括平均功率的时间序列图和风速仪表。您还可以设置警报来监控涡轮机性能，使您能够在潜在问题中断生产之前将其识别出来。您可以通过添加更多可视化效果、创建更多警报或连接其他 Amazon 数据源来继续增强仪表板，以更深入地了解您的工业运营。

## 第 5 步：完成教程后清理资源
<a name="clean_up_resources"></a>

完成有关使用 Grafana 可视化数据的本教程后，请清理资源以免产生额外费用。

**要删除演 Amazon IoT SiteWise 示**

1. 导航至 [Amazon IoT SiteWise 控制台](https://console.amazonaws.cn/iotsitewise/)。

1. 在页面的右上角，选择**删除**演示。

1. 在确认对话框中，输入 **DELETE**，然后选择 **删除**。

有关更多信息，请参阅 [删除演 Amazon IoT SiteWise 示](getting-started-demo.md#delete-getting-started-demo)。

如果您删除 Amazon Managed Grafana，则该工作空间的所有配置数据也会被删除。这包括控制面板、数据来源配置、警报和快照。

**删除亚马逊托管 Grafana 工作空间**

1.  打开 [Amazon Managed Grafana 控制台](https://console.amazonaws.cn/grafana/)。

1. 在左侧导航窗格中，选择菜单图标。

1. 选择**所有工作区**。

1. 选择要删除的工作区的名称。

1. 选择**删除**。

1. 要确认删除，请输入工作区的名称并选择**删除**。
**注意**  
此过程将删除工作区。其他资源可能不会删除。例如，该工作区使用的 IAM 角色不会删除（但如果不再使用，可能会被解锁）。

有关更多信息，请参阅[亚马逊托管 Grafana 用户指南中的删除亚马逊托管 Grafana](https://docs.amazonaws.cn/grafana/latest/userguide/AMG-edit-delete-workspace.html) 工作*空间*。

## 其他资源
<a name="additional-resources"></a>

有关可视化数据的更多信息，请参阅以下资源：
+ 《[亚马逊托管 Grafana 用户指南》中的*亚马逊托*管 Grafana 身份和访问权限疑难解答](https://docs.amazonaws.cn/grafana/latest/userguide/security_iam_troubleshoot.html)
+ 《*亚马逊托管 Grafana 用户指南*》中的@@ [安全最佳实践](https://docs.amazonaws.cn/grafana/latest/userguide/AMG-Security-Best-Practices.html)
+ [Amazon IoT SiteWise 与 Grafana 集成](grafana-integration.md)
+ [使用 SiteWise Edge 和开源工具处理和可视化数据在边缘处理和可视化数据](open-source-edge-integrations.md)
+ 《*亚马逊托管 Grafana* [用户指南》中的用户、团队和权限](https://docs.amazonaws.cn/grafana/latest/userguide/Grafana-administration-authorization.html)
+ 《[亚马逊托管 Grafana 用户指南》中 Amazon 针对数据源的*亚马逊托管* Grafana 权限和政策](https://docs.amazonaws.cn/grafana/latest/userguide/AMG-manage-permissions.html)