Activate a Grafana Enterprise license from AWS Marketplace on EKS

If you have purchased a Grafana Enterprise subscription through AWS Marketplace, you must activate it in order to use Grafana Enterprise data source plugins and features in Grafana.

Before you begin:

  • Purchase a subscription to Grafana Enterprise from AWS Marketplace.
  • Be sure that the IAM user that was used to purchase Grafana Enterprise has permission to manage subscriptions, create new IAM users and roles, and create access policies.

To activate your license, complete the following tasks:

Task 1: Deploy Grafana Enterprise on Amazon EKS

  1. Deploy Grafana Enterprise on Amazon EKS.

    For more information about deploying an application on Amazon EKS, refer to Getting started with Amazon EKS – AWS Management Console and AWS CLI.

    For more information about installing Grafana on Kubernetes using the Helm Chart, refer to the Grafana Helm Chart.

  2. Use kubectl set image deployment/my-release grafana=grafana/grafana-enterprise:<version> to update the container image to Grafana Enterprise version 8.3.0 or later.

    For example, enter grafana/grafana-enterprise:8.3.3.

Only Grafana Enterprise versions 8.3.0 and later support licenses granted through AWS Marketplace.

Task 2: Configure Grafana for high availability

Grafana requires that you configure a database to hold dashboards, users, and other persistent data.

Before you begin

To configure Grafana for high availability, choose one of the following options:

  • Option 1: Use kubectl edit configmap grafana to edit grafana.ini add the following section to the configuration:

    1. [database]
    2. type = [database type]
    3. host = [database address and port]
    4. name = [database name]
    5. user = [database username]
    6. password = [database password]
  • Option 2: use kubectl edit deployment my-release to edit the pod env variables and add the following database variables:

    1. - name: GF_DATABASE_TYPE
    2. value: [database type]
    3. - name: GF_DATABASE_HOST
    4. value: [database address and port]
    5. - name: GF_DATABASE_NAME
    6. value: [database name]
    7. - name: GF_DATABASE_USER
    8. value: [database username]
    9. - name: GF_DATABASE_PASSWORD
    10. value: [database password]

For more information on Grafana High Availability setup, refer to Set up Grafana for high availability.

Task 3: Configure Grafana Enterprise to validate its license with AWS

In this task, you configure Grafana Enterprise to validate the license with AWS instead of Grafana Labs.

  1. In AWS IAM, assign the following permissions to the Node IAM role (if you are using a Node Group), or the Pod Execution role (if you are using a Fargate profile):

    • "license-manager:CheckoutLicense"
    • "license-manager:ListReceivedLicenses"
    • "license-manager:GetLicenseUsage"
    • "license-manager:CheckInLicense"

    For more information about creating an access policy, refer to Creating IAM policies (console).

    For more information about AWS license permissions, refer to Actions, resources, and condition keys for AWS License Manager.

  2. Choose one of the following options to update the license_validation_type configuration to aws:

    • Option 1: Use kubectl edit configmap grafana to edit grafana.ini add the following section to the configuration:

      1. [enterprise]
      2. license_validation_type=aws
    • Option 2: Use kubectl edit deployment my-release to edit the pod env variables and add the following variable:

      1. name: GF_ENTERPRISE_LICENSE_VALIDATION_TYPE
      2. value: aws

Task 4: Start or restart Grafana

To activate Grafana Enterprise features, you must start (or restart) Grafana.

To restart Grafana on a Kubernetes cluster,

  1. Run the command kubectl rollout restart deployment my-release.

  2. After you update the service, navigate to your Grafana instance, sign in with Grafana Admin credentials, and navigate to the Statistics and Licensing page to validate that your license is active.

For more information about restarting Grafana, refer to Restart Grafana.

If you experience issues when you update the EKS cluster, refer to Amazon EKS troubleshooting.