本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 配置 Amazon Managed Grafana 工作区
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** 警报**、插件**管理或 IP 地址类型旁边的**编辑**。**
+ **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 警报。
**注意**
Grafana 版本 12 中删除了经典控制面板警报。在版本 12 的工作空间中，Grafana 警报始终处于启用状态，并且该开关不再可用。有关更多信息，请参阅 [将经典控制面板警报迁移到 Grafana Alerting](v10-alerting-use-grafana-alerts.md)。
+ **插件管理**
要启用插件管理，请选中**开启插件管理**复选框。开启插件管理允许 Amazon Managed Grafana 工作区的管理员使用 Grafana 插件目录安装、更新或移除[插件](grafana-plugins.md)。此选项仅适用于支持 Grafana 版本 9 或更新版本的工作区。
+ **IP 地址类型**
选择 “**仅限 IPv4 Dual-stack****” 或模式**。您的选择决定了资源用于与您的工作空间通信的寻址协议。如果您的资源必须通过 IPv6 与您的工作空间通信，请选择双堆栈模式。 Dual-stack 模式仅适用于支持 Grafana 版本 10 或更高版本的工作空间。
**重要**
在启用双堆栈模式之前，请验证以下内容：
您的网络防火墙和身份提供商配置中允许使用该`sso.signin.aws`域。
您的网络允许 IPv6 流量。
任何用于网络访问控制的前缀列表都包含相应的 IP 范围。
如果您的身份提供商使用 CORS 验证，则新域名将添加到 CORS 许可名单中。
如果您的工作空间使用 VPC 配置，则您的子网必须分配 IPv6 CIDR 块。
使用直接 SAML 身份验证的工作空间或 Ident AWS Identity and Access Management ity Center 的内置目录不受登录 URL 更改的影响。有关更多信息，请参阅《*AWS Identity and Access Management 身份中心用户指南*》中的[断言使用者服务 (ACS) 端点](https://docs.aws.amazon.com/singlesignon/latest/userguide/multi-region-workforce-access.html#acs-endpoints)。
如果您稍后从双栈切换回仅限 IPv4，则当前通过 IPv6 连接的所有客户端或资源都将无法访问您的工作空间。
**注意**
如果您*关闭* Grafana Alerting，则会丢失开启 Grafana Alerting 时对警报配置所做的所有更改。这包括您创建的所有新警报规则。
有关使用 Grafana Alerting 的更多信息，以及开启或关闭警报的效果，请参阅 [Grafana 10 版本中的警报](v10-alerts.md)。
下一节将介绍如何使用 Amazon Managed Grafana API 或 AWS CLI更改 Grafana 实例配置。
## 使用 API 设置配置或 AWS CLI
您可以使用 Amazon Managed Grafana API 或 AWS CLI设置 Grafana 工作区配置。
**注意**
`configuration` 是一个 JSON 字符串，允许以后添加配置设置。
------
#### [ AWS CLI ]
**要更新亚马逊托管 Grafana 实例配置，请使用 AWS CLI**
运行以下命令开启实例的 Grafana Alerting 和插件管理功能。将{{}}和{{}}字符串替换为适合您的实例的值。
```
aws grafana update-workspace-configuration \
--region {{region}} \
--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 和插件管理功能。将该{{}}字符串替换为适合您的实例的值。
```
PUT /workspaces/{{}}/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 或更新版本的工作区中提供。
------