RTI Connext C# API  7.1.0
Rti.Config Namespace Reference

Contains configuration utilities, such as logging More...

Classes

class  Logger
 The singleton used to configure RTI Connext logging More...
 
struct  LogMessage
 A log message provided by the Logger.MessageLogged event. More...
 
class  ProductVersion
 Contains the version of the RTI Connext DDS and its different libraries. More...
 

Enumerations

enum class  LogLevel {
  FatalError ,
  Error ,
  Warning ,
  StatusLocal ,
  StatusRemote ,
  Debug
}
 The level at which diagnostic information is logged. More...
 
enum class  SyslogLevel {
  Emergency ,
  Alert ,
  Critical ,
  Error ,
  Warning ,
  Notice ,
  Informational ,
  Debug
}
 Syslog level category assigned to RTI Connext log messages. More...
 
enum class  Verbosity {
  Silent ,
  Error ,
  Warning ,
  StatusLocal ,
  StatusRemote ,
  StatusAll
}
 The verbosity levels at which diagnostic information is logged More...
 
enum class  SyslogVerbosity {
  Silent ,
  Emergency ,
  Alert ,
  Critical ,
  Error ,
  Warning ,
  Notice ,
  Informational ,
  Debug
}
 The Syslog verbosity levels at which RTI Connext diagnostic information is logged. More...
 
enum class  LogCategory {
  Platform ,
  Communication ,
  Database ,
  Entities ,
  Api ,
  Discovery ,
  Security ,
  All
}
 Categories of log messages More...
 
enum class  LogPrintFormat {
  Default ,
  Timestamped ,
  Verbose ,
  VerboseTimestamped ,
  Debug ,
  Minimal ,
  Maximal
}
 Configures the format to print diagnostic information. More...
 
enum class  LogFacility {
  User ,
  Security ,
  Service ,
  Middleware
}
 A number that identifies the source of a log message. More...
 

Functions

delegate void MessageLoggedEventHandler (LogMessage message)
 Event handler for Logger.MessageLogged. More...
 

Detailed Description

Contains configuration utilities, such as logging

Enumeration Type Documentation

◆ LogCategory

enum LogCategory
strong

Categories of log messages

The full documentation is available in the C API: DDS_LogCategory

Enumerator
Platform 

Log messages pertaining to the underlying platform (hardware and OS) on which RTI Connext is running are in this category.

The full documentation is available in the C API: DDS_NDDS_CONFIG_LOG_CATEGORY_PLATFORM

Communication 

Log messages pertaining to data serialization and deserialization and network traffic are in this category.

The full documentation is available in the C API: DDS_NDDS_CONFIG_LOG_CATEGORY_COMMUNICATION

Database 

Log messages pertaining to the internal database in which RTI Connext objects are stored are in this category.

The full documentation is available in the C API: DDS_NDDS_CONFIG_LOG_CATEGORY_DATABASE

Entities 

Log messages pertaining to local and remote entities and to the discovery process are in this category.

The full documentation is available in the C API: DDS_NDDS_CONFIG_LOG_CATEGORY_ENTITIES

Api 

Log messages pertaining to the API layer of RTI Connext (such as argument validation) are in this category.

The full documentation is available in the C API: DDS_NDDS_CONFIG_LOG_CATEGORY_API

Discovery 

Log messages pertaining to Discovery are in this category.

The full documentation is available in the C API: DDS_NDDS_CONFIG_LOG_CATEGORY_DISCOVERY

Security 

Log messages pertaining to Security are in this category.

The full documentation is available in the C API: DDS_NDDS_CONFIG_LOG_CATEGORY_SECURITY

All 

Log messages pertaining to all category of RTI Connext

The full documentation is available in the C API: DDS_NDDS_CONFIG_LOG_CATEGORY_ALL

◆ LogFacility

enum LogFacility
strong

A number that identifies the source of a log message.

The full documentation is available in the C API: NDDS_Config_LogFacility

Enumerator
User 

A security-related message.

The full documentation is available in the C API: NDDS_CONFIG_LOG_FACILITY_USER

Security 

A security-related message.

The full documentation is available in the C API: NDDS_CONFIG_LOG_FACILITY_SECURITY

Service 

A log message produced by an Infrastructure Service.

The full documentation is available in the C API: NDDS_CONFIG_LOG_FACILITY_SERVICE

Middleware 

A log message produced by Connext.

The full documentation is available in the C API: NDDS_CONFIG_LOG_FACILITY_MIDDLEWARE

◆ LogLevel

enum LogLevel
strong

The level at which diagnostic information is logged.

The full documentation is available in the C API: NDDS_Config_LogLevel

Enumerator
FatalError 

The message describes a fatal error.

The full documentation is available in the C API: NDDS_CONFIG_LOG_LEVEL_FATAL_ERROR

Error 

The message describes an error.

The full documentation is available in the C API: NDDS_CONFIG_LOG_LEVEL_ERROR

Warning 

The message describes a warning.

The full documentation is available in the C API: NDDS_CONFIG_LOG_LEVEL_WARNING

StatusLocal 

The message contains information about the lifecycles of local RTI Connext objects will be logged.

The full documentation is available in the C API: NDDS_CONFIG_LOG_LEVEL_STATUS_LOCAL

StatusRemote 

The message contains information about the lifecycles of remote RTI Connext objects will be logged.

The full documentation is available in the C API: NDDS_CONFIG_LOG_LEVEL_STATUS_REMOTE

Debug 

The message contains debug information that might be relevant to your application.

The full documentation is available in the C API: NDDS_CONFIG_LOG_LEVEL_DEBUG

◆ LogPrintFormat

enum LogPrintFormat
strong

Configures the format to print diagnostic information.

Enumerator
Default 

Print message, method name, category, log level and activity context (what was happening when the event occurred).

The full documentation is available in the C API: NDDS_CONFIG_LOG_PRINT_FORMAT_DEFAULT

Timestamped 

Print message, method name, category, log level, activity context, and timestamp.

The full documentation is available in the C API: NDDS_CONFIG_LOG_PRINT_FORMAT_TIMESTAMPED

Verbose 

Print message with all available context information.

The full documentation is available in the C API: NDDS_CONFIG_LOG_PRINT_FORMAT_VERBOSE

VerboseTimestamped 

Print message with all available context information, and timestamp.

The full documentation is available in the C API: NDDS_CONFIG_LOG_PRINT_FORMAT_VERBOSE_TIMESTAMPED

Debug 

Print a set of fields (including the activity context and backtrace information) that may be useful for internal debugging.

The full documentation is available in the C API: NDDS_CONFIG_LOG_PRINT_FORMAT_DEBUG

Minimal 

Print only message number and method name.

The full documentation is available in the C API: NDDS_CONFIG_LOG_PRINT_FORMAT_MINIMAL

Maximal 

Print all available fields (including backtrace information).

The full documentation is available in the C API: NDDS_CONFIG_LOG_PRINT_FORMAT_MAXIMAL

◆ SyslogLevel

enum SyslogLevel
strong

Syslog level category assigned to RTI Connext log messages.

The full documentation is available in the C API: NDDS_Config_SyslogLevel

Enumerator
Emergency 

System is unusable.

The full documentation is available in the C API: NDDS_CONFIG_SYSLOG_LEVEL_EMERGENCY

Alert 

Should be corrected immediately.

The full documentation is available in the C API: NDDS_CONFIG_SYSLOG_LEVEL_ALERT

Critical 

Critical conditions.

The full documentation is available in the C API: NDDS_CONFIG_SYSLOG_LEVEL_CRITICAL

Error 

Error conditions.

The full documentation is available in the C API: NDDS_CONFIG_SYSLOG_LEVEL_ERROR

Warning 

May indicate that an error will occur if action is not taken.

The full documentation is available in the C API: NDDS_CONFIG_SYSLOG_LEVEL_WARNING

Notice 

Events that are unusual, but not error conditions.

The full documentation is available in the C API: NDDS_CONFIG_SYSLOG_LEVEL_NOTICE

Informational 

Normal operational messages that require no action.

The full documentation is available in the C API: NDDS_CONFIG_SYSLOG_LEVEL_INFORMATIONAL

Debug 

Information useful to developers for debugging the application.

The full documentation is available in the C API: NDDS_CONFIG_SYSLOG_LEVEL_DEBUG

◆ SyslogVerbosity

enum SyslogVerbosity
strong

The Syslog verbosity levels at which RTI Connext diagnostic information is logged.

The full documentation is available in the C API: NDDS_Config_SyslogVerbosity

Enumerator
Silent 

No output will be logged.

The full documentation is available in the C API: NDDS_CONFIG_SYSLOG_VERBOSITY_SILENT

Emergency 

Only fatal log messages will be logged.

The full documentation is available in the C API: NDDS_CONFIG_SYSLOG_VERBOSITY_EMERGENCY

Alert 

Only fatal log messages will be logged.

The full documentation is available in the C API: NDDS_CONFIG_SYSLOG_VERBOSITY_ALERT

Critical 

Only fatal log messages will be logged.

The full documentation is available in the C API: NDDS_CONFIG_SYSLOG_VERBOSITY_CRITICAL

Error 

Only error and fatal error messages will be logged.

The full documentation is available in the C API: NDDS_CONFIG_SYSLOG_VERBOSITY_ERROR

Warning 

Fatal, error and warning messages will be logged.

The full documentation is available in the C API: NDDS_CONFIG_SYSLOG_VERBOSITY_WARNING

Notice 

Fatal, error and warning messages will be logged.

The full documentation is available in the C API: NDDS_CONFIG_SYSLOG_VERBOSITY_NOTICE

Informational 

Local, remote, fatal, error and warning messages will be logged.

The full documentation is available in the C API: NDDS_CONFIG_SYSLOG_VERBOSITY_INFORMATIONAL

Debug 

All messages will be logged.

The full documentation is available in the C API: NDDS_CONFIG_SYSLOG_VERBOSITY_DEBUG

◆ Verbosity

enum Verbosity
strong

The verbosity levels at which diagnostic information is logged

The full documentation is available in the C API: NDDS_Config_LogVerbosity

Enumerator
Silent 

No output will be logged.

The full documentation is available in the C API: NDDS_CONFIG_LOG_VERBOSITY_SILENT

Error 

Only error and fatal error messages will be logged.

The full documentation is available in the C API: NDDS_CONFIG_LOG_VERBOSITY_ERROR

Warning 

Both error and warning messages will be logged.

The full documentation is available in the C API: NDDS_CONFIG_LOG_VERBOSITY_WARNING

Both error and warning messages will be logged.

The full documentation is available in the C API: NDDS_CONFIG_LOG_VERBOSITY_WARNING

StatusLocal 

Errors, warnings, and verbose information about the lifecycles of local RTI Connext objects will be logged.

The full documentation is available in the C API: NDDS_CONFIG_LOG_VERBOSITY_STATUS_LOCAL

StatusRemote 

Errors, warnings, and verbose information about the lifecycles of remote RTI Connext objects will be logged.

The full documentation is available in the C API: NDDS_CONFIG_LOG_VERBOSITY_STATUS_REMOTE

StatusAll 

Errors, warnings, verbose information about the lifecycles of local and remote RTI Connext objects, and periodic information about RTI Connext threads will be logged.

The full documentation is available in the C API: NDDS_CONFIG_LOG_VERBOSITY_STATUS_ALL

Function Documentation

◆ MessageLoggedEventHandler()

delegate void Rti.Config.MessageLoggedEventHandler ( LogMessage  message)

Event handler for Logger.MessageLogged.