SlotsDB timeseries database API

FendoDB is a timeseries database targeted at IoT device log data, used in particular with OGEMA

License

License

Categories

Categories

Logging Application Layer Libs
GroupId

GroupId

org.smartrplace.logging
ArtifactId

ArtifactId

fendodb-api
Last Version

Last Version

0.1.0
Release Date

Release Date

Type

Type

jar
Description

Description

SlotsDB timeseries database API
FendoDB is a timeseries database targeted at IoT device log data, used in particular with OGEMA

Download fendodb-api

How to add to project

<!-- https://jarcasting.com/artifacts/org.smartrplace.logging/fendodb-api/ -->
<dependency>
    <groupId>org.smartrplace.logging</groupId>
    <artifactId>fendodb-api</artifactId>
    <version>0.1.0</version>
</dependency>
// https://jarcasting.com/artifacts/org.smartrplace.logging/fendodb-api/
implementation 'org.smartrplace.logging:fendodb-api:0.1.0'
// https://jarcasting.com/artifacts/org.smartrplace.logging/fendodb-api/
implementation ("org.smartrplace.logging:fendodb-api:0.1.0")
'org.smartrplace.logging:fendodb-api:jar:0.1.0'
<dependency org="org.smartrplace.logging" name="fendodb-api" rev="0.1.0">
  <artifact name="fendodb-api" type="jar" />
</dependency>
@Grapes(
@Grab(group='org.smartrplace.logging', module='fendodb-api', version='0.1.0')
)
libraryDependencies += "org.smartrplace.logging" % "fendodb-api" % "0.1.0"
[org.smartrplace.logging/fendodb-api "0.1.0"]

Dependencies

compile (3)

Group / Artifact Type Version
org.osgi : osgi.core jar 6.0.0
org.ogema.core : api jar 2.2.0
org.ogema.ref-impl : internal-api jar 2.2.0

Project Modules

There are no modules declared in this project.

FendoDB timeseries database


Overview

FendoDB is a fork of the OGEMA timeseries database (SlotsDB), adding the following features:

  • multiple database instances
  • tagging time series / adding semantic information
  • a full-fledged REST interface
  • administrative shell commands
  • query statistics about individual time series and groups of time series
  • a visualization tool
  • supports Java permissions
  • besides the default one-file-per-day mode, other base intervals can be configured, such as hours, weeks or months

It is best used with OGEMA, but can be integrated in a standalone Java-application as well. Some features are only available when used with OGEMA (REST user permissions, visualization), or at least with OSGi (REST interface, shell commands). See Usage.

FendoDB requires Java 8 or higher.


Getting started

Using Docker

See the Docker instructions.

Using OSGi

Download the run configuration rundir-ogema-felix, and start it using one of the provided start scripts (see https://github.com/smartrplace/osgi-run-configs for more information on configuration options). The rundir contains the compiled FendoDB bundles in the folder init.

Use the REST interface or the shell commands to create a database instance and to add data points, or open the visualization page at https://localhost:8443/org/smartrplace/slotsdb/visualisation/index.html in the Browser.

See the Wiki for more information.


API reference

There is a Java API and a REST interface, and in addition a set of shell commands for the Gogo OSGi shell.


Build

Prerequisites: git, Java and Maven installed.

  1. Clone this repository
  2. In a shell, navigate to the base folder and execute mvn clean install -DskipTests

License

Apache License, Version 2.0

org.smartrplace.logging

Smartrplace

Smartrplace offers OGEMA-based solutions

Versions

Version
0.1.0