---
title: Configuring the Factry Historian Datasource plugin for Grafana
slug: how-tos/configuring-the-factry-historian-datasource-plugin-for-grafana
docTags: 8EU_tNMQjMdJ8KLDWLfi-
createdAt: 2025-06-30T13:42:13.730Z
---

In this guide, we will complete the installation and configuration of the Factry Historian datasource plugin for Grafana.

## Prerequisites

- An installed and properly configured Factry Historian, see [installing Factry Historian](https://docs.factry.io/how-tos/C1i5-installing-factry-historian-for-production-use).
- A running instance of Grafana of at least v10.4.0.
- Admin rights in Grafana.
- A user with READ privileges in Factry Historian

## Step-by-step guide

### 1. Create a read-only user in Factry Historian

:::hint{type="warning"}
If you already have a user group with READ privileges (such as the default Reader group), and a user assigned to the group, you can skip this step. If not, please complete this step first for a secure setup.
:::

We first create a user group with read privileges enabled and add a grafana user to this group from which to generate the API token.

- Create a user group in the according Historian organization:
  1. Go to Factry Historian
  2. Go to **Configuration > Groups**.
  3. Click on **Create user group** and give the user group a name f.e. "factry-historian-readers".
  4. Click on the **Edit** button to edit the Privileges. Assign the following privileges:
     - READ\_ASSETS
     - READ\_COLLECTORS
     - READ\_EVENT\_CONFIGURATIONS
     - READ\_EVENTS
     - READ\_EXTERNAL\_DATABASES
     - READ\_MANUAL\_ENTRY\_FORMS
     - READ\_MEASUREMENTS
     - READ\_SINKS
     - READ\_TASK\_SCHEDULERS
     - READ\_TIMESERIES\_DATABASES
- Create a user and add it to the newly created group.
  - Go to **Configuration > Users**.
  - Click on **Add new user** button,
  - Fill in the fields (username, password, email, etc.)
  - In the User groups field, search for the Reader group you created before. Select it and click the '**+**' icon. The user group should show up in the table below.

### 2. Install the Factry Historian Datasource in Grafana

If you will be using this datasource for the first time, you should install it first.

1. Open Grafana in your browser.
2. Log in with your Grafana admin credentials.
3. In Grafana, go to **Connections > Add New Connection**.
4. Search for *Factry* and select the **Factry Historian Datasource**.
5. On the top right, click **Install**.

### 3. Configure the datasource

Once the plugin is installed, and while still in the **Factry Historian Datasource** connection page, click 'Add new datasource'.

Alternatively, navigate to **Connections > Data sources** and click **Add data source**. Select **Factry Historian Datasource**.

Fill in the required fields:

- **Name**: choose a recognizable name, e.g. 'Factry Historian' or 'USA Site' in case of multi-[organization](https://docs.factry.io/concepts/organizations) setup.
- **URL:** [http://url-of-my-historian.company\:port](http://url-of-my-historian.company\:port) (typically port 8000).
- **Token:**
  - Follow the guide [Obtaining an API token](https://docs.factry.io/how-tos/-VR6-obtain)
  - Paste the token in the `Token` field in Grafana.
- **Organization**:
  - Go to the Historian web app **Configuration > Organizations**.
  - Select the Default organization (unless you defined another name during the Onboarding Wizard), and **copy the UUID** using the double file icon on the far right.
    ![](https://api.archbee.com/api/optimize/QT0Op5BmASO-D5eI7lmoL-aPts4Bc2MG64MKyz226E8-20250827-185815.png)
  - Paste the Organization UUID in the `Organization` field in Grafana.
- Select **Measurements** as the `Default tab`.

### 4. Save & test

![](https://api.archbee.com/api/optimize/QT0Op5BmASO-D5eI7lmoL-HV9uvvqwPteVshCy20lZv-20250827-190316.png)

- Click **Save & test**.
- Grafana should confirm a successful connection.

## What's next

Now that you have successfully installed the Factry Historian Datasource plugin, you can start using it:

- [Trending time-series data](https://docs.factry.io/how-tos/Vix9-trending)
- [Viewing event data](https://docs.factry.io/how-tos/H6Yb-tr)
