Amazon Managed Grafana ワークスペースを設定する

Amazon Managed Grafana の設定については、「Amazon Managed Grafana の認証とアクセス許可の設定」と、「Grafana ワークスペースの設定」に分けて説明することができます。このセクションでは、「Grafana ワークスペースの設定」について説明します。

「Amazon Managed Grafana の認証とアクセス許可の設定」の詳細については、以下のトピックを参照してください。

Grafana ワークスペースの設定内容の変更は、ワークスペースのプロパティを表示する際にある [Workspace 設定オプション] タブの Amazon Managed Grafana 内で行うことができます。

Grafana インスタンスの設定を変更すると、新しい設定を反映するためにインスタンスが再起動することがあります。ブラウザで Grafana ワークスペースを表示している場合、設定の変更後、ブラウザページを更新する必要がある場合があります。

注記

ワークスペースを初めて作成するときにも、同じオプションを使用できます。

Amazon Managed Grafana コンソールを使用した Grafana ワークスペースの設定の変更方法

Amazon Managed Grafana コンソール (https://console.aws.amazon.com/grafana/) を開きます。
左側のナビゲーションペインで、メニューアイコンを選択します。
[すべての WorkSpaces] を選択します。
設定するワークスペースの名前を選択します。これにより、そのワークスペースの詳細が開きます。
[Workspace 設定オプション] タブを選択して、インスタンスの「インスタンス設定オプション」を表示します。
Grafana アラートまたはプラグイン管理の横にある[編集] を選択します。
- Grafana アラート
  
  Grafana アラートを有効にします。Grafana ワークスペースで Prometheus アラートを表示するには、チェックボックスをオンにして Grafana アラートをオンにします。バージョン 8 または 9 を実行しているワークスペースでは、Grafana アラートに対して複数の通知が送信されます。Grafana で定義されたアラートを使用する場合は、ワークスペースをバージョン 10.4 以降に更新することをお勧めします。
  
  従来の Grafana アラートを使用する場合は、Grafana アラートを有効にするの横にあるチェックボックスをオフにして、従来のダッシュボードアラートを有効にします。Grafana アラートが有効でない場合も、既存の Grafana アラートは評価されます。
  
  注記
  従来のダッシュボードアラートは、バージョン 11 で削除される予定です。Grafana バージョン 10 ワークスペースでは、Grafana アラート機能を確認できます。詳細については、「従来のダッシュボードアラートを Grafana アラートに移行する」を参照してください。
- プラグイン管理
  
  プラグイン管理を有効にするには、[プラグイン管理を有効にする] チェックボックスをオンにします。プラグイン管理を有効にすると、Amazon Managed Grafana ワークスペースの管理者は、Grafana プラグインカタログを使用してプラグインをインストール、更新、または削除できまるようになります。このオプションは、Grafana バージョン 9 以降をサポートするワークスペースでのみ使用できます。

注記

Grafana アラートをオフにすると、Grafana アラートがオンになっている間にアラート設定に加えられたすべての変更が失われます。作成した新しいアラートルールも削除されます。

Grafana アラートの使用方法と、アラートのオン/オフの効果の詳細については、「Grafana バージョン 10 のアラート」を参照してください。

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

API または AWS CLI を使用した設定

Grafana ワークスペースの設定は、Amazon Managed Grafana API または AWS CLI を使用して行うことができます。

注記

configuration は、後で追加される将来の構成設定を可能にする JSON 文字列です。

AWS CLI

AWS CLI を使用した Amazon Managed Grafana インスタンス設定の更新方法

以下のコマンドを実行して、インスタンスの 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 アラートを有効にするには、以下の設定オプションを使用します。
```
"configuration": "{\"unifiedAlerting\": { \"enabled\": true }}"
```
プラグイン管理を有効にするには、以下のオプションを使用します。
```
"plugins": "{\"pluginAdminEnabled\": true }"
```
このオプションは、Grafana バージョン 9 以降をサポートするワークスペースでのみ使用できます。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

VPC のトラブルシューティング

ワークスペースの削除