

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 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)

Grafana ワークスペースの設定内容の変更は、ワークスペースのプロパティを表示する際にある [**Workspace 設定オプション**] タブの Amazon Managed 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. [**Workspace 設定オプション**] タブを選択して、インスタンスの「インスタンス設定オプション」を表示します。

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 プラグインカタログを使用して[プラグイン](grafana-plugins.md)をインストール、更新、または削除できまるようになります。このオプションは、Grafana バージョン 9 以降をサポートするワークスペースでのみ使用できます。

**注記**  
Grafana アラートを*オフ*にすると、Grafana アラートがオンになっている間にアラート設定に加えられたすべての変更が失われます。作成した新しいアラートルールも削除されます。  
Grafana アラートの使用方法と、アラートのオン/オフの効果の詳細については、「[Grafana バージョン 10 のアラート](v10-alerts.md)」を参照してください。

次のセクションでは、Amazon Managed Grafana API または AWS CLIを使用して Grafana インスタンス設定を変更する方法について紹介します。

## API または での設定 AWS CLI
<a name="AMG-configuration-format"></a>

Grafana ワークスペースの設定は、Amazon Managed Grafana API または 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 以降をサポートするワークスペースでのみ使用できます。

------