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

# 使用插件扩展您的工作区
<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)。