Debug Logging


FastX has a robust interface for logging debug information when trying to gather information about a server. FastX can log each service individually for pinpoint logging of specific parts of the cluster.

Log levels

FastX supports the following log levels from most to least verbose.

  • trace
  • debug
  • info
  • warn
  • error
  • fatal
  • crit

Logging from the command line

LOGLEVEL environment variable

To set all services to the same level, you can set the LOGLEVEL environment variable.
Note that this logs an extremely large amount of data which will both be difficult to decipher and slow down your system

LOGLEVEL_* environment variables (individual services)

You can log individual services from the command line by prefacing the environment variable with LOGLEVEL_<your_service>

Since services will typically contain a dot (.) you need to set the environment variable using env. For example

env LOGLEVEL_V4.SOCKET=debug /usr/lib/fast/4/tools/run-web

/etc/fastx/loglevel.ini

Logging can also be set in a file /etc/fastx/loglevel.ini or the file specified in LOGLEVEL_FILE environment variable.

Logging works similar to the environment variable method except you drop the LOGLEVEL_ prefix. See loglevel.ini