---
title: Visualize Data Using Grafana
slug: bhdo-v1/visualize-data-using-grafana
createdAt: 2022-12-07T14:30:56.000Z
---

You can use Grafana to visualize data in Belden Horizon Data Operations. 

# Step 1: Install Docker Container

You have two options to install the Docker container. 

## Option 1: Deploy Grafana from Belden Horizon Data Manager

If you have access to Belden Horizon Data Manager (BHDM), you can use BHDM to deploy Grafana in your Belden Horizon Data Operations instance. 

**To deploy Grafana from Belden Horizon Data Manager:**

1. In Belden Horizon Data Manager, follow the steps to [Manage Applications](docId:_Bg4Ap72eT8AoVSjTWeK_). For Grafana, follow the steps to [Deploy an Application to Edge Devices](docId:_YcCBftIm4prbxc2kEK_E).
   - For *Step 2: Application Settings*, if the default port number is already in use, you will need to enter another port.
2. In Belden Horizon Data Operations, navigate to **Applications **> **Containers**.
   The *Containers *pane appears. 
3. Verify that the Grafana Docker Container is running.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/WaAOMIYw3jqvo2U3FPKiX_image.png" size="80" width="1710" height="176" caption="Operational Grafana Docker Container" position="center" showCaption="true"}

## Option 2: Run Grafana Container in Belden Horizon Data Operations

If you don't have access to Belden Horizon Data Manager, you can run the Grafana container in Belden Horizon Data Operations. 

**To run the Grafana container in Belden Horizon Data Operations:**

1. Navigate to **Applications **> **Containers**.
   The *Containers *pane appears. 
2. From the *Containers* pane, click **Run**. 
   The *Enter command to run *field appears. 
3. Enter the following Docker run command and click **Run**.

```linux
docker run -d --name=grafana --restart=always -u root -v grafana-storage:/var/lib/grafana -v grafana-config:/etc/grafana -p 3000:3000 grafana/grafana
```

          If needed, replace `-p 3000:3000` with a different port. 

      4\. Verify that the Grafana Docker Container is running.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/nDu33rzpXZih5O3N3dqYJ_image.png" size="80" width="1710" height="176" caption="Operational Grafana Docker Container" position="center" showCaption="true"}

# Step 2: Access Grafana

To connect to Grafana, you will use your Belden Horizon Data Operations IP address and the port configured in the Grafana container. 

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/xlFo9WkjMu6rC7sexHBbc_image.png" size="80" width="1166" height="303" caption="Grafana port" position="center" showCaption="true"}

**To access Grafana: **

1. In a new browser window, enter the URL to connect to Grafana using this format: \[Belden Horizon Data Operations IP address]:\[port]. For example, if your Belden Horizon Data Operations instance uses the IP address https\://192.168.0.146, and the Grafana container uses port 3000, enter **192.168.0.146:3000**.
   The Grafana login screen appears. 
2. Enter **admin **as the username and password, and then change the password.
   The *Grafana Home *screen appears. 

# Step 3: Set up Database

Grafana needs a database to extract from to display results. Belden Horizon Data Operations allows you to configure the internal timeseries database (tsdata) to connect to Grafana.

You also have the option to set up a database to your specific requirements. 

## Step 1: Create DB User

You will need to create a user that has read access to the database.

**To create a DB user:**

1. In Belden Horizon Data Operations, navigate to **DataHub **> **DB Users**. 
2. Click the **Add (+)** icon.

   ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/gnSY01dUqdDzxMUgr82NS_add-db-user-button.png" size="80" width="1118" height="447" position="center" showCaption="false"}
3. Configure the user details. 
   - **Username**
   - **Password**: Copy and save this for later use. 
   - **Database**: Select **tsdata**. 
   - **Privilege**: Select **Read**. 
4. Click **Add User**. 

## Step 2: Ensure Database Has a Measurement

The database will not connect successfully to Grafana unless at least one measurement is in the database. 

To confirm if the database has a measurement, navigate to **DataHub **> **DB Management** and click the arrow to expand the tsdata database. 

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/72t-B9cFeONzdv1YmLDaD_image.png" size="80" width="1121" height="447" caption="Expand the tsdata database" position="center" showCaption="true"}

If there are no measurements listed, follow the steps below. 

### Step 2a: Connect Device

Follow the steps to [Connect a Device](docId\:T-cWPe0_Jsfw5-aoj8WPP) and do the following:

- Select the Device Type **Simulator **and the Driver Name **Generator**. 
- Select the **Enable Data Store** check box in the device configuration. 
- Enter a value in the **Retention Hours** field. 

### Step 2b: Add Tag to Device

Follow the steps to [Add Tags](docId\:Wpe2HMXelARLBnhWbuChY) and add at least one tag to the device you created. 

After connecting the device and adding the tag, navigate to **DataHub **> **DB Management** and click the arrow to expand the tsdata database again to confirm a measurement is now available.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/YVu1Fr6hPmNkB4GFB75_u_image.png" size="80" width="948" height="327" caption="tsdata measurement" position="center" showCaption="true"}

# Step 4: Add a Data Source in Grafana

You will need to add a data source in Grafana that connects to the database you created. See the [Influx data source](https://grafana.com/docs/grafana/latest/datasources/influxdb/) documentation from Grafana to learn more. 

When configuring the data source, do the following:

- Select the **InfluxDB** time-series database. 
- In the **URL **field, enter `http://10.30.50.1:8086`. 10.30.50.1 is the IP address of Belden Horizon Data Operations on the internal docker network by default. 
- In the **Database **field, enter `tsdata`. 
- In the **User **field, enter the username you configured for the DB user in Belden Horizon Data Operations.  
- In the **Password **field, paste or enter the password you configured for the DB user in Belden Horizon Data Operations. 

# Step 5: Add a Dashboard in Grafana

Now that the database is successfully connected to Grafana, you can start visualizing the data by using a dashboard. See the [Create a dashboard ](https://grafana.com/docs/grafana/latest/dashboards/build-dashboards/create-dashboard/)documentation from Grafana to learn more.