LogMan.io Commander

LogMan.io Commander allows to run the following utility commands via command line or API.

Commands

encpwd

Passwords used in configurations can be protected by the encryption.

Encrypt Password command encrypts password(s) to LogMan.io password format using AES cipher.

The passwords are then used in LogMan.io Collector declarative configuration in the following format:

!encpwd "<LMIO_PASSWORD>"

Configuration

The default AES key path can be configured in the following way:

[pwdencryptor]
key=/data/aes.key

Usage

Docker container
Command Line
docker exec -it lmio-commander lmiocmd encpwd MyPassword
API

LogMan.io Commander also serves an API endpoint, so the encpwd command can be reached via HTTP call:

curl -X POST -d "MyPassword" http://lmio-commander:8989/encpwd

library

Library command serves to insert library folder structure with all YAML declarations into ZooKeeper, where other components such as LogMan.io Parser and Correlator may dynamically download it from.

This is how to initiate loading of the library into ZooKeeper cluster:

Configuration

It is necessary to properly configure the source folder and ZooKeeper output.

[source]
path=/library

[destination]
urls=zookeeper:12181
path=/lmio

Usage

Docker container
Command Line
docker exec -it lmio-commander lmiocmd library load

Using explicitly defined configuration:

docker exec -it lmio-commander lmiocmd -c /data/lmio-commander.conf library load
API

LogMan.io Commander also serves an API endpoint, so the library command can be reached via HTTP call:

curl -X PUT http://lmio-commander:8989/library/load

See Docker Compose section below.

Docker Compose

File

The following docker-compose.yml file pulls the LogMan.io Commander image from TeskaLabs’ Docker Registry and expects the configuration file in ./lmio-commander folder.

version: '3'
services:
  lmio-commander:
    image: docker.teskalabs.com/lmio/lmio-commander
    container_name: lmio-commander
    volumes:
      - ./lmio-commander:/data
      - /opt/lmio-library:/library
    ports:
      - "8989:8080"

The /opt/lmio-library path leads to LogMan.io Library repository.

Run the container

docker-compose pull
docker-compose up -d