Menu
Grafana Enterprise Metrics documentation Set up the GEM plugin for Grafana
Enterprise

Set up the GEM plugin for Grafana

Requirements

Grafana Enterprise 7.3.0 or higher.

Refer to Deploy Grafana Enterprise on Kubernetes if you are using Kubernetes. Otherwise, refer to Install Grafana for more information.

Install the plugin in your GEM instance

There are multiple ways to install the plugin to your local Grafana Enterprise instance. For more information, refer to Grafana Enterprise Metrics app installation.

Enable and configure the plugin

  1. Log in to your Grafana Enterprise Metrics.
  2. Go to the Config/Plugins page and select the Grafana Enterprise Metrics plugin from list.
  3. From the configuration page of the plugin, enable the plugin by clicking on the Enable plugin button.
  4. Provide the necessary API settings so that the plugin can connect to your cluster:
  • Access Token: Enter the admin-scoped access token that you generated when setting up your GEM cluster.
  • Enterprise Metrics URL: Enter the URL of your GEM cluster. For single-process clusters, this is any node in the cluster. For microservice deployments, this URL is the GEM gateway.
    Configuration GEM plugin page
    Configuration GEM plugin page
  1. Click Save API settings.
  2. Verify that the plugin loads and can communicate with the GEM admin API endpoints.
  3. Navigate to the Grafana Enterprise Metrics plugin through the main menu to see the default access policy under the Access policies tab.

Configure the plugin via provisioning

You can alternatively manage the GEM plugin via a plugin config.

Example GEM plugin configuration file

yaml
apiVersion: 1

apps:
  # <string> the type of app, plugin identifier. Required
  - type: grafana-metrics-enterprise-app
    # <int> Org ID. Default to 1, unless org_name is specified
    org_id: 1
    # <string> Org name. Overrides org_id unless org_id not specified
    org_name: Main Org.
    # <bool> disable the app. Default to false.
    disabled: false
    # <map> fields that will be converted to json and stored in jsonData.
    jsonData:
      # key/value pairs of string to object
      backendUrl: 'URL'
      base64EncodedAccessTokenSet: true
    # <map> fields that will be converted to json, encrypted and stored in secureJsonData. 
    secureJsonData:
      # key/value pairs of string to string
      base64EncodedAccessToken: 'token'

Now that you have correctly configured the plugin you can move on to setting up a GEM tenant and visualizing your data.