2017-01-16 11:13:52 +01:00
+++
2017-02-06 18:04:34 +01:00
title = "TestData"
2017-01-16 11:13:52 +01:00
keywords = ["grafana", "dashboard", "documentation", "panels", "testdata"]
2021-04-15 14:08:58 -07:00
aliases = ["/docs/grafana/latest/features/datasources/testdata"]
2020-12-10 19:42:43 +01:00
weight = 1500
2017-01-16 11:13:52 +01:00
+++
2020-02-18 15:06:33 -08:00
# Grafana TestData DB
2017-01-16 11:13:52 +01:00
2020-02-18 15:06:33 -08: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 17:24:42 +05:30
This makes it much easier to verify functionality since the data can be shared very easily.
2017-01-16 11:13:52 +01:00
2017-02-06 18:04:34 +01:00
## Enable
2017-01-16 11:13:52 +01:00
2020-11-09 21:26:49 +01:00
The `TestData DB` data source is not enabled by default. To enable it:
2020-02-18 15:06:33 -08:00
2020-11-09 21:26:49 +01:00
1. In the **Configuration** menu (small gear on the left side of the screen), click **Data Sources** .
2020-10-01 09:45:05 -07:00
1. Click **Add Data Source** .
1. Search and click `TestData DB` .
1. Click **Save & Test** to enable it.
2017-01-16 11:13:52 +01:00
## Create mock data.
2020-02-18 15:06:33 -08:00
Once `TestData DB` is enabled, you can use it as a data source in any metric panel.
2017-01-16 11:13:52 +01:00
2021-05-28 11:27:40 +02:00

2017-01-16 11:13:52 +01:00
## CSV
2017-02-06 18:04:34 +01: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 15:06:33 -08:00
Once you provided the numbers, `TestData DB` distributes them evenly based on the time range of your query.
2017-01-16 11:13:52 +01:00
2021-05-28 11:27:40 +02:00

2017-01-16 11:13:52 +01:00
## Dashboards
2020-11-09 21:26:49 +01:00
`TestData DB` also contains some dashboards with examples.
2021-08-06 07:52:36 -06:00
2020-02-18 15:06:33 -08:00
1. Click **Configuration** > **Data Sources** > **TestData DB** > **Dashboards** .
1. **Import** the **Simple Streaming Example** dashboard.
2017-01-16 11:13:52 +01:00
### Commit updates to the dashboards
2020-02-18 15:06:33 -08:00
To submit a change to one of the current dashboards bundled with `TestData DB` , update the revision property.
2017-01-16 11:13:52 +01:00
Otherwise the dashboard will not be updated automatically for other Grafana users.
## Using test data in issues
2020-09-26 22:11:52 +05:30
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 18:04:34 +01:00
That makes it much easier for the developers to replicate and solve the issue you have.