Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.
Grafana Enterprise Metrics is available as a pre-compiled binary, a Docker image, as well as via common OS-specific packaging. For a list of available download options, refer to the downloads page.
Note: You can use Grafana Cloud to avoid installing, maintaining, and scaling your own instance of GEM. The free forever plan includes 50GB of free metrics. Create an account to get started.
Get a GEM license
A valid Grafana Enterprise Metrics license token is required to run GEM’s many added features. Without a valid license token, not all of GEM’s added features will run. However, GEM will still run with all of the functionality of an open-source Grafana Mimir binary.
If you already have a license for GEM:
- From https://grafana.com, select Login.
- From the left-hand menu, select Licenses to download the license token.
If you do not have a license token to run GEM, contact a Grafana Labs representative.
Choose a name for your GEM cluster
GEM licenses are issued on a per-cluster basis. Each cluster of GEM that you plan to deploy requires a unique license. When we issue a GEM license, we must have a unique cluster name with which to associate the license.
A cluster name must meet the following criteria:
- is 3 to 63 characters long
- contains lowercase letters, numbers, underscores (_), or hyphens (-)
- begins with a letter or number
- ends with a letter or number
Deploy your GEM cluster
Note: GEM includes a system that optionally and anonymously reports non-sensitive, non-personally identifiable information about the running GEM cluster to a remote statistics server. This feature is turned on by default. If possible, we kindly ask that you keep the usage reporting feature enabled to help us understand more about how operators run GEM. To opt out, refer to Disable the anonymous usage statistics reporting.
After you have a Grafana GEM license with an associated cluster name, choose a deployment method to deploy your GEM cluster:
Configure limits for production use
To set up your cluster with limits for production use after you have deployed a cluster, see the GEM limits recommendations.
Was this page helpful?
Related resources from Grafana Labs
