This is archived documentation for v1.5.0. Go to the latest version.
Create a Grafana Enterprise Metrics instance:
Create an instance (or in Cortex terms, a tenant):
Navigate to Grafana Metrics Enterprise > Instances.
Click on Create new instance.
Choose a name for this very instance. For demonstration purposes, use the name
Select the cluster.
Click Create instance.
Create an access policy
Create a data source access policy and token, which are used by Grafana Enterprise itself to access the metrics in the instance named
Navigate to Grafana Enterprise Metrics > Access policies.
Click Create new access policy.
Choose a name for the policy. For demonstration purposes, use
Enable the scope metrics:read and metrics:write.
Select the instance
Click on Create.
From the newly created access policy, click + Add token.
Name the token
dev-token, and click on Create.
In the next window, copy the token.
You can add the following example of a remote-write configuration to your Prometheus or Grafana Cloud Agent configuration files:
remote_write: - url: http://metrics-enterprise/api/v1/push basic_auth: username: dev-instance password: ZGV2LXJlYWQtd3JpdGVyLXBvbGljeS1kZW1vLXRva2VuOjY/ezduMTVhJDQvPGMvLzQ1SzgsJjFbMQ==
Setup remote-write to your instance
To enable writes to your cluster, add the above remote-write configuration snippet to the configuration file of an existing Prometheus or Grafana Cloud Agent. If you do not have an existing metrics collector you can get started with the Grafana Cloud Agent.
An example agent configuration would be:
server: log_level: info http_listen_port: 8081 prometheus: wal_directory: /tmp/agent global: scrape_interval: 5s configs: - name: default scrape_configs: - job_name: metrics-enterprise static_configs: - targets: ["localhost:8080"] - job_name: agent static_configs: - targets: ["localhost:8081"] integrations: agent: enabled: true node_exporter: enabled: true prometheus_remote_write: - url: http://<gme-hostname>/api/v1/push basic_auth: username: dev-instance password: ZGV2LXJlYWQtd3JpdGVyLXBvbGljeS1kZW1vLXRva2VuOjY/ezduMTVhJDQvPGMvLzQ1SzgsJjFbMQ==
Setup your instance as a Grafana datasource
Following that we can use this access policy and token to create a new datasource in Grafana:
Navigate to Configuration ≫ Data Sources.
Click on Add new data source.
Set the URL to
Enable Basic Auth and use User
dev-instanceand as Password the token from your clipboard.
Click Save & Test.
Visualize your data
Once you have created a datasource you should now be able to visualize your metrics in the Grafana Explore page.
Related Metrics Enterprise resources
Running Prometheus-as-a-service with Grafana Enterprise Metrics
Introducing Grafana Enterprise Metrics (GME), a simple and scalable Prometheus service that is seamless to use, simple to maintain, and supported by Grafana Labs.
How Robinhood scaled from 100M to 700M time series with Grafana Enterprise Metrics
In this GrafanaCONline session, the Robinhood team tells how GME (GameStop) led to GEM (Grafana Enterprise Metrics).
Benchmarking Grafana Enterprise Metrics for horizontally scaling Prometheus up to 500 million active series
We stress-tested GEM to show how it horizontally scaled. One takeaway: Hardware usage scales linearly up to 500 million active series.