Professional Documents
Culture Documents
0
User’s Guide
Corporate Headquarters
IneoQuest Technologies, Inc.
170 Forbes Boulevard
Mansfield, MA 02048
http://www.ineoquest.com
Telephone, USA:
+1 508 339 2497
FAX Telephone Number, USA
+1 508 339 4727
NETWORK SECURITY
AND
PROPER USE OF INEOQUEST VIDEO ANALYSIS PROBE PRODUCTS1
Introduction
IneoQuest video analysis probe products detect streaming media data flows on networks and
measure a variety of key parameters. Measurement results and alerts can be sent to one or more
centralized servers, enabling users to view and compare measurements from end-to-end
throughout a distribution network to detect, locate and take corrective action on a wide range of
fault types.
1. This note relates to use of IneoQuest’s Singulus, Singulus Lite, Cricket, Geminus, DVA, Surveyor,
Inspector, and IQDialogue probe types and the AMP, iVMS, iVMS ASM, cVOC, PLM, iDMS, Spectator,
and cPAR management platforms. For more information about these and other products, please contact
your IneoQuest Technologies representative or contact us via our website at www.IneoQuest.com.
2. For more information regarding network security precautions, see generally “Guidelines on Securing
Public Web Servers,” Special Publication 800-44, Version 2, National Institute of Standards and
Technology (NIST), http://csrc.nist.gov/publications/nistpubs/800-44-ver2/SP800-44v2.pdf, including
Section 8, “Implementing a Secure Network Infrastructure.”
Contents
2 Overview
2.1 Product Definition............................................................................................................... 2-1
2.2 Product Overview ............................................................................................................... 2-1
2.2.1 Key Features ........................................................................................................... 2-2
2.2.2 Monitoring and Analysis......................................................................................... 2-3
3 Product Installation
3.1 System Requirements.......................................................................................................... 3-1
3.2 Requirements for Smooth Streaming Publishing Support .................................................. 3-2
3.3 Requirements for Active Client Monitoring ....................................................................... 3-2
3.4 Client Request or Content Distribution Monitoring (Association Mode) Configuration ... 3-2
3.5 iVMS ASM Integration....................................................................................................... 3-3
5 Libpcap Support
5.1 Libpcap Playback and Capture ........................................................................................... 5-1
9 Reporting Screens
9.1 Reporting Tab...................................................................................................................... 9-2
9.1.1 Automated Report Definitions Tab ......................................................................... 9-2
9.1.2 Generated Reports Tab............................................................................................ 9-3
9.2 Automating a Report ........................................................................................................... 9-4
9.3 Report Configuration .......................................................................................................... 9-6
9.4 The Reports ......................................................................................................................... 9-7
9.4.1 Active Client Report by Token ............................................................................... 9-7
9.4.1.1 Report Input............................................................................................. 9-7
9.4.2 Active Client Report by URI .................................................................................. 9-9
9.4.2.1 Report Input............................................................................................. 9-9
9.4.3 Client Sessions Report .......................................................................................... 9-11
9.4.3.1 Report Input........................................................................................... 9-11
9.4.4 User-Agent Report ................................................................................................ 9-14
9.4.4.1 Report Input........................................................................................... 9-14
9.4.5 Bandwidth Usage .................................................................................................. 9-16
9.4.5.1 Report Input........................................................................................... 9-16
9.4.6 HTTP Errors by Server ......................................................................................... 9-18
9.4.6.1 Report Input........................................................................................... 9-18
9.4.7 Alarms & Errors.................................................................................................... 9-20
9.4.7.1 Report Input........................................................................................... 9-20
9.4.8 HLS Manifest Detail ............................................................................................. 9-22
9.4.8.1 Report Input........................................................................................... 9-22
9.4.9 Publishing Outage Report ..................................................................................... 9-25
9.4.9.1 Report Input........................................................................................... 9-25
9.4.10 Client IP/UA Pairings Report ............................................................................... 9-26
9.4.10.1 Report Input........................................................................................... 9-26
Index............................................................................................................................................ Index-1
Updated documentation, software, and information for this and other products are available
on the IneoQuest Web site or FTP server. If you do not have access to the IneoQuest FTP
server, contact your IneoQuest sales representative, IneoQuest Support, or a qualified
IneoQuest reseller for assistance.
Corporate Headquarters
Address, USA:
IneoQuest Technologies Inc.
170 Forbes Blvd.
Mansfield, MA
02048
Telephone, USA:
+1 508 339 2497
FAX Telephone Number, USA
+1 508 339 4727
Toll-Free Technical Support Telephone, USA:
+1 866 464 4636
E-Mail:
techsupport@ineoquest.com
URL:
http://www.ineoquest.com
FTP Server:
https://iq-ftp.ineoquest.com
This document, IQDialogue® ASM 4.0 User’s Guide, provides operating and
troubleshooting instructions for IQDialogue ASM, an adaptive bitrate streaming monitoring
solution. For information regarding any other of IneoQuest’s products, please consult the
appropriate document.
2 Overview
IQDialogue ASM (IQD ASM) is a service assurance probing platform for monitoring
Adaptive Bitrate video using a combination of both passive and active monitoring
techniques at various demarcation points throughout the video distribution workflow. With
IQD ASM technology, IneoQuest performs deep analysis of adaptive streaming video
distribution to provide 24x7 monitoring and alarming, enabling service providers to
measure the quality of the video delivery and troubleshoot impairment conditions to achieve
the highest video streaming experience.
IQD ASM provides a rich user interfaces to display comprehensive Adaptive Bitrate (ABR)
video data in familiar Web and Java based formats. Various views within the probe interface
allow for real-time performance analysis as well as detailed historical evaluation of each
adaptive video session, manifest, and chunk.
IQDialogue ASM provides real-time visual representation of all ABR messaging and
signaling. Video classification is performed in real-time on protocol type, content and
sessions status, with easy to understand color coding and asset aliasing. Configurable alarm
threshold settings and SNMP traps manage the system’s northbound notification, including
IneoQuest’s iVMS ASM and AMP platforms.
IQD ASM contains monitoring features that provide unique analysis capabilities in three
primary locations – Publishing, Intra-CDN (post origin serer) and Edge Cache, as well as
active monitoring capabilities to simulate client devices.
• Publishing – To ensure that all adaptive bitrate video is published from the packager to
the origin without error, IQDialogue ASM continuously monitors every variant of every
published asset. Alarming conditions notify operators of flow outages, missing
encryption keys, manifest and segment HTTP load errors, and MPEG PID loss.
• Intra-CDN – Content delivery networks are used to distribute video assets to the viewing
audience. Proper operation of the origin server and caching servers content is critical to
successful video distribution and the health of the delivery network. Whether using your
own CDN or a third party CDN, IQDialogue ASM provides extensive visibility in to the
performance of the origin server responding to video requests from shield or
mid-caches. IQDialogue ASM is uniquely positioned to categorize CDN performance
and provide detailed information to ensure proper operation, ensuring that all requests
are fulfilled and identifying error conditions for root cause analysis.
• Edge Cache – Positioned at the edge cache, IQDialogue ASM obtains session level
visibility to every user request, collecting metrics to determine the customer experience
associated with multiscreen services. IQD ASM edge cache monitoring enables
performance analysis and problem isolation by serving area, device, content type and
user session.
• Active Client – Beyond monitoring every user session using passive monitoring
throughout the distribution network, IQDialogue ASM also offers the ability to verify
content availability and adaptive protocol conformance by simulating client sessions for
configured video content. The Active Client function of the IQD ASM probe actively
requests content like a client device to validate that assets are available and assess the
quality of service delivery. In this function, the Active Client inspects each manifest file
and downloads every video chunk while performing various protocol checks to notify
the operator on key issues that could impact viewer experience, such as stale manifests,
unavailable encryption keys, chunks unable to be downloaded as well as potential buffer
underrun conditions that would lead to media player buffering.
In the IQDialogue ASM graphical interface, users can easily navigate from key performance
indicators, to real-time views and deep dive analysis of historical issues with just a click of a
button. Protocol and message filtering can be performed on a variety of factors to provide
detailed and targeted analysis.
3 Product Installation
IQDialogue ASM is provided in the form of an “appliance” product. There are two
appliances available, one providing 1-4Gb/sec of monitoring capacity, and another
providing 10Gb/sec of monitoring capability. The appliances are a hardened hardware
platform (1RU/2RU) which are specially prepared and configured to host IQDialogue ASM.
Beyond the monitoring capacity and physical footprint of the appliances, the features and
functionality are the same.
No special installation process or configuration of the appliance is required. The IneoQuest
support team will pre-configure the appliance (IP addressing and monitoring ports) based on
the provided and specific customer requirements.
Any changes to the default configuration of the appliance can be applied, but should be
coordinated with the help of the IneoQuest support team (techsupport@ineoquest.com).
The 1-4Gb/sec appliance provides six Gigabit Ethernet ports. Four Gigabit interfaces can be
used for either passive or active adaptive bitrate video monitoring. The two remaining
Gigabit Ethernet ports can serve as a management interface used to connect to the
IQDialogue ASM server and remote management.
A Web browser (such as Mozilla Firefox or Microsoft’s Internet Explorer), with support for
JavaScript, must also be installed on the personal computer acting as the client agent.
Multiple clients can access the same instance of IQDialogue ASM, with no concurrent user
limitations, beyond the performance limitations of the computing platform. Refer to the
IQDialogue ASM 4.0 Release Notes for the tested and approved Web browser versions and
Java requirements.
The IQDialogue appliance also provides an ILOM (Integrated Lights Out Management)
facility. Instructions and support for the setup and configuration of the ILOM can be
obtained by contacting techsupport@ineoquest.com .
The unique nature of encoders publishing content to an IIS origin server requires special
configuration on the IQDialogue ASM for better support.
• The IP address of each encoder’s publishing output interface must first be configured
appropriately in the “Encoder Publishing” tab.
• After configuration IQDialogue ASM must be manually restarted to complete the
configuration change. Please contact the IneoQuest support team for help with this
procedure, at techsupport@ineoquest.com.
• In most cases, the encoder(s) Smooth Streaming services/sessions must be started
“after” the IQDialogue ASM is restarted with the updated configuration. Failure to
restart Smooth Streaming services may cause the currently active flows to be
unrecognized for long periods of time.
When licensed, the IQDialogue ASM probe can perform active client requests (Adobe HDS,
Apple HLS, and Microsoft Smooth Streaming) for adaptive bitrate video using one of the
gigabit interfaces. This interface must be selected and configured appropriately (IP address,
etc.). This configuration is performed on several components and it’s recommended that you
contact the IneoQuest support team before proceeding with this change.
• One of the Gigabit Ethernet interfaces must be configured at the operating system level
with an appropriate IP address, please contact the IneoQuest support team for help with
this procedure at techsupport@ineoquest.com.
• The configuration file “/etc/iqd.conf” must be edited accordingly to link the appropriate
interface to use:
– The line entry “#ASM_CLIENT_INTERFACE=” must be uncommented and
configured with the IP address of the interface to use
• IQDialogue ASM must then be manually restarted for this change to take place. Please
contact the IneoQuest support team for help with this procedure, at
techsupport@ineoquest.com.
IQDialogue ASM monitors ABR traffic requests at many different points in the network. In
most cases, IQD ASM should be localized to either monitoring Client requests (end-users)
to edge caches or for content distribution traffic between encoder /publisher/packager to
origin, origin to mid-caches, origin to edge-caches or mid-caches to edge-cache.
Isolating the monitored traffic allows IQDialogue to either create logical end-user viewing
sessions in the census and reporting, or to treat every HTTP GET request as individual
HTTP transfers requests. These two modes of operation are association mode and
non-association mode.
The IQDialogue ASM probe can be manually forced in either mode by using the
“http.associate.sessions” configuration value in the “IQD Settings” section of the
Configuration tab.
• Association Mode – When “http.associate sessions” is enabled, IQDialogue will
associate chunk/fragment requests together to create a logical end-user viewing session.
• Non-Association Mode – When “http.associate.sessions” is disabled, IQDialogue will
treat every HTTP Get request as an individual session. The only exception to this is if
IQDialogue ASM detects unique cookies or tokens used by the IQD ASM Active Client
function in the probe. If detected, even when “http.associate.sessions” is disabled,
IQDialogue will create logical sessions for those requests.
HTTP based publishing content is not affected by this mode or feature.
There is no configuration required on the IQDialogue ASM probe for it to properly interface
with an IneoQuest iVMS ASM system. All of the configuration is performed on the
iVMS ASM.
IQDialogue ASM makes use of a Web based user interface to access detailed probe
information and monitoring data during product setup and troubleshooting investigations.
The Web interface is reached from a browser using the IP address of the probe and port
8080. For example, if the management IP address of the IQDialogue ASM probe is
“192.168.1.100”, the URL to connect to is “http://192.168.1.100:8080”. Figure 4-1 displays
the main operating screen.
At the top of the page, you will see the “Edition” name and the version number of
IQDialogue ASM.
You are also presented with the four main sections of operations:
• Session Monitoring
• File Capture
• Setup
• String Filter
This is an option to perform a “String Filter” on the parsed events. The “string” value
can be an IP address, a MAC address, etc. This allows for quick troubleshooting and
targeting of specific traffic types or events in the monitoring window.
Several other ancillary functions are provided through the use of “buttons”:
• Reset: Eliminates all data currently resident in volatile memory for the IQDialogue
ASM Server (faults and aged entries).
• Clear: Eliminates aged (grayed-out) or non-significant data from the user interface.
The following icon “ ” (green or red), provides the operator with the status of the
IQDialogue ASM Web interface engine. This is particularly useful when accessing
IQDialogue ASM remotely or when multiple users are connected to the same IQDialogue
ASM server instance. If the icon is red, then IQDialogue ASM needs to be restarted.
The “Running” option permits the operator to “freeze” the information displayed on the
screen. When monitoring active systems, the display might get updated with so much
information that it might make it hard to track specific messages. By turning-off this option,
you freeze the user interface, but not the background processing of events, or the database
storage of transactions.
The “Delay(ms)” value enables the operator to select the preferred refresh rate of the
information displayed. The value is expressed in milliseconds, and although values of less
than 200ms are accepted, below that threshold some events processed might not get
displayed on the screen due to the timing and performance of the JavaScript processing
engine in the browser of the client.
You can also select the “types” of traffic, transactions, and events of interest to be shown:
• ASM Census: Provides a high-level overview of the types of ABR traffic being
analyzed.
• RTSP/Control: Provides detailed analysis of RTSP based messaging traffic.
• HLS / Publish: Provides detailed analysis of Apple HLS based traffic. The “Publish”
filter will only show the HLS Publishing flows (WEBDAV) from an ABR encoder to an
origin server.
At the bottom of the page, you are shown which network interface(s) is(are) currently being
used to monitor the traffic, packets, and traffic statistics per monitoring interface, and the
delay (if any) in buffering transactions for database logging.
Row entries in any of the filter tables are color coded for quick visual interpretation and
sorting. Refer to the following list for a description of the various colors:
• Red: A transaction, flow, or event that was deemed erroneous or that failed. Red entries
also represent errors that would generate an SNMP trap from the IQDialogue ASM
Northbound Services Agent.
• Green: A transaction, flow, or event that succeeded, or traffic of a certain type being
observed at a rate greater than 1 packet per 10 seconds.
• Light Green: Light green rows indicate that traffic (of a specific type or on a specific
interface) was recently analyzed, but no packets have been seen in the last 10 seconds.
• Grey: Grey represents a stale entry. A stale entry is older than 30 seconds. These entries
are automatically purged from the interface after 60 seconds, but can also be manually
purged by clicking on the “clear” button.
• Orange: Orange is used to identify transactions that have yet to see a response back
from a server/client. It represents a waiting stage of 5 seconds. IQDialogue ASM (for
appropriate transactions) will wait 5 seconds for a reply before classifying it as a failed
transaction.
Each of the supported protocols are represented in the IQDialogue ASM Web Interface.
Based on the selected protocol in the top level menu, the bottom pane displays details of all
applicable streaming sessions. This section provides details of each field displayed by
protocol type.
• NIC: The interface number (as seen on the setup page) on which the traffic was
monitored.
• Pump: The “Pump” thread number that is processing this session. This information is
for the benefit of IneoQuest engineering personnel.
• Client:Port: listing of the IP address and port of the client making the Apple HLS
request, or in this case of Publishing the IP and port of the ABR encoder.
• Server:Port: listing of the IP address and port of the server receiving the Apple HLS
request, or in this case of Publishing the IP and port of the origin server receiving the
content.
• Bytes: The number of bytes sent by both the client and server.
• Packets: The number of packets sent by both the client and server.
• Seqno: The sequence number of the last packet exchange between the client and server.
• Window/Count(<256): The TCP Window size of the HTTP exchange.
• Dups OOSeq: The number of duplicate packets and/or Out-Of-Sequence packets
analyzed for the particular HTTP session.
• Part #: The logical number of parts (often referred to as chunk) analyzed by IQDialogue
for a particular Apple HLS session. When a chunk in question is an index (also called a
manifest) file, a “+” button is provided. When pressed a pop-up window will appear to
detail the contents of the index file, as shown in Figure 4-3.
• Part #: The logical number of parts (often referred to as chunk) analyzed by IQDialogue
ASM for a particular Microsoft Smooth Streaming session. When a chunk in question is
an index (also called a manifest) file, a “+” button is provided. When pressed a pop-up
window will appear to detail the contents of the index file as shown in Figure 4-5.
• Request / Response: The HTTP meta-data from the client and server request and
response.
• Status: Timestamp of the last seen message and the HTTP/TCP transaction state (i.e.,
Active, Finsent, Finback, etc.).
• Part #: The logical number of parts (often referred to as chunk) and/or HTTP
“byte-ranges” analyzed by IQDialogue ASM for a particular OTT session.
• T1/T2/T3/T4: The time-based calculation markers between chunk requests required to
compute the IneoQuest VeriStream metrics. Please contact IneoQuest at
techsupport@ineoquest.com for more information regarding the VeriStream metric. It
should be noted that full VeriStream metrics are not calculated on OTT content because
of the obfuscation or encryption of the index file request.
• FRB(sys) / FRB(ft): The IneoQuest VeriStream metrics for system and file transfers.
Please contact IneoQuest at techsupport@ineoquest.com for more information on the
VeriStream metric. It should be noted that full VeriStream metrics are not calculated on
OTT content because of the obfuscation or encryption of the index file request.
• Quality (kbps): The quality column is calculated from the bitrate (in kbps) of the chunk
size and transfer. It is meant to be used as an indication of the encoded bitrate of the flow
being requested by the client. It should be noted that quality metrics are not shown for
the Publishing of Apple HLS content in the Web GUI, but are available from the NBS
GUI client.
• Request / Response: The HTTP meta-data from the client and server request and
response.
• Status: Timestamp of the last seen message and the HTTP/TCP transaction state (i.e.,
Finsent, Finback, etc.).
• NIC: The interface number (as seen on the setup page) on which the traffic was
monitored.
• Pump: The “Pump” thread number that is processing this session. This information is
for the benefit of IneoQuest engineering personnel.
• Client :Port: listing of the IP address and port of the client making the MobiTV video
request.
• Server :Port: listing of the IP address and port of the server receiving MobiTV video
request.
• Bytes: The number of bytes sent by both the client and server.
• Packets: The number of packets sent by both the client and server.
• Seqno: The sequence number of the last packet exchange between the client and server.
• Window/Count(<256): The TCP Window size of the HTTP exchange.
• Dups OOSeq: The number of duplicate packets and/or Out-Of-Sequence packets
analyzed for the particular HTTP session.
• Part #: The logical number of parts (often referred to as chunk) and/or HTTP
“byte-ranges” analyzed by IQDialogue ASM for a particular session. Not fully
supported at this time (as of IQDialogue ASM release 1.1.58).
• T1/T2/T3/T4: The time-based calculation markers between chunk requests required to
compute the IneoQuest VeriStream metrics. Please contact IneoQuest at
techsupport@ineoquest.com for more information on the VeriStream metric. It should
be noted that full VeriStream metrics are not calculated on MobiTV content at this time.
• FRB(sys) / FRB(ft): The IneoQuest VeriStream metrics for system and file transfers.
Please contact IneoQuest at techsupport@ineoquest.com for more information on the
VeriStream metric. It should be noted that full VeriStream metrics are not calculated on
MobiTV content at this time.
• Bitrate/Avg(mbps): An estimated average bitrate calculation of the requested media.
• Request / Response: The HTTP meta-data from the client and server request and
response.
• Status: Timestamp of the last seen message, and the HTTP/TCP transaction state (i.e.,
Finsent, Finback, etc.).
4.3.5 RTMP
Figure 4-8 provides an example of RTMP traffic monitoring.
4.3.6 Mediaroom
Figure 4-9 provides an example of Mediaroom Legacy VOD traffic monitoring.
4.3.8 RTP/RTCP
Figure 4-13 provides an example of Adobe RTP traffic monitoring.
4.3.9 NDS
Figure 4-14 provides an example of NDS traffic monitoring.
4.3.10 DASH
Figure 4-16 provides an example of DASH traffic monitoring.
5 Libpcap Support
Another option available is “File Capture”. This section is where you can capture network
traffic (in the same style and format as Ethereal/Wireshark®). Figure 5-1 provides a view of
this page.
• Capture File: In this field, you provide the path and filename of the libpcap capture file
that you want to create during the monitoring or emulation. The path is referenced as
“c:\program files\ineoquest\iqdialogue\captures”, as long as the default installation
parameters are used. On Solaris it can be found in “/export/home/iqdialogue/captures”
and on Linux in “/home/iqdialogue/captures”. Capture files are limited to 2 Gigabyte
per file in order to retain Wireshark compatibility (maximum file sizes).
• Download Capture file: In this field, you can select which file previously captured to
download. You can also select a file from the drop-down list and click on the Delete
button to remove it from the file system.
IQDialogue ASM makes extensive use of a back-end database to store metadata about every
packet, flow and transaction monitored.
IQDialogue ASM will automatically “purge” the database of any transactions older than
seven days (always keeping seven days of data accessible in the database). The retention
period can be changed and increased, to a maximum of 31 days, in the “Configuration” tab
menu (see Section 8.7, Configuration).
NOTE: No changes, modifications, alterations are to be performed on the IQDialogue
ASM database schema and tables, nor to any of the triggers and/or stored
procedures without contacting IneoQuest support services at
techsupport@ineoquest.com. Any such change could render the application
inoperative and invalidate support.
Through the use of the IQDialogue ASM Northbound GUI Services, the operator can define
multiple parameters as to the amount of time transactions are kept in the database. Entries
older then the defined period will be purged according to the configured schedule
This can ensure that the database does not keep growing infinitely, and also ensures proper
levels of performance from the application.
7 Software Upgrade
Performing an IQDialogue ASM software upgrade will re-initialize the system database. As
a result, historical performance and alarming data is purged from the system. All system
configuration settings will be maintained through the upgrade process so reconfiguration is
not necessary.
If the IQDialogue ASM is reporting to an iVMS ASM system, aggregated historical data
will remain available until the purge as configured on the iVMS ASM.
A Maintenance Operations Procedures (MOP) document can be provided with detailed
instructions of the upgrade process. Please contact IneoQuest at
techsupport@ineoquest.com for details or a copy of this documentation.
Before upgrading to a newer release, the previous IQDialogue ASM server software must be
removed using the procedures defined in the provided MOP.
NOTE: Upgrades to existing systems should only be performed after a MOP has been
issued by IneoQuest.
This chapter provides details about the Northbound Services (NBS) user interface.
• Section 8.1 Accessing the NBS GUI
• Section 8.2 Home/Key Performance Indicators (KPI)
• Section 8.3 Realtime Census
• Section 8.4 Active Client
• Section 8.5 Query
• Section 8.6 Reporting
• Section 8.7 Configuration
• Section 8.8 About
IQDialogue ASM provides a Java applet to manage the IQDialogue ASM and get graphical
representation of the ABR activity, alarms, and configurations. This Java applet provides
visibility to the Key Performance Indicators (KPI), Census, Dashboards, Alarming, Reports,
and Configuration.
Step 2 Enter your Username. The default username for NBS is nbsmon.
Step 3 Enter your Password. The password for the nbsmon account is also nbsmon.
Step 4 Enter or select the Host. This is the IP address or hostname of the IQDialogue ASM
probe to connect to.
Step 5 Click Connect.
Once logged-in, you have access to the full NBS selections.
The Home (KPI) section is sub-divided into three (with special licensing up to seven) views
for ease of use:
8.2.1 Transactions
The Transactions tab provides KPIs relating to the number of events by protocols types, as
shown in Figure 8-2.
The “Active Alarms” tab provides a view into the number and state of publishing alarms.
All stateful publishing alarms are shown in the table. The bar graph on the left provides
information on the number of such events in the last minute, hour and day. Additionally, it
can be “clicked” on to provide more detailed information. Once a publishing issue is
resolved, the alarm will automatically clear. Publishing alarms can be manually cleared by
right-clicking the entry and selecting “Clear Alarm” or “Clear All Alarms”. Stateful
publishing alarms can be seen and configured in the “Alarms” tab of the NBS.
8.2.2 Distribution
The Distribution tab provides KPIs relating to the client types, bandwidth usage and popular
assets, as shown in Figure 8-9.
8.2.4 RTSP
RTSP shows the number of Real Time Streaming Protocol (RTSP) events detected and
analyzed by the IQDialogue ASM probe, over selected time periods, as shown in
Figure 8-15.
8.2.5 RTMP
RTMP shows the number of Real Time Messaging Protocol (RTMP) sessions currently
active and being analyzed by the IQDialogue ASM probe, as shown in Figure 8-16. The KPI
can be “clicked” on to provide detailed information about each active session.
You can look up a Status Code for HTTP Transactions in the Manifest and Manifest Parts by
selecting the line and right-clicking your mouse. A context menu item appears with a
selection to look up the status code.
8.2.7 HLS
The HLS tab page shows the Request Count by Manifest, Manifest Requests by Host, and
HTTP Transactions including Manifest and Manifest Parts in the top pane. The bottom pane
displays the Alarms Processed and the time that the last trap was sent. See Figure 8-18 for
an example.
You can look up a Status Code for HTTP Transactions in the Manifest and Manifest Parts by
selecting the line and right-clicking your mouse. A context menu item appears with a
selection to look up the status code.
8.2.8 HDS
The HDS tab page shows the Request Count by Manifest, Manifest Requests by Host, and
HTTP Transactions including Manifest and Manifest Parts in the top pane. The bottom pane
displays the Alarms Processed and the time that the last trap was sent. See Figure 8-19 for
an example.
You can look up a Status Code for HTTP Transactions in the Manifest and Manifest Parts by
selecting the line and right-clicking your mouse. A context menu item appears with a
selection to look up the status code.
8.2.9 DASH
The DASH tab page shows the Request Count by Manifest, Manifest Requests by Host, and
HTTP Transactions including Manifest and Manifest Parts in the top pane. The bottom pane
displays the Alarms Processed and the time that the last trap was sent. See Figure 8-20 for
an example.
You can look up a Status Code for HTTP Transactions in the Manifest and Manifest Parts by
selecting the line and right-clicking your mouse. A context menu item appears with a
selection to look up the status code.
In the Realtime Census tab you gain visibility to the real-time ABR sessions currently in
progress. There are two sub-tabs: All Clients and Active Clients.
• Top pane
– The top pane provides a list of “filters” which can mask all other traffic except
for the one selected. The filters are grouped in two categories:
Streams: To select a specific streaming format
Filters
Errors: For any HTTP errors in the 400 or 500 range
String Filter: for specific data in the columns shown in the upper
central pane, as shown in Figure 8-22.
Color Description
Color Description
User Agent: The user-agent field taken from the client’s HTTP requests
Format: The type of session (Apple HLS, Microsoft Smooth Streaming,
etc.) Status: Shown in the “status” column are the VeriStream metrics for
the last 8 requested chunks in the client session (for publishing sessions
the status is always “Balanced” (dark green), and not available for certain
non-HTTP based protocols such as RTP. Please contact IneoQuest at
techsupport@ineoquest.com for more information on the VeriStream
metric.
Manifest Requested: The number of times that the client issues a request
for a manifest or index file. For an Apple HLS publishing session this
value represents the number of times a new manifest was published to an
origin servers for a particular flow. For a Smooth Streaming publishing
session this represents the number of times the ABR encoder requested
the manifest file from the IIS origin server.
Manifest URI: The URI path and filename of the requested content, or
published content. This field and value can be aliased into any other
name of interest. Performing a “mouse-over” on an aliased entry will
display the full URI path.
Chunks: The number of media segments or fragments requested or
published, for a given session.
Avg Bitrate(kb/sec): An estimated average media bitrate of the session
being analyzed. This is not the HTTP transfer rate, but an approximation
of the actual media bitrate of the particular asset.
4xx errors: The number of HTTP errors in the 400 range for any given
session.
5xx errors: The number of HTTP errors in the 500 range for any given
session
– When an entry is right-clicked, several options are provided:
Filter: manually create a filter based on data from this session. See
Figure 8-24 for an example.
Create Manifest Alias: Allows the user to create an alias for the
URI/Manifest being requested or published. Once created the entry is
published and saved in the “Asset Alias” tab. See Figure 8-26 for an
example. When the user wants to alias multiple manifests to a single or
common alias name the usage of the character “%” is accepted as a
wildcard.
Create RTMP Alias: Allows the creation of an RTMP alias for a given
RTMP publishing flow, as seen in Figure 8-29. Only the source IP
address and the destination port are required.
IQDialogue ASM can be configured to perform http requests (as a client) for Apple HLS
and Microsoft Smooth Streaming content. See Figure 8-35 for an example of the Active
Client tab.
Repeat
Duration Delay Result
Count
0 0 0 Continue indefinitely.
Repeat
Duration Delay Result
Count
Continue X loops with a delay of X seconds between
X 0 X
manifest requests.
• User Agent: The user agent used in the request. There are several predefined selections,
but a user agent can also be created by the user by typing in the drop-down box in the
Add Active Request dialog box (see Figure 8-36).
• Authentication: The authentication scheme to use when making requests. Several
options are available, right clicking on the table entry presents a menu.
– None: No authentication.
– Basic: Basic http authentication. You will be prompted for a user name and
password.
– Wowza: Wowza authentication.
• VU (Video Uplink) Destination: The port to use when the content is sent via Video Up
link.
On the Active Client view, sessions are identified by the condition and color index in
Table 8-4.
Color Description
• : Used to export the current list of active client request entries configured in the
probe.
• : Used to export Video Uplink. Refer to Section 8.4.1.3 Video Uplink for
Adaptive Bitrate (ABR) Flows.
When adding a new entry, the dialog box appears as shown in Figure 8-36.
• Duration: Length of time to join the flow. A value of “0” is for a permanent connection
• Repeat Count: With a default of “0” on a “Clip”, the active client will make a single
request for the asset when activated. With a default of “0” on a “Live Stream” the active
client will remain joined to the live broadcast.
• Delay (Seconds): When used in conjunction with the “Repeat Count” parameter, the
active client can be configured to wait a certain amount of time (in seconds) in between
each join requests.
• Stream Content: Used to define either Apple HLS, Adobe HDS, MPEG DASH or
Microsoft Smooth Streaming
• User-Agent: The selection of a pre-configured or user-defined HTTP user-agent to use
for these client requests. To create a user-defined entry simply edit the input box with the
desired value
Once an active client request has been created, other options then become available for
configuration, as shown in Figure 8-37.
Many of the configuration fields can also be directly edited, as long as the session is not
currently active.
In the first column called “Active” the user is presented with a status indicator for this
particular session:
• When the session is inactive the “Active” column will be empty
• When a session is “Active” a “green” progress indicator will be present (as shown in
Figure 8-37)
• When a session is in the process of terminating a “red” progress indicator will be present
• When a session is waiting (for example when configured to join/wait/rejoin) the
progress indicator will be shown as “orange”
8.4.1.2 Authentication
The “Authentication” field can be used to select the specific authentication method, as
shown in Figure 8-38. Simply right click the “Authentication” box to get access to the
methods available. Once selected, a pop-up dialog box will be provided to enter the
username and password required.
Step 2 In the dialog box that appears, enter the Destination IP address (the IP of the device that
will receive the content) and the Default Port (Select an available port). Click OK. See
Figure 8-40 for an example.
Step 3 Select an HLS asset to enable. Right-click your mouse on the asset to bring up the
context menu and select Enable in the “Video Uplink” submenu. See Figure 8-41 for an
example.
The asset will become color coded green to quickly identify which assets are configured.
See Figure 8-42 for an example.
For additional information regarding Video Uplink client setup, refer to Appendix A, Video
Uplink Client Setup.
8.4.1.4 Grouping
The “Group” field can be used to logically group multiple active client entries so that they
can be managed from a single logical entity. From the selection (as shown in Figure 8-43),
you can create a new group, add to an existing group or remove from an assigned group.
8.4.1.7 Traceroute
Find the route from the IQDialogue ASM server to the destination URL by performing a
traceroute directly from the Active Client session right-click context menu (see
Figure 8-46). You can also view the history of previous traceroutes. Identifying the hops
from the IQDialogue ASM to the media file locations could be the next step in diagnosing
issues.
When selecting the “Manage Groups” option a pop-up will appear where you can create,
remove or update logical groups (as shown in Figure 8-49).
Once created you can click on the “Manage Group Mappings” to assign specific active
client sessions to your logical groups (as shown in Figure 8-50).
You select a “Client Group” on the left from the pull-down menu, and then you select an
entry from the “Available Client URIs” window on the right, and by using the arrow buttons
you can assign or remove the mappings from the “Client Group” of interest.
The “Configure Auto Join” feature enabled IQDialogue ASM to automatically create Active
Client entries for Publishing flows that are detected, and then automatically start joining
them. When the user clicks on the option a pop-up dialog box appears (as seen in
Figure 8-51).
At the top of the page, click the drop-down arrow and select an active flow. See Figure 8-53
for an example.
By selecting a radio option button you can choose to view all or a specific selection of the
log report. Selections include:
• All
• Info
• Debug
• Warning
• Error
• Severe
Figure 8-54 displays the AR Logs page.
To configure a list of assets to be scanned based on the defined schedule, you will
(1) Define a single or multiple Groups
(2) Assign the Group(s) and/or configured assets to a Scan List
(3) Set the Schedule for the Scan List operation
Group Configuration
A Group identifies a set of configured assets that will all be streamed simultaneously. If the
configured asset is a top-level HLS manifest or an MPEG-DASH MPD, all the bitrate
variants will be streamed. When configuring a group, be sure to consider the maximum
bandwidth of the IQD ASM Active Client interface as well as the streaming target. To
ensure proper Active Client streaming performance, IneoQuest recommends to not exceed
75% of the 1Gbps appliance interface
Follow these steps to configure a new group of ABR assets in the Group Configuration
section.
Step 1 Click “Add” to name your new group.
Step 2 Select the Group name and add streams to the group by selecting one or more assets in
the Available Assets column and moving them to the Configured Assets.
Step 3 If the group is intended to run independently from the Scan List operation, use the
Repeat Count, Duration, Delay parameters to set value specifically for the group.
Note: If the Group is added to a Scan List, the schedule values for the Scan List will
take precedence but will not overwrite this configuration.
Step 4 Continue adding Groups as required.
Schedule
Once a Scan List is configured, the timing parameters for scanning the contained Groups
and report generation are configured. The following explains each field in the Schedule
section.
• Duration – The length of time in seconds that each Group in the Scan List will be run for
monitoring. For example, if each Group should run for 5 minutes before proceeding to
the next Group of assets, set a value of 300. The Active Client will monitor all streams in
the Group for 300 seconds before moving on to the next group.
• Group Delay – The time in seconds to pause between monitoring a Group and the next
Group immediately following it in the Scan List.
• Iteration Delay – This parameter pertains only applies if the Scan List monitoring will
repeat after the first iteration. When specified, the Active Client will pause for the
configured number of seconds after the final Group before restarting the Scan List.
• Schedule Repeat – Number of times that the Scan List is executed. A value of 0 will run
continuously.
After each iteration through the Scan List, a report can be generated in either CSV, PDF, or
both formats.
8.5 Query
The Query tab provides the ability to perform searches in the IQDialogue ASM database for
specific sets of information using simple to use pre-defined search criteria. Once a search is
completed the resulting set can be exported to a CSV file using the Microsoft Excel export
button at the bottom of the tab.
• Alarms: Provides the ability to get detailed information about past alarms and traps
based on time (before and/or after), transaction type and alarm types. See Figure 8-56
for an example.
• RTSP Information: Provides the ability to get detailed information about RTSP requests
based on time (before and/or after), client IP and server IP. See Figure 8-57 for an
example.
• HTTP Information: Provides detailed activity report based on time (before and/or
after), any HTTP sessions or HTTP errors specifically, source IP (IP address of a
specific client), destination IP (IP address of an HTTP or caching server), and for
specific stream types (HLS, Smooth Streaming, wmv/wma, etc.). The HTTP
Information is divided into two sections, the top part is for a listing of the individual
sessions, and the bottom view is for the details of a specific session (chunks, VeriStream
values, etc.). One important note, when using the “After” filter the query will only return
results of HTTP sessions that got initiated after the selected time, and will not display
sessions that had already been established at that time. See Figure 8-58 for an example.
• Profile Chunk Count: A special query to get a cumulative count of the number of
chunks requested in a period of time against a specific asset in the form of an URI (i.e.
/hls/01.m3u8). See Figure 8-59 for an example.
• RTMP Information: Provides the ability to get detailed information about RTMP
requests based on time (before and/or after), All, Active, or Inactive. See Figure 8-60 for
an example.
8.6 Reporting
The Reporting tab is used to access the manual or automated reporting features provided in
the IQDialogue ASM probe. Please refer to Chapter 9, Reporting Screens for detailed
information on this particular feature.
8.7 Configuration
The Configuration tab is used to configure most operation parameters of the IQDialogue
ASM probe including alarms, probe informational details, KPI customization, etc. The
Configuration tab consists of the following sub-tabs:
• System Configuration
• Publishing Alarm Config
• Alias Configuration
For more details about Wireshark capture filtering, please consult the online user’s guide
available at https://www.wireshark.org/docs/wsug_html_chunked/. Best practices may be
found online at https://wiki.wireshark.org/CaptureFilters.
Example
Some environments use URIs with embedded session, client, or time specific information
like the URI in the following HTTP GET:
‘GET /x/y/T=20170410161723/z.m3u8’
Left alone, this results in an infinite number of unique Manifest URIs which will impact a
probe’s performance. Using the methods described in this example, you can remove
unnecessary information using:
http.uri.edit.list= s|T=[0-9]*/||
• s/a*s/asdasd/; will search and replace any instances of any number of characters
starting with a and ending with s and replace them with “asdasd”. You can specify the
string delimiter by using the first character after the “s” command. This is useful when
the string to be replaced may contain the forward slash character. This also avoids the
need to escape most characters.
• s|x??|y|; will search for any three character string starting with “x” and replace
all of them with “y”. Note the use of the pipe character instead of the forward slash. The
system will recognize the string format and use the pipes instead of forward slashes
automatically.
Multiple strings can be specified using the semicolon ';' to demarcate the end of a string.
Strings are applied in sequential order.
Example
Example
String = s/,VXToken={*}/${b64decode}$/;
Behavior = Any substring which contains “,VXToken=” plus any text will be base 64
decoded and then replaced with the result of that decode prepended and postpended by
dollar symbols.
Example
String = s/#{*satelite*},/#{info},/;
Behavior = will take any substring preceded by “#” and followed by “,” which contains
the word “satellite” and place it in the referer column of the httpvod table for that
stream.
Example
String = s/cookie=*,{*}#/{cookie}#/; will place all of the text selected by {*} which is
preceeded by “cookie=*,” and followed by # into the token column of the httpvod table
for that stream, followed by the pound symbol.
NOTE: Using the capital “S” replacement command instead of the lower case “s” causes
the probe to log the before and after log entries into the /var/log/iqdialog file.
See Figure 8-63 for an example of the “http.uri.edit.list” parameter.
8.7.2.1 Alarms
The Alarms sub-tab is used to display and configure stateful HTTP based publishing alarms.
The “Alarms” section allows for the configuration of the specific alarms, as well as
application to specific tuples and the historical viewing of past alarms. Figure 8-64 provides
an example.
Stateful publishing alarms can be globally enabled or disabled using the “Enable this alarm”
option in the bottom section, while at the same time assigning a specific severity level to the
alarm and trap.
These alarms can also be targeted at all publishing flows, or specific ones, using the “Alarm
Tuples” definition. In this section you can define specific parameters such as source IP:Port,
Destination IP:Port and URI. There is also a global “Match All” value that will apply the
alarm to all publishing flows indiscriminately.
8.7.2.2 Tuples
In the “Tuples” sub-tab you are presented with any pre-configured or manually configured
tuples. An example is provided in Figure 8-65.
• Asset Alias
• NIC Alias
• Origin Server Alias
• RTMP Alias
Under the Asset Alias sub-tab the format for input in the dialog box is very simple. See
Figure 8-67.
Once created the entry is published and saved in the “Asset Alias” tab. When you want to
alias multiple manifests to a single or common alias name the usage of the character “%” is
accepted as a wildcard. The “Top Level Manifest” check box option is used to identify this
URI as a top-level manifest for an HLS flow. Failure to properly configure this option may
lead to false publishing outage alarms, as the top-level manifest will commonly not be
re-published unless it requires a change.
IQDialogue ASM has the ability to monitor this pre-populated list of flows as well as any
flows it automatically discovers from monitoring the wire. To disable the option to
automatically discover flows (and thus use only the pre-populated list from the Publishing
Flows tab), you simply toggle the http.publishing.discover setting, as displayed in
Figure 8-71.
When configuring an RTP or RTMP Alias, you need to provide the source IP (commonly
the IP address of the encoder), the destination TCP port and an alias name.
8.8 About
The About tab is used to display operational parameters of the probe, such as version
number of the probe and client, time length of NBS login, and overview of SNMP alarm
types generated and muted. See Figure 8-73 for an example.
9 Reporting Screens
The Reporting tab is where you go to run a report manually and to set up the initial
Automated report functionally, The following reports are available:
• Section 9.4.1 Active Client Report by Token
• Section 9.4.2 Active Client Report by URI
• Section 9.4.3 Client Sessions Report
• Section 9.4.4 User-Agent Report
• Section 9.4.5 Bandwidth Usage
• Section 9.4.6 HTTP Errors by Server
• Section 9.4.7 Alarms & Errors
• Section 9.4.8 HLS Manifest Detail
• Section 9.4.9 Publishing Outage Report
• Section 9.4.10 Client IP/UA Pairings Report
Every report can be automated. After selecting a report from the available list, a report
dialog input box is presented. This dialog box has a check box on it entitled “Automate this
Report” (see Figure 9-4).
If “Automate this Report” is selected, a secondary dialog box will be presented with the
parameters needed for automating the report (see Figure 9-5).
The parameters include:
(1) Name – The name to be given to the report
(2) Frequency – Chose either weekly or daily report generation frequency.
(3) Day of Week – Disabled by default for daily reports. If you are selecting a weekly
report from the frequency drop down, this will become enabled. Select the day of the
week for the report to be generated.
Figure 9-6 shows the available configuration parameters for automated reporting. These
settings are located under the Configuration tab (Section 8.7 Configuration).
• report.swap.filesize – default 5
• reports.daily.period – default 24 – number of hours to report on when a daily report is
selected for automation.
• reports.daily.purge – default 02:00 – time of day the purging of the reports that have
been automated from the probe.
• reports.daily.start – default 06:00 – time of day that the automated report generation task
will occur.
• reports.date.format – default MM/dd/yyyy kk:mm – Month in year/Day in month/Year/
Hour in day (1-24):Minute in hour
• reports.nbs.display.max.size – default 1024
• report.purge.age – default 30 – number of days to keep automatically generated reports.
• reports.starttime.offset – default 6 – amount of time you want the report start time to be
offset by in relation to the time the reports are generated. For example, if you want the
reports to be generated at 6:00 AM and run from midnight, then the period would be 24
hours. The start time would be 6:00 AM and the offset would be 6 hours which is the
difference from midnight to the start time.
• reports.virtualizer.method – default swap
• reports.weekly.period – default 168 – number of hours that are reported on for weekly
reports.
User-Agent Distribution
Starting: 2015-05-04 16:24
Ending: 2015-05-05 16:24
Probe Location: 170 Forbes Blvd Mansfield MA 02048
User-Agent Distribution
Bandwidth Distribution
Total across all interfaces
Starting: 2015-05-04 16:36
Ending: 2015-05-05 16:36
Probe Location: 170 Forbes Blvd Mansfield MA 02048
+773(UURU'LVWULEXWLRQE\6HUYHU
6WDUWLQJ
(QGLQJ
3UREH/RFDWLRQ)RUEHV%OYG0DQVILHOG0$
$OO(UURU&RGHVIRU
:HGQHVGD\0D\ 3DJHRI
User-Agent Distribution
Starting: 2015-05-04 16:24
Ending: 2015-05-05 16:24
Probe Location: 170 Forbes Blvd Mansfield MA 02048
User-Agent Distribution
When you click OK, a dialog box will appear asking if you want to view the report in
exportable CSV format. If you reply “Yes”, another dialog box will ask if you want to
include column headers. Save this type of report as a CSV file. If you reply “No” to the
question regarding exporting to CSV format, the report will be formatted as it will appear in
PDF format.
Figure 9-23 shows an example HLS Manifest Detail report in PDF format.
When you click OK, a dialog box will appear asking if you want to view the report in
exportable CSV format. If you reply “Yes”, another dialog box will ask if you want to
include column headers. Save this type of report as a CSV file. If you reply “No” to the
question regarding exporting to CSV format, the report will be formatted as it will appear in
PDF format.
This appendix outlines additional details required for IQDialogue Virtual Uplink
configuration to a third party player. The forwarded adaptive video traffic can be delivered
to the end device using any licensed Network Interface Card (NIC) on the IQDialogue as
long as the chosen has an active/routable IP. Contact IneoQuest Support to assist in the
initial setup of the forwarding interface on the IQDialogue ASM server.
Step 1 Log into the NBS tool and navigate to the Active Client tab.
Step 2 Create a new HLS variant entry or edit an existing URL.
Note: RVL can only use HLS variant streams. Top Level Manifest entries cannot be
used. Only the direct URLs to a variant bitrate can be used.
a. Select the URL to be setup for RVL.
b. Use your mouse to “Right Click” and open the menu.
c. Select Video Uplink then Enable. See Figure A-1 for an example.
d. The VU Properties dialog box will appear. See Figure A-2 for an example.
i. Enter the Destination IP (the IP of the device that will receive the content).
This document describes the IQDialogue ASM Active Client and Alarm Setting
configuration parameters.
The IQDialogue ASM provides a rich set of passive and active monitoring capabilities.
Based on the system configuration, the IQDialogue ASM probe will alarm on various
protocol events and threshold conditions. Alarm configuration descriptions in this document
should be used in conjunction with operational practices for monitoring your specific
network.
Active Client monitoring on the IQDialogue ASM enables users to validate assets
availability and verify the content delivery network by simulating client requests for
configured live or video on demand content. The Active Client configuration determines
how the session will operate and specific error conditions to monitor. Thoughtful
consideration of Active Client configuration will ensure the highest performance of the
IQDialogue ASM’s capabilities and provide the best value for early identification of issues
and troubleshooting.
This information is provided in the following sections:
• Section B.1 IQDialogue ASM Active Client Settings
• Section B.2 IQDialogue ASM Alarm Descriptions and Settings
In the IQDialogue ASM NBS interface, all alarm configurations are found on the
Configuration tab under the Active Client submenu.
B.1.1 active.client.403.session.timeout
When configured, a client that receives a HTTP 403 Forbidden response during a streaming
session will return to the initial URL and re-request the media stream. This functionality
ensures that IQDialogue’s Active Client continues monitoring the configured video assets in
production networks with enhanced security measures.
B.1.2 active.client.allow.circular.redirect
Allows the Active Client to use a redirected URI after receiving a HTTP 307 Temporary
Redirect. The Active Client will repeat the request using the new URI.
B.1.3 active.client.autojoin.delay
For monitoring publishing flows only - Selecting “Configure Auto Join” on the Active
Client tab will automatically establish a monitoring session of the asset being published.
The autojoin.delay setting specifies the delay period between the time when the publishing
session is recognized until the Active Client session is initiated for monitoring.
Keep in mind that there may be some delay between the manifest file publishing and enough
media files published to properly stream the asset. This configuration option assists with the
timing condition.
B.1.5 active.client.autojoin.new.flows
Enables the Active Client to automatically start a streaming session for newly added flows.
B.1.6 active.client.autojoin.new.flows.autocreate.session
Automatically adds assets recognized during publishing to the Active Client list.
B.1.7 active.client.autojoin.repeatcount
The number of times to repeat the monitoring duration for automatically joined sessions.
B.1.8 active.client.cookie.mode
The cookie mode configuration defines the Active Client operation for HTTP request
messages. Acceptable values are 0 – 2.
• 0 – Disabled – Even if a set-cookie directive is received in the HTTP response, the
Active Client will ignore the cookie
• 1 – Default – On receiving a set-cookie in the HTTP response, the Active Client will
store the cookie for use on all future requests. If a subsequent set-cookie is received the
current cookie is replaced with the new cookie.
• 2 – Append – This setting differs from the default setting if the Active Client receives
additional set-cookie responses. The first set-cookie response is stored and used on all
outgoing requests. If additional set-cookie responses are received the new cookie will be
appended to the old cookie.
B.1.9 active.client.error.chunk.reloadtime
The time to wait in milliseconds before retrying a chunk request (a single time) if there is an
error.
B.1.10 active.client.error.manifest.reloadtime
The time to wait in milliseconds before attempting to reload the manifest file if an error
occurs on the first attempt.
B.1.11 active.client.error.retry
On receiving any error (manifest, chunk, socket timeout) continue to try and run the Active
Client session.
B.1.12 active.client.hls.download.buffer.size
IQDialogue Active Client buffers the name of each downloaded chunk. Upon receiving a
manifest file, Active Client examines the chunk names to determine if new chunks exist. If
all the chunk URIs are already stored in the buffer, the Active Client will report that there
are no more chunks to download.
The HLS download buffer size configuration provides the control over the number of chunk
URIs to maintain. Essentially, if the chunk name is still buffered, the Active Client will not
operate correctly if the URI is reused. IneoQuest recommends the default value of 15
chunks. Tuning this parameter should be performed only with the assistance of IneoQuest
Support personnel so the Active Client performance can be adjusted and monitored.
B.1.13 active.client.http.connection.timeout
Time to wait before it cleans up a failed start attempt from the ASM census
B.1.14 active.client.http.socket.timeout
Set the parameter in the Active Client for the server connection timeout. This denotes the
time elapsed before the connection established or the server responded to the connection
request.
B.1.15 active.client.logging
Enables logging of Active Client sessions in the AR log. This setting can be used to
troubleshoot Active Client setup but should not be configured permanently because of the
disk space and processing requirements.
B.1.16 active.client.retrieve.encryption.keys
Defines whether or not HLS active clients should retrieve the encryption keys from the
manifest file for the manifest file content (chunks).
If this setting is turned on, the Active Client downloads the encryption keys to be used for
decrypting content found in the manifest file.
NOTE: This setting only applies to Verimatrix decryption if the system is licensed for the
feature.
B.1.17 active.client.smooth.expedus.mode
IQD ASM Active Client for Smooth Streaming assets uses the manifest file to identify the
media fragment duration and time offset of the first fragment. Subsequent request are timed
based on the duration as advertised in the manifest file. A new manifest request is initiated
as the Active Client approaches the end of the fragments in the currently loaded file.
Expedus ASM fragment requests only use the manifest file for the initial fragment. All
following requests use the information in the TfrfBox (contained in the fragment response)
that identifies timestamps and durations of subsequent fragments.
Selecting this configuration forces the IQD ASM Active Client to operate in the same mode
as Expedus ASM. This should only be considered in cases deemed necessary otherwise
MSS manifests will only be validated by the Active Client when initiating the session.
B.1.18 active.client.use.redirect.url
When using redirected URLs, overrides the default Active Client behavior to return to the
original top level manifest for chunk requests. Enabling this mode makes the IQD ASM
Active Client retain the redirected URL for all subsequent requests.
B.1.19 alarm.ac.badvs.chunkcount.error
Per URL an alarm is generated when the number of bad VeriStream (value 1 or 2) chunks
exceeds the configured threshold.
B.1.20 alarm.ac.badvs.chunkcount.error.threshold
Define the number of continuous bad chunks before alarm generation for
alarm.ac.badvs.chunkcount.error configuration.
B.1.21 alarm.ac.badvs.chunkcount.error.severity
Defines severity of the bad VeriStream chunk alarm.
B.1.22 alarm.ac.chunk.load.error
Specifies that an error is desired when a chunk download fails. After two retries if the chunk
request continues to fail, the Active Client continues with the next chunk. This could result
in duplicate alarms depending on other configured settings. For example, the chunk load
error will occur as well as an associated HTTP 404 error.
• alarm.ac.chunk.load.error.severity
• alarm.ac.chunk.load.error.trap
B.1.23 alarm.ac.chunkdelay.error
An alarm is generated if the download time exceeds the chunk duration time. The download
time is measured from the time of the chunk request until the chunk downloaded completes.
Enabling this alarm (along with other response time alarms) can assist in determining the
source of poor VeriStream values.
• Alarm.ac.chunkdelay.error.severity
• Alarm.ac.chunkdelay.error.trap
B.1.24 alarm.ac.connection.error
Not connecting to the target location for either a manifest or chunk
• Alarm.ac.connection.error.severity
• Alarm.ac.connection.error.trap
B.1.25 alarm.ac.manifest.load.error
Specifies that the IQDialogue ASM should alarm for any reason that the Active Client
cannot load a manifest file. This alarm is typically followed by a 4xx or 5xx that specifies
the reason.
• Alarm.ac.manifest.load.error.severity
• Alarm.ac.manifest.load.error.trap
B.1.26 alarm.ac.manifest.nocontent.error
The manifest file is recognized but potentially missing mandatory information, for example,
no chunks.
• Alarm.ac.manifest.nocontent.error. severity
• Alarm.ac.manifest.nocontent.error.trap
B.1.27 alarm.ac.manifest.parse.error
Generally caused by a syntax error that deviates from the protocol specification.
• Alarm.ac.manifest.parse.error.severity
• Alarm.ac.manifest.parse.error.trap
B.1.28 alarm.ac.same.content.error
There are 2 conditions that can cause this alarm to be triggered, signifying a stale manifest:
• If the client requests the manifest file, but the file has not been modified on the server,
the server responds with the 304 status code. The alarm is created every time the “alarm
threshold” is reached. i.e. Every 3 times we get a 304, an alarm is generated (default
threshold is 3).
• If the client requests the manifest file, but the manifest file content is a duplicate of the
last time it was received, create the alarm every time the “alarm threshold” is reached.
i.e. Every 3 times we get the same content, an alarm is generated (default threshold is 3).
– Alarm.ac.same.content.error.trap
– Alarm.ac.same.content.threshold
In the IQDialogue ASM NBS interface, all alarm configurations are found on the
Configuration tab under the Alarm Settings submenu. In most cases, the IQDialogue ASM
alarm settings follow the same format. Each alarm is typically enabled or disabled with a
check box, configured for severity of the alarm notification, and when applicable provided a
threshold to initiate the alarm by either time interval or number of occurrences.
B C
Basic/Adaptive/Strict Terms used in IneoQuest
CA Acronym for Conditional Access
DVA® product’s Program Video template Frame Errors
metric “Error Profile” section to describe escalating CAS Acronym for Conditional Access System
completeness of video analysis options where Basic Client The software program entity described in the
selects that only I Frames are examined, Adaptive HTTP (RFC 7230) Client/Server protocol that
selects that only I and one P and one B Frame are establishes a connection to a Server for the purpose of
examined per GOP, and Strict selects that all I, P, and B sending one or more HTTP requests, typically for
Frames are examined for each GOP. Escalating media information. A Server is a program that accepts
completeness selection enables a user to tradeoff connections in order to service HTTP requests by
sending HTTP responses. A Client protocol entity may
I L
IDR Frames An Instantaneous Decoder Refresh (IDR) Levels Certain IneoQuest Monitoring tools can be
frame is a special type of I-frame in H.264. An IDR user-configured to adjust the depth or level of analysis.
frame specifies that no frame after the IDR frame can Level 1 is the simplest monitoring level requiring the
reference any frame before it. This makes seeking the least monitor resources and enabling the highest
H.264 stream easier and more responsive in the player number of monitored assets. Higher levels provide
because the player does not have to retain or process a more thorough monitoring to better detect more types
long history of frames. All subsequent transmitted of impairments and result in faster impairment
frames can be decoded without reference to any frame detection but typically require more monitor
decoded prior to the IDR picture. computing resources resulting in higher costs or lesser
IEC Acronym for International Electrotechnical number of simultaneous monitored assets.
Commission LKFS Loudness, K-weighted, relative to Full Scale
IGMP: Internet Group Management Protocol (LKFS) is a standard loudness metric used to enable
(ver 1,2) (as per RFCs 1112/2236) IGMP is used to normalization of audio levels for delivery of broadcast
dynamically register individual hosts in a multicast TV and other video.
group on a particular LAN. Hosts identify group
memberships by sending IGMP messages to their local
multicast router. Under IGMP, routers listen to IGMP M
messages and periodically send out queries to discover
Master Playlist A file that provides a set of bit rate
which groups are active or inactive on a particular
variants and resolutions which describe different
subnet.
versions of the same content. A playlist is a Master
Instrumented Media Player A player that Playlist if all URI lines in the file identify Media
integrates IneoQuest’s Software Design Kit (SDK) Playlists.
software to enable monitoring and reporting media
Master Program The Master Program Name is used
transport quality performance levels and other
in DVA/Inspector™ to identify a collection of bit rate
statistics.
variants carrying the same program content but
I/P/B Frame I-frame (Intra-coded), P-Frame encoded at different bit rates. Using recommended
(Predicted), B-frame (Bi-predictive) are picture types terminology, a Master Program Name is similar to the
used in video compression algorithms where I-frames Asset name. As used in the DVA/Inspector tool, it
hold fully specified pictures, P-frames include refers to the collection of bit rate variants that are
information about changes in the image from the received by the monitor while the Asset may have been
previous frame, and B-frames include information encoded and resides on a server as a larger collection of
between the current frame and both preceding and Asset Variants.
following frames.
Media Playlist A file that contains a list of Media
IP Multicast: Internet Protocol Multicast IP Segments of the same bit rate. A playlist is a Media
Multicast delivers source traffic to a group of receivers Playlist if all URI lines in the file identify media
without adding any additional burden on the source or segments.
the receivers while using the least network bandwidth
Media Player Refer to Player or Media Player.
of any competing technology. Multicast packets are
replicated in the network resulting in the most efficient MDI-DF: Delay Factor Delay Factor is a metric
delivery of data to multiple receivers possible. All which characterizes IP Packet cumulative jitter and
alternatives require the source to send more than one delay. The DF is the amount of buffer, in milliseconds,
copy of the data. that would be required to subtract IP packet arrival
deviations from the rate determined by the media
IP-SBR: IP Stream Bitrate The IP Stream Bitrate
payload.
is the measured data (payload) per second of a given
media over IP stream. The type of the payload is not MDI-MLR: Media Loss Rate Media Loss Rate is
considered, just the amount of payload in bytes is the number of media packets lost per second.
measured.
Z
ZAP: ZAP Time Time which it takes for a Multicast
group stream to appear at a destination after an IGMP
join is issued from the destination. For certain Video
over IP applications, that use multicast groups to
transport video, this can be referred to as channel
change time.
A I
Active Alarms 8-8 Intra-CDN 2-1
Active Client 2-2 iVMS ASM Integration 3-3
Group Association on Import 8-42
Recent Alarms 8-38 J
Report by Token 9-7 Java applet 8-1
Report by URI 9-9 Java Requirements 8-1
Session Logging 8-37
Active Requests (AR) Census 8-42 L
Active Requests (AR) Logs 8-42 Logging into the NBS GUI 8-2
Alarm Events 8-3
Alarms & Errors 9-20
P
Apple HLS Traffic 4-4
Publishing 2-1
Authentication 8-34
Publishing Failure Rate 8-8
Automated Report Definitions Tab 9-2
Publishing Outage Report 9-25
Automating a Report 9-4
R
B
Reporting Tab 9-2
Bandwidth Usage 8-10, 9-16
Response Failure Rate 8-8
C
S
Capture File 5-2
Smooth Streaming Traffic 4-7
Client IP/UA Pairings Report 9-26
Client Sessions Report 9-11
Client Type Distribution 8-11 T
Configure Options 8-40 Top 10 Manifest Distribution 8-11
Traceroute 8-39
Transactions 8-2
D
Database Purging 6-1
Database Transactions Logging and Sizing 6-1 U
User-Agent Report 9-14
E
Edge Cache 2-2 V
VeriStream Metric Distribution 8-9
Video Uplink 8-35
F
File Capture 5-1
W
Web based user interface 4-1
G
Web browser requirements 3-1
Generated Reports Tab 9-3
Grouping 8-37
Grouping Management Features 8-40
H
HLS Manifest Detail 9-22
HTTP Errors 4XX 8-6
HTTP Errors 5XX 8-8
HTTP Errors by Server 9-18
HTTP Publishing Sessions 8-5
HTTP Sessions Initiated 8-4
URL:
http://www.ineoquest.com
Phone:
1-508-339-2497
Fax:
1-508-339-4727