---
title: Visualize Data Using Grafana
slug: litmusedge/how-to-guides/applications-guides/visualize-datahub-data-using-grafana
description: Learn how to visualize data using Grafana. 
docTags: 
createdAt: 2023-04-14T16:46:08.000Z
---

You can use Grafana to visualize data in Litmus Edge. 

# Step 1: Install Docker Container

You have two options to install the Docker container. 

## Option 1: Deploy Grafana from Litmus Edge Manager

If you have access to Litmus Edge Manager (LEM), you can use LEM to deploy Grafana in your Litmus Edge instance. 

**To deploy Grafana from Litmus Edge Manager:**

1. In Litmus Edge Manager, follow the steps to [Manage Applications](docId:1cjuL2kjJIQEBN2kVHjp6). For Grafana, follow the steps to [Deploy an Application to Edge Devices](docId\:DruoOcegNxCGi-D_5azZw).
   - For *Step 2: Application Settings*, if the default port number is already in use, you will need to enter another port.
2. In Litmus Edge, 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 Litmus Edge

If you don't have access to Litmus Edge Manager, you can run the Grafana container in Litmus Edge. 

**To run the Grafana container in Litmus Edge:**

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.

![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/nDu33rzpXZih5O3N3dqYJ_image.png "Operational Grafana Docker Container")

# Step 2: Access Grafana

To connect to Grafana, you will use your Litmus Edge IP address and the port configured in the Grafana container. 

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/fd8bBffMy8AnzthY0OC16_image.png" size="80" width="1350" height="363" 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: \[Litmus Edge IP address]:\[port]. For example, if your Litmus Edge 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. Litmus Edge 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 Litmus Edge, navigate to **DataHub **> **DB Users**. 
2. Click the **Add user** icon. 
   ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/87yrHqM7VDvqiMyQcsDE5_add-user.png" size="80" width="1031" height="383" caption="The Add user icon" position="center" showCaption="true"}
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/QHmEBSDbk3KSmAlPxduy__image.png" size="80" width="1133" height="456" 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\:pal6ABPZbrimdU9LvGJ30) 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\:XgWOkQbTPevII7OR82LL0) 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/w3I4oxDdUWezec3DTR1eS_image.png" size="80" width="1133" height="465" 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 Litmus Edge 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 Litmus Edge.  
- In the **Password **field, paste or enter the password you configured for the DB user in Litmus Edge. 

# 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.