

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

# 配置 Amazon Managed Grafana 工作区
<a name="AMG-configure-workspace"></a>

Amazon Managed Grafana 配置可分为 Amazon Managed Grafana 身份验证和权限配置，以及 Grafana 工作区配置。本节包含有关 Grafana 工作区配置的信息。

有关配置 Amazon Managed Grafana 身份验证和权限的更多信息，请参阅以下主题。
+ [在 Amazon Managed Grafana 工作区中对用户进行身份验证](authentication-in-AMG.md)
+ [管理用户和组对 Amazon Managed Grafana 工作区的访问权限](AMG-manage-users-and-groups-AMG.md)
+ [用户、团队和权限](Grafana-administration-authorization.md)

在查看工作区属性时，您可以在 Amazon Managed Grafana 的**工作区配置选项卡**上修改 Grafana 工作区的配置。

更改 Grafana 实例的配置可能会导致实例重新启动，从而重新加载新设置。配置更改后，用户可能需要刷新所有显示 Grafana 工作区的浏览器页面。

**注意**  
首次创建工作区时，您也可以使用相同的选项。

**使用 Amazon Managed Grafana 控制台更改 Grafana 工作区的配置**

1. 打开 Amazon Managed Grafana 控制台，其位于 [https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/home/)。

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

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

1. 选择要配置的工作区名称。这将打开该工作区的详细信息。

1. 选择**工作区配置选项**选项卡，查看实例的实例配置选项。

1. 选择 **Grafana Alerting** 或**插件管理**旁边的**编辑**。
   + **Grafana Alerting**

     您可以启用 [Grafana Alerting](v10-alerts.md)。要在 Grafana 工作区中查看 Prometheus 警报，请选择**开启 Grafana Alerting** 复选框。在运行版本 8 或 9 的工作区中，这将为 Grafana 警报发送多个通知。如果使用在 Grafana 中定义的警报，我们建议将工作区更新到 10.4 或更高版本。

     如果想改为使用经典 Grafana 警报，请*清除***开启 Grafana Alerting** 旁边的复选框。这将开启[经典控制面板警报](old-alerts-overview.md)。即使不开启 Grafana Alerting，也会评估现有的 Grafana 警报。
**注意**  
经典控制面板警报将在版本 11 中移除。在 Grafana 版本 10 的工作区中，您可以预览 Grafana Alerting 功能。有关更多信息，请参阅 [将经典控制面板警报迁移到 Grafana Alerting](v10-alerting-use-grafana-alerts.md)。
   + **插件管理**

     要启用插件管理，请选中**开启插件管理**复选框。开启插件管理允许 Amazon Managed Grafana 工作区的管理员使用 Grafana 插件目录安装、更新或移除[插件](grafana-plugins.md)。此选项仅适用于支持 Grafana 版本 9 或更新版本的工作区。

**注意**  
如果您*关闭* Grafana Alerting，则会丢失开启 Grafana Alerting 时对警报配置所做的所有更改。这包括您创建的所有新警报规则。  
有关使用 Grafana Alerting 的更多信息，以及开启或关闭警报的效果，请参阅 [Grafana 10 版本中的警报](v10-alerts.md)。

下一节将介绍如何使用 Amazon Managed Grafana API 或 AWS CLI更改 Grafana 实例配置。

## 使用 API 设置配置或 AWS CLI
<a name="AMG-configuration-format"></a>

您可以使用 Amazon Managed Grafana API 或 AWS CLI设置 Grafana 工作区配置。

**注意**  
`configuration` 是一个 JSON 字符串，允许以后添加配置设置。

------
#### [ AWS CLI ]

**要更新亚马逊托管 Grafana 实例配置，请使用 AWS CLI**  
运行以下命令开启实例的 Grafana Alerting 和插件管理功能。将*<region>*和*<workspace-id>*字符串替换为适合您的实例的值。

```
aws grafana update-workspace-configuration \
    --region region \
    --workspace-id <workspace-id> \
    --configuration '{"plugins": {"pluginAdminEnabled": true}, "unifiedAlerting": {"enabled": true}}'
```

该配置目前支持以下选项。这些选项可开启或关闭 Grafana Alerting 或插件管理。
+ 要启用 Grafana Alerting，请使用此配置选项：

  ```
  --configuration '{"unifiedAlerting": { "enabled": true }}'
  ```
+ 要启用插件管理，请使用此配置选项：

  ```
  --configuration '{"plugins": {"pluginAdminEnabled": true }}'
  ```

  此选项仅在支持 Grafana 版本 9 或更新版本的工作区中提供。

------
#### [ Amazon Managed Grafana API ]

**要使用 API 更新 Amazon Managed Grafana 实例配置**  
使用以下操作开启实例的 Grafana Alerting 和插件管理功能。将该*<workspace-id>*字符串替换为适合您的实例的值。

```
PUT /workspaces/<workspace-id>/configuration HTTP/1.1
Content-type: application/json

{
   "configuration": "{ \"unifiedAlerting\": { \"enabled\": true }, \"plugins\": { \"pluginAdminEnabled\": true }}"
}
```

该配置目前支持以下选项。这些选项可开启或关闭 Grafana Alerting 或插件管理。
+ 要启用 Grafana Alerting，请使用此配置选项：

  ```
  "configuration": "{\"unifiedAlerting\": { \"enabled\": true }}"
  ```
+ 要启用插件管理，请使用此选项：

  ```
  "plugins": "{\"pluginAdminEnabled\": true }"
  ```

  此选项仅在支持 Grafana 版本 9 或更新版本的工作区中提供。

------