Logging events

Complete these steps to enable content, instant messaging, or presence logging. To actually view the log results, you must install the sample EAR file.

About this task

When you first install Sametime® Gateway Server, event logging is enabled. But to begin logging events, you must enable at least one custom property for the event logger. You can record three types of events: the actual content of an instant messaging session, instant messaging data, and presence (or subscription) data. Each type of event records basic information such as when a session starts and stops, when an instant message is sent, when a presence subscription is created or released, and when a presence notification takes place.

Event logging for content, instant messaging, and presence is disabled (set to 0) by default. Values 0 or 1 and true or false are acceptable.

Expected state:
  • Single server: the Sametime Gateway Server is started.
  • Cluster: the deployment manager is started, and the node agent and Sametime Gateway Server are started on at least one node.

Procedure

  1. In the Integrated Solutions Console, click Sametime Gateway > Message Handlers.
  2. Click the event logger plugin in the table.
  3. Click Custom properties.
  4. Select one of the following properties:
    • enableContentLogging
    • enableImLogging
    • enablePresenceLogging
  5. Set the value as follows:
    Values Meaning
    0 OR false disabled
    1 OR true enabled
  6. Click OK.
    You cannot view logged events until you install the sample application that logs information to trace.log. See the sample EAR file and Sametime Gateway Server Integration Guide included in the Sametime Software Development Kit.