Инструменты командной строки

OpenTSDB состоит из одного JAR-файла, который использует скрипт оболочки для определения действий пользователя. Хотя наиболее распространённое действие — запуск TSD с помощью команды tsd для постоянной работы и обработки RPC, доступны и другие команды для работы с данными OpenTSDB. Эти команды включают:

Доступ к инструменту командной строки осуществляется из расположения файла tsdb, созданного после компиляции OpenTSDB. По умолчанию файл tsdb будет находиться в каталоге build, поэтому вы можете получить к нему доступ через ./build/tsdb. Укажите имя утилиты командной строки, как в ./build/tsdb tsd.

Общие параметры

Все утилиты командной строки используют общие параметры командной строки:

Конфигурация сайта

Общие параметры выше необходимы для всех команд CLI. Ручное ввод их каждый раз может быть утомительным. Вместо этого вы можете сохранить часто используемые значения в файле ./tsdb.local. Ожидается, что этот файл будет скриптом оболочки и будет использован ./tsdb, если он существует.

Установка значений по умолчанию для общих параметров

Например, если ваш кворум ZooKeeper находится за именем DNS "zookeeper.example.com" (имя с 5 записями A), вместо того, чтобы каждый раз передавать --zkquorum=zookeeper.example.com в инструмент CLI, вы можете создать ./tsdb.local со следующим содержимым:

#!/bin/bash
MY_ARGS='--zkquorum=zookeeper'
set x $MY_ARGS "$@"
shift

Переопределение часового пояса TSD

Серверы часто используют UTC в качестве своего часового пояса. По умолчанию TSD отображает графики, используя местный часовой пояс сервера. Вы можете переопределить это, чтобы графики отображались в вашем местном времени, указав часовой пояс в ./tsdb.local. Например, если вы находитесь в Калифорнии, это заставит TSD использовать ваш часовой пояс:

echo export TZ=PST8PDT >>tsdb.local

В большинстве систем Linux и BSD вы можете посмотреть в /usr/share/zoneinfo названия часовых поясов, поддерживаемых вашей системой.

Изменение параметров JVM

Вы можете настроить параметры JVM, например, включить логирование действий GC или установить размер различных областей памяти. Для этого просто задайте переменную JVMARGS в ./tsdb.local.

Вот пример, рекомендуемый для использования в производстве:

GCARGS="-XX:+PrintGCDetails -XX:+PrintGCTimeStamps -XX:+PrintGCDateStamps\
 -XX:+PrintTenuringDistribution -Xloggc:/tmp/tsd-gc-`date +%s`.log"
if test -t 0; then # if stdin is a tty, don't turn on GC logging.
  GCARGS=
fi
# The Sun JDK caches all name resolution results forever, which is stupid.
# This forces you to restart your application if any of the backends change
# IP. Instead tell it to cache names for only 10 minutes at most.
FIX_DNS='-Dsun.net.inetaddr.ttl=600'
JVMARGS="$JVMARGS $GCARGS $FIX_DNS"