1. Get your Lenses license key 

Sign up with Lenses and download your license key.

2. Sign up for AWS and create an MSK Kafka 

MSK for Apache Kafka is a fully managed streaming platform by AWS, deployable on the AWS cloud.

Start by signing up for an AWS account. Follow the in-product instructions to launch a Kafka cluster within the AWS console interface.

Then, enable connectivity and open monitoring to get the most of it.

Enable connectivity 

Allow your Lenses instance to connect to the MSK cluster. Edit the MSK security group and add the IP address of your Lenses Docker host.

Enable connectivity

Enable open monitoring 

Enable it on an existing cluster with this AWS guide.

Enable open monitoring

Gather Kafka connection points 

Go to View Client Information

  1. Kafka endpoints (Plaintext)
Kafka endpoints

3. Run Lenses with Docker 

Run the following in a terminal:

docker run -e LENSES_PORT=8080 -p 8080:8080 lensesio/lenses

Wait for this message in the logs:

2021-12-16 18:17:04,322 INFO  [i.l.b.r.HttpServer] [ioapp-compute-6] Lenses http server started and listening to requests.

Now your Lenses is up and running.

4. Login 

Head to http://localhost:8080.

Login as admin:

  • User: admin
  • Password: admin
Lenses login page

5. Wizard Setup 

  • Go to the 2nd step of the Lenses wizard.
  • Paste the Kafka endpoints.
  • Select PLAINTEXT as the security protocol.
  • Click on next.

Lenses will check that it can connect to your Kafka.

Kafka endpoints

6. License 

Add your Lenses license. Copy and paste the JSON file you downloaded from your email. Lenses will check that the license is valid.

License Validation

7. Boot 

Click on Save & Boot Lenses. Lenses will finish configuring itself.

Wizard Validation

8. Eureka! 

Lenses Dashboard

Next Steps 


Currently, Lenses doesn’t integrate with:

  • AWS MSK Connect

Without this services these Lenses features are not available:

Last modified: July 17, 2024