StreamBase Runtime Error Logging

StreamBase Server emits messages about events that occur when you run a client application. You can control the level or error messages generated and where they are written.

Controlling Error Message Levels

StreamBase Server can generate the following types of messages, shown in ascending order of severity:

  • Debug: Diagnostic messages emitted by the debugger.

  • Info: Informational messages that do not require action.

  • Notice: A significant event, such as server startup or shutdown.

  • Warn: An event or condition that should be avoided or may require correction.

  • Error: A nonfatal problem that may be correctable. Operation continues, although some functions may no longer be available or an action could not be completed.

  • Fatal: An unrecoverable error that probably requires manual intervention. The program usually terminates immediately after a fatal error.

By default, only the last four levels are logged (Debug and Info messages are not written). To change the levels logged, or to add time, process ID, or thread information to the error messages, set the STREAMBASE_LOG_LEVEL environment variable. See Environment Variables for details and examples.

On Windows, the STREAMBASE_LOG_LEVEL environment variable overrides settings in the LogLevel registry key. See StreamBase Services and Registry Keys on Windows for details.

Controlling Log File Locations

The location of StreamBase error logging messages depends on the mode of execution:

  • Interactive mode: When you start the sbd server from a terminal or StreamBase Command Prompt window, messages are written to standard output. You can use the redirect (>) operator to write output to a file.

  • Background mode (also called daemon mode): When you start sbd with the -b option:

    • On UNIX, error messages are written to syslog and stderr.

    • On Windows, messages are written to locations specified in the LogFile and LogToLogFile registry keys. See StreamBase Services and Registry Keys on Windows for more information on modifying messages for each server.

  • Service mode: when you start the sbd server using net start on Windows, or when you start sbd as a Windows service, messages are written in the same way as in background mode (-b).