---
title: "Set up a GEM tenant | Grafana Enterprise Metrics documentation"
description: "Create a Grafana Enterprise Metrics tenant: Navigate to Grafana Metrics Enterprise > Tenants. Click on Create new tenant. Choose a name for this very tenant. For demonstration purposes, use the name dev-tenant."
---

> For a curated documentation index, see [llms.txt](/llms.txt). For the complete documentation index, see [llms-full.txt](/llms-full.txt).

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](/docs/enterprise-metrics/latest/).

[Documentation](/docs/)![breadcrumb arrow](/static/assets/img/icons/grafana-icon-breadcrumb-arrow-gray.svg) [Grafana Enterprise Metrics Documentation](/docs/enterprise-metrics/v1.7.x/)![breadcrumb arrow](/static/assets/img/icons/grafana-icon-breadcrumb-arrow-gray.svg) Set up a GEM tenant

Enterprise [RSS](/docs/enterprise-metrics/v1.7.x/set-up-gem-tenant/index.xml)

Create a Grafana Enterprise Metrics tenant:

1. Navigate to **Grafana Metrics Enterprise** > **Tenants**.
2. Click on **Create new tenant**.
3. Choose a name for this very tenant. For demonstration purposes, use the name `dev-tenant`.
4. Select the cluster.
5. Click **Create tenant**.

[Create tenant](./assets/create-tenant.png)

## 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 tenant named `dev-tenant`:

1. Navigate to **Grafana Enterprise Metrics** > **Access policies**.
2. Click **Create new access policy**.
3. Choose a name for the policy. For demonstration purposes, use `dev-read-write-policy`.
4. Enable the scope **metrics:read** and **metrics:write**.
5. Select the tenant `dev-tenant`.
6. Click on **Create**.

[Create access policy](./assets/create-ap.png)

7. From the newly created access policy, click **+ Add token**.
8. Name the token `dev-token`, and click on **Create**.
9. 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:

YAML ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```yaml
remote_write:
  - url: http://metrics-enterprise/api/v1/push
    basic_auth:
      username: dev-tenant
      password: ZGV2LXJlYWQtd3JpdGVyLXBvbGljeS1kZW1vLXRva2VuOjY/ezduMTVhJDQvPGMvLzQ1SzgsJjFbMQ==
```

## Setup remote-write to your tenant

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.](https://github.com/grafana/agent/blob/master/docs/getting-started.md)

An example agent configuration would be:

YAML ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```yaml
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-tenant
        password: ZGV2LXJlYWQtd3JpdGVyLXBvbGljeS1kZW1vLXRva2VuOjY/ezduMTVhJDQvPGMvLzQ1SzgsJjFbMQ==
```

## Setup your tenant as a Grafana datasource

Following that we can use this access policy and token to create a new datasource in Grafana:

1. Navigate to **Configuration ≫ Data Sources**.
2. Click on **Add new data source**.
3. Select **Prometheus**.
4. Set the URL to `http://<gme-host>/prometheus`.
5. Enable **Basic Auth** and use **User** `dev-tenant` and as **Password** the token from your clipboard.
6. Click **Save &amp; Test**.

[Create datasource](./assets/create-datasource.png)

## Visualize your data

Once you have created a datasource you should now be able to visualize your metrics in the Grafana Explore page.

[Visualize data](./assets/visualize-data.png)