Lenses offers a powerful CLI (command line tool) built in Go that utilizes the REST and WebSocket APIs of Lenses to communicate with Apache Kafka. It provides a straightforward way to perform common data engineering and site reliability engineering tasks.
You can download the binary for your platform by clicking the Download button below.
View on GitHub
Alternatively, you can run from a Docker image:
# Pass credentials explicitly
docker run --rm -it lensesio/lenses-cli lenses-cli \
# Use your existing lenses-cli config file
docker run --rm -it -v $HOME/.lenses:/root/.lenses lensesio/lenses-cli \
To use the CLI you must first configure the workspace:
And fill in the details:
? Host: https://lenseshost:9991
? Auth token or username:
? Password: ******
? Save workspace name: dataopsDev
The configuration will be stored in ~/.lenses/config.yml
The —output flag, which controls the format of the output.
The value of output can be Table, YAML or JSON. By default the results of a command are printed as a table.
Additionally, when using the –output flag with JSON, two more optional flags are available: –pretty and –query.
These flags can be passed to all commands that fetch and return JSON-formatted results.
To use the CLI with a service account for CI/CD you need to pass these options:
lenses-cli topics --token=<service-account-name>:<service-account-token> --host=<lenses-url-host>
# Real Example
lenses-cli topics --token=ci:58d86476-bcc6-47e2-a57e-0c6bbd9c88b9 --host=http://<your-lenses-url>:9991
Release notes for the latest version of the CLI can be found here.
On this page