---
title: "OpenTSDB data source | Grafana documentation"
description: "Guide for using OpenTSDB in Grafana"
---

# OpenTSDB data source

Grafana ships with support for OpenTSDB, an open source time series database built on top of HBase. Use the OpenTSDB data source to visualize metrics, create alerts, and build dashboards from your time series data.

## Supported features

The OpenTSDB data source supports the following features:

Expand table

| Feature            | Supported | Notes                                                                |
|--------------------|-----------|----------------------------------------------------------------------|
| Metrics queries    | Yes       | Query time series data with aggregation, downsampling, and filtering |
| Alerting           | Yes       | Create alert rules based on OpenTSDB queries                         |
| Annotations        | Yes       | Overlay events on graphs using metric-specific or global annotations |
| Template variables | Yes       | Use dynamic variables in queries                                     |
| Explore            | Yes       | Ad-hoc data exploration without dashboards                           |

## Supported OpenTSDB versions

The data source supports OpenTSDB versions 2.1 through 2.4. Some features are version-specific:

Expand table

| Feature       | Minimum version |
|---------------|-----------------|
| Filters       | 2.2             |
| Fill policies | 2.2             |
| Explicit tags | 2.3             |

## Get started

The following documents help you get started with the OpenTSDB data source:

- [Configure the OpenTSDB data source](/docs/grafana/latest/datasources/opentsdb/configure/) - Set up authentication and connect to OpenTSDB.
- [OpenTSDB query editor](/docs/grafana/latest/datasources/opentsdb/query-editor/) - Create and edit queries with aggregation, downsampling, and filtering.
- [Template variables](/docs/grafana/latest/datasources/opentsdb/template-variables/) - Create dynamic dashboards with OpenTSDB variables.
- [Troubleshooting](/docs/grafana/latest/datasources/opentsdb/troubleshooting/) - Solve common configuration and query errors.

## Additional features

After you have configured the OpenTSDB data source, you can:

- Add [Annotations](/docs/grafana/latest/datasources/opentsdb/annotations/) to overlay OpenTSDB events on your graphs.
- Configure and use [Template variables](/docs/grafana/latest/datasources/opentsdb/template-variables/) for dynamic dashboards.
- Set up [Alerting](/docs/grafana/latest/datasources/opentsdb/alerting/) rules based on your time series queries.
- Use [Explore](/docs/grafana/latest/explore/) to investigate your OpenTSDB data without building a dashboard.

## Related resources

- [Official OpenTSDB documentation](http://opentsdb.net/docs/build/html/index.html)
- [Grafana community forums](https://community.grafana.com/)