Log output
The Pexip Infinity Management Node collates the logs from itself and all Conferencing Nodes and compiles these into the support log and the administrator log (which is a subset of the events in the support log). To view these logs from the Pexip Infinity Administrator interface, go to or .
You can also use a syslog server to collate logs remotely.
Log timestamps always use UTC.
The log appears in the format:
syslog_time system originating_time level name details
where:
Field | Description |
---|---|
syslog_time
|
In the format:
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:
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:
|
name
|
The system module producing the log output. |
details
|
Information about the event, as a series of name=value pairs. |
Administrator log system modules
The administrator log contains information about events occurring during the normal use of the system which may be of interest to a system administrator.
The following list shows typical events that are shown in the administrator log. In addition to these, logs may also contain one-off events, such as bulk configuration import and incident reports.
For the sake of brevity, the examples shown below feature only the name
and details
sections of the log message.
administrator.system
Logs when the Pexip Infinity application has started on this Conferencing Node. Also logs web-based activities such as:
- import of service configuration
- deployment of a Conferencing Node
- configuration synchronization towards Conferencing Nodes
- liveness status of Conferencing Nodes
Examples
Name="administrator.system" Message="Starting Infinity application." Pid="1650" Name="administrator.system" Message="Deploying worker virtual machine." Address="192.168.0.2" Name="administrator.system" Message="Successfully deployed worker virtual machine." Address="192.168.0.2" Name="administrator.system.configuration" Message="Conferencing node configuration updated." Node="conferencingnode1" Name="administrator.system.configuration" Message="Conferencing node appears unavailable." Node="conferencingnode1" Last-Reported="2013-06-20 14:21:35" Name="administrator.system.configuration" Message="Conferencing node successfully updated after being marked unavailable." Node="conferencingnode1" Name="administrator.system.connectivity" Message="Connectivity lost to node." Node="192.168.0.2" Last-Reported="Mon Dec 9 15:28:12 2013" Name="administrator.system.connectivity" Message="Connectivity re-established." Node="192.168.0.2" Last-Reported="Mon Dec 9 15:28:12 2013"
administrator.configuration
This module logs when:
- configuration is added or changed
- a user logs in or logs out of the system, or fails to log in
- a participant is manually dialed into a conference
- license requests are processed
Messages
Configuration added Configuration changed Configuration deleted User logged in User logged out User login failed Initiated dial command License activation request stored for offline processing Processed license request
Parameters
Parameter | Definition |
---|---|
User | The user who made the change. |
Type | The field that was changed/added. |
ID | The value that was assigned. |
Remote-Address | The IP address of the system from which the request was received. |
Remote-Port | The port on the system from which the request was received. |
Examples
Name="administrator.configuration" Message="Configuration added" User="admin" Type="Virtual Meeting Room" ID="meet.alice" Name="administrator.configuration" Message="User login failed" User="admins" Remote-Address="192.0.2.0" Remote-Port="53991"
administrator.conference
This module logs conference activity.
Parameters
Each log entry includes information in the form of a series of name=value pairs. These are defined as follows:
Parameter | Definition |
---|---|
Conference | The name of the service being connected to. |
ConferenceAlias | The alias that was dialed in order to connect to the service. |
Service-tag | The unique identifier for the service, if configured. |
Service-type |
This will be one of the following:
|
Location | The system location of the Conferencing Node that received the call. |
Protocol | The protocol of the incoming call. |
Licenses | The number of licenses allocated for the call. |
Vendor | The vendor string of the endpoint that placed the call. |
Signaling-node | The IP address of the Conferencing Node handling the signaling for the call. |
Media-node | The IP address of the Conferencing Node handling the media processing for the call. |
Duration | (for disconnect events) The duration of the call. |
Detail | (for disconnect events) The reason this call was disconnected. |
Examples
Message="Conference has been created." Conference="meet" Service-tag="" Service-type="conference"
Logged when a conference instance is created on a particular Conferencing Node. This occurs when the first participant attempts to join this conference on a particular Conferencing Node:
Note that the name given in the Conference= parameter is the name of the service, not the alias being dialed.
Message="Failed creating conference." Conference="meet" Service-tag=""
Logged if the conference creation fails.
Message="Conference has been stopped." Conference="meet" Service-tag="" Duration="62.234"
Logged when a conference has stopped on a particular conferencing node. The Duration
of this conference is given in seconds.
Message="Participant attempting to join conference." ConferenceAlias="sip:meet@example.com" Participant="sip:bob@example.com" Protocol="SIP"
When a participant tries to connect to a conference, this is the first thing logged (note that at this stage it is the conference alias that is logged).
Message="Participant failed to join conference." ConferenceAlias="sip:meet.invalid@example.com" Participant="sip:bob@example.com" Reason="Conference not found"
Logged if the participant cannot join the conference. The Reason
may vary as appropriate; the example above shows one possibility.
Message="Participant has joined." Conference="meet" Service-tag="" Participant="sip:alice@example.com" DisplayName="Alice Smith" Protocol="SIP" Vendor="TANDBERG/257 (TE4.1.1.273710)" Call-id="c15b773a81af1740@192.168.0.1" Location="London" Licenses="1" Signaling-node="192.168.0.1" Media-node="192.168.0.2"
Logged when the participant joins the conference. Note at this stage it is now using the Virtual Meeting Room name. The Call-ID
allows correlation of messages from the same participant URIs but different calls. Location
reports the configured location of the Conferencing Node.
Message="Participant has disconnected." Conference="meet" Service-tag="" Participant="sip:alice@example.com" Call-id="c15b773a81af1740@192.168.0.1" Location="London" Licenses="1" Signaling-node="192.168.0.1" Media-node="192.168.0.1" Duration="63.123" Detail="Remote disconnect"
Logged when a participant leaves the conference. Parameters are the same as for Participant has joined
, apart from the inclusion of a Duration
(in seconds) that they were present for. This message provides the definitive record of the length of time a call has been connected to a conference.
Message="Participant is presenting." Conference="meet" Service-tag="" Participant="sip:chuck@example.com" Call-id="c15b773a81af1740@192.168.0.1"
Logged when participants start presenting.
Message="Participant has stopped presenting." Conference="meet" Service-tag="" Participant="sip:chuck@example.com" Call-id="c15b773a81af1740@192.168.0.1"
Logged when participants stop presenting.
Message="Participant hold requested by API." Conference="meet" Service-tag="" Participant="sip:alice@pexip.com" Call-id="a364a6e8d9012fb9@192.168.0.1" Message="Participant resume requested by API." Conference="meet" Service-tag="" Participant="sip:alice@pexip.com" Call-id="a364a6e8d9012fb9@192.168.0.1" Message="Participant disconnect requested by API." Conference="meet" Service-tag="" Participant="sip:alice@pexip.com" Call-id="a364a6e8d9012fb9@192.168.0.1" Message="Participant mute/unmute requested by API." Conference="meet" Service-tag="" Participant="sip:alice@pexip.com" Call-id="a364a6e8d9012fb9@192.168.0.1" Message="Participant presentation receipt enabled by API." Conference="meet" Service-tag="" Participant="sip:alice@pexip.com" Call-id="a364a6e8d9012fb9@192.168.0.1" Message="Participant presentation receipt disabled by API." Conference="meet" Service-tag="" Participant="sip:alice@pexip.com" Call-id="a364a6e8d9012fb9@192.168.0.1" Message="Outgoing call requested" ConferenceAlias="sip:meet" Participant="sip:alice@pexip.com" Protocol="SIP"
The above messages are logged when the Infinity Connect Mobile client or Infinity Connect client (or any third party using the Pexip Client API) controls participants in a conference.
Message="PIN entry correct." Participant="sip:bob@example.com" ConferenceAlias="sip:meet@example.com" Call-id="c15b773a81af1740@192.168.0.1" Detail="Participant entered correct conference PIN and will be placed into the conference." Message="Participant entered incorrect conference PIN" RetriesRemaining="2" Participant="sip:bob@example.com" ConferenceAlias="sip:meet@example.com" Call-id="c15b773a81af1740@192.168.0.1" Message="Participant exceeded PIN entry retries. Call will be disconnected." Participant="sip:bob@example.com" ConferenceAlias="sip:meet@example.com" Call-id="c15b773a81af1740@192.168.0.1" Message="PIN entry timed out." Participant="sip:bob@example.com" ConferenceAlias="sip:meet@example.com" Call-id="c15b773a81af1740@192.168.0.1" Detail="The correct PIN has not been received. Call will be disconnected."
The above messages are logged when participants attempt to join a PIN-protected conference.
Message="Conference host timeout." Participant="sip:bob@example.com" ConferenceAlias="sip:meet@example.com" Call-id="c15b773a81af1740@192.168.0.1" Detail="The conference host has not joined. Call will be disconnected." Message="Guest participant joining." Participant="sip:bob@example.com" ConferenceAlias="sip:meet@example.com" Call-id="c15b773a81af1740@192.168.0.1" Role="guest" Detail="Participant will be automatically placed into the conference because a conference host is present."' Message="First host seen in the conference; guest participant will be transferred in." Participant="sip:bob@example.com" ConferenceAlias="sip:meet@example.com"
The above messages occur when guest participants are involved in a PIN-protected conference.
administrator.participantdialer
This module logs outbound calls placed from a conference or via the Pexip Distributed Gateway.
Examples
Message="Placing outbound call" ConferenceAlias="meet.alice@example.com" DisplayName="meet.alice" Participant-alias="sip:bob@example.com" Protocol="SIP"
Logged when dialing out from a conference.
Message="Placing outbound call" Conference="Route to Lync:423a18c5-b06c-4654-9d34-e6b82f308b64" ConferenceAlias="alice@example.com" DisplayName="Alice" Participant-alias="sip:carol@example.com" Protocol="MSSIP"
Logged when making a call via the Pexip Distributed Gateway.
administrator.gatewayroutingrulematcher
This module logs the aliases that are matched against Gateway Routing Rules. The parsed or unparsed alias match type depends upon the rule's Match against full alias URI setting.
Example
Message="Alias matched gateway rule" Name="Route calls from Lync" Description="" Service-tag="" Unparsed-alias="alice@example.com" Parsed-alias="alice@example.com" Matched-alias-type="Parsed-alias"
administrator.registration
This module logs endpoint registration activities.
Examples
Message="Registration added" Alias="sip:alice@example.com" Protocol="SIP" Registration-id="8695ea23-66fb-41d2-9266-d16598f5d133" Natted="False"
Logged when a registration is added.
Message="Registration deleted" Alias="bob@example.com" Protocol="WebRTC" Registration-id="6936f540-6dbc-40ac-9d55-5469bbf4e561" Reason="Registration expired"
Logged when a registration is removed.
administrator.vmrsync
This module logs VMR synchronization template activities.
Examples
Message="Beginning VMR Sync" template="All employees" creating_vmrs="219" deleting_vmrs="0" modifying_vmrs="0" unchanged_vmrs="0"
Logged when a VMR template synchronization is initiated.
Message="Completed VMR Sync" template="Europe" status="sync_succeeded" vmrs_created="18" vmrs_deleted="10" vmrs_updated="5" vmrs_unchanged="34" warnings="3" last_warning="Sync template clash: attempt to create same conference multiple times"
Logged when a VMR template synchronization finishes.
Support Log system modules
Support logs provide a more detailed record of activity on the MCU.
support.sip:
Shows SIP signaling.
support.dns
Shows DNS lookups associated with SIP signaling.
support.bfcp
Shows BFCP signaling.
support.h323.q931, support.h323.ras, support.h323.h245
Shows H.323 signaling.
support.rest
Shows messages to and from the Pexip Client API (used by the Infinity Connect Mobile client, Infinity Connect client, and other third parties).
Content of signaling messages
All log lines for signaling-related messages contain source and destination IP addresses and ports.
Multi-line messages are encoded on a single line with the character sequence ^M
representing a linebreak.
In addition to observing remote IP addresses, for H323 logging, a Uuid
is present for H.225 (RAS) and H.245 signaling messages. These come from the same IP address but different ports, and the Uuid allows you to identify that they relate to the same call.
For BFCP signaling, all log lines are tied to a SIP Call-id
.
Most of the content of the support log is the signaling messages themselves; however it also includes logging such as TCP and TLS connection attempts, successes, and failures.
support.participant
This module logs details about conference participants, including presentation stream activation, loss of incoming video, and call media statistics when a call is completed.
Example
An example of end-of-call media statistics is as follows:
Name="support.participant" Message="Media Stream destroyed" Participant="sip:alice@example.com" Call-id="890b38520c27737c@192.168.0.1" Detail="Stream 0 (audio) RX: rate 54kbps loss 0.77% jitter 6ms TX: rate 61kbps loss 0.00% jitter 2ms codec MP4A-LATM rate 64kbps" Name="support.participant" Message="Media Stream destroyed" Participant="sip:alice@example.com" Call-id="890b38520c27737c@192.168.0.1" Detail="Stream 1 (video) RX: rate 1085kbps loss 0.00% jitter 3ms TX: rate 699kbps loss 0.00% jitter 5ms codec H264 rate 700kbps resolution 768x448 fps 30" Name="support.participant" Message="Current participant is the presenter" Participant="sip:bob@example.com" Call-id="c15b773a81af1740@192.168.0.1" Name="support.participant" Message="Presentation started" Presenter="sip:bob@example.com" Participant="sip:alice@example.com" Call-id="890b38520c27737c@192.168.0.1" Name="support.participant" Message="Stopped sending presentation to participant" Last-presenter="sip:bob@example.com" Participant="sip:alice@example.com" Call-id=890b38520c27737c@192.168.0.1" Name="support.participant" Message="Call is on hold" Participant="sip:alice@example.com" Call-id="890b38520c27737c@192.168.0.1" Name="support.participant" Message="Call has resumed" Participant="sip:alice@example.com" Call-id="890b38520c27737c@192.168.0.1" Name="support.participant" Message="Lost incoming video" Participant="sip:alice@example.com" Call-id="890b38520c27737c@192.168.0.1"