Skip to content

Smile-SA/palindrome.js

Repository files navigation

Palindrome.js

Palindrome.js

A palindrome is a word, number, phrase, or other sequence of characters which reads the same backward as forward, such as madam, racecar. There are also numeric palindromes, including date/time stamps using short digits 11/11/11 11:11 and long digits 02/02/2020.

Palindrome.js is a three.js based library which provides 3D monitoring for system metrics and KPIs. Presented as metrics sets within layers, Palindrome.js helps to easily identify relations between metrics, indicators, behaviors or trends for your realtime systems or any other data source. Custom algorithms, visual behaviors, styles and color schemes can easily be modified or added.

Palindrome.js is still considered as an experimental / beta prototype, be aware API can change at any moment. Feedbacks are more than welcome !

Palindrome.js

Motivation

The idea behind this project is to go one step further current monitoring and dashboards solutions, by enabling a scalable and user oriented, 3D monitoring probe for multi-dimensional and heterogeneous sets of data points. Compatible use cases are various, from comparing system metrics with external indicators, to stacking up multi-tenancy informations groups for measuring differences or similarities, Palindrome.js can both be used as a live UI component for a larger BI dashboard, or as the signal source for a computer-vision based workflow.

Requirements

  • Node.js version 20 or later

Node.js version can be updated by executing the following commands:

sudo apt remove nodejs
sudo apt remove nodejs-doc
curl -sL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt install nodejs

Note: An already built version of Palindrome.js is ready to be integrated without any Node.js setup, two files can be found inside the /artifacts folder: palindrome.dev.js, which includes a sidebar, and palindrome.js, which represents the basic version of Palindrome.js without a sidebar. The documentation should be followed for more integration details.

Setup

This project uses three.js as its 3D renderer, yarn as the dependency manager, Storybook for functional testing and parcel-bundler as the stand-alone packager.

First install the project dependencies :

yarn install

You can configure your remote data use cases by following the documentation here.

Default HTML

Then, run the default html session for an interactive session :

yarn dev

Palindrome HTML

Storybook

Alternatively, you can run storybook :

yarn storybook

Palindrome Storybook

Docker

Palindrome.js can also be run in Docker.

You can optionally start the TSDB servers, as outlined in the documentation.

Then, launch Palindrome.js by running:

docker compose up

Documentation

Click here to visit our wiki page containing the documentation with all the implementation details.

Demo Environments

You can explore the following demo environments:

Contribute

Simply open a pull request over the repository to describe your changes.

Credits

  • Mohamed Ali Yacoubi @yacoubii
  • JonRiv (author) @JonRiv
  • Rnd Team @ SMILE

License

Licensed under the Apache 2.0 license