Server Tracing Options

When configuring log or console tracing, you have a variety of options for the types of trace messages that can be generated.

Specify tracing with a comma-separated list of trace options. You may specify trace options in three forms:

  • plain:  A trace option without a prefix character replaces any existing trace options.
  • +:  A trace option preceded by + adds the option to the current set of trace options.
  • -:  A trace option preceded by - removes the option from the current set of trace options.
Trace Option Description
DEFAULT Sets the trace options to the default set. This includes:
  • INFO
  • WARNING
  • ACL
  • LIMITS
  • ROUTE
  • ADMIN
  • RVADV
  • CONNECT_ERROR
  • CONFIG
  • MSG
ACL Prints a message when a user attempts to perform an unauthorized action. For example, if the user attempts to publish a message to a secure topic for which the user has not been granted the publish permission.
ADMIN Prints a message whenever an administration function is performed.
AUTH Prints a message when the server authenticates a user using an external LDAP system.
CONFIG Prints information about configuration files and their contents as the EMS server is starting up.
CONNECT Prints a message when a user attempts to connect to the server.
CONNECT_ERROR Prints a message when an error occurs on a connection.
DBSTORE Prints a message when a database store is created, along with general database store information and errors.
DEST Prints a message when a dynamic destination is created.
FLOW Prints a message when the server enforces flow control or stops enforcing flow control on a destination.
FTL Prints trace messages related to TIBCO FTL transports.
INFO Prints messages as the server performs various internal housekeeping functions, such as creating a configuration file, opening the persistent database files, and purging messages. Also prints a message when tracking by message ID is enabled or disabled.
JAAS Prints messages related to any extensible security modules.

Messages are printed when a username and password are passed to the LoginModule for authentication, and when a user and action are passed to the Permissions Modules for authorization.

JNDI Prints a trace message for each JNDI lookup performed by a client, including the name and type of the object looked up and its return value.
JVM Prints startup information about the JVM configuration, as well as any output from custom modules running in the JVM that uses System.out.
JVMERR Prints output from custom modules running in the JVM that uses System.err.
LDAP_DEBUG Prints messages when LDAP is used for authentication or to obtain group information.
LIMITS Prints a message when a limit is exceeded, such as the maximum size for a destination.
LOAD Prints the paths of any dynamically loaded libraries. For example, the tibemsd can load Zlib, FTL, and SSL libraries.
MEMORY Prints a server trace information when reserve memory is triggered because of low server memory conditions.
MSG Specifies that message trace messages should be printed. Message tracing is enabled/disabled on a destination or on an individual message. If message tracing is not enabled for any messages or destinations, no trace messages are printed when this option is specified for log or console tracing. See Message Tracing for more information about message tracing.
PRODCONS Prints a message when a client creates or closes a producer or consumer.
ROUTE Prints a message when routes are created or when a route connection is established.
ROUTE_DEBUG Prints status and error messages related to the route.
RVADV Prints TIBCO Rendezvous advisory messages whenever they are received.
SSL Prints detailed messages of the SSL process, including certificate content.
SSL_DEBUG Prints messages that trace the establishment of SSL connections.
TX Prints a message when a client performs a transaction.
WARNING Prints a message when a failure of some sort occurs, usually because the user attempts to do something illegal. For example, a message is printed when a user attempts to publish to a wildcard destination name.

Examples

The following example sets the trace log to only show messages about access control violations.

   log_trace=ACL

The next example sets the trace log to show all default trace messages, in addition to SSL messages, but ADMIN messages are not shown.

   log_trace=DEFAULT,-ADMIN,+SSL

The next example sends a trace message to the console when a TIBCO Rendezvous advisory message arrives.

   console_trace=RVADV