org.spf4j.perf.tsdb

Class TimeSeriesDatabase

java.lang.Object

org.spf4j.perf.tsdb.TimeSeriesDatabase

All Implemented Interfaces:

Closeable, AutoCloseable

public final class TimeSeriesDatabase
extends Object
implements Closeable

Yet another time series database. Why? because all the other ts databases had various constraints that restrict the functionality I can add to spf4j. Initial Features: 1. measurements can be added dynamically anytime to a database. 2. long measurement names. 3. the stored interval is not known from the beginning. 4. implementation biased towards write performance. Format: Header: TSDB[version:int][metadata:bytes] Table of Contents: firstTableInfoPtr, lastTableInfoPtr TableInfo: DataFragment: ...... ...... TableInfo: DataFragment: EOF

Author:

zoly

Field Summary

Fields

Modifier and Type	Field and Description
static int	VERSION

Constructor Summary

Constructors

Constructor and Description
TimeSeriesDatabase(String pathToDatabaseFile)
TimeSeriesDatabase(String pathToDatabaseFile, boolean isWrite, byte... metaData)
TimeSeriesDatabase(String pathToDatabaseFile, byte... metaData)

Method Summary

Methods

Modifier and Type	Method and Description
void	addTSTable(String tableName, byte[] tableMetaData, int sampleTime, String[] columnNames, byte[][] columnMetaData)
void	addTSTable(String tableName, byte[] tableMetaData, int sampleTime, String[] columnNames, String[] columnMetaData)
static boolean	canGenerateCount(TSTable info)
static boolean	canGenerateHeatChart(TSTable info)
static boolean	canGenerateMinMaxAvgCount(TSTable info)
void	close()
org.jfree.chart.JFreeChart	createCountJFreeChart(String tableName)
org.jfree.chart.JFreeChart	createCountJFreeChart(String tableName, long startTime, long endTime)
static org.jfree.chart.JFreeChart	createCountJFreeChart(TimeSeries data, TSTable info)
org.jfree.chart.JFreeChart	createHeatJFreeChart(String tableName)
org.jfree.chart.JFreeChart	createHeatJFreeChart(String tableName, long startTime, long endTime)
static org.jfree.chart.JFreeChart	createHeatJFreeChart(TimeSeries data, TSTable info)
List<org.jfree.chart.JFreeChart>	createJFreeCharts(String tableName)
List<org.jfree.chart.JFreeChart>	createJFreeCharts(String tableName, long startTime, long endTime)
static List<org.jfree.chart.JFreeChart>	createJFreeCharts(TimeSeries data, TSTable info)
org.jfree.chart.JFreeChart	createMinMaxAvgJFreeChart(String tableName)
org.jfree.chart.JFreeChart	createMinMaxAvgJFreeChart(String tableName, long startTime, long endTime)
static org.jfree.chart.JFreeChart	createMinMaxAvgJFreeChart(TimeSeries data, TSTable info)
void	flush()
List<String>	generateCharts(int width, int height)
List<String>	generateCharts(long startTimeMillis, long endTimeMillis, int width, int height) Quantized recorders will have min, max avg charts and distribution charts generated.
String[]	getColumnNames(String tableName)
String	getDBFilePath()
String	getFilePath()
byte[]	getMetaData()
TSTable	getTSTable(String tableName)
Map<String,TSTable>	getTsTables()
Collection<TSTable>	getTSTables()
boolean	hasTSTable(String tableName)
static boolean	isCounterOnly(TSTable info)
TimeSeries	read(String tableName, long startTime, long endTime)
TimeSeries	readAll(String tableName)
long	readStartDate(String tableName)
void	reReadTableInfos()
void	tail(long pollMillis, long from, TSDataHandler handler)
String	toString()
void	write(long time, String tableName, long[] values)
void	writeCsvTable(String tableName, File output)
void	writeCsvTables(List<String> tableNames, File output)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

VERSION

public static final int VERSION

See Also:

Constant Field Values

Constructor Detail

TimeSeriesDatabase

public TimeSeriesDatabase(String pathToDatabaseFile)
                   throws IOException

Throws:

IOException

TimeSeriesDatabase

public TimeSeriesDatabase(String pathToDatabaseFile,
                  byte... metaData)
                   throws IOException

Throws:

IOException

TimeSeriesDatabase

public TimeSeriesDatabase(String pathToDatabaseFile,
                  boolean isWrite,
                  byte... metaData)
                   throws IOException

Throws:

IOException

Method Detail

reReadTableInfos

public void reReadTableInfos()
                      throws IOException

Throws:

IOException

close

public void close()
           throws IOException

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Throws:

IOException

hasTSTable

public boolean hasTSTable(String tableName)

addTSTable

public void addTSTable(String tableName,
              byte[] tableMetaData,
              int sampleTime,
              String[] columnNames,
              String[] columnMetaData)
                throws IOException

Throws:

IOException

addTSTable

public void addTSTable(String tableName,
              byte[] tableMetaData,
              int sampleTime,
              String[] columnNames,
              byte[][] columnMetaData)
                throws IOException

Throws:

IOException

write

public void write(long time,
         String tableName,
         long[] values)
           throws IOException

Throws:

IOException

flush

public void flush()
           throws IOException

Throws:

IOException

getColumnNames

public String[] getColumnNames(String tableName)

getTSTable

public TSTable getTSTable(String tableName)

getTSTables

public Collection<TSTable> getTSTables()

getTsTables

public Map<String,TSTable> getTsTables()

readAll

public TimeSeries readAll(String tableName)
                   throws IOException

Throws:

IOException

readStartDate

public long readStartDate(String tableName)
                   throws IOException

Throws:

IOException

read

public TimeSeries read(String tableName,
              long startTime,
              long endTime)
                throws IOException

Throws:

IOException

getDBFilePath

public String getDBFilePath()

createHeatJFreeChart

public org.jfree.chart.JFreeChart createHeatJFreeChart(String tableName)
                                                throws IOException

Throws:

IOException

createHeatJFreeChart

public org.jfree.chart.JFreeChart createHeatJFreeChart(String tableName,
                                              long startTime,
                                              long endTime)
                                                throws IOException

Throws:

IOException

createMinMaxAvgJFreeChart

public org.jfree.chart.JFreeChart createMinMaxAvgJFreeChart(String tableName)
                                                     throws IOException

Throws:

IOException

createMinMaxAvgJFreeChart

public org.jfree.chart.JFreeChart createMinMaxAvgJFreeChart(String tableName,
                                                   long startTime,
                                                   long endTime)
                                                     throws IOException

Throws:

IOException

createCountJFreeChart

public org.jfree.chart.JFreeChart createCountJFreeChart(String tableName)
                                                 throws IOException

Throws:

IOException

createCountJFreeChart

public org.jfree.chart.JFreeChart createCountJFreeChart(String tableName,
                                               long startTime,
                                               long endTime)
                                                 throws IOException

Throws:

IOException

createJFreeCharts

public List<org.jfree.chart.JFreeChart> createJFreeCharts(String tableName)
                                                   throws IOException

Throws:

IOException

createJFreeCharts

public List<org.jfree.chart.JFreeChart> createJFreeCharts(String tableName,
                                                 long startTime,
                                                 long endTime)
                                                   throws IOException

Throws:

IOException

createHeatJFreeChart

public static org.jfree.chart.JFreeChart createHeatJFreeChart(TimeSeries data,
                                              TSTable info)

createMinMaxAvgJFreeChart

public static org.jfree.chart.JFreeChart createMinMaxAvgJFreeChart(TimeSeries data,
                                                   TSTable info)

createCountJFreeChart

public static org.jfree.chart.JFreeChart createCountJFreeChart(TimeSeries data,
                                               TSTable info)

createJFreeCharts

public static List<org.jfree.chart.JFreeChart> createJFreeCharts(TimeSeries data,
                                                 TSTable info)

getMetaData

public byte[] getMetaData()

writeCsvTable

public void writeCsvTable(String tableName,
                 File output)
                   throws IOException

Throws:

IOException

writeCsvTables

public void writeCsvTables(List<String> tableNames,
                  File output)
                    throws IOException

Throws:

IOException

toString

public String toString()

Overrides:

toString in class Object

tail

public void tail(long pollMillis,
        long from,
        TSDataHandler handler)
          throws IOException

Throws:

IOException

getFilePath

public String getFilePath()

generateCharts

public List<String> generateCharts(long startTimeMillis,
                          long endTimeMillis,
                          int width,
                          int height)
                            throws IOException

Quantized recorders will have min, max avg charts and distribution charts generated. Counting recorders will have simple charts generated.

Parameters:

startTimeMillis -

endTimeMillis -

width -

height -

Returns:

Throws:

IOException

isCounterOnly

public static boolean isCounterOnly(TSTable info)

canGenerateMinMaxAvgCount

public static boolean canGenerateMinMaxAvgCount(TSTable info)

canGenerateCount

public static boolean canGenerateCount(TSTable info)

canGenerateHeatChart

public static boolean canGenerateHeatChart(TSTable info)

generateCharts

public List<String> generateCharts(int width,
                          int height)
                            throws IOException

Throws:

IOException