6.1 Real-Time Event Logs

You can configure the Conferencing servers, either at installation time or later, to produce real-time event logs for call, user and meeting reservation events. The real-time interface provides the event data records as they are occur so that third-party systems can use them (for example, a billing system or cost accounting system, management reporting systems or user directory database). The records are delivered via a TCP connection to Conferencing server hosts.

6.1.1 Determining Whether Real-Time Events Are Enabled

If the value of the enable_rt_logs file is set to yes, the system delivers the records to consumers connecting to Conferencing hosts. If it is set to no, the system does not provide the real-time interface. If real-time records are required but not enabled, rerun the installer script to change the setting.

6.1.2 Determining Hosts and Ports

You can find the hosts and ports providing the real-time event records by examining the global configuration found in /opt/iic/conf/global-config directory on any Conferencing host.

6.1.3 Call Record Host and Port

The connected call record hosts are specified by the controller_host array in the global-config file. The port to use for the connection is specified by the rt_call_port variable.

6.1.4 User Record Host and Port

The connected user record host is specified by the addressbk_host array in the global-config file. The port to use for the connection is specified by the rt_user_port variable.

6.1.5 Reservation Record Host and Port

The connected user record host is specified by the addressbk_host array in the global-config file. The port to use for the connection is specified by the rt_rsrv_port variable.

6.1.6 Connecting to Real-Time Event Logs

When a consumer of real-time events connects to one of the event logs described above, the system sends the contents of the event log for the current day. Future events are sent to the consumer as they occur for the duration of the time that the consumer remains connected to the event log host. Each night, the event logs are rotated. After the logs have been rotated, the prior day’s events are no longer available to the real-time event log consumer. If needed, you can obtain them from the time-stamped event log files (call+<timestamp>.elg, user+<timestamp>.elg and rsrv+<timestamp>.elg) in the /var/iic/cdr directory on the same host used for the real-time event log connection. The time stamp on the files refers to the time that the log rotation happened.