Run

Running Lightbend Telemetry with the sandbox basically means two things; start the sandbox and then run your configured application.

Sandbox

The sandbox utilizes Docker and Docker Compose to start all the required software.

Download sandbox

First download and unzip the sandbox scripts. You can do this in a terminal with:

curl -O https://downloads.lightbend.com/cinnamon/sandbox/cinnamon-docker-sandbox-2.9.2.zip
unzip cinnamon-docker-sandbox-2.9.2.zip

The unzipped directory contains a Docker Compose file, to download and run the Docker containers for the sandbox, and a Grafana plugin with dashboards for Cinnamon metrics.

Run sandbox

To run Lightbend Telemetry with the Docker sandbox, first change into the unzipped directory for the downloaded sandbox scripts at a terminal:

cd cinnamon-docker-sandbox-2.9.2

Make sure that Docker is running, and then start the sandbox using Docker Compose:

docker-compose up

This will start Docker containers for Elasticsearch, Kibana, and Grafana.

Or to run in the background, you can use detached mode:

docker-compose up -d

Stop sandbox

To stop the sandbox, you can Ctrl+C if running in the foreground, or by using:

docker-compose down

Run application

Once the sandbox environment is running the next step is to run your configured application. The way you run it depends on the build tool you have selected.

Before your application starts to run, Lightbend Telemetry will be initialized. If you have followed the configuration setup then data is going to be published from your application into Elasticsearch. This is done in regular pulses and it may take a couple of seconds before data is starting to show up in Grafana and Kibana.