67.2.1 Syslog Level and Verbosity Mapping

Connext works with its own builtin log levels and verbosities, and with Syslog standard log levels and verbosities. (See 67.2 Configuring Connext Logging.) Internally, Connext uses its own logging levels and verbosities; the following components use Syslog log levels and verbosities:

• RTI Connext Observability Framework (see the RTI Observability Framework documentation)
• NDDSConfigLogger USER-logging APIs (the "Log USER messages" row of Table 67.4 NDDSConfigLogger Operations)
• Security events generated by the Security Plugins (see Security Events and Logging, in the RTI Security Plugins User's Manual)

Connext translates between Syslog log levels/verbosities and builtin log levels/verbosities when interacting with the above components. Because the mapping is not one-to-one, you may observe unexpected behavior when using some Syslog log levels and verbosities. For example, using a Syslog verbosity of NOTICE in Observability Framework will return messages of the following levels: EMERGENCY, CRITICAL, ALERT, ERROR, WARNING, NOTICE, and INFORMATIONAL. (A pure Syslog system would not provide INFORMATIONAL messages with a NOTICE verbosity.)

For consistent results, and to avoid conversion issues, RTI recommends using only the following Syslog log levels and verbosities: ERROR, WARNING, INFORMATIONAL, and DEBUG.

Although it's recommended to use only the above-mentioned Syslog log levels and verbosities, the following tables describe the full mapping between Syslog and builtin log levels and verbosities (depending on whether you are translating from builtin to Syslog, or from Syslog to builtin), for your reference.

Table 67.5 Mapping from NDDS_Config_SyslogLevel to NDDS_Config_LogLevel

NDDS_Config_SyslogLevel (NDDS_CONFIG_SYSLOG_LEVEL_*)	NDDS_Config_LogLevel (NDDS_CONFIG_LOG_LEVEL_*)
EMERGENCY	FATAL_ERROR
ALERT CRITICAL ERROR	ERROR
WARNING	WARNING
NOTICE INFORMATIONAL	STATUS_LOCAL
DEBUG	DEBUG

 

Table 67.6 Mapping from NDDS_Config_LogLevel to NDDS_Config_SyslogLevel

NDDS_Config_LogLevel (NDDS_CONFIG_LOG_LEVEL_*)	NDDS_Config_SyslogLevel (NDDS_CONFIG_SYSLOG_LEVEL_*)
FATAL_ERROR	EMERGENCY
ERROR	ERROR
WARNING	WARNING
STATUS_LOCAL STATUS_REMOTE	INFORMATIONAL
DEBUG	DEBUG

 

Table 67.7 Mapping from NDDS_Config_SyslogVerbosity to NDDS_Config_LogVerbosity

NDDS_Config_SyslogVerbosity (NDDS_CONFIG_SYSLOG_VERBOSITY_*)	NDDS_Config_LogVerbosity (NDDS_CONFIG_LOG_VERBOSITY_*)
SILENT	SILENT
EMERGENCY ALERT CRITICAL ERROR	ERROR
WARNING	WARNING
NOTICE INFORMATIONAL	STATUS_REMOTE
DEBUG	STATUS_ALL

 

Table 67.8 Mapping from NDDS_Config_LogVerbosity to NDDS_Config_SyslogVerbosity

NDDS_Config_LogVerbosity (NDDS_CONFIG_LOG_VERBOSITY_*)	NDDS_Config_SyslogVerbosity (NDDS_CONFIG_SYSLOG_VERBOSITY_*)
SILENT	SILENT
ERROR	ERROR
WARNING	WARNING
STATUS_LOCAL STATUS_REMOTE	INFORMATIONAL
STATUS_ALL	DEBUG