Configuring component logging

You can change the level of messages logged, where log messages are sent, and what is included in log messages for component activity.

1. In the administration tool, right-click the component that you want to log and select Properties to open the Properties Editor window.
2. Click Logging.
3. Select one or more logging levels:

   Level	To Log
   Trace	Virtually all messages that are generated. Important: Trace logging can severely decrease performance, so restrict its use to debugging.
   Warning	Events that might cause the application to fail or work incorrectly. Recommended.
   Error	Events that usually cause the application to fail or work incorrectly. Highly recommended.
   Include IP address	Appends the IP address of the source computer to each log entry; useful if you are running multiple instances of a component on different computers.

   Attention: Unlike the log4j levels, these levels are not cumulative. To log both Error and Warning messages, for example, you must select both.
4. Set the output target and other options.

   Option	Description
   Stdout	Sends the logging messages to the console.
   Logging server	Writes the logging messages to the logging server that you specify in the URL field.
   URL	The URL of the logging server. In a distributed installation, use the name of the computer where your logging server is installed. The default value is rmi://localhost:1250/LoggingServer
   Apply To All Components	Applies these values to all existing components.

   You can send the messages to the console, logging server, or both.
5. Set the logging server system service parameters.
6. Use one of these methods to start the logging service:
   • If no system services are running, run the VeniceBridgeServices script file (which typically resides in ICI_HOME\bin\). This action starts all system services, including the logging service.
   • If system services are already running and you do not mind restarting them all, stop them and run the VeniceBridgeServices script file.
   • If system services are running and you want to run the logging service alone, copy the VeniceBridgeServices script file and save the file to another location for later retrieval. Open the original in a text editor and replace com.venetica.vbr.service.VeniceBridgeServicesLauncher with com.venetica.vbr.log.LogServerLauncher. Save and run the new VeniceBridgeServices script file.
7. Click File > Save Configuration.