2017-01-16 04:13:52 -06:00
+++
2017-02-06 11:04:34 -06:00
title = "TestData"
2017-01-16 04:13:52 -06:00
keywords = ["grafana", "dashboard", "documentation", "panels", "testdata"]
2020-10-09 10:16:25 -05:00
aliases = ["/docs/grafana/latest/features/datasources/testdata"]
2020-12-10 12:42:43 -06:00
weight = 1500
2017-01-16 04:13:52 -06:00
+++
2020-02-18 17:06:33 -06:00
# Grafana TestData DB
2017-01-16 04:13:52 -06:00
2020-02-18 17:06:33 -06:00
The purpose of this data source is to make it easier to create fake data for any panel.
Using `TestData DB` you can build your own time series and have any panel render it.
2020-04-27 06:54:42 -05:00
This makes it much easier to verify functionality since the data can be shared very easily.
2017-01-16 04:13:52 -06:00
2017-02-06 11:04:34 -06:00
## Enable
2017-01-16 04:13:52 -06:00
2020-11-09 14:26:49 -06:00
The `TestData DB` data source is not enabled by default. To enable it:
2020-02-18 17:06:33 -06:00
2020-11-09 14:26:49 -06:00
1. In the **Configuration** menu (small gear on the left side of the screen), click **Data Sources** .
2020-10-01 11:45:05 -05:00
1. Click **Add Data Source** .
1. Search and click `TestData DB` .
1. Click **Save & Test** to enable it.
2017-01-16 04:13:52 -06:00
## Create mock data.
2020-02-18 17:06:33 -06:00
Once `TestData DB` is enabled, you can use it as a data source in any metric panel.
2017-01-16 04:13:52 -06:00

## CSV
2017-02-06 11:04:34 -06:00
The comma separated values scenario is the most powerful one since it lets you create any kind of graph you like.
2020-02-18 17:06:33 -06:00
Once you provided the numbers, `TestData DB` distributes them evenly based on the time range of your query.
2017-01-16 04:13:52 -06:00

## Dashboards
2020-11-09 14:26:49 -06:00
`TestData DB` also contains some dashboards with examples.
2020-02-18 17:06:33 -06:00
1. Click **Configuration** > **Data Sources** > **TestData DB** > **Dashboards** .
1. **Import** the **Simple Streaming Example** dashboard.
2017-01-16 04:13:52 -06:00
### Commit updates to the dashboards
2020-02-18 17:06:33 -06:00
To submit a change to one of the current dashboards bundled with `TestData DB` , update the revision property.
2017-01-16 04:13:52 -06:00
Otherwise the dashboard will not be updated automatically for other Grafana users.
## Using test data in issues
2020-09-26 11:41:52 -05:00
If you post an issue on Github regarding time series data or rendering of time series data, we strongly advise you to use this data source to replicate the data.
2017-02-06 11:04:34 -06:00
That makes it much easier for the developers to replicate and solve the issue you have.