Lightbend Console

Lightbend Console the Reactive Application Monitor

Lightbend Console enables you to monitor your Reactive applications running on Kubernetes.

The Console provides visibility for KPIs, reactive metrics, monitors and alerting, and includes a large selection of ready-to-use dashboards. Lightbend Console delivers real value during development, testing, and staging as well as during production. The Console works with Lightbend Orchestration to help you manage the complexities of distributed applications and focus on building core business value.

The Console provides out-of-the-box support for any application instrumented to export metrics to Prometheus. Akka, Lagom, and Play applications that include Lightbend Telemetry (formerly called Cinnamon) provide even deeper insights and can take advantage of pre-built Grafana dashboards. Lightbend Orchestration provides a command line to simplify packaging and deployment of Akka, Lagom, and Play applications.

quick start

prerequisites

First things first you need to contact Lightbend to get a Lightbend account.

Next add the Lightbend helm chart repository.

helm repo add es-repo https://repo.lightbend.com/helm-charts
helm repo update

temporary workaround to install the Lightbend container images

Note: Konvoy is using containerd. There is currently an issue with the Lightbend container registry (i.e. bintray, JFrog internal JIRA JBT-2988) when pulling private images. Thats why we need the additional steps described in this section until the issue gets resolved.

Use your Lightbend credentials to login to the Lightbend container registry.

docker login lightbend-docker-commercial-registry.bintray.io

Next execute the following script. It pulls the Lightbend container images, saves them in a tarball, copies the tarball to every worker node, and imports it into containerd.

Note: The script requires the aws cli and jq commands to be installed. On Mac OS X both can be installed using brew. You also have to login to your aws account using the aws cli.

CLUSTER=... # name of your cluster, its the prefix used for worker nodes, check in ec2 console
REGION=us-west-2
KEY_FILE=... # path to private key file in folder where you ran konvoy -up


docker pull lightbend-docker-commercial-registry.bintray.io/enterprise-suite/es-console:v1.0.7
docker pull lightbend-docker-commercial-registry.bintray.io/enterprise-suite/es-grafana:v0.2.4
docker pull lightbend-docker-commercial-registry.bintray.io/enterprise-suite/console-api:v1.0.12

docker save lightbend-docker-commercial-registry.bintray.io/enterprise-suite/es-console:v1.0.7 lightbend-docker-commercial-registry.bintray.io/enterprise-suite/es-grafana:v0.2.4 lightbend-docker-commercial-registry.bintray.io/enterprise-suite/console-api:v1.0.12 > lb.tar.gz

IPS=$(aws --region=$REGION ec2 describe-instances |  jq --raw-output ".Reservations[].Instances[] | select((.Tags | length) > 0) | select(.Tags[].Value | test(\"$CLUSTER-worker\")) | select(.State.Name | test(\"running\")) | [.PublicIpAddress] | join(\" \")")

for ip in $IPS; do
  echo $ip;
  scp -o StrictHostKeyChecking=no -i $KEY_FILE lb.tar.gz centos@$ip:/tmp;
  ssh -o StrictHostKeyChecking=no -i $KEY_FILE centos@$ip sudo ctr -n k8s.io image import /tmp/lb.tar.gz;
done

In your Konvoy cluster.yaml file remove the line - AlwaysPullImages and do a konvoy up.

...
spec:
  kubernetes:
    admissionPlugins:
      enabled:
      - NodeRestriction
      - AlwaysPullImages
      disabled: []
...      

installing the Lightbend console

The helm install requires that you pass your Lightbend credenitals. Use the following snippet to create a credentials.yaml file.

cat << EOF > credentials.yaml
imageCredentials:
    username: <your-lightbend-username>
    password: <your-lightbend-password>
EOF

Install the Lightbend console.

helm install es-repo/enterprise-suite --name enterprise-console --namespace lightbend --version 1.1.0 --values credentials.yaml

accessing the Lightbend console

Enable localhost access to the Lightbend console.

kubectl -n lightbend port-forward svc/console-server 5000:80

Click to open the Lightbend console.

installing Lightbend demo applications

Lightbend provides two demo applications to experience the Lightbend platform, shoppingcartapp and drone-tracker.

Start with cloning the demo github repository.

git clone https://github.com/lightbend/lb-demos.git
cd lb-demos

build the examples yourself

An overview of the demonstrated features, and instructions to build these examples locally are available in the lb-demos repository.

run with prebuilt images

If you want to quickly deploy versions of these apps use the below instructions:

If you want to install the shoppingcartapp, then go to the respective subfolder. In the shoppingcartapp.yaml change the image setting to image: "kwehden/shoppingcartapp". Next you apply the yaml manifest.

kubectl apply -f shoppingcart.yaml

If you want to install the drone-tracker, then go to the respective subfolder. In the drone-tracker.yaml and drone-sim.yaml change the image setting to image: kwehden/dronetracker:latest. Next apply both manifests.

kubectl apply -f drone-tracker.yaml
kubectl apply -f drone-sim.yaml

delete the Lightbend console

helm delete --purge enterprise-console

information

documentation

release notes

license

maintenance & support