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 . If required, you can export the logs to a text file by selecting .
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 |
---|---|
Call-id | An identifier that allows correlation of messages from the same participant URI but over different connections, for example covering both an API and a WebRTC connection. |
Conference | The name of the service being connected to. |
ConferenceAlias | The alias that was dialed in order to connect to the service. |
Conversation-id | An identifier that allows correlation of messages across separate "calls" for video+audio, RDP, chat for Lync / Skype for Business connections. |
Detail | The reason the call was disconnected (for disconnect events). |
Direction | Either "in" or "out" as to whether this is an inbound or outbound call. |
Duration | The duration of the call (for disconnect events). |
Licenses | The number of licenses allocated for the call. |
Location | The system location of the Conferencing Node that received the call. |
Media-node | The IP address of the Conferencing Node handling the media processing for the call. |
Participant | The name or alias of the conference participant. |
Participant-id | Allows correlation of messages from the same participant URI per connection type, for example an API connection will have a different Participant-id from a WebRTC connection. |
Protocol | The protocol of the call (may also indicate "BACKPLANE" when a backplane between Conferencing Nodes is established or removed). |
Role | The participant's role (either "host" / "chair" or "guest"). |
Service-tag | The unique identifier for the service, if configured. |
Service-type |
This is one of the following:
|
Signaling-location | The name of the location handling the signaling. |
Signaling-node | The IP address of the Conferencing Node handling the signaling for the call. |
Vendor | The vendor string of the endpoint that placed the call. |
Examples
Trigger for the log message | Example log entry |
---|---|
Logged when a participant tries to connect to a conference (at this stage it is the conference alias that is logged). |
Message="Participant attempting to join conference." ConferenceAlias="sip:meet.alice@example.com" Participant="sip:alice@example.com" Protocol="SIP" Direction="in" Participant-id="44be63a0-...c52" |
A conference instance is created on a Conferencing Node. This occurs when the first participant attempts to join this conference on that Conferencing Node. The Conference parameter indicates the name of the service, not the alias being dialed. |
Message="Conference has been created." Conference="Meet Alice" Service-tag="" Service-type="conference" |
The participant joins the conference. This log message is issued before a role is assigned. |
Message="Participant has joined." Conference="Meet Alice" Service-tag="" Service-type="conference" ConferenceAlias="sip:meet.alice@example.com" Participant="sip:alice@example.com" DisplayName="Alice Smith" Protocol="SIP" Direction="in" Vendor="TANDBERG/257 (TE4.1.1.273710)" Call-id="fe7107ba-...16c" Conversation-id="fe7107ba-...16c" Participant-id="44be63a0-...c52" Location="London" Licenses="1" Signaling-node="192.168.0.1" Signaling-location="London" Media-node="192.168.0.2" |
Logged if conference creation fails. |
Message="Failed creating conference." Conference="meet" Service-tag="" |
Logged if the participant cannot join the conference. The Reason may vary as appropriate. |
Message="Participant failed to join conference." ConferenceAlias="sip:meet.invalid@example.com" Participant="sip:bob@example.com" Reason="Conference not found" |
A participant leaves the conference. Includes the Duration (in seconds) for which they were present in the conference. This message provides the definitive record of the length of time a call was connected to a conference. |
Message="Participant has disconnected." Conference="Meet Alice" Service-tag="" Service-type="conference" ConferenceAlias="sip:meet.alice@example.com" Participant="sip:alice@example.com" DisplayName="Alice Smith" Protocol="SIP" Direction="in" Call-id="fe7107ba-...16c" Conversation-id="fe7107ba-...16c" Participant-id="44be63a0-...c52" Location="London" Licenses="1" Signaling-node="192.168.0.1" Signaling-location="London" Media-node="192.168.0.1" Duration="63.123" Detail="Remote disconnect" |
A conference has stopped on a particular Conferencing Node. The Duration of this conference is given in seconds. |
Message="Conference has been stopped." Conference="Meet Alice" Service-tag="" Service-type="conference" Duration="62.234" |
A participant starts / stops presenting. |
Message="Participant is presenting." Conference="meet" Service-tag="" Participant="sip:chuck@example.com" Call-id="e5dbd44b...243" Message="Participant has stopped presenting." Conference="meet" Service-tag="" Participant="sip:chuck@example.com" Call-id="e5dbd44b...243" |
These 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="Participant hold requested by API." Conference="meet" Service-tag="" Participant="sip:alice@pexip.com" Call-id="e5dbd44b...243" Conversation-id="e5dbd44b...243" Message="Participant resume requested by API." Conference="meet" Service-tag="" Participant="sip:alice@pexip.com" Call-id="e5dbd44b...243" Conversation-id="e5dbd44b...243" Message="Participant disconnect requested by API." Conference="meet" Service-tag="" Participant="sip:alice@pexip.com" Call-id="e5dbd44b...243" Conversation-id="e5dbd44b...243" Message="Participant mute/unmute requested by API." Conference="meet" Service-tag="" Participant="sip:alice@pexip.com" Call-id="e5dbd44b...243" Conversation-id="e5dbd44b...243" Message="Participant presentation receipt enabled by API." Conference="meet" Service-tag="" Participant="sip:alice@pexip.com" Call-id="e5dbd44b...243" Conversation-id="e5dbd44b...243" Message="Participant presentation receipt disabled by API." Conference="meet" Service-tag="" Participant="sip:alice@pexip.com" Call-id="e5dbd44b...243" Conversation-id="e5dbd44b...243" Message="Outgoing call requested" Conference="meet" Participant="sip:carol@pexip.com" Protocol="SIP" Role="chair" Message="Sending DTMF to participant." Conference="meet" Service-tag="" Participant="sip:alice@pexip.com" Call-id="e5dbd44b...243" Conversation-id="e5dbd44b...243" Digits="4" |
These messages are logged when participants attempt to join a PIN-protected conference. |
Message="PIN entry correct." Participant="sip:bob@example.com" ConferenceAlias="sip:meet@example.com" Call-id="27efdd36...6be" Role="host" 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="27efdd36...6be" Message="Participant exceeded PIN entry retries. Call will be disconnected." Participant="sip:bob@example.com" ConferenceAlias="sip:meet@example.com" Call-id="27efdd36...6be" Message="PIN entry timed out." Participant="sip:bob@example.com" ConferenceAlias="sip:meet@example.com" Call-id="a15dc445-...dfc" Detail="The correct PIN has not been received. Call will be disconnected." |
These messages occur when participants are involved in a PIN-protected conference. |
Message="Host participant joining." Participant="sip:alice@example.com" ConferenceAlias="sip:meet@example.com" Call-id="4d3ad9a1-...833" Role="chair" Detail="Participant will be automatically placed into the conference." Message="Conference host timeout." Participant="sip:bob@example.com" ConferenceAlias="sip:meet@example.com" Call-id="4d3ad9a1-...833" Detail="The conference host has not joined. Call will be disconnected." Message="Guest participant waiting." Participant="sip:bob@example.com" ConferenceAlias="sip:meet@example.com" Call-id="50a86594-...797" Role="guest" Detail="Waiting until participant is allowed to join the conference." Message="Guest participant joining." Participant="sip:bob@example.com" ConferenceAlias="sip:meet@example.com" Call-id="50a86594-...797" Role="guest" Detail="Participant will be automatically placed into the conference." |
These messages occur when automatically ending a conference |
Message="Last host left the conference and has not re-joined; conference will be terminated." Conference="Meet Alice" Service-tag="" Message="Removing participant due to conference termination" Participant="sip:bob@example.com" Conference="Meet Alice" Service-tag="" |
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.registration
This module logs endpoint registration activities.
Examples
Message="Registration added" Alias="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 and device 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.
administrator.apps.cloudbursting
This module logs cloud bursting activities.
Examples
Message="On-prem location 'Oslo' is overloaded! Starting instance i-0043088a9073b57e6 (stopped) in location 'AWS eu-west-1'"
Logged when an overflow Conferencing Node is started up.
Message="Shutting down idle worker i-597394d2 (running) (uptime: 50 minutes)"
Logged when an overflow Conferencing Node is shut down.
Support Log system modules
Support logs provide a more detailed record of activity on the Pexip Infinity system.
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).
support.jinja2
Shows messages generated by the pex_debug_log filter when inserted into local policy jinja2 scripts.
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"