Skip to content
This repository has been archived by the owner on Jan 13, 2022. It is now read-only.


Folders and files

Last commit message
Last commit date

Latest commit



21 Commits

Repository files navigation

Archived Repo

This is an archived project and is no longer supported or updated by Facebook. Please do not file issues or pull-requests against this repo. If you wish to continue to develop this code yourself, we recommend you fork it.

Proceed and be bold!


This is TSDash, a UI/Dashboard for OpenTSDB ( It is written in Java and it's built entirely using Open-Source software.


Copyright 2011 Facebook, Inc.

Licensed under the Apache License, Version 2.0 (the "License"); you may
not use this file except in compliance with the License. You may obtain
a copy of the License at

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
License for the specific language governing permissions and limitations
under the License.


server/	- contains the sources of the HTTP/JSON API needed by the UI
ui/	- GWT UI


To build each of the parts, run "ant" on "server" and "ui" directories. To build a deployable bundle run "ant war" from the root dir and this should build each component and create a .war file - tsdash.war - out of these, that can be deployed with any Servlet container (e.g. Apache Tomcat).

The two parts can also be imported in Eclipse (File > Import > Existing project into workspace) as separate projects. For the UI, Google Eclipse Plugin must be installed before importing the project.


First you need to build the .war file and then use a Servlet container to serve it. In Apache Tomcat 7.0.23 you have to copy the .war file into the webapps/ directory and it will unpack the app at startup. You can also unpack it by yourself with "jar xvf tsdash.war", as the .war file is a regular archive.


Additionally, you have to install Gnuplot 4.2 or newer and to make it accessible from /usr/local/bin/gnuplot (symlink works). Gnuplot will generate static images and these images have to be served somehow. What I did is that I've used nginx to serve the plots. The mapping between files and URLs can be configured with the "plot.tsdash.urlpattern" property from file. The default port used for serving the plots is 8090.
So Gnuplot creates the files on the disk, and nginx is serving them through the generated URL.
For example, my configuration is using nginx to listen on 8090 and serves the files from the /var/www/tsdash/plots dir. Hence, the URLs will look like http://host:8090/plots/34343.png. The advantage of separating plot serving from the app itself is that it's more flexible to use a different webserver for serving the plots, that might even be on a different machine. 

TSDash can work without Gnuplot, but you will have to use only interactive charts, which are being rendered in the browser.


conf/ - contains parameters for OpenTSDB - table names and zookeeper quorom, as well as some configuration for the plot generation process
conf/ - configuration for the log4j package