+++
title = "OpenTSDB"
description = "Руководство по использованию OpenTSDB в Harvest"
keywords = ["harvest", "opentsdb", "guide"]
aliases = ["/docs/harvest/latest/features/opentsdb", "/docs/harvest/latest/features/datasources/opentsdb/"]
weight = 1100
+++
# Использование OpenTSDB в Harvest

Harvest поставляется с расширенной поддержкой OpenTSDB. В этом разделе объясняются параметры, переменные, запросы и другие параметры, характерные для источника данных OpenTSDB. См. [Добавить источник данных]({{< relref "add-a-data-source.md" >}}) для получения инструкций о том, как добавить источник данных в Harvest. Добавлять источники данных могут только пользователи с ролью администратора организации.

## Настройки OpenTSDB

Чтобы получить доступ к настройкам OpenTSDB, наведите указатель мыши на значок **Конфигурация** (шестеренка), затем щелкните **Источники данных**, а затем щелкните источник данных OpenTSDB.
|Имя        | Описание                                                                                                                          |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------- |
| `Name`       | Имя источника данных. Именно так вы обращаетесь к источнику данных в панелях и запросах.                                               |
| `Default`    | Источник данных по умолчанию означает, что он будет предварительно выбран для новых панелей.                                                               |
| `URL`        | Протокол HTTP, IP и порт вашего сервера OpenTSDB (порт по умолчанию обычно 4242).                                                 |
| `Whitelisted Cookies`     | Перечислите имена файлов cookie для пересылки в источник данных. |
| `Version`    |Версия = версия opentsdb, либо <= 2.1, либо 2.2                                                                                     |
| `Resolution` | Метрики из opentsdb могут иметь точки данных с секундным или миллисекундным разрешением.                                          |
| `Lookup Limit`| По умолчанию 1000. |
## Редактор запросов

Откройте график в режиме редактирования, щелкнув заголовок. Редактор запросов будет отличаться, если источник данных имеет версию <=2.1 или = 2.2.
В предыдущей версии для запросов к OpenTSDB можно было использовать только теги. Но в последней версии фильтры, а также теги
можно использовать для запроса opentsdb. Политика заполнения также представлена в OpenTSDB 2.2.

![](/static/img/docs/v43/opentsdb_query_editor.png)

> **Примечание.** При использовании источника данных OpenTSDB 2.2 обязательно используйте фильтры или теги, поскольку они взаимоисключающие. Если использовать вместе, может дать вам странные результаты.

### Автодополнение предложений

Как только вы начнете вводить имена метрик, имена тегов и значения тегов , вы должны увидеть выделенные варианты автозаполнения для них.
Автозаполнение работает только в том случае, если включен API предложений OpenTSDB.
## Шаблоны запросов

Вместо жесткого кодирования таких вещей, как имя сервера, приложения и датчика в ваших метрических запросах, вы можете использовать вместо них переменные.
Переменные отображаются в виде раскрывающегося списка в верхней части панели инструментов. Эти раскрывающиеся списки упрощают изменение данных.
отображается на панели инструментов.

Ознакомьтесь с документацией [Templating]({{< relref "../variables/_index.md" >}}) для ознакомления с функцией шаблонов и различными
Типы переменных шаблона.

### Переменная запроса

Источник данных Harvest OpenTSDB поддерживает запросы переменных шаблона. Это означает, что вы можете создавать переменные шаблона
которые извлекают значения из OpenTSDB. Например, имена метрик, имена тегов или значения тегов.

При использовании OpenTSDB с переменной шаблона типа «запрос» вы можете использовать следующий синтаксис для поиска.

| Запрос                      | Описание                                                                     |
| --------------------------- | --------------------------------------------------------------------------------- |
| `metrics(prefix)`           | Возвращает имена метрик с определенным префиксом (может быть пустым)                         |
| `tag_names(cpu)`            |Возвращает имена тегов (т. е. ключи) для определенной метрики процессора.                        |
| `tag_values(cpu, hostname)` | Возвращает значения тегов для метрики процессора и имени хоста ключа тега.                           |
| `suggest_tagk(prefix)`      | Возвращает имена тегов (т. е. ключи) для всех метрик с определенным префиксом (может быть пустым) |
| `suggest_tagv(prefix)`      | Возвращает значения тегов для всех показателей с определенным префиксом (может быть пустым)           |

Если вы не видите, что переменные шаблона заполняются в разделе «Предварительный просмотр значений», вам необходимо включить
`tsd.core.meta.enable_realtime_ts` в настройках сервера OpenTSDB. Кроме того, для заполнения метаданных
существующие данные временных рядов в OpenTSDB, вам необходимо запустить tsdb uid metasync на сервере OpenTSDB.

### Вложенные шаблоны

Одна переменная шаблона может использоваться для фильтрации значений тега для другой переменной шаблона. Первый параметр — это имя метрики,
второй параметр — это ключ тега, для которого нужно найти значения тега, а затем все остальные зависимые переменные шаблона.
Ниже приведены некоторые примеры успешной работы вложенных шаблонных запросов.
| Запрос                                                | Описание                                                                                            |
| ----------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| `tag_values(cpu, hostname, env=$env)`                 |Возвращает значения тега для метрики процессора, выбранного значения тега env и имени хоста ключа тега.                     |
| `tag_values(cpu, hostname, env=$env, region=$region)` | Возвращает значения тега для метрики процессора, выбранного значения тега env, выбранного значения тега региона и имени хоста ключа тега. |

Подробную информацию о запросах метрик OpenTSDB см. в официальной [документации OpenTSDB](http://opentsdb.net/docs/build/html/index.html).

## Настройте источник данных с предоставлением

Теперь можно настраивать источники данных с помощью конфигурационных файлов в системе обеспечения Harvest. Вы можете узнать больше о том, как это работает, и обо всех настройках, которые вы можете установить для источников данных, на [странице документации по подготовке]({{< relref "../administration/provisioning/#datasources" >}})

Вот несколько примеров подготовки для этого источника данных.
```yaml
apiВерсия: 1

источник данных:
  - name: OpenTsdb
    type: opentsdb
    access: proxy
    url: http://localhost:4242
    jsonData:
      tsdbResolution: 1
      tsdbVersion: 1
```
