---
title: OpenTSDB Telnet “PUT” API input data format
description: Use the opentsdb data format to parse OpenTSDB Telnet PUT API data into Telegraf metrics.
url: https://docs.influxdata.com/telegraf/v1/data_formats/input/opentsdb/
estimated_tokens: 216
product: Telegraf Enterprise
version: v1
publisher: InfluxData
canonical: https://docs.influxdata.com/telegraf/v1/data_formats/input/opentsdb/
date: '2023-09-12T23:33:31-06:00'
lastmod: '2023-09-12T23:33:31-06:00'
---

Use the `opentsdb` data format to parse [OpenTSDB Telnet `PUT` API](http://opentsdb.net/docs/build/html/api_telnet/put.html) data into
Telegraf metrics. There are no additional configuration options for OpenTSDB.

For more detail on the format, see:

* [OpenTSDB Telnet “PUT” API guide](http://opentsdb.net/docs/build/html/api_telnet/put.html)
* [OpenTSDB data specification](http://opentsdb.net/docs/build/html/user_guide/writing/index.html#data-specification)

## Configuration

```toml
[[inputs.file]]
  files = ["example"]

  ## Data format to consume.
  ## Each data format has its own unique set of configuration options, read
  ## more about them here:
  ##   https://github.com/influxdata/telegraf/blob/master/docs/DATA_FORMATS_INPUT.md
  data_format = "opentsdb"
```

## Example

```opentsdb
put sys.cpu.user 1356998400 42.5 host=webserver01 cpu=0
```