Open Media Distribution Insights User Guide, Release 1.

0
First Published: October 9, 2015

Last Modified: December 10, 2015

Americas Headquarters
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
USA
http://www.cisco.com
Tel: 408 526-4000
800 553-NETS (6387)
Fax: 408 527-0883

THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS,
INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.
THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH
THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY,
CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.
The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB's public domain version
of the UNIX operating system. All rights reserved. Copyright 1981, Regents of the University of California.
NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED "AS IS" WITH ALL FAULTS.
CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE.
IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT
LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS
HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: http://

www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership

relationship between Cisco and any other company. (1110R)

Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the document are shown
for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental.
Adobe Systems, Inc.
Adobe LiveCycle Data Services ES2.5, Copyright 2010, Adobe Systems, Inc. All Rights Reserved
Oracle
Copyright 2012, Oracle and/or its affiliates. All rights reserved.
Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.
Red Hat, Inc.
Red Hat and Red Hat Enterprise Linux are trademarks of Red Hat, Inc., registered in the United States and other countries.
Other product names, symbols, and phrases used throughout this document (if any) are property of their respective owners.

2015 Cisco Systems, Inc. All rights reserved.

CONTENTS

Preface
Audience ............................................................................................................................................................................. 13
Document Conventions ................................................................................................................................................... 13
Reader Alert Conventions ............................................................................................................................................... 14
Document Organization .................................................................................................................................................. 16
Reporting Problems .......................................................................................................................................................... 16
Obtaining Documentation and Submitting a Service Request ................................................................................. 16

C H A P T E R 1 - O p e n M e d i a D i s t r i b u t i o n ( O p e n M D ) O v e r v i e w
OpenMD Hierarchy .......................................................................................................................................................... 17
Logical Topology .............................................................................................................................................................. 17
OpenMD Components ..................................................................................................................................................... 18
Traffic Ops ............................................................................................................................................................................... 18
Traffic Router ........................................................................................................................................................................... 18
DNS Content Routing ............................................................................................................................................................... 18
HTTP Content Routing ............................................................................................................................................................. 18
Traffic Monitor ........................................................................................................................................................................ 19
Traffic Stats .............................................................................................................................................................................. 19

C H A P T E R 2 - O p e n M e d i a D i s t r i b u t i o n ( O p e n M D ) H o m e p a g e
Network ............................................................................................................................................................................... 23
Bandwidth ............................................................................................................................................................................... 23
Request Rate ........................................................................................................................................................................... 24
Response Status Codes and Cache Hit Ratio ........................................................................................................................... 24
Protocol ............................................................................................................................................................................... 25
Content ................................................................................................................................................................................ 26
Viewers ................................................................................................................................................................................ 27
Content Origin ................................................................................................................................................................... 29

C H A P T E R 3 - O p e n M D I n s i g h t s
Analyze Metrics with Pivoting ....................................................................................................................................... 30
Trends ................................................................................................................................................................................... 32
Network ............................................................................................................................................................................... 33
Volume ...................................................................................................................................................................................... 33
Bandwidth ........................................................................................................................................................................... 34
Volume of Data Delivered .................................................................................................................................................... 34
Delivery Services by Bytes Delivered .................................................................................................................................... 35
Caching .................................................................................................................................................................................... 36
Cache Hit and Miss Rate by Request Count ......................................................................................................................... 36
% Cache Hit and Miss ........................................................................................................................................................... 37
Cache Hit Ratio by Protocol ................................................................................................................................................. 38
Request .................................................................................................................................................................................... 39
Request Rate ........................................................................................................................................................................ 39
Total Requests and Errors .................................................................................................................................................... 40
Top Delivery Services by Request Count ............................................................................................................................... 41
Response ................................................................................................................................................................................. 42
Response Count by Status Codes ......................................................................................................................................... 42
Response Codes by Edge Cache ........................................................................................................................................... 43
Sorted Delivery Services by Client Errors on Edge Cache ..................................................................................................... 44
4xx Error Rate on Edge Cache .............................................................................................................................................. 45
Response Codes by Protocol ................................................................................................................................................ 46
4xx Errors by Protocol .......................................................................................................................................................... 47
Viewers .................................................................................................................................................................................... 48
Number of Unique Viewers ..................................................................................................................................................... 49
Viewers by Client Type ............................................................................................................................................................ 49
Viewer Density by Location ................................................................................................................................................... 50
Top Viewers ........................................................................................................................................................................... 50
Viewers by Session Duration ................................................................................................................................................ 51
Viewers by ISP, Net Speed ...................................................................................................................................................... 51
Viewers by Protocol .............................................................................................................................................................. 52
Viewers by Download Size ..................................................................................................................................................... 53
Content .................................................................................................................................................................................... 53
Content by Client Requests ..................................................................................................................................................... 54
Content by Bytes Transferred ................................................................................................................................................... 55
Top Content by Edge Cache ...................................................................................................................................................... 56
Average ABR Session Bitrate by Content .................................................................................................................................. 56
Top Content by City ................................................................................................................................................................. 57
Top Content by Client Type ....................................................................................................................................................... 57

Reports .................................................................................................................................................................................. 58
OpenMD Traffic ........................................................................................................................................................................... 58
Traffic Summary by Edge Caches ................................................................................................................................................... 59
Traffic Summary by Delivery Services ............................................................................................................................................ 60
Edge Cache Traffic .................................................................................................................................................................. 60
Delivery Service Traffic ............................................................................................................................................................ 61
Custom Dashboards .......................................................................................................................................................... 62
Adding a Custom Dashboard ...................................................................................................................................................... 62
Deleting a Custom Dashboard ................................................................................................................................................... 64
Sessions .............................................................................................................................................................................. 65
Analyze by Client IP .................................................................................................................................................................... 65
Session Report ......................................................................................................................................................................... 66

C H A P T E R 4 - Monitor

OpenMD Overview ................................................................................................................................................................. 69

Bandwidth ............................................................................................................................................................................... 69
Cache Hit Ratio ........................................................................................................................................................................ 70
Unique Clients ......................................................................................................................................................................... 70
Responses ............................................................................................................................................................................... 71

C H A P T E R 5 - A l e r t s
Alerts Overview ................................................................................................................................................................. 64
Adding a Threshold Alert ............................................................................................................................................................ 64
Deleting a Threshold Alert ......................................................................................................................................................... 65

Preface

Audience
The Open Media Distribution (OpenMD) Insights User Guide provides instructions to the Operators and Administrators, who
are responsible for the management, real-time analysis and monitoring, business policy enforcement, and other critical
network intelligence for Videoscape OpenMD.

Document Conventions
This document uses the following conventions:

Convention
^ or Ctrl

Description

Both symbols represent the Control (Ctrl) key on the keyboard. For
example, the key combinations ^D or Ctrl-D means that you hold down
the Control key while you press D . (Keys are indicated in capital letters
but are not case sensitive.)

bold font

Commands, keywords, and user-entered text appear in bold font.

Italic font

Document titles, new or emphasized terms, and arguments for which you
need to enter values appear in italic font.

Open Media Distribution Analytics User Guide, Release 1.0

13


Preface

Convention

Description

Courier font

Terminal sessions and information, which the system displays appear in

courier font.

Bold Courier font

Bold Courier font indicates the text that you must enter.

[x]

Elements in square brackets are optional.

...

An ellipsis (three consecutive non-bolded periods without spaces) after

a syntax element indicates that the element can be repeated.

A vertical line, called a pipe, indicates a choice within a set of keywords

or arguments.

[x | y]

Optional alternative keywords are grouped in brackets and separated by

vertical bars.

{x | y}

Required alternative keywords are grouped in braces and separated by

vertical bars.

[x {y | z}]

Nested set of square brackets or braces indicate optional or required

choices within optional or required elements. Braces and a vertical bar
within square brackets indicate a required choice within an optional
element.

string

A non-quoted set of characters. Do not use quotation marks around the

string or the string will include the quotation marks.

<>

Nonprinting characters such as passwords appear in angle brackets.

[]

Default responses to system prompts appear in square brackets.

!, #

An exclamation point (!) or a pound sign (#) at the beginning of a line

of code indicates a comment line.

Reader Alert Conventions

This document uses the following conventions for reader alerts:

Note

Tip

Means reader take note. Notes contain helpful suggestions or references to material, which is not covered
in the manual.

Means the following information will help you solve a problem.

Open Media Distribution Analytics User Guide, Release 1.0

Preface

Document Organization

Caution

Means reader needs to be careful. In this situation, you might do something that could result in equipment
damage or loss of data.

Timesaver

Means the described action saves time. You can save time by performing the action described in the
paragraph.

Warning

Means reader beware. In this situation, you might perform an action that could result in bodily injury.

Open Media Distribution Analytics User Guide, Release 1.0

15

Document Organization

This document is organized into the following chapters:

Chapter

Description

Open Media Distribution (OpenMD) Overview

Home

Provides an overview of OpenMD Insights.

Provides information and reporting for:
Network
Protocol
Content
Viewers
Content Origin
Content Routing
Provides configuration and reporting information for the
OpenMD Insights.
Displays various dashboards such as Bandwidth, Cache Hit
Ratio, and Responses, which allow the CDN Operator to
monitor the performance of the network.
Displays details on how to manage threshold alerts.

Analytics
Monitor

Alerts

Reporting Problems

If you have any query or experience problems when installing the OpenMD software, contact your Cisco Technical
representative.

Obtaining Documentation and Submitting a Service Request

For information on obtaining documentation, using the Cisco Bug Search Tool (BST), submitting a service request, and
gathering additional information, see What's New in Cisco Product Documentation, at:
http:// www.cisco.com/c/en/us/td/docs/general/whatsnew/whatsnew.html.
Subscribe to What's New in Cisco Product Documentation, which lists all new and revised Cisco technical documentation
as an RSS feed and delivers content directly to your desktop using a reader application. The RSS feeds are a free service.

Open Media Distribution Analytics User Guide, Release 1.0

CHAPTER

Open Media Distribution (OpenMD) Overview

The OpenMD is composed of Traffic Control and the cache servers. The Traffic Control component is a control plane for
a CDN, which includes:

Traffic Ops
Traffic Router
Traffic Monitor
Traffic Stats
Traffic Vault

The following figure provides a view of the whole OpenMD architecture (the blues items are for traffic control).

Open Media Distribution Analytics User Guide, Release 1.0

OpenMD Hierarchy
Physically, the OpenMD is comprised of different divisions, regions, and locations. Each division has the following
structure:

Logical Topology
Logically, the OpenMD is comprised of the cache groups. Cache servers within a single cache group are treated with the
following set of properties in common:

Single logical location

Single physical region
Single group membership
Either EDGE or MID

EDGE group servers are deployed as reverse proxy caches, while MID group servers are deployed as forward proxy
caches.

Open Media Distribution Analytics User Guide, Release 1.0

17

OpenMD Components
The Open MD is comprised of the following components:

Traffic Ops
Traffic Router
Traffic Monitor
Traffic Stats
Traffic Vault

Traffic Ops
The Traffic Ops is the tool for administration (configuration and monitoring) of all components in a Traffic Control CDN.
The OpenMD administrator uses Traffic Ops to manage servers, cache groups, delivery services, and so on. The
following is a list of the basic functions of the traffic ops:

Provides a WEB Graphical User Interface (GUI) for OpenMD administrator.

Configures and monitors the OpenMD.
Exposes the HTTP APIs for data access.
Generates the application specific configuration files for other OpenMD components.
Using extensions, it runs a collection of periodic checks to determine the operational readiness of the caches.

Traffic Router
The Traffic Routers function is to send clients to the most optimal cache and has the following routing methods:

DNS content routing.

HTTP content routing.

DNS Content Routing

The DNS content routing resolves the hostname and returns the cache's IP address directly. DNS content routing has
the following factors:

Serves the url with the hostname beginning with 'edge.'(e.g.http://edge.dsname.cdn.com/foo/bar/fun.html).

Considers the localization between the Client's LDNS server and the cache groups.
Considers the health of the cache servers.

HTTP Content Routing

HTTP content routing is similar to the HTTP based routing method in VDS-IS, where the router resolves the hostname
and return its own IP address first, which allows the client to send the http requests to the router first and then the
router can service the application level information to determine the best cache server for the request. HTTP has the
following factors:

Serves the url with the hostname beginning with 'tr.'(e.g.http://tr.dsname.cdn.com/foo/bar/fun.html).

Considers the localization between the client's IP address and the cache groups.
Considers the content awareness (like the content based routing in VDS-IS) to make sure that same content
requests go to same cache server.
Considers the health of the cache servers.

Open Media Distribution Analytics User Guide, Release 1.0

Traffic Monitor
The Traffic Monitor is a Java/Tomcat application that monitors the caches in OpenMD for a variety of cache metrics in
OpenMD. These metrics are for determining the overall health of a given cache and the related delivery services.
TrafficMonitor pulls metrics from an ATS (Ap Tr Server) plugin running on the cache servers. The TrafficMonitor has the
following properties:

It is a Java/Tomcat application
Monitors the edge cache and delivery service statistics (for example; tps, system performance, and so on.
Determines the health of the cache server and delivery service, which then informs the traffic router.
Provides HTTP APIs for data access.
Health reports are interpreted optimistically in deployments with multiple TrafficMonitors. The most optimal
value is chosen as true if multiple TrafficMonitors inform a single TrafficRouter.

Traffic Stats
Traffic Stats is a utility that mines metrics from Traffic Monitors JSON APIs and stores the data locally in Redis, for a
short period of time. It has the following factors:

Queries the metrics from traffic monitor via its HTTP APIs periodically.
Stores the queried data in the local redis.
Is not necessary for the content delivery but it is required in order to display charts in Traffic Operations.

Open Media Distribution Analytics User Guide, Release 1.0

19

CHAPTER

Open Media Distribution (OpenMD) Homepage

The OpenMD homepage, provides information and reporting for:

Network
Protocol
Content
Viewers
Content Origin

The following is an example of the OpenMD homepage.

Open Media Distribution Analytics User Guide, Release 1.0

21

From within this page you can filter information using criteria similar to the following:

Specific Time Range of either 60 minutes or 24 hours.

Edge Cache Group for a specific group or all groups.
Edge Cache for a specific user or all users.
Delivery Service for a specific service or all services.

This information can then be viewed or analyzed (depending on the specific screen). For example, by clicking on View
results or Analyze data, located at the bottom of the display, specific information or analysis for the screen is displayed.
View Results

As can be seen, this information can be viewed by events, patterns, statistics, and visualization, providing additional
usage information.
Analyze Data

Open Media Distribution Analytics User Guide, Release 1.0

This information can be displayed in either table or chart formats. By dragging your mouse over the chart, detailed
information for a given point in time is displayed. For example:

Network
The Network tab provides the following information and reporting:

Bandwidth
Request Rate
Response Status Codes
Cache Hit Rates

Bandwidth
The Network Bandwidth provides the Gigabytes per second for a given time period. For example:

Open Media Distribution Analytics User Guide, Release 1.0

23

This information can be viewed or analyzed, as described previously.

Request Rate
The Request Rate provides the number of request (per second), at a given time. For example:

Response Status Codes and Cache Hit Ratio

The Response Status Codes provides the count or percentage or responses for a given date/time. The Cache Hit Ratio
provides a percentage of hits and misses for a given date/time. For example:

Open Media Distribution Analytics User Guide, Release 1.0

Protocol
The Protocol tab provides the following information and reporting:

Volume Delivered by Protocol

Total Requests by Protocol
Response Codes by Protocol
Cache Hit Ratio by Protocol
ABR Session Bitrate by Protocol
4xx Errors by Protocol

The following is an example of each.

This information can be viewed as described previously.
The following table provides a brief description of each display.
Chart
Description
Volume Delivered by Protocol
Gigabytes delivered at a given date and time, for a specific protocol.
Total Requests by Protocol
Total requests received at a given date and time, for a specific protocol.
Response Codes by Protocol
Number of response codes received for a specific protocol.
Cache Hit Ratio by Protocol
Percent of hits received at a given date and time, for a specific protocol.
ABR Session Bitrate by Protocol
The bitrate in Kbps at a given date and time, for a specific protocol.
4xx Errors by Protocol
4xx errors received at a given date and time, for a specific protocol.

Open Media Distribution Analytics User Guide, Release 1.0

25

Content
The Content tab provides the following information and reporting:

Content by Client Request

Content by Bytes Transferred
Average ABR Session Bitrate by Content
Top Content by Edge Cache
Top Content by City
Top Content by Client Type

The following is an example of each.

Open Media Distribution Analytics User Guide, Release 1.0

This information can be viewed as described previously.
The following table provides a brief description of each display.
Chart
Content by Client Request
Content by Bytes Transferred
Average ABR Session Bitrate by Content
Top Content by Edge Cache
Top Content by City
Top Content by Client Type

Description
The count of the top or bottom 10 shows viewed.
The bytes of content transferred for the top or bottom shows viewed.
The average ABR session bitrate by content for the top or bottom 10 shows
viewed.
The top content by edge device.
The top content count, viewed per city.
The top content count, viewed by client type.

Viewers
The Viewers tab provides the following information and reporting:

Unique Viewers
Viewers by Client Type
Viewers by City
Viewers by ISP and Net Speed
Viewers by Download Size
Viewers by Session Duration

The following is an example of each.

Open Media Distribution Analytics User Guide, Release 1.0

27

This information can be viewed as described previously.
The following table provides a brief description of each display.
Chart
Unique Viewers
Viewers by Client Type
Viewers by City
Viewers by ISP and Net Speed
Viewers by Download Size
Viewers by Session Duration

Description
The viewer count at a given date and time.
The number of viewers, by client type.
The viewer count, per city.
The viewer count by ISP and Net Speed.
The viewer count, by download size.
The viewer count, by the average session duration.

Open Media Distribution Analytics User Guide, Release 1.0

Content Origin
The Content Origin tab provides the following information and reporting:

Ingest Requests
Ingest Bytes Read

The following is an example of each.

This information can be viewed as described previously.
The following table provides a brief description of each display.
Chart
Ingest Requests
Ingest Bytes Read

Description
The ingest count at a given date and time.
The number of ingest bytes read at a given date and time.

Open Media Distribution Analytics User Guide, Release 1.0

29

CHAPTER

OpenMD Insights

This section provides an overview of the Open Media Distribution (OpenMD) Insights, which provides the ability to view
and analyze data that are collected about trends, reports, content, and sessions in textual and graphical form.
The Splunk UFs on edge and mid caches monitor the log files and forward them to OpenMD Insights indexers in real-
time. The data available is used to provide a multitude of historical search capabilities. The data is gathered using
predefined indexing metrics designed to provide data that are monitored by service provider operators. The data
output is viewed in the form of a dashlet.
The OpenMD Insights also displays various scorecards such as Network, Protocol, Content, and Viewer.

Analyze Metrics with Pivoting

The Analyze Metrics with Pivoting feature allows the OpenMD operators to analyze the data at a granular level. The
difference between the Analyze data option on individual charts and generic pivoting is that, in pivoting, you need to
select an option to start the analysis. You can analyze the data for the following:

Bandwidth Delivered
Cache Efficiency
GigaBytes Delivered
Requests
Response Codes
Viewers

To access the Analyze Metrics with Pivoting feature, complete the following:
1. From within the OpenMD page, select Analytics > Analyze Metrics with Pivoting.

Open Media Distribution Analytics User Guide, Release 1.0

The Analyze Metrics with Pivoting page is displayed. For example:

2. From the Pivot on: drop-down list, choose the category for which you need to analyze the data.
3. From the Analyze, of, over, and split by drop-down lists, choose the required options.
NOTE: Make sure that you choose different options from the over and split by drop-down lists.
The data on this page can be viewed in the following ways:

By clicking on the Both tab, the data is displayed, in a tabular column and chart. For example:

By clicking on the Table tab, the data is displayed in a tabular column. For example:

Open Media Distribution Analytics User Guide, Release 1.0

31

By clicking on the Chart tab, the data will be displayed in a chart/graph. For example:

You can also view the same data in different charts and stack modes. For this, click the Chart type and Stack mode
drop-down lists respectively, and choose the required chart and stack mode. The different chart types are column, bar,
line, area, and pie.
The different types of stack modes are stacked, none, and 100% stacked.
NOTE: When you choose an option other than Time in the over drop-down list and choose none in the split by drop-
down list, additional drop-down lists such as top/bottom and the number of results to be plotted are displayed.

Trends
The Trends feature allows you to view the historical data (more than 7 days), in a graph and tabular column. The OpenMD
Insights gathers historical data from different perspectives, such as:

Network
Streaming
Viewers
Content

When each of these categories is clicked, the respective subcategories are expanded. On further expanding the
subcategories, the respective dashlets are listed. When each of these dashlets is selected, the corresponding charts and
data (in a tabular column) are displayed on the right pane. When you click View results option below the charts, the
underlying search and corresponding search results are displayed.
NOTE: In the search field, which is located in the left pane, enter the dashlet name or part of the dashlet name as a
search string. This will display the receptive dashlet names.

Open Media Distribution Analytics User Guide, Release 1.0

Network
The Network Trends dashboard provides historical information on volume, caching, request, and response of the
managed OpenMD network.
To access the Network Trends feature, complete the following:
1. From the OpenMD main page, choose Analytics > Trends. The Trends page is displayed. For example:

2. From the tree view, which appears in the left pane, select Network.

The following subcategories are displayed in Network:

Volume
Caching
Request
Response

Volume
The Volume feature include the following:

Bandwidth
Volume of Data Delivered
Delivery Services by Bytes Delivered

The following are examples of each:

Open Media Distribution Analytics User Guide, Release 1.0

33

Bandwidth

Volume of Data Delivered

Open Media Distribution Analytics User Guide, Release 1.0

Delivery Services by Bytes Delivered

The following table describes the chart within this dashlet:
Chart
Delivery Services by Bytes Delivered

Description
Illustrates the top delivery services, based on the content delivered, for the
specified time interval.
Chart Information
The information within this chart is a bar graph with the bytes delivered in GB
along the X-axis and Delivery Service along the Y-axis.
Formula
The formula used to derive the graph is: Top 'n' delivery services by total bytes
delivered.
Chart Filters
This chart uses Edge Cache Group, Edge Cache, Delivery Service, and the Time
Range Picker, as filters.
Availability
This chart is available only to the OpenMD users.
You can also view the top delivery services, such as top 10 and top 20, by clicking the Sorting Criteria drop-down list.

Open Media Distribution Analytics User Guide, Release 1.0

35

Caching
The Caching feature includes the data and charts for the following:

Cache Hit and Miss Rate by Request Count

% Cache Hit and Miss

Cache Hit Ratio by Protocol

The following are examples of each:

Cache Hit and Miss Rate by Request Count

The following table describes the chart within this dashlet:
Chart
Cache Hit and Miss Rate by Request Count
Chart Information

Formula
Chart Filters
Availability

Description
Illustrates the rate of cache hit and miss, for the specified time interval.
The information within this chart is a line graph with Date/Time along the
X-axis and Requests per Second along the Y-axis. The legends are Cache
Hit and Cache Miss.
The formula used to derive the graph is: the rate of cache hit and cache
miss requests per second.
This chart uses Edge Cache Group, Edge Cache, Delivery Service, and the
Time Range Picker as filters.
This chart is available only to the Wholesale and OpenMD users.

Open Media Distribution Analytics User Guide, Release 1.0

% Cache Hit and Miss

The following table describes the chart within this dashlet:
Chart
% Cache Hit and Miss

Chart Information

Formula

Chart Filters
Availability

Description
Illustrates the percentage of cache hits and cache miss, based on the
number of requests served and total bytes delivered, for the specified
time interval.
The information within this chart is a stacked area graph with Date/Time
along the X-axis and Cache Hit and Cache Miss percentage along the Y-
axis. The legends are Cache Hit and Cache Miss.
The formula used to derive the requests served graph is: percentage of
cache hit and cache miss over total requests.
The formula used to derive the bytes delivered graph is: percentage of
cache hit bytes and cache miss bytes over total bytes delivered.
This chart uses Edge Cache Group, Edge Cache, Delivery Service, and the
Time Range Picker as filters.
This chart is available only to the Wholesale and OpenMD users.

Open Media Distribution Analytics User Guide, Release 1.0

37

Cache Hit Ratio by Protocol

The following table describes the chart within this dashlet:
Chart
Cache Hit Ratio by Protocol
Chart Information

Description
Illustrates the cache-hit ratio for each protocol, for the specified time interval.
The information within this chart is shown in a line graph with Date/Time along
the X-axis and cache hit ratio (%) along the Y-axis. The legends representing the
graph are protocols.
The formula used to derive the graph is the percentage of cache hit over total
requests grouped by the protocol.
This chart uses Time Range picker similar to other chart tables.
This chart is available only to OpenMD users.

Formula
Chart Filters
Availability

Open Media Distribution Analytics User Guide, Release 1.0

Request
The Request feature includes data and charts for the following:

Request Rate
Total Requests and Errors
Top Delivery Services by Request Count

The following are examples of each:

Request Rate

The following table describes the chart within this dashlet:
Chart
Request Rate
Chart Information
Formula
Chart Filters
Availability

Description
Illustrates the number of requests per second, for the specified time interval.
The information within this chart is a column graph with Date/Time along the X-
axis and Requests per Second along the Y-axis.
The formula used to derive the graph is the number of requests per second.
This chart uses Cache Group and Edge Cache, Delivery Service, and the Time
Range Picker as filters.
This chart is available only to Wholesale and OpenMD users.

Open Media Distribution Analytics User Guide, Release 1.0

39

Total Requests and Errors

The following table describes the chart within this dashlet:
Chart
Total Requests and Errors

Description
Illustrates the total requests and the number of errors from the total requests, for
the specified time interval.
The information within this chart is an area graph with Date/Time along the X-axis
and the requests/error Count along the Y-axis. The legends are Total Requests and
Error Count.
The formula used to derive the graph is the total number of requests and errors
(requests with status codes 4xx or 5xx).
This chart uses Cache Group and Edge Cache, Delivery Service, and the Time
Range Picker as filters.
This chart is available only to Wholesale and OpenMD users.

Chart Information

Formula
Chart Filters
Availability

Open Media Distribution Analytics User Guide, Release 1.0

Top Delivery Services by Request Count

The following table describes the chart within this dashlet:
Chart
Top Delivery Services by Request Count
Chart Information
Formula
Chart Filters
Availability

Description
Illustrates the top delivery services by request count, for the specified time
interval.
The information within this chart is a bar graph with request count along
the X-axis and the top Delivery Services along the Y-axis.
The formula used to derive the graph is the top 10 delivery services by the
number of requests received by them.
This chart uses Cache Group and Edge Cache, Delivery Service, and the
Time Range Picker as filters.
This chart is available only to OpenMD users.

Open Media Distribution Analytics User Guide, Release 1.0

41

Response
The Response feature includes data and charts for the following:

Response Count by Status Cache

Response Codes by Edge Device
Sorted Delivery Services by Client Errors on Edge Cache
4xx Error Rate on Edge Cache
Response Codes by Protocol
4xx Errors by Protocol

Response Count by Status Codes

The following table describes the chart within this dashlet:
Chart
Response Status Codes
Chart Information

Formula

Chart Filters
Availability

Description
Provides response codes count and percentage, for the specified time interval.
The information within this chart is shown in stacked area with Date/Time along the X-
axis with the response count and percentage along the Y-axis. The legends
representing the graph are 2xx, 3xx, 4xx, and 5xx.
The status codes from logs are grouped as 2xx, 3xx, 4xx, and 5xx. The count of each
group is calculated as the sum of individual status code counts. The percentage of each
group is derived by calculating the percentage of group count over the total responses.
This chart uses Cache Group and Edge Cache, Delivery Service, and the Time Range
Picker as filters.
This chart is available only to OpenMD users.

Open Media Distribution Analytics User Guide, Release 1.0

Response Codes by Edge Cache

The following table describes the chart within this dashlet:
Chart
Response Codes by Edge Cache

Description
Illustrates the responses that are grouped by status codes (such as success, client
error, and server error: status of a request), for a given Edge Cache.
The information within this chart is a stacked bar graph with response Count along
the X-axis and the Edge Cache along the Y-axis. The legends are the status codes.
The formula used to derive the graph is the number of responses grouped by the
response codes for each Edge Cache.
This chart uses Cache Group and Edge Cache, Delivery Service, and the Time Range
Picker as filters.
This chart is available only to OpenMD users.

Chart Information
Formula
Chart Filters
Availability

Open Media Distribution Analytics User Guide, Release 1.0

43

Sorted Delivery Services by Client Errors on Edge Cache

The following table describes the chart within this dashlet:
Chart
Sorted Delivery Services by
Client Errors on Edge Cache
Chart Information

Description
Illustrates the top 10 delivery services by client errors.
The information within this chart is a bar graph with response Count along the X-axis
and the Delivery Service along the Y-axis.
The formula used to derive the graph is the top 10 delivery services by the number of
4xx errors.
This chart uses Cache Group and Edge Cache, Delivery Service, and the Time Range
Picker as filters.
This chart is available only to OpenMD users.

Formula
Chart Filters
Availability

Open Media Distribution Analytics User Guide, Release 1.0

4xx Error Rate on Edge Cache

The following table describes the chart within this dashlet:
Chart
4xx Error Rate on Edge Cache

Description
Illustrates the number of 4xx errors per second for each edge cache, for the specified
time interval.
The information within this chart is a line graph with Date/Time along the X-axis and
4xx Errors/Second along the Y-axis.
The formula used to derive the graph is number of errors per day for each edge cache.
This chart uses Cache Group and Edge Cache, Delivery Service, and the Time Range
Picker as filters.
This chart is available only to OpenMD users.

Chart Information
Formula
Chart Filters
Availability

Open Media Distribution Analytics User Guide, Release 1.0

45

Response Codes by Protocol

The following table describes the chart within this dashlet:
Chart
Response Code by Protocol
Chart Information

Description
Illustrates the response codes for each protocol.
The information within this chart is a stacked bar graph with Count along the X-axis
and Protocol along the Y-axis. The legends represent individual response codes.
The formula used to derive the bar graph is the count of individual response codes
grouped by the response code and protocol.
This chart uses Cache Group and Edge Cache, Delivery Service, and the Time Range
Picker as filters.
This chart is available only to OpenMD users.

Formula
Chart Filters
Availability

Open Media Distribution Analytics User Guide, Release 1.0

4xx Errors by Protocol

The following table describes the chart within this dashlet:
Chart
4xx Errors by Protocol
Chart Information

Description
Illustrates the number of 4xx errors for each protocol, for the specified time interval.
The information within this chart is shown in a stacked area graph with the Date/Time
along the X-axis and the Error Count along the Y-axis. The legends representing the
graph are protocol types.
The formula used to derive the graphs is Total 4xx errors/sec on each edge.
This chart uses Cache Group and Edge Cache, Delivery Service, and the Time Range
Picker as filters.
This chart is available only to OpenMD users.

Formula
Chart Filters
Availability

Open Media Distribution Analytics User Guide, Release 1.0

47

Viewers
The Trends Viewers dashboard provides historical information on the following:

Number of Unique Viewers

Viewers by Client Type
Viewer Density by Location
Top Viewers
Viewers by Session Duration
Viewers by ISP and Net Speed
Viewers by Protocol
Viewers by Download Size

To access the Trends Viewer feature, complete the following:

1. From the OpenMD main page, choose Analytics > Trends. The Trends page is displayed. For example:

2. From the tree view, which appears in the left pane, select Viewers.

Open Media Distribution Analytics User Guide, Release 1.0

Number of Unique Viewers

The following table describes the chart within this dashlet:
Chart
Unique Viewers
Chart Information
Formula
Chart Filters
Availability

Description
Illustrates the number of unique viewers per day.
The information within this chart is shown in a column graph with the Date/Time
along the X-axis and the unique viewer Count along the Y-axis.
The formula used to derive the graph is the total unique viewer, per day.
This chart uses Cache Group and Edge Cache, Delivery Service, and the Time Range
Picker as filters.
This chart is available only to Wholesale and OpenMD users.

Viewers by Client Type

The following table describes the chart within this dashlet:
Chart
Viewers by Client Type
Table Information
Formula
Chart Filters
Availability

Description
Illustrates the number of viewers accessing the network through each client.
The information within this table is the Client Type and Count.
The formula used is unique viewer by client type and request count.
This chart uses Cache Group and Edge Cache, Delivery Service, and the Time Range
Picker as filters.
This chart is available only to Wholesale and OpenMD users.

Open Media Distribution Analytics User Guide, Release 1.0

49

Viewer Density by Location

The following table describes the chart within this dashlet:
Chart
Viewer Density by Location
Table Information
Formula
Chart Filters

Description
Illustrates the viewer density per city, for a specified time interval.
The information within this table is City and Count.
The formula used to derive the table is the number of viewers in each city.
This chart uses Cache Group and Edge Cache, Delivery Service, and the Time Range
Picker as filters.
This chart is available only to Wholesale and OpenMD users.

Availability
Top Viewers

Open Media Distribution Analytics User Guide, Release 1.0

The following table describes the chart within this dashlet:

Chart
Top Viewers

Description
Illustrates the top viewers by total bytes delivered and request count, for a specified
time interval.
Chart Information
The information within this chart is a bar graph with the Request Count/Bytes
Delivered along the X- axis and Client IP address along the Y-axis.
Formula
The formula used to derive the graph is the top 'n' viewers of requests and bytes
delivered.
Chart Filters
This chart uses Cache Group and Edge Cache, Delivery Service, and the Time Range
Picker as filters.
Availability
This chart is available only to Wholesale and OpenMD users.
You can also view the top viewers, such as top 10 and top 20, by choosing the respective options from the Sorting
Criteria drop-down list. You can also view the request count and bytes delivered by clicking the respective radio
buttons.
Viewers by Session Duration

The following table describes the chart within this dashlet:
Chart
Viewers by Session Duration
Table Information
Formula

Description
Illustrates the number of viewers, based on session duration.
The information within this table is Average Session Duration (minutes) and Count.
The formula used is the number of unique viewers bucketed by the average session
duration.
This chart uses Cache Group and Edge Cache, Delivery Service, and the Time Range
Picker as filters.
This chart is available only to Wholesale and OpenMD users.

Chart Filters
Availability
Viewers by ISP, Net Speed

Open Media Distribution Analytics User Guide, Release 1.0

51

The following table describes the chart within this dashlet:

Chart
Viewers by ISP and Net Speed

Description
Illustrates the number of viewers accessing the network, grouped by Internet Service
Provider (ISP) or Net Speed.
The information within this table are ISP or Net Speed and Count.
NOTE: The ISP and Net Speed count appear in descending order of views..
The formula used is the number of unique viewers grouped by Client ISP or Net
Speed.
This chart uses Cache Group and Edge Cache, Delivery Service, and the Time Range
Picker as filters.
This chart is available only to Wholesale and OpenMD users.

Table Information
Formula
Chart Filters
Availability
Viewers by Protocol

The following table describes the chart within this dashlet:
Chart
Viewers by Protocol
Chart Information

Description
Illustrates the number of viewers per protocol, for the specified time interval.
The information within this chart is a column graph with the Protocol along the X-axis
and viewer Count along the Y-axis.
The formula used to derive the graph is the number of viewers grouped by protocol.
This chart uses Cache Group and Edge Cache, Delivery Service, and the Time Range
Picker as filters.
This chart is available only to Wholesale and OpenMD users.

Formula
Chart Filters
Availability

Open Media Distribution Analytics User Guide, Release 1.0

Viewers by Download Size

The following table describes the chart within this dashlet:
Chart
Viewers by Download Size
Table Information
Formula
Chart Filters

Description
Illustrates the number of viewers, based on the download size.
The information within this table is Download Size and Count.
The formula used is the number of viewers bucketed by the download size in MB.
This chart uses Cache Group and Edge Cache, Delivery Service, and the Time Range
Picker as filters.
This chart is available only to Wholesale and OpenMD users.

Availability

Content
The Trends Content dashboard provides historical information on the following:

Content by Client Requests

Content by Bytes Transferred
Top Content by Edge Cache
Average ABR Session Bitrate by Content
Top Content by City
Top Content by Client Type

To access the Trends Content feature, complete the following:

1. From the OpenMD main page, choose Analytics > Trends. The Trends page is displayed. For example:

Open Media Distribution Analytics User Guide, Release 1.0

53

2. From the tree view, which appears in the left pane, select Content.

Content by Client Requests

The following table describes the chart within this dashlet:
Chart
Content by Client Request
Chart Information
Formula
Chart Filters
Availability

Description
Illustrates the most/least popular content, based on the number of client requests
received.
The information within this chart is shown in a bar graph with Count along the X-axis
and Title along the Y-axis.
The formula used to derive the graph is the most/least viewed content titles by client
session count, per day.
This chart uses Cache Group and Edge Cache, Delivery Service, and the Time Range
Picker as filters.
This chart is available only to Wholesale and OpenMD users.

Open Media Distribution Analytics User Guide, Release 1.0

Content by Bytes Transferred

The following table describes the chart within this dashlet:
Chart
Content by Bytes Transferred
Chart Information

Description
Illustrates the most/least popular content, based on the download size.
The information within this chart is shown in a bar graph with Bytes Delivered along
the X-axis and Title along the Y-axis.
The formula used to derive the graph is the most/least viewed content titles by bytes
transferred to clients, per day.
This chart uses Cache Group and Edge Cache, Delivery Service, and the Time Range
Picker as filters.
This chart is available only to Wholesale and OpenMD users.

Formula
Chart Filters
Availability

Open Media Distribution Analytics User Guide, Release 1.0

55

Top Content by Edge Cache

The following table describes the chart within this dashlet:
Chart
Top Content by Edge Cache
Table Information
Formula
Chart Filters
Availability

Description
Illustrates the most popular content, based on the edge cache.
The information within this table is Edge Cache, Title, and Count.
The formula used is the top content title (based on count) by edge cash.
This chart uses Cache Group and Edge Cache, Delivery Service, and the Time Range
Picker as filters.
This chart is available only to Wholesale and OpenMD users.

Average ABR Session Bitrate by Content

The following table describes the chart within this dashlet:
Chart
Average ABR Session Bitrate by Content
Table Information
Formula
Chart Filters
Availability

Description
Illustrates the content delivered with highest/lowest bitrate.
The information within this table is Title and Average Bitrate.
The formula used is the top/bottom content title by average bitrate.
This chart uses Cache Group and Edge Cache, Delivery Service, and the Time
Range Picker as filters.
This chart is available only to Wholesale and OpenMD users.

Open Media Distribution Analytics User Guide, Release 1.0

Top Content by City

The following table describes the chart within this dashlet:
Chart
Top Content by City
Table Information
Formula
Chart Filters

Description
Illustrates the most popular content viewed in a city.
The information within this table is City, Title, and Count.
The formula used is: the top content title (based on count) by city.

This chart uses Cache Group and Edge Cache, Delivery Service, and the Time
Range Picker as filters.
This chart is available only to Wholesale and OpenMD users.

Availability
Top Content by Client Type

The following table describes the chart within this dashlet:
Chart
Top Content by City

Description
Illustrates the most popular content viewed in each client (players and
browsers that is used to request the content).
The information within this table is Client Type, Title, and Count.
The formula used is the top content title (based on count) by client type.
This chart uses Cache Group and Edge Cache, Delivery Service, and the Time
Range Picker as filters.
This chart is available only to Wholesale and OpenMD users.

Table Information
Formula
Chart Filters
Availability

Open Media Distribution Analytics User Guide, Release 1.0

57

Reports
This Reports feature allows you to view the daily, weekly, and monthly reports for the following:

OpenMD Traffic
Traffic Summary by Edge Cache
Traffic Summary by Delivery Services
Edge Cache Traffic
Delivery Server Traffic

NOTE: The information that follows is shown for Daily reports. Information for Weekly and Monthly reports, is also
available, with the same information, with the exception of time interval.
To access the Reports feature, from within the OpenMD main page, choose Analytics > Reports. The Report page is
displayed. For example:

OpenMD Traffic

Open Media Distribution Analytics User Guide, Release 1.0

The following table describes the chart within this dashlet:

Chart
OpenMD Traffic
Table Information

Description
Illustrates CDN Traffic for the past day in 5 minute intervals.
The information within this table is:
_time
Bandwidth
Total GB Delivered
Total GB Ingested
Cache Hits
Cache Misses
Cache Hit Ratio
Total Requests
4xx errors
5xx errors
Success %

Traffic Summary by Edge Caches

The following table describes the chart within this dashlet:
Chart
Traffic Summary by Edge Cache
Table Information

Description
Illustrates traffic summary at 5 minutes intervals for every Delivery Service.
The information within this table is:
Edge Cache
Bandwidth
Total GB Delivered
Total GB Ingested
Cache Hits
Cache Misses
Cache Hit Ratio
Total Requests
4xx errors
5xx errors
Success %

Open Media Distribution Analytics User Guide, Release 1.0

Traffic Summary by Delivery Services

The following table describes the chart within this dashlet:
Chart
Traffic Summary by Delivery Services
Table Information

Description
Illustrates traffic summary at 5 minutes intervals for every Delivery Service.
The information within this table is:
Delivery Service
Bandwidth
Total GB Delivered
Total GB Ingested
Cache Hits
Cache Misses
Cache Hit Ratio
Total Requests
4xx errors
5xx errors
Success %

Edge Cache Traffic

Open Media Distribution Analytics User Guide, Release 1.0

The following table describes the chart within this dashlet:

Chart
Edge Cache Traffic
Table Information

Description
Illustrates traffic summary at 5 minutes intervals for every Delivery Service.
The information within this table is:
_time
Bandwidth
Total GB Delivered
Total GB Ingested
Cache Hits
Cache Misses
Cache Hit Ratio
Total Requests
4xx errors
5xx errors
Success %

Delivery Service Traffic

The following table describes the chart within this dashlet:
Chart
Delivery Service Traffic
Table Information

Description
Illustrates traffic summary at 5 minutes intervals for every Delivery Service.
The information within this table is:
Delivery Service
Bandwidth
Total GB Delivered
Total GB Ingested
Cache Hits
Cache Misses
Cache Hit Ratio
Total Requests
4xx errors
5xx errors
Success %
Choose the required delivery service from the Delivery Service drop-down list located above the chart.

Open Media Distribution Analytics User Guide, Release 1.0

Custom Dashboards
This Custom Dashboards feature allows the OpenMD operators to create and save custom dashboards, using the search
application. You can view the list of all custom dashboards created by you and other users.
This feature specifically allows you to create, delete, and refresh custom dashboards. By default, the custom dashboards
are grouped by username.
To access the Custom Dashboards feature, from within the OpenMD main page, choose Analytics > Custom Dashboards.
The Analytics/Custom Dashboards page is displayed. For example:

If you have created a custom dashboard, to view the custom dashboards, click the arrow next to My Dashboards and
select the previously created custom dashboard that you want to view. The details will be displayed in the right pane.
NOTE: If you manually modify the savedsearches.conf file in the JS node, the savedsearches.conf file under the
Searchhead node will be updated and thereby, all the searches will be deleted.

Adding a Custom Dashboard

To add a custom dashboard, complete the following:
1. From within the OpenMD main page, select Analytics > Custom Dashboards.
2. Click on

Open Media Distribution Analytics User Guide, Release 1.0

3. In the right pane, enter the query in the Search field and click

4. Choose Save As > Dashboard Panel.

5. To save the Dashboard Panel to an existing dashboard, refer to step 7. To create a new dashboard, select New
and enter the following information:
Dashboard Title (Optional) Enter the custom dashboard title.
NOTE: It is recommend that you always start the custom dashboard names with the word Custom (or any
word other than dashboard). The usage of word Custom helps the users to add panels to existing custom
dashboard.

Dashboard ID Enter the custom dashboard ID.

NOTE: The custom dashboard ID can contain only alphanumeric characters and underscores.

Dashboard Description (Optional) Enter the custom dashboard description.

Dashboard Permissions Select the custom dashboard permissions as Private or Shared in App.
o Private You can only view and edit the custom dashboard.
o Shared in App All users can view the created custom dashboard.
Panel Title (Optional) Enter the panel title.
Panel Content Select the panel content as Statistics or Column.
o Statistics Displays data in table format.
o Column Displays data as column chart.
6. When finished, click Save.

Open Media Distribution Analytics User Guide, Release 1.0

7. To add a panel in an existing custom dashboard, in the Save As Dashboard Panel dialog box, click Existing.
8. From the drop-down list, choose the desired custom dashboard.
NOTE: You can only add panels to the custom dashboards that are created using the custom dashboard interface.
9. Enter the Panel Content by selecting the panel content as Statistics or Column.
Statistics Displays data in table format.
Column Displays data as column chart.
10. Click Save. Your Dashboard Panel h as b een Created dialog box appears.

11. Click View Dashboard.

NOTE: Refresh the custom dashboards by clicking

name in the tree view.

in the left pane to view the created custom dashboard

Deleting a Custom Dashboard

To delete a custom dashboard, complete the following:
1.
2.
3.
4.

Select Analytics > Custom Dashboards.

From the left pane, select the desired custom dashboard, which you want to delete.
Choose Delete from the Edit drop-down list. The Delete confirmation dialog box appears.
Click Delete.

NOTE: If you are deleting one or more searches, which is being used by one or more custom dashboards, then those
custom dashboards will not be functional. Also, the search saved as part of the custom dashboards will have to be deleted
manually.
Also, the deleted custom dashboard will be removed from the tree view only after clicking

Open Media Distribution Analytics User Guide, Release 1.0

in the left pane.

Sessions
The Sessions feature, allows you to analyze the data based on the end user session. You can also generate a session
report based on various filters. The following features are available within the Sessions feature:

Analyze by Client IP
Session Reports

Analyze by Client IP
The Analyze by Client IP feature provides a platform for users to analyze the individual client IP address, based on
various parameters, such as:

Sessions created for the IP address

Session duration
Protocol used to serve the content
Title viewed during the session

To access this feature, complete the following:

1. From within the OpenMD main page, select Analytics > Sessions > Analyze by Client IP.

2. Select the desired delivery service and the time range from the drop-down lists, and enter the exact Client IP
address in the search Client IP field. Click Search.

Open Media Distribution Analytics User Guide, Release 1.0

3. From within the sessions counts chart that is displayed, click the desired column. The session details will be
displayed below the session count chart.

Session Report
The Session Report feature provides a platform for the users to generate session reports, based on various parameters
such as Cache Group, Edge Cache, and Delivery Service.
To access this feature, complete the following:
1. From within the OpenMD main page, select Analytics > Sessions > Session Report.

2. Select the Cache Group, Edge Cache, Delivery Service, and Time Range Picker from the respective drop-down
lists and click Filter. The session report is displayed.
NOTE: By clicking the Client IP in the session report, you will be navigated to the Analyze by Client IP page with
the selected Client IP address pre-populated in the search Client IP field.

Open Media Distribution Analytics User Guide, Release 1.0

Open Media Distribution Analytics User Guide, Release 1.0

CHAPTER

Monitor

OpenMD hosts different content, such as live and archived, to viewers around the world. The OpenMD operator can
quickly check the performance of content distribution through real-time monitoring of the KPIs. The KPIs available for
real-time monitoring are: Bandwidth, Cache Hit Ratio, Unique Clients, and Responses.
NOTE: Only Throughput, Cache Hit Ratio, Unique Clients, and Responses charts are refreshed real-time (with minimum
delay).
To access this feature, click Monitor from the OpenMD main page.

Open Media Distribution Analytics User Guide, Release 1.0

OpenMD Overview
OpenMD Overview displays the number of delivery services, Edge Cache Servers, and Edge Cache Groups. These values
are refreshed every eight minutes.

Bandwidth
Illustrates the bandwidth consumed to deliver content.

The following table describes the chart within this dashlet:
Chart
Bandwidth
Chart Information

Description
Illustrates the bandwidth consumed to deliver content.
The information within this chart is shown in a line graph with Date/Time
along the X-axis and the Bandwidth in Gbps along the Y-axis.
This chart uses Edge Cache and Delivery Service, as filters.

Chart Filters

Open Media Distribution Analytics User Guide, Release 1.0

Cache Hit Ratio

Illustrates CDNs Cache Hit and Miss percentage in near real-time.

The following table describes the chart within this dashlet:
Chart
Cache Hit Ratio
Chart Information

Chart Filters

Description
Illustrates CDNs Cache Hit and Miss percentage in near real-time.
The information within this chart is shown in a stacked area graph with
Date/Time along the X-axis and the cache hit/miss percentage in the Y-axis.
The legends representing the graph are Cache Hit and Cache Miss.
This chart uses Edge Cache and Delivery Service, as filters.

Unique Clients
Provides the number of unique clients requesting content from to the CDN.

Open Media Distribution Analytics User Guide, Release 1.0

The following table describes the chart within this dashlet:

Chart
Unique Clients
Chart Information
Chart Filters

Description
Provides the number of unique clients requesting content from to the CDN.
The information within this chart is shown in a area graph with Date/Time
along the X-axis and the count in the Y-axis.
This chart uses Edge Cache and Delivery Service, as filters.

Responses
The Response chart provides response codes count or percentage at real-time.

The following table describes the chart within this dashlet:

Chart
Responses
Chart Information

Chart Filters

Description
Provides response codes count or percentage at real-time.
The information within this chart is shown in stacked area graph with
Date/Time along the X-axis with the response count or percentage along the
Y-axis. The legends representing the graph are 2xx, 3xx, 4xx, and 5xx..
This chart uses Edge Cache and Delivery Service, as filters.

Open Media Distribution Analytics User Guide, Release 1.0

CHAPTER

Alerts

Alerts Overview
Alerts are sent in the form of emails and are designed based on the results of your scheduled searches. Alerts highlight
the exceptions that occur as a result of exceeding the configured threshold criteria.

Adding a Threshold Alert

To add a threshold alert, from the OpenMD home page:
1. Select Alerts > Thresholds. The Alerts/Thresholds page is displayed.

2. Enter the following details in the Thresholds table:
Field
Alert Condition
Alert Name
Email Id

Description
Choose the condition for which the alert is to be triggered and specify the value.
Enter the Alert name.
Enter the email IDs to which the alerts are to be sent. Multiple email IDs can be added
separated by using commas.
Frequency
Specify the frequency for triggering the alert emails.
The alert will be sent at regular intervals based on the value that you configure in the Frequency field.
3. When finished, click Create.
The newly added alert appears in the Threshold Alerts table.

Open Media Distribution Analytics User Guide, Release 1.0

Deleting a Threshold Alert

To delete a threshold alert, complete the following:
From within the Open MD home page, choose Alerts > Thresholds. The Thresholds page is displayed.
2. In the Threshold Alerts table, click the Delete button next to the threshold alert that you want to delete.
3. Click OK to permanently delete the threshold alert in the confirmation dialog box.
4. Click Close to exit the Success dialog box.
1.

In the search query, use the pattern "$%operator%$" instead of comparison operator and
"$%thresholdValue%$" instead of comparison value.
NOTE:

You can also add a footer to the alert mails by replacing ". " with the custom message for footer_Text option, in
thresholds_alerts.conf file.
The newly added metric appears in the Thresholds page. After adding a new metric, replace the existing
savedsearches.conf file with savedsearches.conf back up file in the SH node.

Open Media Distribution Analytics User Guide, Release 1.0

Open Media Distribution Analytics User Guide, Release 1.0