Module Interface
Starting Logging
Note
See the Overview for more information on the parameters specified here.
- cx_Logging.StartLogging(fileName, level, maxFiles=1, maxFileSize=1048576, prefix='%t', reuse=True, rotate=True)
Start logging to the specified file at the specified level.
- cx_Logging.StartLoggingForThread(fileName, level, maxFiles=1, maxFileSize=1048576, prefix='%t', reuse=True, rotate=True)
Start logging to the specified file at the specified level, but only for the current Python thread.
- cx_Logging.StartLoggingStderr(level, prefix='%t')
Start logging to stderr at the specified level.
- cx_Logging.StartLoggingStdout(level, prefix='%t')
Start logging to stdout at the specified level.
Stopping Logging
- cx_Logging.StopLogging()
Stop logging.
- cx_Logging.StopLoggingForThread()
Stop logging for the given Python thread.
Logging Messages
- cx_Logging.Critical(format, \*args)
Log a message at the CRITICAL level. The format and arguments are the standard Python format.
- cx_Logging.Debug(format, \*args)
Log a message at the DEBUG level. The format and arguments are the standard Python format.
- cx_Logging.Error(format, \*args)
Log a message at the ERROR level. The format and arguments are the standard Python format.
- cx_Logging.Info(format, \*args)
Log a message at the INFO level. The format and arguments are the standard Python format.
- cx_Logging.Log(level, format, \*args)
Log a message at the specified level. The format and arguments are the standard Python format.
- cx_Logging.Trace(format, \*args)
Log a message regardless of the current level. The format and arguments are the standard Python format.
- cx_Logging.Warning(level, format, \*args)
Log a message at the WARNING level. The format and arguments are the standard Python format.
Logging Exceptions
- cx_Logging.LogException([value, configuredExcBaseClass])
Log the exception just raised. The value is either a string (in which case the exception will be retrieved from the thread state) or the value is a configured exception (in which case it will be used directly). Not specifying either will use the information specified in SetExceptionInfo() instead and if that is not specified default values will be used.
- cx_Logging.SetExceptionInfo(baseClass[, builder, message])
Define the behavior that specifies how exceptions are logged. The first parameter specifies the base class of exceptions that are logged in a special way and once specified does not need to be specified in the method LogException(). The second parameter specifies a method to call to build an instance of the base class if the exception is not already an instance of that class. The last parameter specifies the message that is logged immediately prior to logging the exception.
Logging State
- cx_Logging.GetEncoding()
Return the encoding currently in place for logging Unicode objects.
- cx_Logging.GetLoggingFile()
Return the file object to which logging is currently taking place.
- cx_Logging.GetLoggingFileName()
Return the name of the file to which logging is currently taking place.
- cx_Logging.GetLoggingLevel()
Return the current logging level.
- cx_Logging.GetLoggingState()
Return the current logging state.
- cx_Logging.SetEncoding(encoding)
Set the encoding to use for logging Unicode objects.
- cx_Logging.SetLoggingLevel(level)
Set the current logging level.
- cx_Logging.SetLoggingState(state)
Set the current logging state.
Constants
- cx_Logging.buildtime
The date and time when the module was built.
- cx_Logging.CRITICAL
The level at which critical errors are logged.
- cx_Logging.DEBUG
The level at which debugging messages are logged.
- cx_Logging.ENV_NAME_FILE_NAME
The environment variable name used for defining the file to which messages are to be logged.
- cx_Logging.ENV_NAME_LEVEL
The environment variable name used for defining the level at which messages are to be logged.
- cx_Logging.ENV_NAME_MAX_FILES
The environment variable name used for defining the maximum number of files to use in the rotating logging scheme.
- cx_Logging.ENV_NAME_MAX_FILE_SIZE
The environment variable name used for defining the maximum size of files before the files are rotated.
- cx_Logging.ENV_NAME_PREFIX
The environment variable name used for defining the prefix to use for all messages.
- cx_Logging.ERROR
The level at which errors are logged.
- cx_Logging.INFO
The level at which information messages are logged.
- cx_Logging.NONE
The level at which no messages are logged.
- cx_Logging.version
The version of the module.
- cx_Logging.WARNING
The level at which warning messages are logged.