energylink/docs/sources/datasources/opentsdb.md

---

page_title: OpenTSDB Guide page_description: OpenTSDB guide for Grafana

page_keywords: grafana, opentsdb, documentation

OpenTSDB Guide

The newest release of Grafana adds additional functionality when using an OpenTSDB Data source.

1. Open the side menu by clicking the the Grafana icon in the top header.

2. In the side menu under the Dashboards link you should find a link named Data Sources.

   NOTE: If this link is missing in the side menu it means that your current user does not have the Admin role for the current organization.

3. Click the Add new link in the top header.

4. Select OpenTSDB from the dropdown.

Name	Description
Name	The data source name, important that this is the same as in Grafana v1.x if you plan to import old dashboards.
Default	Default data source means that it will be pre-selected for new panels.
Url	The http protocol, ip and port of you opentsdb server (default port is usually 4242)
Access	Proxy = access via Grafana backend, Direct = access directory from browser.

Query editor

Open a graph in edit mode by click the title.

Auto complete suggestions

You should get auto complete suggestions for tags and tag values. If you do not you need to enable tsd.core.meta.enable_realtime_ts in the OpenTSDB server settings.

Note: This is required for the OpenTSDB lookup api to work.

Templating queries

Grafana's OpenTSDB data source now supports template variable values queries. This means you can create template variables that fetch the values from OpenTSDB (for example metric names, tag names, or tag values). The query editor is also enhanced to limiting tags by metric.

When using OpenTSDB with a template variable of query type you can use following syntax for lookup.

metrics()                     // returns metric names
tag_names(cpu)                // return tag names (i.e. keys) for a specific cpu metric
tag_values(cpu, hostname)     // return tag values for metric cpu and tag key hostname

For details on opentsdb metric queries checkout the official OpenTSDB documentation