With this open source live tracking software you can record and analyze data in real time. It's useful for recording data and performing analytics in real-time. In addition, it is very easy to use and can be quickly integrated in existing applications.
This application is very much based on InfluxDB. So you have all the advantages of a very fast time series database.
- Built-in HTTP API so you don't have to write any server side code to get up and running.
- SQL-like query language.
- Get data fast in and out.
- It aims to answer queries in real-time. That means every data point is indexed as it comes in and is immediately available in queries that should return in < 100ms.
For many distributions, there are pre-packaged packages.
Install InfluxDB with the following commands:
wget https://dl.influxdata.com/influxdb/releases/influxdb_1.7.10_amd64.deb
sudo dpkg -i influxdb_1.7.10_amd64.deb
More help: https://portal.influxdata.com/downloads/
Install packages:
sudo apt update
sudo apt install git curl php-cli php-sqlite3 php-mbstring phpunit sqlite3 zip unzip
Install Composer:
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
sudo php composer-setup.php --install-dir=/usr/bin --filename=composer
php -r "unlink('composer-setup.php');"
# Clone this repository
git clone "https://github.com/livetracking/server.git"
cd server
# Install dependencies
composer install
# Create SQLite database
cat database/users.sql | sqlite3 database/users.sqlite
# Create default users
php database/default_users.php | sqlite3 database/users.sqlite
# Create InfluxDB default users and databases
bash database/influxdb.sh
# Edit setting, set InfluxDB username and password
vi src/settings.php
# Edit InfluxDB configuration
# Enable authentication by setting the 'auth-enabled' option to 'true'
sudo vi /etc/influxdb/influxdb.conf
# Restart InfluxDB
sudo systemctl restart influxdb
You can then run it with PHP's built-in webserver:
php -S 127.0.0.1:8080 -t public public/index.php
# or run
bash start.sh
Test your setup:
# Adjust variables
vi test/test.sh
# Run
bash test/test.sh
Register new user:
curl "http://127.0.0.1:8080/register" \
--data "username=my_username" \
--data "password=my_password"
Write data into InfluxDB:
curl -u "my_username:my_password" "http://127.0.0.1:8086/write?db=my_username" \
--data "test value=1"
Show user:
curl -u "my_username:my_password" "http://127.0.0.1:8080/user"
Query data from InfluxDB:
curl -u "public:livetracking" "http://127.0.0.1:8086/query?db=my_username" \
--data "q=SELECT * FROM test"
If you want to publish your setup on the internet you should use a proper web server.
A Lighttpd configuration (lighttpd.conf) can be found in the folder server.
Lighttpd is also used as a reverse proxy for InfluxDB.
Run Phing build script:
vi build.xml
sudo bash deploy.sh
A detailed description of the HTTP API can be found at https://livetracking.nkn-it.de/.
Most source files (database, public, src and templates folders and below) are made available under the terms of the GNU Affero General Public License (AGPL).