Properties element (QualityUpdate element)
(LyncDiagnostics element) (Lync SDN API Schema A)
Properties of the media stream, including a selected set of quality metrics reported and thresholds that are used to determinine a bad call.
Applies to: Lync 2013
Element information
Element type |
Not defined |
Namespace |
|
Schema file |
LyncSdnApi.Schema.A.xsd |
Definition
<xs:element name="Properties">
<xs:complexType>
<xs:sequence maxOccurs="unbounded">
<xs:element name="RelativeOneWayAverage">
<xs:attribute name="Limit" type="xs:decimal" use="optional" />
</xs:element>
<xs:element name="VideoFrameLossRate"></xs:element>
<xs:element name="VideoPacketLossRate">
<xs:attribute name="Limit" type="xs:decimal" use="optional" />
</xs:element>
<xs:element name="BurstGapDensity"></xs:element>
<xs:element name="SpoiledTilePercentTotal">
<xs:attribute name="Limit" type="xs:decimal" use="optional" />
</xs:element>
<xs:element name="PacketLossRateMax"></xs:element>
<xs:element name="JitterInterArrival">
<xs:attribute name="Limit" type="xs:decimal" use="optional" />
</xs:element>
<xs:element name="Codec" type="CodecType"></xs:element>
<xs:element name="BurstGapDuration" type="xs:string"></xs:element>
<xs:element name="RecvSignalLevel" type="xs:string"></xs:element>
<xs:element name="SendListenMOS"></xs:element>
<xs:element name="RelativeOneWayBurstDensity">
<xs:attribute name="Limit" type="xs:decimal" use="optional" />
</xs:element>
<xs:element name="DegradationAvg">
<xs:attribute name="Limit" type="xs:decimal" use="optional" />
</xs:element>
<xs:element name="VGAQualityRatio"></xs:element>
<xs:element name="HealerPacketDropRatio" type="xs:string"></xs:element>
<xs:element name="EchoPercentSend" type="xs:string"></xs:element>
<xs:element name="SpoiledTilePercentAverage" type="xs:decimal"></xs:element>
<xs:element name="RecvListenMOSMin"></xs:element>
<xs:element name="RoundTrip">
<xs:attribute name="Limit" type="xs:decimal" use="optional" />
</xs:element>
<xs:element name="RecvListenMOS"></xs:element>
<xs:element name="PacketLossRate">
<xs:attribute name="Limit" type="xs:decimal" use="optional" />
</xs:element>
<xs:element name="RDPTileProcessingLatencyAverage">
<xs:attribute name="Limit" type="xs:decimal" use="optional" />
</xs:element>
<xs:element name="ConversationalMOS" type="xs:string"></xs:element>
<xs:element name="SendListenMOSMin"></xs:element>
<xs:element name="EchoReturn"></xs:element>
<xs:element name="LowResolutionCallPercent">
<xs:attribute name="Limit" type="xs:decimal" use="optional" />
</xs:element>
<xs:element name="VideoLocalFrameLossPercentageAvg">
<xs:attribute name="Limit" type="xs:decimal" use="optional" />
</xs:element>
<xs:element name="DegradationPacketLossAvg"></xs:element>
<xs:element name="BurstDuration"></xs:element>
<xs:element name="OverallAvgNetworkMOS" type="xs:string"></xs:element>
<xs:element name="JitterInterArrivalMax" type="xs:string"></xs:element>
<xs:element name="HDQualityRatio"></xs:element>
<xs:element name="LowFrameRateCallPercent">
<xs:attribute name="Limit" type="xs:decimal" use="optional" />
</xs:element>
<xs:element name="Protocol" type="xs:string"></xs:element>
<xs:element name="EchoEventCauses"></xs:element>
<xs:element name="DegradationMax" type="xs:string"></xs:element>
<xs:element name="RecvFrameRateAverage">
<xs:attribute name="Limit" type="xs:decimal" use="optional" />
</xs:element>
<xs:element name="OverallMinNetworkMOS" type="xs:string"></xs:element>
<xs:element name="AppliedBandwidthLimit" type="xs:unsignedInt" minOccurs="0"></xs:element>
<xs:element name="PacketUtilization" type="xs:string"></xs:element>
<xs:element name="BurstDensity"></xs:element>
<xs:element name="RDPTileProcessingLatencyBurstDensity">
<xs:attribute name="Limit" type="xs:decimal" use="optional" />
</xs:element>
<xs:element name="RatioConcealedSamplesAvg">
<xs:attribute name="Limit" type="xs:decimal" use="optional" />
</xs:element>
<xs:element name="RecvNoiseLevel" type="xs:string"></xs:element>
<xs:element name="FrameRate" type="xs:decimal"></xs:element>
<xs:element name="BitRateMax" type="xs:string"></xs:element>
<xs:element name="LocalFrameLossPercentageAvg" type="xs:string"></xs:element>
<xs:element name="DegradationJitterAvg" type="xs:string"></xs:element>
<xs:element name="BitRateAvg" type="xs:string"></xs:element>
<xs:element name="EchoPercentMicIn" type="xs:string"></xs:element>
<xs:element name="RoundTripMax" type="xs:string"></xs:element>
<xs:element name="DynamicCapabilityPercent">
<xs:attribute name="Limit" type="xs:decimal" use="optional" />
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
Elements and attributes
If the schema defines specific requirements, such as sequence, minOccurs, maxOccurs, and choice, see the definition section.
Parent elements
Element |
Type |
Description |
---|---|---|
Not defined |
Specifies the event that a SIP call has ended and contains an updated report of the quality metrics of individual media streams. These quality metrics for a stream may include updates provided by other endpoints during the call. By default, LDL raises this event (and thus reports the quality updates) only if the call quality is under the quality thresholds defined in the QoE database or in the LDL configuration file. Alterantively, you can configure Lync Dialog Listener (LDL) to send all quality updates. Quality updates are based on individual streams instead of the call. |
Child elements
Element |
Type |
Description |
---|---|---|
xs:unsignedInt |
Displays the limits applied. It's provided only in QualityUpdate events when Call Admission Control is used. |
|
xs:string |
Average bit rate, in bits per second, sent or received for a video stream and computed over the duration of the session. This includes raw video and transport bits. This metric is reported for video streams when available. (bits/s) |
|
xs:string |
Maximum bit rate, in bits per second, sent or received for a video stream and computed over the duration of the session. This metric is reported for video streams when available. (bits/s) |
|
Not defined |
Average burst density, as specified in [RFC3611] section 4.7.2, is computed with a Gmin=16 for the received RTP packets. This metric is reported for audio streams when available. The fraction of RTP data packets within burst periods since the beginning of reception that were either lost or discarded. This value is expressed as a fixed point number with the binary point at the left edge of the field. It's calculated by dividing the total number of packets lost or discarded (excluding duplicate packet discards) within burst periods by the total number of packets expected within the burst periods, multiplying the result of the division by 256, limiting the maximum value to 255 (to avoid overflow), and taking the integer part. This field MUST be populated and MUST be set to zero if no packets have been received. |
|
Not defined |
The average burst duration, as specified in [RFC3611] section 4.7.2, is computed with a Gmin=16 for the received RTP packets. This metric is reported for audio streams when available. (ms) |
|
Not defined |
Average burst gap density, as specified in [RFC3611] section 4.7.2, computed with a Gmin=16 for the received RTP packets. This metric is reported for audio streams when available. |
|
xs:string |
Average burst gap duration, as specified in [RFC3611] section 4.7.2, computed with a Gmin=16 for the received RTP packets. This metric is reported for audio streams when available. (ms) |
|
Describes the last codec used for the media. |
||
xs:string |
Conversational clarity index for remote party, as described in [ITUP.562] section 6.3. This metric is reported for all available modalities and media types. |
|
Not defined |
Difference between the OverallAvg value and the maximum possible MOS-LQO for the audio codec used in the session. This metric is reported for audio streams when available. |
|
xs:string |
Average fraction of the degradation jitter average applies to inter-arrival packet jitter. This metric is reported for audio streams when available. |
|
xs:string |
Maximum degradation as the difference between the OverallMin and the maximum possible MOS-LQO for the audio codec used in the session. This metric is reported for audio streams when available. |
|
Not defined |
Average fraction of the DegradationAvg that was caused by packet loss. This metric is reported for audio streams when available. |
|
Not defined |
Percentage of time that the client is running under capability of less than 70% of expected capability for this type of CPU. Inbound and Outbound are identical because it measures the capability of the client instead of the channel. This metric is reported for video streams when available. (percent) |
|
Not defined |
Reasons of device echo detection and reported for audio streams when available. The causes are coded by the following bit flags: "0x01" - Sample timestamps from capture or render device were poor quality. "0x04" - High level of echo remained after echo cancellation. "0x10" - Signal from capture device had significant instances of maximum signal level. |
|
xs:string |
Percentage of time when echo is detected in the audio from the capture or microphone device prior to echo cancellation. This metric is reported for audio streams when available. |
|
xs:string |
Percentage of time when echo is detected in the audio from the capture or microphone device after echo cancellation. This metric is reported for audio streams when available. |
|
Not defined |
Echo returns reported for audio streams, when available. |
|
xs:decimal |
Average frame rate (in frames per second). When available, this metric is only reported for application sharing streams and only for Lync 2013. (frames/s) |
|
Not defined |
Percentage of the duration of a call that is using the HD720 resolution. This metric is reported for video streams when available. (percent) |
|
xs:string |
Ratio of audio packets dropped by a healer over total number of audio packets received by the healer. This metric is reported for all modalities/media types when available. (percent) |
|
Not defined |
Average inter-arrival jitter, as specified in [RFC3550] section 6.4.1. This metric is reported for all available modalities/media types. (ms) |
|
xs:string |
Maximum inter-arrival jitter, as specified in [RFC3550] section 6.4.1. This metric is reported for all modalities/media types when available. (ms) |
|
xs:string |
Average percentage of video frames lost as they are displayed to the user, including frames recovered from network losses. This metric is reported for video streams when available. (percent) |
|
Not defined |
Percentage of time of the call where frame rate is less than 7.5 frames per second. This metric is reported for video streams when available. (percent) |
|
Not defined |
Percentage of time of the call where resolution is low. Threshold is 120 pixels for smaller dimension. This metric is reported for video streams when available. (percent) |
|
xs:string |
Average of MOS-LQO wideband, as specified by [ITUP.800.1] section 2.1.2, based on the audio codec used, the observed packet loss and inter-arrival packet jitter. This metric is reported for audio streams when available. |
|
xs:string |
Minimum of MOS-LQO wideband, as specified by [ITUP.800.1] section 2.1.2, based on the audio codec used, the observed packet loss and inter-arrival packet jitter. This metric is reported for audio streams when available. |
|
Not defined |
Average fraction lost computed over the duration of the session, as specified in [RFC3550] section 6.4.1. This metric is reported for all available modalities and media types. (percent) |
|
Not defined |
Maximum fraction lost, as specified in [RFC3550] section 6.4.1, computed over the duration of the session. This metric is reported for all available modalities/media types. (percent) |
|
xs:string |
Number of Real-time Transport Protocol (RTP) packets received in the session. This metric is reported for all available modalities and media types. |
|
xs:string |
Transmission protocol of the call such as TCP or UDP. |
|
Not defined |
Ratio of the number of audio frames with samples generated by packet loss concealment to the total number of audio frames. This metric is reported for audio streams when available. |
|
Not defined |
Average processing time for remote desktop protocol (RDP) tiles. A higher total value implies a longer delay in the viewing experience. When available, this metric is only reported for application sharing streams using Lync 2013. (ms) |
|
Not defined |
Burst density in the processing time for remote desktop protocol (RDP) tiles. A "bursty" transmission is a transmission where data flows in unpredictable bursts as opposed to a steady stream. This metric is only reported for application sharing streams using Lync 2013. |
|
Not defined |
Average frames per second received for all video streams and computed over the duration of the session. This metric is reported for video streams when available. (frames/s) |
|
Not defined |
MOS-LQO wideband, as specified by [ITUP.800.1] section 2.1.2, for decoded audio received by the reporting entity during the session. This metric is reported for audio streams when available. |
|
Not defined |
Minimum of the RecvListenMOS for the stream during the session. This metric is reported for audio streams when available. |
|
xs:string |
Received noise level in units of dB that is reported for audio streams when available. Average energy level of received audio is classified as noise, mono signal or the left channel of stereo signal. (dB) |
|
xs:string |
Received signal level in units of dB. This metric is reported for audio streams when available. Average energy level of received audio is classified as mono speech, or left channel of stereo speech. (dB) |
|
Not defined |
Average amount of one-way latency. Relative one-way latency measures the delay between the client and the server. This metric is only reported for application sharing streams using Lync 2013. (ms) |
|
Not defined |
Total one-way burst density involving unsteady transmission. An unsteady transmission is one where data flows in random bursts as opposed to a steady stream. This metric measures data flow between the client and the server and is only reported for application sharing streams using Lync 2013. |
|
Not defined |
Average network propagation round-trip time as specified in [RFC3550] section 6.4.1. This metric is reported for all modalities/media types when available. (ms) |
|
xs:string |
Maximum network propagation round-trip time as specified in [RFC3550] section 6.4.1. This metric is reported for all modalities/media types when available. (ms) |
|
Not defined |
MOS-LQO wideband, as specified by [ITUP.800.1] section 2.1.2, for pre-encoded audio sent by the reporting entity during the session. This metric is reported for audio streams when available. |
|
Not defined |
Minimum of the SendListenMOS for the stream over the duration of the session. This metric is reported for audio streams when available. |
|
xs:decimal |
Average percentage of the content that did not reach the viewer but was instead discarded and overwritten by fresh content. When available, this metric is only reported for application sharing streams and only for Lync 2013. (percent) |
|
Not defined |
Total percentage of the content that did not reach the viewer but was instead discarded and overwritten by fresh content. When available, this metric is only reported for application sharing streams and only for Lync 2013. (percent) |
|
Not defined |
Percentage of the duration of a call that is using the VGA resolution. This metric is reported for video streams when available. (percent) |
|
Not defined |
Average fraction of frames lost on the video receiver side as computed over the duration of the session. This metric is reported for video streams when available. (frames/s) |
|
Not defined |
Average percentage of video frames lost as they are displayed to the user. This includes frames recovered from network losses. This metric is reported for video streams when available. (percent) |
|
Not defined |
Average fraction lost, as specified in [RFC3550] section 6.4.1, computed over the duration of the session. This metric is reported for video streams when available. (packets/s) |
Attributes
None.
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for