

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 設定 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. 開啟位於 https：//[https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/home/) 的 Amazon Managed Grafana 主控台。

1. 在左側導覽窗格中，選擇功能表圖示。

1. 選擇**所有工作區**。

1. 選擇您要設定的工作區名稱。這會開啟該工作區的詳細資訊。

1. 選擇**工作區組態選項**索引標籤，以查看執行個體的執行個體組態選項。

1. 選取 **Grafana 提醒**或**外掛程式管理**旁的**編輯**。
   + **Grafana 提醒**

     您可以啟用 [Grafana 提醒](v10-alerts.md)。若要在 Grafana 工作區中檢視 Prometheus 提醒，請選取核取方塊以**開啟 Grafana 提醒**。在執行版本 8 或 9 的工作區中，這將傳送多個 Grafana 提醒的通知。如果您使用 Grafana 中定義的提醒，建議您將工作區更新為 10.4 版或更新版本。

     如果您想要改用傳統 Grafana 提醒，請*清除***開啟 Grafana 提醒**旁的核取方塊。這會開啟[傳統儀表板提醒](old-alerts-overview.md)。即使您未開啟 Grafana 提醒，也會評估您現有的 Grafana 提醒。
**注意**  
第 11 版中將移除傳統儀表板提醒。在 Grafana 第 10 版工作區中，您可以預覽 Grafana 提醒功能。如需詳細資訊，請參閱[將傳統儀表板提醒遷移至 Grafana 提醒](v10-alerting-use-grafana-alerts.md)。
   + **外掛程式管理**

     若要開啟外掛程式管理，請選取核取方塊以**開啟外掛程式管理**。開啟外掛程式管理功能可讓 Amazon Managed Grafana 工作區中的管理員[使用外掛程式擴展您的工作區](grafana-plugins.md)使用 Grafana 外掛程式目錄來安裝、更新或移除外掛程式。此選項僅適用於支援 Grafana 第 9 版或更新版本的工作區。

**注意**  
如果您*關閉* Grafana 提醒，則會遺失在 Grafana 提醒開啟時對提醒組態所做的所有變更。這包括您建立的任何新提醒規則。  
如需使用 Grafana 提醒的詳細資訊，以及開啟或關閉它的效果，請參閱 [Grafana 第 10 版中的提醒](v10-alerts.md)。

下一節說明如何使用 Amazon Managed Grafana API 或 對 Grafana 執行個體組態進行變更 AWS CLI。

## 使用 API 或 設定組態 AWS CLI
<a name="AMG-configuration-format"></a>

您可以使用 Amazon Managed Grafana API 或 來設定 Grafana 工作區組態 AWS CLI。

**注意**  
`configuration` 是 JSON 字串，允許未來進行稍後新增的組態設定。

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

**使用 更新 Amazon Managed Grafana 執行個體組態 AWS CLI**  
執行下列命令來開啟執行個體的 Grafana 警示和外掛程式管理功能。將 *<region>* 和 *<workspace-id>* 字串取代為執行個體的適當值。

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

組態目前支援下列選項。這些會開啟或關閉 Grafana 提醒或外掛程式管理。
+ 若要啟用 Grafana 提醒，請使用此組態選項：

  ```
  --configuration '{"unifiedAlerting": { "enabled": true }}'
  ```
+ 若要啟用外掛程式管理，請使用此組態選項：

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

  此選項僅適用於支援 Grafana 第 9 版或更新版本的工作區。

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

**使用 API 更新 Amazon Managed Grafana 執行個體組態**  
使用下列動作來開啟執行個體的 Grafana 提醒和外掛程式管理功能。將 *<workspace-id>* 字串取代為執行個體的適當值。

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

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

組態目前支援下列選項。這些會開啟或關閉 Grafana 提醒或外掛程式管理。
+ 若要啟用 Grafana 提醒，請使用此組態選項：

  ```
  "configuration": "{\"unifiedAlerting\": { \"enabled\": true }}"
  ```
+ 若要啟用外掛程式管理，請使用此選項：

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

  此選項僅適用於支援 Grafana 第 9 版或更新版本的工作區。

------