Configure a Amazon Managed Grafana workspace
Amazon Managed Grafana configuration can be separated into configuration of the Amazon Managed Grafana authentication and permissions, and configuration of the Grafana workspace. This section includes information regarding configuration of your Grafana workspace.
For more information about configuring Amazon Managed Grafana authentication and permissions, see the following topics.
You can modify the configuration of your Grafana workspace within Amazon Managed Grafana on the Workspace configuration options tab when viewing the properties of your workspace.
Making configuration changes to your Grafana instance can cause the instance to restart to reload the new settings. After configuration changes are made, your users might need to refresh any browser pages that show the Grafana workspace.
Note
The same options are available to you when you first create your workspace.
To change the configuration of a Grafana workspace using the Amazon Managed Grafana console
-
Open the Amazon Managed Grafana console at https://console.aws.amazon.com/grafana/
. -
In the left navigation pane, choose the menu icon.
-
Choose All workspaces.
-
Choose the name of the workspace that you want to configure. This opens the details for that workspace.
-
Choose the Workspace configuration options tab to see the instance configuration options for your instance.
-
Select Edit next to either Grafana alerting, Plugin management, or IP Address Type.
-
Grafana alerting
You can enable Grafana alerting. To view Prometheus alerts in your Grafana workspace, select the check box to Turn Grafana alerting on. In workspaces running version 8 or 9, this will send multiple notifications for your Grafana alerts. If you use alerts defined in Grafana, we recommend updating your workspace to version 10.4 or later.
If you want to the classic Grafana alerts instead, clear the check box next to Turn Grafana alerting on. This turns on the classic dashboard alerts. Even if you don't turn Grafana alerting on, your existing Grafana alerts are evaluated.
Note
Classic dashboard alerts have been removed in Grafana version 12. In version 12 workspaces, Grafana alerting is always enabled and the toggle is no longer available. For more information, see Migrating classic dashboard alerts to Grafana alerting.
-
Plugin management
To turn on plugin management, select the check box to Turn plugin management on. Turning plugin management on allows admins in your Amazon Managed Grafana workspace to install, update, or remove plugins using the Grafana plugin catalog. This option is only available for workspaces that support Grafana version 9 or newer.
-
IP Address type
Choose IPv4 only or Dual-stack mode. Your selection determines the addressing protocols that resources use to communicate with your workspace. Choose dual-stack mode when you have resources that must communicate with your workspace over IPv6. Dual-stack mode is available only for workspaces that support Grafana version 10 or later.
Important
Before enabling dual-stack mode, verify the following:
-
The
sso.signin.awsdomain is allowed in your network firewall and identity provider configurations. -
Your network allows IPv6 traffic.
-
Any prefix lists used for network access control include the appropriate IP ranges.
-
If your identity provider uses CORS validation, the new domain is added to the CORS allowlist.
-
If your workspace uses a VPC configuration, your subnets must have IPv6 CIDR blocks assigned.
Workspaces using direct SAML authentication or AWS Identity and Access Management Identity Center's built-in directory are not affected by the sign-in URL change. For more information, see Assertion Consumer Service (ACS) endpoints in the AWS Identity and Access Management Identity Center User Guide.
If you later switch from dual-stack back to IPv4 only, any clients or resources currently connecting over IPv6 will lose access to your workspace.
-
-
Note
If you turn off Grafana alerting, you lose all changes made to the alerting configuration while Grafana alerting was on. This includes any new alert rules that you created.
For more information about using Grafana alerting, and the effects of turning it on or off, see Alerts in Grafana version 10.
The next section shows how to make changes to the Grafana instance configuration using the Amazon Managed Grafana API or the AWS CLI.
Setting configuration with API or AWS CLI
You can set the Grafana workspace configuration using the Amazon Managed Grafana API or the AWS CLI.
Note
The configuration is a JSON string to allow for future
configuration settings which made be added later.