Triggers¶
According to the notification type, the triggers can be divided into two groups: state and events.
All available triggers and their short description are represented in the table below. See detailed description of parameters and events in the Registered Parameters section. Detailed description of thresholds and configurations is represented in the section Thresholds.
Key name |
Name |
Type |
Description |
---|---|---|---|
TosDscp |
ToS/DSCP Changed |
Event |
It triggers in case of ToS/DSCP field change in IP header.
|
Ttl |
TTL Changed |
Event |
It triggers in case of the Time to live (TTL) value change in IP header.
|
IatError |
maxIAT Error |
State |
It triggers in case the Error threshold is exceeded. Maximum Inter-packet Arrival Time (maxIAT) – is maximum time between packets arrival and defined as a summary of average IAT and jitter.
Set the threshold value in the Threshold tab.
|
IatWarning |
maxIAT Warning |
State |
It triggers in case the Warning threshold is exceeded. Maximum Inter-packet Arrival Time (maxIAT) – is maximum time between packets arrival and defined as a summary of average IAT and jitter.
Set the threshold value in the Threshold tab.
|
MlrError |
MLR Error |
State |
It triggers in case the Error threshold is exceeded. Media Loss Rate (MLR) refers to the number of transport packets lost per 1 second.
Set the threshold value in the Threshold tab.
|
MlrWarning |
MLR Warning |
State |
It triggers in case the Warning threshold is exceeded. Media Loss Rate (MLR) refers to the number of transport packets lost per 1 second.
Set the threshold value in the Threshold tab.
|
MaxBitrate |
Input Bitrate Overflow |
State |
It triggers in case the upper threshold is exceeded. Input bitrate refers to data volume received from the source per 1 second.
Set the threshold value in the Threshold tab.
|
MinBitrate |
Input Bitrate Underflow |
State |
It triggers in case input bitrate goes below the lower threshold. Input bitrate refers to data volume received from the source per 1 second.
Set the threshold value in the Threshold tab.
|
BadSource |
BadSource (No signal) |
State |
It triggers when the probe cannot receive data for further analysis.
|
BadBroadcast |
Several Broadcasters |
State |
It triggers when several broadcasters are detected in the same group.
Note: If the task configuration specifies one “Source Address”, the probe will not be able to detect multiple broadcast sources and this trigger will not work.
|
NoChildren |
Task Has No Subtasks |
State |
It triggers depending on the protocol type when:
HLS and DASH
The service analysis task has only a Manifest task and doesn’t contain any subtasks. This may occur when in the manifest (playlist) no links to a media representation or to a variant stream can be found (HLSv3). At the same time, the manifest (playlist) is reachable and valid.
SRT
The task analyzing a SRT stream has only a Master task and doesn’t contain any subtasks. This may occur when the task is active and started in the Listener mode. At this time, a task doesn’t receive any SRT streams and waits for incoming connection.
|
TR_101_290_TSSyncLoss |
TS Sync Loss |
State |
It triggers when two or more successive Sync_Byte_Errors are detected and disappears after five or more successive sync bytes are received (synchronization is achieved again).
|
TR_101_290_SyncByteError |
Sync Byte Error |
Event |
It triggers when a sync byte 0x47 is missing in the successive packet (after 188 or 204 bytes).
|
TR_101_290_PatError |
PAT Error |
State |
It triggers under the conditions described below:
Adjust the threshold value in the Threshold tab if required. |
TR_101_290_ContinutyCount |
Continuity Counter |
State |
It triggers under the conditions described below:
To enable detection of the error, go to the Thresholds tab and activate the Enable TR 101 290 (Priority 1) compliance setting. Also, in the Thresholds profile you can exclude the required PIDs or media types from CC errors detection. Note that for the excluded media types, the corresponding recording triggers won’t fire. |
TR_101_290_PmtError |
PMT Error |
State |
It triggers under the conditions described below:
Adjust the threshold value or disable detection in the Threshold tab if required. |
TR_101_290_PidError |
PID Error |
State |
It triggers when data for the specified PIDs does not occur during the specified period (default interval is 5 s). It corresponds to partial loss of service or to errors occurred in PAT/PMT.
Adjust the threshold value, exclude the required PIDs/media types or fully disable error detection in the Threshold tab if required.
Note that for the excluded PIDs and media types, the corresponding recording triggers won’t fire.
|
TR_101_290_PidError_VA |
Audio/Video PID Error |
State |
It triggers when data for the specified Audio and Video PIDs does not occur during the specified period (default interval is 5 s). It corresponds to partial loss of service or to errors occurred in PAT/PMT.
Adjust the threshold value, exclude the required PIDs/media types or fully disable error detection in the Threshold tab if required.
Note that for the excluded PIDs and media types, the corresponding recording triggers won’t fire.
|
TR_101_290_TsError |
Transport Error |
State |
It triggers when the Transport_error_indicator field in TS header is equal to “1”
|
TR_101_290_CrcError |
CRC Error |
State |
It triggers when the CRC error is detected in the CAT, PAT, PMT, NIT, EIT, BAT, SDT or TOT table.
|
TR_101_290_PcrRepetitionError |
PCR Repetition Error |
State |
It triggers when the time interval between two packets with PCR values exceeds the interval specified by a user.
You can select the interval in the Thresholds tab.
|
TR_101_290_PcrDiscontinuityError |
PCR Discontinuity |
State |
It triggers when the difference between two consecutive PCR values is outside the range of 0…100 ms without the discontinuity_indicator set.
|
TR_101_290_PcrAccuracyError |
PCR Accuracy Error |
State |
It triggers when PCR accuracy of selected program is not within ±500 ns.
|
TR_101_290_PtsError |
PTS Repetition Error |
State |
It triggers when the time interval between two consecutive PTS values exceeds the interval specified by a user.
You can set the interval in the Thresholds tab.
|
TR_101_290_CatError |
CAT Error |
State |
It triggers under the following conditions:
|
TR_101_290_NitError |
NIT Error |
State |
It triggers under the conditions described below:
Select the Delivery System in the Threshold tab if required. |
TR_101_290_SIError |
SI Repetition Error |
State |
It triggers under the conditions described below:
Select the Delivery System in the Threshold tab if required. |
TR_101_290_UnrefPidError |
Unreferenced PID Error |
State |
It triggers when PID is not referred to by a PMT or a CAT within 0,5 s. This does not apply to PMT_PIDs, PIDs with numbers between 0x00 and 0x1F or PIDs that are defined as private data streams.
|
TR_101_290_SdtError |
SDT Error |
State |
It triggers under the conditions described below:
Select the Delivery System in the Threshold tab if required. |
TR_101_290_EitError |
EIT Error |
State |
It triggers under the conditions described below:
Select the Delivery System in the Threshold tab if required. |
TR_101_290_RstError |
RST Error |
State |
It triggers under the conditions described below:
Select the Delivery System in the Threshold tab if required. |
TR_101_290_TdtError |
TDT Error |
State |
It triggers under the conditions described below:
Select the Delivery System in the Threshold tab if required. |
TR_101_290_BufferError |
Buffer Error |
State |
It triggers under the conditions described below:
|
TR_101_290_BufferEmptyError |
Empty Buffer Error |
State |
It triggers under the conditions described below:
|
PcrError |
PCR Is Not Present |
State |
It triggers when the PCR is not detected in a stream for the 3-second period. The PCR is used to calculate elementary stream bitrates. In case the PCR is not detected, the analyzer switches to the use of the system time in a 1 minute. The state disappears as soon as the PCR occurs again. For UDP (RTP) and SRT only.
Attention: if the PCR has already disappeared, but the probe has not switched to system time yet, elementary stream bitrates and most of TR 101 290 time-counting errors cannot be detected correctly.
|
ClockContinuity |
Timestamp Discontinuity |
State |
It triggers when timestamp discontinuity is detected (i.e. the absolute difference of timestamps values exceeds the set threshold). It monitors continuity of the timestamps (PTS/DTS for MPEG-TS), detects backward time shifts and sudden skips in the stream (it relates to packet loss and/or stream splicing).
Adjust the threshold value, exclude the required PIDs/media types or fully disable error detection in the Threshold tab if required. Note that for the excluded PIDs and media types, the corresponding recording triggers won’t fire.
|
ProgramSpecificInformation |
Program Specific Information Changed |
Event |
It triggers when program information described in PAT, PMT and SDT changed.
|
Detect_crypt |
Encryption State Changed |
State |
It triggers if encryption state is changed. Encryption state change of any elementary stream contained in the service is taken into account.
For example, encrypted service becomes open or an open service becomes encrypted.
|
VI_changed |
Video Information Changed |
Event |
It triggers if video stream header changes (format, profile, resolution, aspect ratio, frame rate, etc.).
|
Invalid_ES |
Invalid Video Elementary Stream |
State |
It triggers if video headers (SPS, PPS) are not detected in a stream during 20 seconds that does not allow decoding the stream. The parameter is used only for video elementary streams. The stream may be encrypted.
|
VideoFreeze |
Video Freeze |
State |
It triggers if Video freeze is detected during the specified period.
Enable the Video Freeze Detection option in the Add Task form and set sensitivity and detection interval values in the Threshold tab.
|
VideoDecodabilityError |
Video Decodability Error |
State |
It triggers if the number of correctly decoded frames is less than the threshold.
Enable Video Decodability Analysis in the Add Task form and set the threshold value in the Threshold tab.
|
AudioInformation_changed |
Audio Information Changed |
Event |
It triggers if audio stream header changes (format, channels, sample rate, etc.).
|
AudioTrackMissing |
Audio Track Missing |
State |
It triggers if sound is missing in a program (there are no audio PIDs). Each program contained in a stream is analyzed.
Enabling of sound analysis options (such as Loudness and Decodability analysis) in the Add Task form is not required.
|
AudioDecodabilityError |
Audio Decodability Error |
State |
It triggers if bitrate of the decoded stream is less than the threshold.
Enable Audio Decodability Analysis in the Add Task form and set the threshold value as a percentage of declared bitrate in the Threshold tab.
|
AudioSilence |
Audio Silence |
State |
It triggers if audio silence is detected in a sound track. There is a sound track in a program but its Short-Term Loudness is lower than the threshold.
The Audio Loudness Analysis option should be enabled in task settings, and Audio silence threshold should be set.
|
HlsBandwidthSwitched |
Variant Stream Switching |
Event |
It triggers when algorithm switches to a Variant Stream with different bandwidth (Adaptive bitrate service analysis). It is applied only for a task in the Player mode.
|
HlsNumberOfProfilesChanged |
The Number of Variant Streams Changed |
Event |
HLS
It triggers if the number of Variant Streams in a Master playlist is changed. The Update MasterPlaylist option should be enabled.
DASH
It triggers if the number of media content Representations declared in the manifest within the analysed Period has changed. When going to the next Period, the probe will compare the number of Representations between Periods.
|
HlsMinimumProfiles |
Minimum Variant Streams |
State |
HLS
It triggers if the number of Variant Streams stated in Master playlist is less than the minimum threshold.
DASH
It triggers if the number of video Representations declared in the manifest within the analysed Period is less than the minimum threshold.
Set the Minimum Variant Streams value in the Threshold tab.
|
HlsSequenceDivergence |
Sequence Divergence in Variant Streams |
Event |
It triggers if divergence occurs in the #EXT-X-MEDIA-SEQUENCE fields in Media playlists. All declared Variant Streams are compared.
For HLS only.
|
HlsFewSegments |
Few Segments in Manifest |
State |
It triggers if the number of segments stated in the playlist is less than the minimum threshold. For DASH: only those MPD files can be validated in which Segment List information is specified for the SegmentList element.
Set the Minimum segments value in the Threshold tab.
|
HlsProfileStreamTypeChanged |
Variant Stream Attributes Changed |
Event |
HLS
It triggers if any Variant Stream attribute contained in the Master playlist changes (a line that follows the EXT-X-STREAM-INF tag).
DASH
It triggers if the Presentation description changes (a line containing attributes of the Representation element) declared in the manifest within the analysed Period. When going to the next Period, the probe will search for similar Representations and compare descriptions between Periods.
|
HlsDuplicateBandwidth |
Duplicate Bandwidth in Variant Streams |
Event |
It triggers if the Master playlist or manifest has two similar Bandwidth values for different Variant Streams within the same codec.
The Bandwidth parameter is the upper bound of the overall bitrate for each segment, in bps. It includes any container overhead that appears or will appear in the playlist.
|
OttBandwidthMissed |
Bandwidth Missed in Variant Stream |
State |
It triggers if the Bandwidth field is not present in the Variant Stream description of the Master playlist or manifest.
In the Player analysis mode, the probe will not switch to Variant Streams with the Bandwidth field not specified. If there is no bitrate information for all Variant Streams, the probe analyzes an arbitrary Variant Stream without switching to other Variant Streams.
Additionally, such Variant Streams will not be analyzed for the following characteristics:
|
HlsInvalidResolution |
Invalid Resolution in Variant Streams |
Event |
It triggers if:
|
HlsDownloadBitrateWarn |
Download Bitrate Low |
State |
It triggers if low download bitrate of a segment is registered (download time exceeds warning threshold). Trigger conditions: download time / segment duration >= warning threshold (%).
Set the Download speed warning threshold in the Threshold tab.
|
HlsDownloadBitrateErr |
Download Bitrate Too Low |
State |
It triggers if download bitrate of a segment is too low (download time exceeds error threshold (segment duration by default)). Trigger conditions: download time / segment duration >= error threshold (%).
Set the Download speed error threshold in the Threshold tab
|
HlsActualBitrate |
Actual Bitrate |
State |
It triggers if average bitrate of a downloaded segment is higher or lower than the specified thresholds.
Set the thresholds (%) relating to the Variant Stream bandwidth (stated in a Master playlist) in the Threshold tab.
|
HlsBadSegmentSize |
Bad Segment Size |
Event |
It triggers if:
|
HlsSequenceNumberDiscontinuity |
Segment Loss |
Event |
It triggers if one or several Media playlists (#EXT-X-MEDIA-SEQUENCE discontinuity) along with segments are missing during analysis. For HLS only.
There are several causes of the error:
|
HlsStaticManifest |
Static Manifest Error |
State |
It triggers when the probe downloads the same playlist during the specified number of attempts. If the probe detects the static playlist which has the same content during two sequent downloads, the download interval will be reduced to the half of the segment duration OR to the half of the TARGETDURATION tag value (the lowest value is selected). The error and reduced download interval will persist until the probe downloads an updated Media playlist. For DASH: only those MPD files can be validated in which Segment List information is specified in the SegmentList or SegmentTimeline element.
Set the number of download attempts in the Attempts of identical playlist downloads field in the Threshold tab.
|
HlsManifestError |
Manifest Error |
Event |
Depending on an OTT type, it triggers if:
HLS
DASH
|
HlsUnknownManifest |
Unknown Manifest |
State |
It triggers if the playlist content does not comply with the standard, or the playlist is empty.
|
HlsManifestSize |
Manifest Size Error |
State |
It triggers if size of any playlist exceeds the Manifest size threshold.
Set the threshold value in the Threshold tab.
|
HlsFailedDownloadPlaylist |
Manifest Download Failure |
State |
It triggers if a playlist cannot be downloaded. The error cause is saved in the Alarm journal: as HTTP status code or as curl error detailed description.
The playlist download timeout is 15 seconds.
|
HlsFailedDownloadKey |
Key Download Failure |
Event |
It triggers if a decryption key cannot be downloaded. The error cause is saved in the Alarm journal: as HTTP status code or as curl error detailed description.
The key download timeout is 15 seconds.
|
HlsFailedDownloadChunk |
Segment Download Failure |
Event |
It triggers if a segment cannot be downloaded. The error cause is saved in the Alarm journal: as HTTP status code or as curl error detailed description.
The segment download timeout is equal to double the segment stated duration, but not less than 5 seconds.
|
HlsStartWithIDR |
Start With non-IDR Frame |
State |
It triggers if a segment starts with a non-IDR frame. Analysis of encrypted segments (decryption keys are not accessible) is unavailable. Enabling of video analysis options in the Add Task form is not required.
|
Ott_InterlacedVideo |
Interlaced Video |
State |
It triggers if a segment has interlaced video stream. Analysis of encrypted segments (decryption keys are not accessible) is unavailable. Enabling of video analysis options in the Add Task form is not required.
|
HlsSkipSegment |
OTT Buffer Overflow |
Event |
It triggers if system low performance results in OTT buffer overflow with downloaded segments that cannot be timely analyzed by a probe. The system starts skipping segments to avoid RAM overflow.
|
HlsBadSegmentDuration |
Bad Segment Duration |
Event |
It triggers if declared segment duration exceeds or less than the estimated duration by 10 times. Estimated duration is calculated as the segment size (received in a header of http server response) divided by declared bitrate of variant stream (SegmentSize/DeclaredBitrate).
|
HlsSegmentZeroDuration |
Zero Duration Segment |
Event |
It triggers if zero duration segment with segment size less than 564 bytes (three TS packets) is detected. If the segment duration is not declared, then the size of each downloaded segment is validated. However, if the downloaded segment size (content-length) is equal to zero, then regardless of its duration the Bad Segment Size event triggers.
|
OttDuplicateRenditionUri |
Duplicated URI |
Event |
It triggers if some Alternative renditions or Variant Streams have the same URI in a Master Playlist or in a manifest.
For HLS only.
|
HlsMediaPlaylistEvent |
Media Playlist Event |
Event |
It triggers when:
|
OttTargetDurationMismatch |
Segment duration exceeds TARGETDURATION |
State |
It triggers when the segment duration exceeds the EXT-X-TARGETDURATION value declared in the Media playlist. For HLS only.
|
AdInsert |
SCTE-35 Advertisement Insertion |
State |
It triggers when the probe detects the start of an Ad insertion (based on SCTE-35 tags data). The state disappears when the probe detects the end.
|
AdInsertDurationExceed |
SCTE-35 Ad Insertion Exceeds the Specified Period |
State |
It triggers when the duration of an Ad insertion exceeds the specified period. The probe initiates counting of the period as it detects the start of an Ad insertion.
|
SCTE35ParseError |
SCTE-35 Tags Parsing Error |
Event |
It triggers if the error was detected while Ad insertion tags parsing. The error details are returned in the message.
|
AdInsert_missing |
SCTE-35 Ad Insertions Are Missing |
State |
It triggers when the probe does not detect the start of an Ad insertion (based on SCTE-35 tags data) during the specified period. The state disappears when the probe detects an Ad insertion start. The trigger is implemented on the basis of the SCTE-35 Advertisement Insertion event.
Note: if you convinced that the service necessarily contains the ad insertion, than set “Ad Insertion Monitoring Mode = AllProgram” in Threshold settings for the trigger to work correctly.
|
SCTE35Ott_missing |
SCTE-35 Tags Are Not Present in the Playlist |
State |
It triggers when the probe does not detect SCTE-35 tags in a playlist during the specified period. The trigger is implemented on the basis of the SCTE-35 Tag in OTT Playlist event.
Note: if you convinced that the service necessarily contains the ad insertion, than set “Ad Insertion Monitoring Mode = AllProgram” in Threshold settings for the trigger to work correctly. For subtitles, you can disable SCTE-35 tags monitoring in Thresholds.
|
Video_buffer_overflow |
Media Buffer Overflow |
Event |
It triggers if system low performance results in media buffer overflow and audio/video data cannot be timely analyzed by a probe. The system starts dropping data before decoding. The data is dropped after TR 101 290 analysis and bitrate calculation, thus, the error does not influence the results of stream integrity analysis. This statement is also applicable to OTT, data drop before decoding does not influence calculation of segments download rate and detection of OTT errors.
The Media Buffer Overflow error occurs only if QoE options are enabled in a task (i.e. video decoder or audio decoder is used).
|
Resumption |
Task Crash Detected |
Event |
It triggers if a child process analyzing the stream has been restarted by the parent process, because no reply was received within 10s. Parent process monitors the tasks (child processes) performance and in case of critical error restarts the tasks with backward recovery.
|
RAM_warning |
Out of Memory Warning |
State |
Warning of exceeding the RAM threshold.
|
RAM_error |
Out of Memory Error |
State |
Error of exceeding the RAM critical threshold.
|
CPU_warning |
High CPU Usage Warning |
State |
Warning of exceeding the CPU threshold.
|
CPU_error |
High CPU Usage Error |
State |
Error of exceeding the CPU critical threshold.
|
Stalled |
Server Lost Connection to Probe |
State |
It triggers if the server does not receive data from a probe within 60 seconds. Afterwards, the connection with the probe is considered to be lost.
|
ServerConnectionLost |
Probe Lost Connection to Server |
State |
It triggers if connection from the probe to server cannot be established within the stated period.
|
Pcap_loading_error |
Pcap Loading Error |
State |
The Ethernet parameters are measured under the following conditions:
Windows: The Npcap (https://nmap.org/npcap/) packet capture library should be installed on the PC before a probe starts. While installing the library, WinPcap API-compatible Mode and Support Loopback Traffic options should be selected.
Linux: The probe should be launched with root privileges (sudo ./streamMonitor).
|
Record_access_error |
Record Access Error |
State |
It triggers when the probe cannot access the ‘./record’ folder, its subfolders and content. Usually, the error occurs when the probe was initially started with superuser privileges and then was restarted with regular user permissions. To address the error, stop the probe and change owner/access permissions for the ‘./record’ folder and its content.
|