tadis-ui is a Docker-based microservice that transforms a system model into HTML + SVG and provides it via a HTTP server. The viewer uses graphviz-d3 which is ultimately based on Graphviz. It transforms a system model to DOT first and then from DOT to SVG.
It shows the focussing on single nodes by displaying theirs neighours only. And then neighbours and neighbours of neighbours and so on.
If you just want to try the viewer and play with it, do the following:
npm run startbuilds the bundle that is used in index.html and runs a web server that provides the index.html and some more endpoints- access the local example system:
http://localhost:8080/tadis/html/?demo=1
A Docker image for tadis-ui is also available via Docker Hub: https://hub.docker.com/r/andreasblunkmw/tadis-ui
The viewer needs to fetch the system that is to be visualized from a URL. There are two options which are configured by environment variables. You may set the variables by placing them into a .env file in the viewers root directory.
a) Direct URL
- SYSTEM_PROVIDER_URL='http://localhost:8081/collect/system?version=1'
b) Indirect discovery through Consul service discovery
- CONSUL_BASE_URL='https://consulhost:8080'
- SYSTEM_PROVIDER_SERVICE_NAME='analyzer'
- SYSTEM_PROVIDER_SERVICE_ENDPOINT='/subsystems/json'
Further configuration:
- NODE_ENV='production' enables production mode
- CACHE_TTL_SECONDS=300 sets the time to live of the cache
- PORT sets the port of the HTTP server, default is 8080 if PORT is not specified
- local execution:
npm run start
- execution via docker container:
npm run docker-buildnpm run docker-run(expects.envfile with environment variables in current directory)
In addition, the following options can be specified via query parameters:
demo=1loads an example system as inputdebug=1shows debug information in the graph from metadatalast=1forces the viewer to use last system successfully fetched (as fallback)anonymize=1anonymizes all node names