Logd is a log scanner daemon that exposes a Lua API to run arbitrary logic on structured logs.

• logd
• uv
• miniz

Depending on the build, the following modules are preloaded:

• lpeg
• openssl
• zlib

Run configure script and then make:

$ ./configure
$ make
$ make install

If you have problems linking with a system dependency, you can configure the project to build the dependency from source:

$ ./configure --enable-build-luajit --enable-build-openssl
$ make

Alternatively, you can provide your own CFLAGS or LDFLAGS:

$ ./configure CFLAGS='-DOPENSSL_NO_STDIO -DOPENSSL_NO_SM2'
$ make

Finally, you can also disable some of the modules:

$ ./configure --without-openssl --without-lpeg
$ make

For a full list of options run ./configure --help.

Please refer to the Docker images in utils to see some of the common options and CFLAGS used by the different Linux distros.

Assuming you have Homebrew installed:

$ brew update && brew bundle --file=utils/Brewfile
$ export LIBTOOL=glibtool
$ export LIBTOOLIZE=glibtoolize
$ ./configure --enable-build-all
$ make && make install

Please refer to MacOS section in .travis.yml to see the latest build options.

The builtin scanner expects logs to be in the following format:

YYYY-MM-dd hh:mm:ss	LEVEL	[Thread]	Class	key: value...

If you need to scan logs in a different format, you can load a dynamic shared object that implements src/scanner.h via the --scanner flag. For static builds (if dlopen is disabled) or if you simply want to build the project with a different builtin scanner, you can configure so with:

$ ./configure --with-builtin-scanner=my_scanner.c

For a list of available scanners look for the source files in src that end in _scanner.c.

Configure and enable the development build:

$ ./configure --enable-develop
$ make
$ make test

Logd uses Libuv under the hood and is compatible with Luvit modules. The Luvit runtime and standard modules are not preloaded by default but you can do so by running lit install luvit/luvit in your script's directory and then supplying your script to the logd executable.