About the support log

The Management Node collates the logs from itself and all Conferencing Nodes and compiles them into the support log.

The support log records all events occurring across the Pexip Infinity deployment, including:

  • configuration changes on the system
  • conferences starting and ending
  • participants joining and leaving conferences
  • participants presenting in conferences
  • SIP, H.323 and BFCP signaling
  • device registration requests
  • DNS lookups.

Sensitive information, such as the content of chat messages, is not logged.

Log timestamps always use UTC.

The information in the support log is retained during reboot and upgrade.

You can also configure Pexip Infinity to use an external syslog server. This allows you to use the syslog server's associated tools to collate and process the log entries to obtain specific information about real-time events, tailored to your requirements.

For more information on the content of the support log, see Log output.

Viewing the support log

To view the support log, go to History & Logs > Support log. If required, you can export the support log to a text file by selecting Download.

The log is presented in the order the messages were received by the Management Node.

The log appears in the format:

syslog_time system originating_time level name details

where:

Field Description
syslog_time

In the format:

year-month-dayThour:minute:second.millisecondUTC_offset

The time that the event was logged by syslog on the originating system.

system The IP address or host name of the system that sent the log message.
originating_time

In the format:

year-month-day hour:minute:second,millisecond

The time at which the event occurred on the originating system.

level

The severity of the event. The levels, in order of increasing severity, are:

  • DEBUG
  • INFO
  • WARNING
  • ERROR

In the Pexip Infinity Administrator interface, warnings and errors are highlighted with an orange or blue background respectively.

name The system module producing the log output.
details Information about the event, as a series of name=value pairs.

Searching the support log

You can filter the entire support log to only show messages that contain a particular string (for example, an IP address or alias) using the search box at the top left of the web page.

The search box also supports BRE syntax regular expressions (regex), so for example, you could search for:

  • ^2017-10-07T09:[34][[:digit:]]: to limit the displayed log messages to those emitted between 09:30:00 and 09:49:59 UTC on 7 October 2017
  • .*"Registration added".*"sip:alice@example.com" to find all instances of "Registration added" messages for the SIP alias alice@example.com
  • .*\("error"\|administrator.alarm\).* to review error and warning alarms that have been raised or lowered.

Note that the results are not paginated.

Summarizing support log messages

You can select Log summary to generate a condensed view of the messages in the support log, showing a summary of the call signaling — similar to traditional ladder diagrams, but text based — for the current search/filtered log messages, such as a filter on a specific call ID.

File size

The support log has a maximum size of 2 GB, after which it will be overwritten, starting with the oldest entries. Up to 10 MB is available in a single page view on the Pexip Infinity Administrator interface; you can navigate through additional log pages using the buttons at the bottom left of the page. (Note that each page is a separate file, so the first page, which is the end of the file, may not be full.)