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

# 使用插件扩展您的工作区
<a name="grafana-plugins"></a>

*Grafana 插件*增加的功能使用户能够连接到新数据来源或向工作区添加可视化或其他功能。基本上，插件有三种类型：
+ **面板插件**：面板插件增加了新的可视化类型，可在控制面板中使用。它们定义了数据在前端的呈现。
+ **数据来源插件**：数据来源插件与外部数据来源通信，并以 Grafana 可以使用的格式返回数据。
+ **应用程序插件**：应用程序，也称为应用程序插件。其中包括捆绑数据来源和面板，可以在您的 Grafana 工作区中提供整体一致的体验。

**注意**  
当 Amazon 确定某个插件经常出现故障或未被维护时，可能会将该插件从控制台的可用插件列表中移除。

对于支持版本 9 或更高版本的 Amazon Managed Grafana 工作区，您可以启用插件管理。这允许工作区管理员从*插件目录*安装或卸载插件。

## 使用插件目录查找插件
<a name="plugin-catalog"></a>

您的 Amazon Managed Grafana 工作区包括一个显示所有已安装插件的页面，以及可在工作区中安装的所有插件的列表。此页面是*插件目录*。除了默认安装的插件外，您还可以再安装多达 50 个插件。

可用的插件大致分为以下类别：
+ **AWS 数据源** — 这是一款由 Amazon Managed Grafana 提供的应用程序插件，用于轻松 AWS 发现您账户中的资源。此类插件是默认安装的。有关更多信息，请参阅 [使用 AWS 数据源插件查找 AWS 数据](aws-datasources-plugin.md)。
+ **核心插件**：这些插件默认在 Grafana 中提供。它们包括流行的数据来源和面板可视化。它们在插件目录中被标记为**核心**。它们是默认安装的，无法移除。
+ **Enterprise 插件**：这些插件可用于拥有 Enterprise 许可证的 Grafana 工作区。默认情况下，未安装这些插件。它们在插件目录中被标记为 **Enterprise**。只有拥有有效的 Enterprise 许可证才能安装这些插件。有关如何将工作区升级为 Enterprise 许可证的详细信息，请参阅 [管理对 Amazon Managed Grafana 企业插件的访问权限](AMG-workspace-manage-enterprise.md)。
+ **社区插件** — 这些插件来自各种来源，包括 Grafana Labs 等，为 Grafana 工作空间提供。 AWS在支持版本 9 或更高版本的 Grafana 工作区中，默认情况下不会安装这些插件（早期的工作区会自动安装其中的一些插件）。这些插件通常是开源插件。您可以安装或移除这些插件。
**注意**  
是否使用社区插件由您自行决定。作为您和 AWS之间的[责任共担模式](security.md)的一部分，对于这些第三方插件，您应该了解您在工作区中具体安装了什么。您还要对满足您的安全需求的插件负责。

**插件支持**

插件有多种来源，对它们的支持也各不相同。
+ **AWS 数据源插件**-此插件由提供并由支持 AWS。
+ **企业插件** — 两者 AWS 和 Grafana Labs 都支持企业插件——您可以通过任一支持团队提交问题。
+ **核心插件** — Amazon Managed Grafana 支持 AWS 或 Grafana Labs 提供的核心插件和其他插件。 AWS您可以在中提交问题以修复错误或 GitHub 进行改进，也可以通过或 G AWS rafana Labs 创建工作单。
+ **社区插件** — 通常 GitHub通过议题 AWS 或其他论坛支持不是由 Grafana Labs 创建的社区插件。在这些情况下，支持信息包含在插件目录中插件的详细信息中。

[您也可以通过[亚马逊托管 Grafana 或 Grafana](https://github.com/aws/amazon-managed-grafana-roadmap/issues) 的 GitHub 论坛提交插件问题。](https://github.com/grafana/grafana/issues)

**插件版本**

大多数插件都会定期更新。Amazon Managed Grafana 工作区中的插件目录显示了插件的最新版本，您可以选择要安装的版本。当插件的过时版本存在已知安全问题时，过时的版本将被移除而不再可用。

您也可以[更新](#update-plugin)已安装的插件。

**注意**  
有时，会提供新版本的插件来修复已安装插件中的安全问题。对于严重的问题，Amazon Managed Grafana 可能会自动将工作区中的插件更新到包含修复的版本。

## 使用插件目录管理插件
<a name="manage-plugins"></a>

您可以从插件目录中管理 Amazon Managed Grafana 工作区的插件。您只能在工作区内安装插件目录中列出的插件。

以下内容描述了使用插件目录的先决条件以及如何查找插件目录。

**先决条件**
+ 您必须拥有支持版本 9 的 [Amazon Managed Grafana](AMG-create-workspace.md) 工作区，并拥有可以登录该工作区的账户。
+ 工作区必须[已启用插件管理](AMG-configure-workspace.md)。
+ 您的用户账户必须是 [Amazon Managed Grafana 工作区的管理员](Grafana-user-roles.md)。
+ 要安装和使用 Enterprise 插件，必须先[升级到 Enterprise 许可证](AMG-workspace-manage-enterprise.md)。

**要查看插件目录**

1. 登录您的 Amazon Managed Grafana 工作区。

1. 从左侧菜单中选择**管理**，然后选择**插件**。此操作将打开插件目录。

1. 默认情况下，该插件目录会列出已安装的插件。要查看所有可用的插件，请在目录顶部的**状态**筛选器下选择**全部**。已安装的插件包含一个标有**已安装**的标签。

## 安装或移除插件
<a name="install-plugin"></a>

**注意**  
您必须满足前一节中的先决条件，否则您将无权修改插件。

**安装或移除 Grafana 插件**

1. 转到插件目录。

1. 默认情况下，该插件目录仅列出已安装的插件。要查看所有可用的插件，请在目录顶部的**状态**筛选器下选择**全部**。已安装的插件包含一个标有**已安装**的标签。

1. 选择要安装或卸载的插件。例如，如果要移除 *Datadog* 数据来源，请选择 **Datadog** 插件。

1. 在插件详细信息页面上，选择卸载或安装选项。

1. 安装插件后，可能需要几分钟的时间才能将更改同步到工作区的所有部分。最好等待几分钟后再使用新插件。

**注意**  
您可以在一个工作区中安装 50 个插件（除了默认的核心插件之外）。

## 更新插件
<a name="update-plugin"></a>

**要更新现有的 Grafana 插件**

1. 登录您的 Amazon Managed Grafana 工作区。

1. 从左侧菜单中选择**管理**，然后选择**插件**。此操作将打开插件目录，仅列出已安装的插件。

1. 选择要更新的插件。

1. 在插件详细信息页面上，检查是否有可用的更新。如果是，请选择更新插件的选项并选择要更新到的版本。
**注意**  
如果您看到有关您无权修改插件的提示，请确认您的工作区[已启用插件管理](AMG-configure-workspace.md)。您还必须是 Amazon Managed Grafana 工作区的[管理员](Grafana-user-roles.md)。

# 使用 AWS 数据源插件查找 AWS 数据
<a name="aws-datasources-plugin"></a>

AWS 提供了一个应用程序插件，可以更轻松地在 Amazon Managed Grafana 工作空间中发现和使用 AWS 资源作为数据源。*AWS 数据来源*插件默认安装在新工作区中。

 AWS 数据源插件需要访问您的资源以进行发现的权限。有关更多信息，请参阅 [所需的权限](#aws-ds-plugin-permissions)。

## 打开 AWS 数据源插件
<a name="aws-ds-plugin-open"></a>

**打开 AWS 数据源插件**

1. 登录您的 Amazon Managed Grafana 工作区。

1. 从左上角的**菜单**中，选择**应用程序**，然后选择 **AWS 数据来源**。

将出现 AWS 数据源插件界面，其中列出了您可以搜索资源的 AWS 服务。

## 发现资源
<a name="aws-ds-plugin-use"></a>

**要从您的资源中查找资源 AWS 账户**

1. 打开 AWS 数据源插件。

1. 从 AWS 服务列表中，选择要查找的资源以用作数据源的服务。例如，选择 **Amazon Managed Service for Prometheus**。这将带您进入**数据来源**选项卡，并为您选中**服务**。

1. 选择要在其中查找资源的地 AWS 区。例如，选择 `US East (N. Virginia)`。
**注意**  
要查找资源，插件必须具有访问该区域服务的适当[权限](#aws-ds-plugin-permissions)。

1. 某些服务在一个区域可能有多个资源。如果该区域有多个资源，则 AWS 数据源插件会提供一个列表供您选择。

   从资源列表（本例中为 Amazon Managed Service for Prometheus）中，选择要用作数据来源的资源。例如，选择 Amazon Managed Service for Prometheus 工作区会将该资源设置为数据来源。该数据来源已准备就绪，可在您的控制面板中使用，或在通过 Amazon Managed Grafana 进行监控时使用。

1. 您在该服务和区域中预置的资源将显示在页面底部。

   （可选）您可以选择**转到设置**，查看和编辑该数据来源的设置。

**注意**  
 AWS 数据源插件取决于工作区中安装的各个数据源插件。例如，如果要使用 AWS X-Ray 功能，必须从[插件目录](grafana-plugins.md#manage-plugins)安装 X-Ray 数据来源插件。

## 版本和更新插件
<a name="aws-ds-plugin-versions"></a>

 AWS 数据源插件会定期更新。与新工作区一起安装的版本通常不是最新版本。与工作区中安装的版本相比，较新的版本可能具有更多功能。例如，较新的版本可能支持其他 AWS 服务作为数据源。

要查看每个版本 AWS 的数据源插件的更改，可以查看[变更日志](https://grafana.com/grafana/plugins/aws-datasource-provisioner-app/?tab=changelog)。

要更新到较新版本的插件，请按照 [更新插件](grafana-plugins.md#update-plugin) 的标准说明进行操作。

**注意**  
如果您更新到较新版本 AWS 的数据源插件，则需要为不由 Amazon Managed Grafana 管理的新数据源提供额外的[权限](#aws-ds-plugin-permissions)。

## 所需的权限
<a name="aws-ds-plugin-permissions"></a>

 AWS 数据源插件需要权限才能访问您的 AWS 资源。最简单的方法是允许 Amazon Managed Grafana 为您管理权限。要了解如何为数据来源设置服务托管权限，请参阅 [管理数据来源和通知渠道的权限](AMG-datasource-and-notification.md)。默认情况下，Amazon Managed Grafana 可以管理数据源插件中包含 AWS 的资源的权限。 AWS 

如果您将 AWS 数据源插件更新到比工作空间中默认包含的版本更新的版本，则它可能会自动添加对权限不由 Amazon Managed Grafana 管理的 AWS 资源的支持。在这种情况下，您必须自己添加权限。例如，已添加到 AWS IoT TwinMaker 该插件的最新版本（版本 1.9.0）中，但这些权限不由亚马逊托管 Grafana 管理。

要详细了解任何特定数据来源的权限，请参阅 [连接到数据来源](AMG-data-sources.md) 部分提供的该数据来源的详细信息。例如，该[Connect 连接到 AWS IoT TwinMaker 数据源](AMG-iot-twinmaker.md)部分包含有关向亚马逊托管 Grafana 授予访问权限的详细信息。 AWS IoT TwinMaker