FAQ

#How much CPU does Sage use?

On a typical web server shipping a few hundred lines a second, well under 1% of one core. Parsing with regular expressions costs the most; JSON is cheapest.

#Can it read logs from Docker containers?

Yes. Point an input at /var/lib/docker/containers/*/*.log and set the format to json; each line carries the container's output in the log field.

#What happens when the disk buffer is full?

The oldest events are dropped to make room for new ones, and the number of dropped events is logged once a minute.

#Does it support multiline messages such as stack traces?

Yes. Give an input a multiline pattern that matches the first line of a message, and the lines that follow are joined to it.

#Is Windows supported?

Not yet. Sage runs on Linux and FreeBSD; macOS works for development.

#Which platforms are supported?

Linux, macOS and FreeBSD on amd64 and arm64. Linux on armv7 and riscv64 is built for every release too, but tested less.

#Does Sage collect telemetry?

No. It never contacts anything you did not configure, and it does not check for updates on its own.

#Is Sage free to use at work?

Yes. It is released under the MIT License, which allows commercial use.