Description

The OpenTSDB sender sends metrics from 1Gateway into a OpenTSDB. If configured, OpenTSDB sends the messages it receives to Grafana.

 

Prerequisites

To integrate OpenTSDB with 1Gateway, make these changes in the OpenTSDB configuration.

Set JAVA_HOME 

sudo su

vi /root/.bash_profile
TEXT

Add the JAVA_HOME to the file

export JAVA_HOME=<JAVA_HOME_PATH>
TEXT

Run following command to apply changes

su -

echo JAVA_HOME
TEXT

Restart hbase

Make sure that the echo response is the JAVA_HOME path set.

grep hbase
TEXT

Stop opentsdb and hbase (depends on hbase)

kill XXXX (opentsdb process number)

/opt/hbase_1.2.6/bin/stop_hbase.sh
TEXT

Start hbase

/opt/hbase_1.2.6/bin/start_hbase.sh
TEXT

Change OpenTSDB configuration

Change opentsdb to run as a service. Go to /etc/opentsdb and change configuration

vi opentsdb.conf
TEXT

Set the auto_create_metrics to true

tsd.core.auto_create_metrics = true
TEXT

Start OpenTSDB

If it's running as a service:

service opentsdb start
TEXT

If it is not running as a service:

cd opentsdb/build

make install
TEXT

Check if the changed made to the configuration are applied: http://localhost:4242/api/config

Installation

Make sure you have the 1gateway zip file that includes the plugin files and valid licences information ready. This file has been provided to you with the installation files.

1 - Login

Login to 1gateway, and make sure you are in "Advanced mode". If this is the first time you log in, the default user and password are both 'admin' (without the quotes).

2 - System Maintenance

Click on the menu icon and choose the option "System maintenance"


3 - Upload file


In the System maintenance view you can either drag and drop the downloaded zip file or select it by clicking the "choose file" button.

4 - Restart

After the upload installation will be confirmed. Restart 1Gateway to ensure any locked files are updated.

Configuration


Open the main menu and click on "New plugin"

Select the plugin you want to configure. Use the Filter field if needed.

Field name

Supported values

Description

IP address

Valid ip address

OpenTSDB server

Port number

Valid port number

OpenTSDB port number

See also