Cisco Content Delivery System Manager User Guide

Add to my manuals
218 Pages

advertisement

Cisco Content Delivery System Manager User Guide | Manualzz

Videoscape Distribution Suite Service Manager User Guide

First Published: August 03, 2012

Last Modified: January 08, 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.

VDS Service Manager Analytics and Provisioning Portal User Guide

©

2015 Cisco Systems, Inc. All rights reserved.

C O N T E N T S

P r e f a c e

C H A P T E R 1

C H A P T E R 2

Preface xiii

Audience xiii

Document Conventions xiii

Document Organization xv

Reporting Problems xvi

Obtaining Documentation and Submitting a Service Request xvi

Getting Started 1

Getting Started 1

Configuring Videoscape Distribution Suite Service Manager 2

Configuring CSV Files 2

Configuring VDS-IS for VDS-SM 3

Enabling Transaction Log 4

Enabling Session Tracking for ABR Services 7

Verifying Log Ingestion in VDS-SM 8

Verifying Connectivity Between VDS-IS and VDS-SM 8

Checking for Data in VDS-SM 9

Introduction to Videoscape Distribution Suite Service Manager Portal's User Interface 11

Videoscape Distribution Suite Service Manager Overview 11

Logging Into the User Interface 12

Changing Your Password 12

Alert Counter 13

VDS-SM Portal's User Interface Overview 13

User Interface Components 15

Main Menu 17

About 17

Videoscape Distribution Suite Service Manager User Guide iii

Contents

C H A P T E R 3

Configuration Icons 18

Role Based Access Control 20

Home 25

Home Overview 25

Using the Scorecards 25

Network 28

Throughput 29

Concurrent Active Sessions 30

Cache Hit Ratio 31

Response Status Codes 32

Storage Usage 33

Protocol 34

Volume Delivered by Protocol 35

Total Requests by Protocol 36

Response Codes by Protocol 37

Cache Hit Ratio by Protocol 38

ABR Session Bitrate by Protocol 39

4xx Errors by Protocol 40

Content 41

Content by Client Request 41

Content by Bytes Transferred 42

Average ABR Session Bitrate by Content 43

Top Content by Delivery Server 44

Top Content by City 45

Top Content by Client Type 46

Viewers 47

Unique Viewers 48

Viewers by Client Type 49

Viewers by City 50

Viewers by ISP and Net Speed 51

Viewers by Download Size 52

Viewers by Session Duration 53

Content Origin 53

Enabling Ingest Transaction Log 54

iv

Videoscape Distribution Suite Service Manager User Guide

Contents

C H A P T E R 4

Ingest Requests 54

Origin/Ingest Volume 55

Bytes Read by Protocol 56

Download Speed 57

Ingest Response Codes 58

Origin Server Failures 59

Analytics 61

Analytics Overview 61

Analyze Metrics with Pivoting 61

Trends 63

Network 64

Volume 64

Throughput 64

Volume of Data Delivered 64

Delivery Services by Bytes Delivered 64

Origin/Ingest Volume 65

Average Download Speed 65

Predict Throughput 66

Caching 68

Cache Hit and Miss Rate by Request Count 68

% Cache Hit and Miss 69

Storage Usage 69

Cache Hit Ratio by Protocol 69

Request 70

Request Rate 70

Total Requests and Errors 70

Top Delivery Services by Request Count 71

Response 72

Response Count by Status Codes 72

Response Codes by Delivery Servers 72

Response Codes by Service Routers 73

Sorted Delivery Services by Client Errors on Delivery Servers 73

4xx Error Rate on Delivery Servers 74

4xx Error Rate on Service Routers 75

Videoscape Distribution Suite Service Manager User Guide v

Contents

Total Rejections due to Quota Limits 75

4xx Errors 76

Sorted Delivery Services by Client Errors on Service Routers 77

Response Codes by Protocol 77

4xx Errors by Protocol 77

Streaming 77

Sessions 78

Concurrent Active Sessions 78

Total Sessions by Protocol 78

Session Download Size 79

ABR 79

Bitrate 79

Bitrate Oscillations 80

Total Requests 80

Request Rate 81

MobiTV Client Log Analysis 82

Viewers 82

Number of Unique Viewers 82

Viewers by Client Type 83

Viewer Density by Location 83

Top Viewers 84

Viewers by Session Duration 84

Viewers by ISP, Net Speed 84

Viewers by Protocol 85

Viewers by Download Size 85

Content 85

Content by Client Requests 86

Content by Bytes Transferred 86

Top Content by Delivery Server 86

Average ABR Session Bitrate by Content 86

Top Content by City 86

Top Content by Client Type 86

Content Origin 87

Ingest Requests 87

Bytes Read 87

vi

Videoscape Distribution Suite Service Manager User Guide

Contents

Download Speed 88

Ingest Response Codes 88

Origin Server Failures 89

Billing 89

95/5 Billing 89

Pay Go Billing 91

Reports 92

Daily 92

CDN Traffic [5 min Intervals] 92

Traffic Summary by Delivery Servers 92

Traffic Summary by Delivery Services 93

Delivery Server Traffic [5 min Intervals] 94

Delivery Service Traffic [5 min Intervals] 94

All Assets - Video 95

All Assets - Non-Video 96

Weekly 96

CDN Traffic [1 hour Intervals] 96

Traffic Summary by Delivery Servers 97

Traffic Summary by Delivery Services 97

Delivery Server Traffic [1 hour Intervals] 98

Delivery Service Traffic [1 hour Intervals] 99

All Assets - Video 99

All Assets - Non-Video 100

Monthly 100

CDN Traffic [1 day Intervals] 100

Traffic Summary by Delivery Servers 101

Traffic Summary by Delivery Services 101

Delivery Server Traffic [1 day Intervals] 102

Delivery Service Traffic [1 day Intervals] 103

All Assets - Video 103

All Assets - Non-Video 104

Custom Searches and Reports 104

Creating a Custom Report 105

Deleting a Custom Report 106

Custom Dashboards 106

Videoscape Distribution Suite Service Manager User Guide vii

Contents

C H A P T E R 5

C H A P T E R 6

C H A P T E R 7

Adding a Custom Dashboard 106

Deleting a Custom Dashboard 109

Content 109

Analyze by Content Title 109

Viewership Report 122

Sessions 123

Analyze by Client IP 123

Session Report 124

Geo Analysis 125

Cache Hit Ratio by Location 125

Viewers Density by Location 125

Bytes Delivered by City 126

Average ABR Bitrate by City 127

4xx and 5xx Errors by City 127

North Bound Application Programming Interface 128

Monitor 131

Monitor Overview 131

Alerts 137

Alerts Overview 137

Managing Alerts 137

Bandwidth Alerts 137

Session Alerts 138

Storage Alerts 138

Configuration 139

VDS Manager Configuration 139

Multi-Tiered and Multi-Tenancy 139

Adding a CDN 140

Managing a VDS-IS CDN 141

Distribution Hierarchy Function Overview 142

Adding a Distribution Hierarchy 142

Modifying a Distribution Hierarchy 143

Cloning a Distribution Hierarchy 143

viii

Videoscape Distribution Suite Service Manager User Guide

Contents

C H A P T E R 8

Deleting a Distribution Hierarchy 144

Delivery Servers 144

Modifying a Delivery Server 144

URL Signing 145

Creating URL Signature 147

Editing URL Signature 147

Deleting URL Signature 148

Delivery Services 149

Adding a Delivery Service 149

Deleting a Delivery Service 152

Reseller Function Overview 152

Adding a Reseller 152

Modifying a Reseller 154

Deleting a Reseller 154

Content Provider Function Overview 154

Adding a Content Provider 155

Mapping a Content Provider and Delivery Service 156

Assigning Multiple Content Providers to a Single Delivery Service 157

Modifying a Content Provider 158

Deleting a Content Provider 158

Services 158

Geo Fencing 160

Assigning a Geo/IP file to a Delivery Service 160

Disassociating a Geo/IP file from a Delivery Service 161

Content Purging 161

Deleting Content 162

Administration 165

System Load Dashboard 165

License Usage 167

Managing Users and Roles Overview 168

About User Accounts 168

Roles 169

Adding a User 169

Deleting a User 170

Videoscape Distribution Suite Service Manager User Guide ix

Contents

C H A P T E R 9

Global Configurations 170

Adding Global Configurations 171

Deleting Global Configurations 171

CDN Health 171

Enabling Service Monitor Transaction Log 171

Enabling Service Monitor (SE) Transaction Log 172

Enabling Service Monitor (SR) Transaction Log 172

Monitor 172

CPU Usage 173

Memory Usage 174

Disk Usage 175

CPU Usage by Protocol Engines 176

Memory Usage by Protocol Engines 177

Stopped Protocol Engines 178

Threshold Exceeded Protocol Engines 179

Trend 179

Service Engine 179

CPU Usage 180

Memory Usage 181

Disk Usage 182

CPU Usage by Protocol Engines 183

Memory Usage by Protocol Engines 184

TCP Server Connections 185

TCP Client Connections 186

Service Router 187

CPU Usage 187

Memory Usage 188

Disk Usage 189

CPU Usage for Service Routing 190

Memory Usage for Service Routing 191

TCP Server Connections 192

TCP Client Connections 193

Troubleshooting 195

Troubleshooting Analytics Dashboards 195

x

Videoscape Distribution Suite Service Manager User Guide

Contents

Troubleshooting Splunk Licensing Issues 196

Troubleshooting Splunk Forwarder Issues 197

Troubleshooting the Splunk Indexer 198

Troubleshooting the Analytics Search Head 199

Troubleshooting VDS-IS Provisioning 201

Deleting Summarized Data 201

Splunk License Violation 202

Videoscape Distribution Suite Service Manager User Guide xi

Contents xii

Videoscape Distribution Suite Service Manager User Guide

Preface

Audience, page xiii

Document Conventions, page xiii

Document Organization, page xv

Reporting Problems, page xvi

Obtaining Documentation and Submitting a Service Request, page xvi

Audience

The Videoscape Distribution Suite Service Manager (VDS-SM) 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 Distribution Suite Internet

Streaming (VDS-IS) and other 3rd party Content Delivery Networks (CDNs).

Document Conventions

This document uses the following conventions:

Table 1: Document Conventions

Convention

^ or Ctrl bold font

Italic font

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.)

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

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

Videoscape Distribution Suite Service Manager User Guide xiii

Preface

Document Conventions

Convention

Courier font

|

Bold Courier font

[x]

...

[x | y]

{x | y}

[x {y | z}] string

< >

[ ]

!, #

Description

Terminal sessions and information, which the system displays appear in courier font.

Bold Courier font indicates the text that you must enter.

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.

Optional alternative keywords are grouped in brackets and separated by vertical bars.

Required alternative keywords are grouped in braces and separated by vertical bars.

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.

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 Means reader take note . Notes contain helpful suggestions or references to material, which is not covered in the manual.

Tip Means the following information will help you solve a problem.

xiv

Videoscape Distribution Suite Service Manager User Guide

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.

Document Organization

This document is organized into the following chapters:

Table 2: Document Organization

Chapter Description

Getting Started Provides information on getting started with VDS-SM 3.2.

Introduction to VDS-SM Portal's

User Interface

Describes the VDS-SM user interface and general framework.

Home

Analytics

Displays various scorecards such as Network, Protocol, Content, Viewers, and Content Origin.

Displays various dashboards such as Analyze Metrics with Pivoting,

Trends, Reports, and Geo Analysis.

Monitor

Alerts

Configuration

Administration

Displays various dashboards such as Throughput, Cache Hit Ratio, and

Responses, which helps the CDN Operators to check the performance of the network.

Displays Manage Alerts menu, which lists a count of events that are generated by the system.

Displays various dashboards such as Reseller and Content Provider.

Provides information on how to manage users and roles, an overview of the global configuration parameters, and dashboards to monitor the CDN health parameters.

Videoscape Distribution Suite Service Manager User Guide xv

Preface

Reporting Problems

Reporting Problems

If you have any query or experience problems when installing the VDS Service Manager 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 deliver content directly to your desktop using a reader application. The

RSS feeds are a free service.

xvi

Videoscape Distribution Suite Service Manager User Guide

C H A P T E R

1

Getting Started

Getting Started, page 1

Configuring Videoscape Distribution Suite Service Manager , page 2

Configuring CSV Files, page 2

Configuring VDS-IS for VDS-SM, page 3

Verifying Log Ingestion in VDS-SM, page 8

Verifying Connectivity Between VDS-IS and VDS-SM, page 8

Checking for Data in VDS-SM, page 9

Getting Started

The VDS-SM provides configuration, management, real-time analytics and monitoring, business policy enforcement, and other critical network intelligence for VDS-IS. The solution installs on a VM infrastructure and operates on a customer's traditional computing system or a Cisco UCS system. This allows more efficient and focused use of computing resources, memory, and disk space; thus resulting in a more efficient ratio of computing resources to application performance.

Before you begin, ensure that the following tasks are completed as part of installation:

• Run configure indexers script (for details, see the section Adding an Analytics Indexer to VDS-SM in the Software Installation Guide).

• Schedule getCDStopology script in cron (for details, see the section Deploying CDS System Delivery

Server/Services in Analytics Node in the Software Installation Guide).

• Install license

The software Installation Guide is available at http://www.cisco.com/c/dam/en/us/td/docs/video/ videoscape/ distribution_suite/vds/ v_3-2/b_VDS-SM_Installation_Guide_3-2

.pdf

.

To install the Splunk license, perform the following steps:

1 Copy the Splunk license file to your local machine, taking care to note the location, which will be used later in this procedure.

2 Open the Splunk manager app in the Job Scheduler.

Videoscape Distribution Suite Service Manager User Guide

1

Getting Started

Configuring Videoscape Distribution Suite Service Manager

Example, http://<IP of Job Scheduler>:8000/en-us/manager ( Username : Admin or admin Password:

Beaumaris1).

Note Do not change the above mentioned Splunk credentials. In the Change Password dialog box, click Skip and proceed.

3 Select Licensing .

4 Select Add License .

5 Browse your machine to the location where you copied the license file.

6 Select Install .

7 Return to the Licensing page and confirm whether the new license is added and is valid.

Note Do not change the Splunk license filename.

Configuring Videoscape Distribution Suite Service Manager

VDS-SM discovers topology of Content Delivery Network (Service Engine, Service Router, and Distribution

Hierarchy) and Delivery Services through CDSM. To initiate the discovery, you need to register the CDSM

IP address along with the user credentials that is required to connect to CDSM.

To configure VDS-SM, perform the following steps:

Step 1

Step 2

Login to VDS-SM using the link http:// UInode IP /bnimgmt

Username : bniadmin and Password : admin

From the main page, choose Configuration > CDN .

To add CDN, see

Adding a CDN, on page 140

Synchronization between VDS-SM and CDSM occurs at an interval of five minutes. After synchronization, the status will be displayed as ‘ Synchronization Successful ’ .

After synchronization, you can select the CDN and verify whether the devices and services information have been discovered.

Note Only Distribution Hierarchy and Delivery Services can be added or modified in VDS-SM.

Configuring CSV Files

VDS-SM uses CSV files to map certain attributes with the log events. These CSV files need to be configured optionally for filters and for certain dashlets to be reflected in the user interface. The CSV files are located in the Job Scheduler node at the following location ( Username : bnisplunk and Password : password):

2

Videoscape Distribution Suite Service Manager User Guide

Getting Started

Configuring VDS-IS for VDS-SM

/opt/splunk/etc/deployment-apps/appnormalize/lookups delivery_server_capacity.csv

This CSV file is used to enter the Bandwidth Capacity and Storage Capacity values for the Delivery Server that is being used.

These values will be reflected in Throughput and Storage Capacity dashlets (these charts are available in

Network scorecard and Trends).

provider_title.csv

This CSV file is used to map the Filename of the content played with its Title, Resolution, and Genre.

These values will be mapped under the respective filters in the Content scorecard.

useragent_device.csv

This CSV file is used to map the user agent by which the content is played to its meaningful name (user defined).

These values will be reflected in the Top Content by Client Type dashlet (this chart is available in Viewers scorecard and Trends). However, if this CSV is not updated manually, the dashlet will be displayed by fetching the actual user agent of the client.

Configuring VDS-IS for VDS-SM

VDS-SM uses transaction logs that are generated by Service Router (SR) and Service Engine (SE) for analysis.

Therefore, you need to configure SR and SE to enable logging and export them to VDS-SM.

Videoscape Distribution Suite Service Manager User Guide

3

Getting Started

Enabling Transaction Log

Note There is footer count mismatch issue in the older versions of VDS-IS 3.3 due to which the client session index will not be created. This will hinder certain dashlets from being populated in VDS-SM. Therefore, we recommend you to use the following versions of VDS-IS:

• VDS-IS 3.2.0(B33)

• VDS-IS 3.2.1(B11)

• VDS-IS 3.3

• VDS-IS 4.0

Enabling Transaction Log

To enable and export transaction logs, perform the following steps:

Step 1

Step 2

Step 3

Step 4

Step 5

Login to the CDSM UI.

Click Devices and select the required SE.

In the right pane, choose Service Control > Transaction Logging .

Check the Transaction Log Enable check box.

From the Log File Format drop-down list, choose custom format for CDNM option.

Step 6 From within Archive Settings , click every radio button and set the archive to 5 minutes (300 seconds).

4

Videoscape Distribution Suite Service Manager User Guide

Getting Started

Enabling Transaction Log

Step 7

Note VDS-SM recommends that the archival time be set to 5 minutes. Exceeding this time interval would result in missing events (logs), which might hinder the dashboards from being populated.

From within Splunk UF Export Settings (scroll down using the scroll bar), check the Export Enable check box, and check the type of logs that has to be logged (Snapshot Counter, FMS, Web Engine, ABR Session, WMT).

Step 8

Step 9

Enter the VDS-SM Forwarder IP in the Export Server field and click Submit .

The following steps are necessary to populate the network scorecards and other SR related dashlets in VDS-SM.

Select Devices and select the required SR.

Videoscape Distribution Suite Service Manager User Guide

5

Getting Started

Enabling Transaction Log

Step 10

Step 11

Step 12

In the right pane, choose General Settings > Notification and Tracking > Transaction Logging .

From within Archive Settings , click every radio button and set the archive to 5 minutes (300 seconds).

From within Splunk UF Export Settings (scroll down using the scroll bar), check the Export Enable check box, and check the type of logs that has to be logged (Snapshot Counter and Service Router).

6

Videoscape Distribution Suite Service Manager User Guide

Getting Started

Enabling Session Tracking for ABR Services

Enabling Session Tracking for ABR Services

VDS-SM uses ABR session logs to analyze ABR sessions. Although the ABR session log is enabled as part of the previous step, the log will be generated only if session tracking is configured for the delivery services.

You can configure session tracking using CDSM as mentioned below:

1 Choose Services and select the required delivery service.

2 In the left pane, choose Location settings and enable the required protocol (HSS and HLS based tracking).

For more information, refer page 248 in the VDS-IS User Guide ( http://www.cisco.com/en/US/docs/video/ cds/cda/is/3_0/configuration_guide/is_cds_3_0_config.pdf

)

CAVEAT : With VDS-IS 3.2, session tracking is supported only by SE at the edges. If SE from inner tiers are used to deliver content, then session tracking cannot be enabled on those SEs and the sessions will not be visible to VDS-SM.

Valid Rule File

A valid rule file must be present in CDSM to analyze the ABR protocols and bitrate fields. Choose System

> Configuration > Authorization File Registration (in the right pane).

Example

The following are rule file entries with fields for analyzing the ABR protocols :

<Rule_Allow matchGroup="grp1" protocol="http"/>

Videoscape Distribution Suite Service Manager User Guide

7

Getting Started

Verifying Log Ingestion in VDS-SM

<Rule_SetAction name="Rule_DSConfig" matchGroup="grp1" protocol="http">

<SetParameter name="SessionResolveRule#1" value="(.*) m3u8 (.*):none"/> //m3u8 is the extension of the video played

<SetParameter name="GenericSessionPlay#1" value="(.*) ts (.*):none"/>

<SetParameter name="SessionProtocol#1" value="(.*):protocol=$ generic_hls "/> //to map abr-protocol field from the log

<SetParameter name="SessionBitrate#1" value="(.*)sample/(.*)/(.*): bitrate =$2"/> //to map the bit rate fieldfrom the field

<SetParameter name="SessionProfile#1" value="(.*)sample/(.*)/(.*):profile=$2"/>

The following are sample log file entries that are mapped using the above rule file entries :

#Software: (CDS 3.2.0 b8) client-ip abr-protocol session-id manifest-uri asset-id bytes-sent bytes-recvd status time-recvd time-to-serve bitrate encryption session-tracking-mode status-code user-agent entry-gen-time mime-type profile

10.140.8.240

generic_hls 10f-I-617F44E4B4027469A848025065C227409629 http://hls.abr.com/sample/ sample .

m3u8 - 514515 1663 bitrate_shift [10/Jan/2013:05:52:53.710+0000]

Note Make sure that proper quotas (Storage, Bandwidth, Session) are being allotted to Delivery Services in

CDSM.

Verifying Log Ingestion in VDS-SM

After enabling the export of log data using Splunk UF, SE and SR will connect to the VDS-SM Forwarder node and start ingesting data. You can verify the data flow in the system as mentioned in the

Verifying

Connectivity Between VDS-IS and VDS-SM, on page 8

section.

Verifying Connectivity Between VDS-IS and VDS-SM

You need to check whether the connection has been established or not between SE, SR, and the Forwarder node.

To verify the connectivity between VDS-IS and VDS-SM, perform the following steps:

Step 1

Step 2

SSH to VDS-SM Forwarder node.

Username : bnisplunk and Password : password

Enter the command netstat -na | grep 9998

8

Videoscape Distribution Suite Service Manager User Guide

Getting Started

Checking for Data in VDS-SM

Connection must be established between SE, SR, and the Forwarder node.

If the connection is not established, verify the connectivity between VDS-SM Forwarder node and the nodes in CDN.

Checking for Data in VDS-SM

VDS-SM aggregates data at different intervals to compute metrics. Therefore, expect some delay for the data to reflect in the dashboards.

Note All the above steps need to be performed as a prerequisite before ingesting logs into VDS-SM.

The following table lists the different dashboards and the time they require to display the data:

Dashboard

Monitor

Network Scorecard

Protocol Scorecard

Content Scorecard

Viewers Scorecard

Trends

Content and Session

Analytics

Time Required

Less than 15 minutes

1 Hour

1 Hour

1 Day

1 Day

1 Day

1 Day

To check the data in VDS-SM, perform the following steps:

Step 1

Step 2

Login to VDS-SM using the link http://UInode IP/bnimgmt

Username : bniadmin and Password : admin

Choose Analytics > Custom Searches and Reports .

In the Search page, query for the respective index and check whether the data is indexed. After playing various video formats, the corresponding dashboards will be populated in VDS-SM.

Videoscape Distribution Suite Service Manager User Guide

9

Getting Started

Checking for Data in VDS-SM

Monitor dashboard can be used to check the data flow into VDS-SM at real-time (with minimal delay).

Dashboard

Network scorecard > 24 hours (default time)

Remarks

Displays data for the last 24 hours.

Network Scorecard > 60 minutes

Network Scorecard > 7 days

Protocol Scorecard > 60 minutes (default)

Protocol Scorecard > 24 hours

Protocol Scorecard > 7 days

Displays data for the last 60 minutes (current time minus

10 minutes).

Displays data for the last 7 days.

Displays data for the last 60 minutes (current time minus

10 minutes).

Displays data for the last 24 hours.

Displays data for the last 7 days.

Content Scorecard > Previous day (default)

Content Scorecard >7 days

Viewers Scorecard > Previous day (default)

Viewers Scorecard >7 days

Monitor

Trends

Displays the previous day's data.

Displays data for the last 7 days.

Displays the previous day's data.

Displays data for the last 7 days.

Displays data for every 5 minutes with 1 minute delay.

Displays data for last 7 days by default.

10

Videoscape Distribution Suite Service Manager User Guide

C H A P T E R

2

Introduction to Videoscape Distribution Suite

Service Manager Portal's User Interface

Videoscape Distribution Suite Service Manager Overview, page 11

VDS-SM Portal's User Interface Overview, page 13

User Interface Components, page 15

Role Based Access Control, page 20

Videoscape Distribution Suite Service Manager Overview

The VDS-SM provides configuration, management, real-time analytics and monitoring, business policy enforcement, and other critical network intelligence for VDS-IS. CDN hosts different content, such as live and archived, to viewers around the world. It helps the CDN Operators to quickly check the performance of the network.

The VDS Manager software includes the following major components:

• Analytics — Creates a fast searchable index of CDN streaming device log files for centralized access.

• Provisioning — Provides the Administration team the rights to create new Delivery Services and to control

CDN from the same interface, which is used for analytics retrieval.

• Reporting — Provides a single interface for provisioning and reporting CDN solutions that may reside in a single provider ’ s environment (for example, VDS-IS).

The application nodes that comprise the VDS-SM solution are Java applications deployed within a JBOSS application server, and is separated into distinct “ solutions ” , each of which provides a specific set of services for the overall application.

VDS-SM Application Nodes

The VDS-SM supports the following application nodes:

• Core Services

• User Interface

Videoscape Distribution Suite Service Manager User Guide

11

Introduction to Videoscape Distribution Suite Service Manager Portal's User Interface

Logging Into the User Interface

• CDN Manager

• Analytics

Core Services

The Core Services node includes the following:

• Management Interface — This interface provides service registry, and stores global configuration parameters, for the management of solution nodes.

• Database — Hosts the MySQL database that is used to store the configuration information including topology, solution tables, and registry information.

User Interface

Presents a User Interface where status, configuration, and analytics can be viewed by the Operator.

CDN Manager

Provides management services for CDN including Cisco VDS-IS.

Analytics

Analytics includes the following nodes:

• Search Head — Provides search and reporting functions.

• Forwarder — Manages the distribution of log data from CDN to Analytics Infrastructure for processing.

• Indexer — Processes log data to facilitate fast data retrieval and reporting.

• Job Scheduler — Provides job scheduling and functions as a deployment repository for the analytics software.

Logging Into the User Interface

Enter your Username and Password in the Login window.

By default, the username is bniadmin and the password is admin . If required, you can change the username and password after initial log in.

To log out of the user interface, click Logout , located on the top-right corner of the window.

Changing Your Password

To change your password, click the < User Profile > button, for example, bniadmin , located in the menu bar, to open the User Info dialog box.

12

Videoscape Distribution Suite Service Manager User Guide

Introduction to Videoscape Distribution Suite Service Manager Portal's User Interface

User Info Dialog

Alert Counter

To increase security, we recommend that you use a combination of letters, numbers and characters.

Alert Counter

The Alert Manager, which is accessed from the Alerts function, allows you to view the recently triggered alerts. It displays records of triggered alerts.

Following is a list of alerts:

• Application available – A service named in an alert has become available, meaning it has been recognized as in service by the system.

• Application unavailable – A service named in an alert became unavailable, meaning it is no longer visible on the network or is out of service.

• Delivery Service conflict – An alert is created when there is a conflict in the Device Service

• Device In Service – A topology device has transitioned to in service and is eligible to service requests, if it is operational.

• Device Out of Service – A topology device has transitioned to out of service and is not eligible to service requests, if it is operational.

Note Access the Alerts function by clicking Alerts from top-right of the main page.

VDS-SM Portal's User Interface Overview

This section provides an overview of the VDS-SM Portal's user interface.

Videoscape Distribution Suite Service Manager User Guide

13

VDS-SM Portal's User Interface Overview

Introduction to Videoscape Distribution Suite Service Manager Portal's User Interface

Note Before you access the VDS-SM Portal's user interface, you must deploy, install, and configure, all nodes in your network.

VDS-SM comprises the following functions:

Table 3: VDS-SM Functionalities & Description

Function

Home

Description

Displays the following scorecards:

• Network

• Protocol

• Content

• Viewers

• Content Origin

Analytics

Monitor

Alerts

Configuration

Displays the following menus and submenus:

• Analyze Metrics with Pivoting

• Trends

• Reports

• Customs Searches and Reports

• Custom Dashboards

• Content – Analyze by Content Title and

Viewership Report

• Sessions – Analyze by Client IP and Session

Report

• Geo Analysis

Helps the CDN Operators check the performance of the network.

Displays Manage Alerts menu.

Displays the following menus and submenus:

• CDN

• Customers – Reseller and Content Provider

• Services

• Geo Fencing

• Content Purging

14

Videoscape Distribution Suite Service Manager User Guide

Introduction to Videoscape Distribution Suite Service Manager Portal's User Interface

User Interface Components

Function

Administration

Description

Displays the following menus:

• System Load Dashboard

• License Usage

• User Management

• Global Configurations

• CDN Health – Monitor and Trend

User Interface Components

The user interface components are explained in the following table:

Table 4: User Interface Components

Component

User Profile

Alert Counter

About

Logout

Home

Description

To change your password, click the < User Profile > button; for example, bniadmin , located in the top-right corner of the window, to open the

User Info dialog box.

Note The button name displays the name of the user logged in.

Lists the alert notifications.

Click Alerts , located next to User Profile. It displays the alerts you set up.

Click About , located next to Alert, to display the About dialog box.

Click Logout , located next to Help, to log out from the application.

Displays the following scorecards:

• Network

• Protocol

• Content

• Viewers

• Content Origin

Videoscape Distribution Suite Service Manager User Guide

15

User Interface Components

Component

Analytics

Monitor

Alerts

Configuration

Administration

Introduction to Videoscape Distribution Suite Service Manager Portal's User Interface

Description

Displays the following menus and submenus:

• Analyze Metrics with Pivoting

• Trends

• Reports

• Customs Searches and Reports

• Custom Dashboards

• Content – Analyze by Content Title and Viewership Report

• Sessions – Analyze by Client IP and Session Report

• Geo Analysis

Displays the following dashlets:

• CDN Overview

• Throughput

• Cache Hit Ratio

• Concurrent Active Sessions

• Responses

• Bitrates

Displays the Manage Alerts menu.

Displays the following menus and submenus:

• CDN

• Customers – Reseller and Content Provider

• Services

• Geo Fencing

• Content Purging

Displays the following menus:

• System Load Dashboard

• License Usage

• User Management

• Global Configurations

• CDN Health – Monitor and Trend

16

Videoscape Distribution Suite Service Manager User Guide

Introduction to Videoscape Distribution Suite Service Manager Portal's User Interface

Main Menu

The main menu bar displays all VDS-SM tabs. Click the menus to view the submenus.

About

The VDS-SM Portal's About option lists the following information:

• Product Version Number

• Product Name

• Build Timestamp

• Build Number

• Build Java Version

• Software Licenses

• End User Licenses Agreement

To access this, click About at the top right of the page.

Main Menu

Videoscape Distribution Suite Service Manager User Guide

17

Configuration Icons

Introduction to Videoscape Distribution Suite Service Manager Portal's User Interface

Note Click the orange arrow next to the item to see more information.

Configuration Icons

VDS-SM portal provides various icons to perform configuration commands or to indicate operational status.

The following table lists all the icons included in the user interface.

Table 5: User Interface Icons

Icon Description

Go to Detail page

Create or Add

Delete

18

Videoscape Distribution Suite Service Manager User Guide

Introduction to Videoscape Distribution Suite Service Manager Portal's User Interface

Icon Description

Undo

Refresh

Disable

Enable

Clone

Import

Edit: in-line mode:

• Select: light gray

Edit: full-screen mode:

• Select: light gray

Edit: bulk mode:

• Select: light gray

• Deselect: dark gray

Edit: Item Selector

Information

Auto Refresh

Context Sensitive Help

Search; Filter

Notice

Normal

Added

Configuration Icons

Videoscape Distribution Suite Service Manager User Guide

19

Introduction to Videoscape Distribution Suite Service Manager Portal's User Interface

Role Based Access Control

Icon Description

Deleted

Edited

View

Export

Add Volumes

Remove Volumes

Operational State: Up

Operational State: Down

Synchronization

Role Based Access Control

Role Based Access Control (RBAC) is implemented in VDS-SM. Delivery Services and Providers drop-down lists are filtered, based on the user logged into the system.

The following figure shows the permissions granted for CDN Operator Admin, CDN Operator Viewer, Reseller

Admin, Reseller Viewer, Content Provider Admin, and Content Provider Viewer.

20

Videoscape Distribution Suite Service Manager User Guide

Introduction to Videoscape Distribution Suite Service Manager Portal's User Interface

Role Based Access Control

Access privileges are determined by the role assigned to the user. A user may be granted privileges for all or some system configuration and management functions.

The CDN Operator Admin and CDN Operator Viewer have access to almost all the functions in VDS-SM except for the following:

• CDN Operator Admin — Reseller Profile, Content Provider Profile, Monitor (Services page).

• CDN Operator Viewer — Reseller Profile, Content Provider Profile, System Load Dashboard, License

Usage, User Management, Monitor (Services page).

The following table lists the access privilege to Reseller Admin.

Main Menu and Navigation

Home > Scorecards

Reseller Admin

Delivery Service and Provider drop-down lists will be filtered for the Reseller.

View results and Analyze data link will not be available.

Analytics > Trends Delivery Service and Provider drop-down lists will be filtered for the Reseller.

Analytics > Reports

Analytics > Content > Analyze by Content Title

Analytics > Content > Viewership Report

Analytics > Sessions > Analyze by Client IP

Delivery Service and Provider drop-down lists will be filtered for the Reseller.

Delivery Service drop-down list will be filtered for the Reseller.

Delivery Service and Provider drop-down lists will be filtered for the Reseller.

Delivery Service and Provider drop-down lists will be filtered for the Reseller.

Videoscape Distribution Suite Service Manager User Guide

21

Introduction to Videoscape Distribution Suite Service Manager Portal's User Interface

Role Based Access Control

Main Menu and Navigation

Analytics > Sessions > Session Report

Configuration > Customers > Content Provider

Configuration > Content Purging

Administration > User Management

Monitor > Monitor (Services page)

Reseller Admin

Delivery Service and Provider drop-down lists will be filtered for the Reseller.

Displays the list of Content Providers (assigned to the Reseller) associated with the customer. A Reseller

Admin can create a Content Provider and assign delivery services.

Only the content deletion tasks will be displayed for the Reseller Admin.

Delivery Service and Provider drop-down lists will be filtered for the Reseller. A Reseller Admin has the privilege to create a Reseller Viewer, Content

Provider Admin, and Content Provider Viewer roles.

The data displayed in the screen is filtered, based on the logged in user.

The following table lists the access privilege to Reseller Viewer.

Main Menu and Navigation

Home > Scorecards

Reseller Viewer

Delivery Service and Provider drop-down lists will be filtered for the Reseller.

View results and Analyze data link will not be available.

Analytics > Trends

Analytics > Reports

Delivery Service and Provider drop-down lists will be filtered for the Reseller.

Delivery Service and Provider drop-down lists will be filtered for the Reseller.

Analytics > Content > Analyze by Content Title

Analytics > Content > Viewership Report

Analytics > Sessions > Analyze by Client IP

Analytics > Sessions > Session Report

Configuration > Customers > Content Provider

Delivery Service drop-down list will be filtered for the Reseller.

Delivery Service and Provider drop-down lists will be filtered for the Reseller.

Delivery Service and Provider drop-down lists will be filtered for the Reseller.

Delivery Service and Provider drop-down lists will be filtered for the Reseller.

Displays the list of Content Providers (assigned to the Reseller) associated with the customer.

22

Videoscape Distribution Suite Service Manager User Guide

Introduction to Videoscape Distribution Suite Service Manager Portal's User Interface

Role Based Access Control

Main Menu and Navigation

Configuration > Content Purging

Monitor > Monitor (Services page)

Reseller Viewer

Only the content deletion tasks will be displayed for the Reseller Viewer.

The data displayed in the screen is filtered, based on the logged in user.

The following table lists the access privilege to Content Provider Admin.

Main Menu and Navigation

Home > Scorecards

Content Provider Admin

Delivery Service and Provider drop-down lists will be filtered for the Content Provider.

View results and Analyze data link will not be available.

Analytics > Trends

Analytics > Reports

Data will be filtered for the respective Content

Provider.

Data will be filtered for the respective Content

Provider.

Analytics > Content > Analyze by Content Title

Analytics > Content > Viewership Report

Analytics > Sessions > Analyze by Client IP

Delivery Service drop-down list will be filtered for the respective Content Provider.

Delivery Service and Provider drop-down lists will be filtered for the respective Content Provider.

Delivery Service and Provider drop-down lists will be filtered for the respective Content Provider.

Analytics > Sessions > Session Report

Configuration > Content Purging

Configuration > Geo Fencing

Administration > User Management

Monitor > Monitor (Services page)

Delivery Service and Provider drop-down lists will be filtered for the respective Content Provider.

Option to choose Delivery Server is not available.

Content Provider Admin users can delete content from

Delivery Services associated to them.

Delivery Service drop-down list will be filtered for the respective Content Provider.

Data will be filtered for the respective Content

Provider. A Content Provider Admin has the Privilege to create a Content Provider Viewer role.

The data displayed in the screen is filtered, based on the logged in user.

Videoscape Distribution Suite Service Manager User Guide

23

Introduction to Videoscape Distribution Suite Service Manager Portal's User Interface

Role Based Access Control

The following table lists the access privilege to Content Provider Viewer.

Main Menu and Navigation

Home > Scorecards

Content Provider Viewer

Delivery Service and Provider drop-down lists will be filtered for the Content Provider.

View results and Analyze data link will not be available.

Analytics > Trends Data will be filtered for the respective Content

Provider.

Analytics > Reports

Analytics > Content > Analyze by Content Title

Analytics > Content > Viewership Report

Analytics > Sessions > Analyze by Client IP

Data will be filtered for the respective Content

Provider.

Delivery Service drop-down list will be filtered for the respective Content Provider.

Delivery Service and Provider drop-down lists will be filtered for the respective Content Provider.

Delivery Service and Provider drop-down lists will be filtered for the respective Content Provider.

Analytics > Sessions > Session Report

Configuration > Content Purging

Monitor > Monitor (Services page)

Delivery Service and Provider drop-down lists will be filtered for the respective Content Provider.

Only the content deletion tasks will be displayed for the Content Provider Viewer.

The data displayed in the screen is filtered, based on the logged in user.

Note The delivery server and delivery server group filters are not available for the wholesale users.

24

Videoscape Distribution Suite Service Manager User Guide

C H A P T E R

3

Home

Home Overview, page 25

Network, page 28

Protocol, page 34

Content, page 41

Viewers, page 47

Content Origin, page 53

Home Overview

The logs from VDS-IS are summarized and indexed in VDS-SM. The enormous information present in logs are displayed in charts to help the operators understand their CDN network. This provides an holistic view of a CDN.

On logging into the application, the Home page is displayed. It includes various scorecards. A scorecard is a dashboard, which displays specific information about network, protocol, content, viewers, and content origin data of managed CDN.

Home tab includes the following scorecards:

• Network

• Protocol

• Content

• Viewers

• Content Origin

Using the Scorecards

Using the scorecards, you can:

Videoscape Distribution Suite Service Manager User Guide

25

Using the Scorecards

Home

• Mouse hover a specific point within a chart, which displays additional information such as time and parameters.

• View results

Each chart provides access to view the log information corresponding to the dashlets. Click View results , located at the bottom left of each chart, to view the report.

From within the source report, you can choose a desired row to display the log details for the item.

26

Videoscape Distribution Suite Service Manager User Guide

Home

Using the Scorecards

• Analyze data

The chart in few scorecards contain data at a high-level. The CDN Operators have the option to drill down the data in the chart at a granular level. Click Analyze data , located at the bottom right of the chart, to view the details. Here, the CDN Operators can view the data plotted using various metrics over different dimensions that are split by the required dimension.

You can also view the data represented in different charts, such as line, bar, area and pie, by clicking the Chart type drop-down list, which appears after you click Analyze data .

Click Analyze , of , over , and split by drop-down lists and choose the required options. You can also choose the stack mode from the Stack mode drop-down list.

Legend

Depending on the chart, if more than one data set is displayed, a legend is located below the chart.

Lookups

Lookup is a process, which replaces the raw data from the logs with meaningful information. In VDS-SM, lookups are performed during summary index creation and chart rendition. CSV files and third party databases are used in the lookup operations.

Following is the list of lookups:

Lookup

Name

Description

Title

Genre,

Resolution

The raw logs do not contain any information on Genre and Resolution. Based on 'asset', the

Genre and Resolution are looked up from provider_title.csv file. This lookup is performed during summarization.

Bitrate

The raw logs has the URL field, which contains the 'asset' information. Lookup is performed on provider_title.csv file to get a meaningful Title name. This lookup is performed during summarization.

ISP, Net

Sped

The ABR traffic type's (HLS and MobiTV) raw logs have 'profile name' to indicate bitrate.

Lookup is performed on profilename_bitrate.csv to get the related bitrates for profile names.

This lookup is performed during summarization.

The raw logs do not contain information on ISP and Net Speed. It has ClientIP. Lookup is performed on Maxmind DB using ClientIP to get ISP and Net Speed. The Lookup works for public IP addresses. This lookup is performed during summarization.

Videoscape Distribution Suite Service Manager User Guide

27

Home

Network

Lookup

Name

City

Description

Client

Type

Capacity

The raw logs do not contain the City information. It has ClientIP. Lookup is performed on

Maxmind DB using ClientIP to get City. The Lookup works for public IP addresses. This lookup is performed during chart rendition.

The raw logs has User Agent related information. Lookup is performed on useragent_device.csv

file using User Agent to get Client Type. This lookup is performed during summarization.

Provider

Server

Topology

The Bandwidth and Storage capacity of Delivery Servers are maintained in the delivery_server_capacity.csv file. These capacity values are looked up and added to the summary indexes during summarization.

When CP lookup is implemented, users extract CP ID from the URL. Lookup is performed on content_provider.csv file using CP ID to get CP name. This lookup is performed during summarization.

Lookup is performed on the origin_server_topology.csv file to manage content origin dashboards.

This lookup is performed during summarization.

Network

When you launch the application, by default, the Network tab is displayed in the Home page. This scorecard displays charts that provides the users a quick overview on the overall performance of the network. By default, the data for the last 24 hours is displayed in the scorecard.

The following metrics are displayed here:

• Throughput (Gbps)

• Concurrent Active Sessions

• Cache Hit Ratio

• Response Status Codes

• Storage Usage

Note The Delivery Server Group filter grouping is based on the node locations.

28

Videoscape Distribution Suite Service Manager User Guide

Home

Throughput

Throughput

The following table describes the chart within this scorecard:

Table 6: Throughput Chart & Description

Chart

Throughput (Gbps)

Chart Information

Chart Formula

Chart Filters

Description

Illustrates the bandwidth delivered by the network, for the specified time interval.

The information within this chart is shown in a line graph with Date/Time along the X-axis and Peak

Throughput, Average Throughput, and Capacity in

Gbps along the Y-axis. The legends are Peak,

Average, and Capacity.

The formula used to derive the peak and average throughput graph is: the maximum and mean throughput for the specified time interval.

This chart uses Time Range (Last 60 Minutes, Last

24 Hours, and Last 7 days), Delivery Server Group,

Delivery Server, Provider, and Delivery Service as filters.

Note If requests are made directly to the service engine without the service router, this dashlet will not be displayed.

Videoscape Distribution Suite Service Manager User Guide

29

Concurrent Active Sessions

Concurrent Active Sessions

Home

The following table describes the chart within this scorecard:

Table 7: Concurrent Active Sessions Chart & Description

Chart

Concurrent Active Sessions

Chart Information

Chart Formula

Chart Filters

Description

Illustrates the concurrent active sessions, for the specified time interval.

The information within this chart is a line graph with

Date/Time along the X-axis and the Peak and Average

Count along the Y-axis. The legends representing the graph are Peak and Average.

The formula used to derive the graph is: calculate the maximum and mean active sessions, for the specified time interval.

This chart uses Time Range (Last 60 Minutes, Last

24 Hours, and Last 7 days), Delivery Server Group,

Delivery Server, Provider, and Delivery Service as filters.

30

Videoscape Distribution Suite Service Manager User Guide

Home

Cache Hit Ratio

Note If requests are made directly to service engine without service router, this dashlet will not be populated.

Cache Hit Ratio

The following table describes the chart within this scorecard:

Table 8: Cache Hit Ratio Chart & Description

Chart

Cache Hit Ratio

Chart Information

Chart Formula

Description

Provides client request cache hit and miss percentage, for the specified time interval.

The information within this chart is shown in a stacked area graph with Date/Time along the X-axis and the cache hit and miss percentage in the Y-axis.

The legends representing the graph are Cache Hit and

Cache Miss.

The formula used to derive the cache hit graph is: the percentage of cache hit over total requests. The formula used to derive the cache miss graph is: the percentage of cache miss over total requests.

Videoscape Distribution Suite Service Manager User Guide

31

Response Status Codes

Chart

Chart Filters

Response Status Codes

Home

Description

This chart uses Time Range (Last 60 Minutes, Last

24 Hours, and Last 7 days), Delivery Server Group,

Delivery Server, Provider, and Delivery Service as filters.

The following table describes the chart within this scorecard:

Table 9: Response Status Codes Chart & Description

Chart

Response Status Codes

Chart Information

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.

32

Videoscape Distribution Suite Service Manager User Guide

Home

Storage Usage

Chart

Chart Formula

Chart Filters

Description

The status code 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 total responses.

This chart uses Time Range (Last 60 Minutes, Last

24 Hours, and Last 7 days), Delivery Server Group,

Delivery Server, Provider, and Delivery Service as filters.

To view the response status code in percentage and count, click the respective radio buttons located above the chart.

Storage Usage

The following table describes the chart within this scorecard:

Videoscape Distribution Suite Service Manager User Guide

33

Home

Protocol

Table 10: Storage Usage Chart & Description

Chart

Storage Usage

Chart Information

Chart Formula

Chart Filters

Description

Illustrates the storage usage 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 storage usage as Prepositioned,

Dynamic, and Available in GB along the Y-axis. The legends representing the graph are Prepositioned,

Dynamic, and Available.

The prepositioned and dynamic values are derived by calculating the average of prepositioned and dynamic data, for the specified time interval. The available capacity is derived by calculating the difference between the storage capacity (as specified in the delivery_server_capacity.csv file) and the sum of prepositioned plus dynamic data.

This chart uses Time Range (Last 60 Minutes, Last

24 Hours, and Last 7 days), Delivery Server Group,

Delivery Server, Provider, and Delivery Service as filters.

Protocol

This tab displays charts that provides an overview of the network at the protocol level. By default, the data for the last 60 minutes is displayed in the scorecard.

To access this tab, choose Home > Protocol .

The following metrics are displayed here:

• 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

34

Videoscape Distribution Suite Service Manager User Guide

Home

Volume Delivered by Protocol

Volume Delivered by Protocol

The following table describes the chart within this scorecard:

Table 11: Volume Delivered by Protocol Chart & Description

Chart

Volume Delivered by Protocol

Chart Information

Chart Formula

Chart Filters

Description

Illustrates the volume delivered by each protocol, for the specified time interval.

The information within this chart is shown in a stacked area graph with Date/Time along the X-axis and the volume delivered in GB along the Y-axis.

The legends representing the graph are protocols.

The formula used to derive the graph is: Total of

CacheMissBytes, CacheHitBytes, and

NoCacheCodeBytes grouped by Protocol.

This chart uses Time Range (Last 60 Minutes, Last

24 Hours, and Last 7 days), Delivery Server Group,

Delivery Server, Provider, and Delivery Service as filters.

Videoscape Distribution Suite Service Manager User Guide

35

Home

Total Requests by Protocol

Total Requests by Protocol

The following table describes the chart within this scorecard:

Table 12: Total Requests by Protocol Chart & Description

Chart

Total Requests by Protocol

Chart Information

Chart Formula

Chart Filters

Description

Illustrates the number of requests received from each protocol, for the specified time interval.

The information within this chart is shown in a stacked area graph with Date/Time along the X-axis and the request Count along the Y-axis. The legends representing the graph are protocols.

The formula used to derive the graph is: Total

Requests is the sum of all Status Code Counts grouped by Protocol.

This chart uses Time Range (Last 60 Minutes, Last

24 Hours, and Last 7 days), Delivery Server Group,

Delivery Server, Provider, and Delivery Service as filters.

36

Videoscape Distribution Suite Service Manager User Guide

Home

Response Codes by Protocol

Response Codes by Protocol

The following table describes the chart within this scorecard:

Table 13: Response Codes by Protocol Chart & Description

Chart

Response Codes by Protocol

Chart Information

Chart Formula

Chart Filters

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 line graphs is: the count of individual response codes grouped by the response code and protocol.

This chart uses Time Range (Last 60 Minutes, Last

24 Hours, and Last 7 days), Delivery Server Group,

Delivery Server, Provider, and Delivery Service as filters.

Videoscape Distribution Suite Service Manager User Guide

37

Cache Hit Ratio by Protocol

Cache Hit Ratio by Protocol

Home

The following table describes the chart within this scorecard:

Table 14: Cache Hit Ratio by Protocol Chart & Description

Chart

Cache Hit Ratio by Protocol

Chart Information

Chart Formula

Chart Filters

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 (Last 60 Minutes, Last

24 Hours, and Last 7 days), Delivery Server Group,

Delivery Server, Provider, and Delivery Service as filters.

38

Videoscape Distribution Suite Service Manager User Guide

Home

ABR Session Bitrate by Protocol

ABR Session Bitrate by Protocol

The following table describes the chart within this scorecard:

Table 15: ABR Session Bitrate by Protocol Chart & Description

Chart

ABR Session Bitrate by Protocol

Chart Information

Chart Formula

Description

Provides HSS (HTTP smooth streaming), HLS (HTTP live streaming), and MobiTV average bitrate (Kbps).

Click the Protocol drop-down list and select the respective protocol to choose HSS, HLS, and

MobiTV.

The information within this chart is shown in a line graph with Date/Time along the X-axis and maximum, minimum, and average bitrate (Kbps) along the Y-axis. The legends representing the graph are maximum, minimum, and average.

The formula used to derive the line graphs is: calculate the maximum, minimum, and average of bitrate, for the specified time interval.

Videoscape Distribution Suite Service Manager User Guide

39

4xx Errors by Protocol

Chart

Chart Filters

4xx Errors by Protocol

Home

Description

This chart uses Time Range (Last 60 Minutes, Last

24 Hours, and Last 7 days), Delivery Server Group,

Delivery Server, Provider, and Delivery Service as filters.

The following table describes the chart within this scorecard:

Table 16: 4xx Errors by Protocol Chart & Description

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.

40

Videoscape Distribution Suite Service Manager User Guide

Home

Content

Chart

Chart Formula

Chart Filters

Description

The formula used to derive the graphs is: the count of 4xx errors in each protocol, for the specified time interval.

This chart uses Time Range (Last 60 Minutes, Last

24 Hours, and Last 7 days), Delivery Server Group,

Delivery Server, Provider, and Delivery Service as filters.

Content

This tab displays charts that provides an overview of the top content, based on different dimensions such as content by client request, bytes transferred, and average ABR session bitrate. By default, the data for the previous day is displayed in the scorecard.

To access this tab, click Home > Content .

The following metrics are displayed here:

• Content by Client Request

• Content by Bytes Transferred

• Average ABR Session Bitrate by Content

• Top Content by Delivery Server

• Top Content by City

• Top Content by Client Type

Content by Client Request

Videoscape Distribution Suite Service Manager User Guide

41

Home

Content by Bytes Transferred

The following table describes the chart within this scorecard:

Table 17: Content by Client Request Chart & Description

Chart

Content by Client Request

Chart Information

Chart Formula

Chart Filters

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 Time Range (Previous day and Last

7 days), Delivery Server Group, Delivery Server,

Provider, Service Type (Live and VOD), Delivery

Service, Resolution (HD and SD), and Genre as filters.

To view the top 10 content by client request and the bottom 10 content by client request, click the respective radio buttons located above the chart.

Content by Bytes Transferred

The following table describes the chart within this scorecard:

42

Videoscape Distribution Suite Service Manager User Guide

Home

Average ABR Session Bitrate by Content

Table 18: Content by Bytes Transferred Chart & Description

Chart

Content by Bytes Transferred

Chart Information

Chart Formula

Chart Filters

Description

Illustrates the most/least popular content, based on the download size.

The information within this chart is shown in a bar graph as MB 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 Time Range (Previous day and Last

7 days), Delivery Server Group, Delivery Server,

Provider, Service Type (Live and VOD), Delivery

Service, Resolution (HD and SD), and Genre as filters.

Note To view the top 10 content by bytes transferred and the bottom 10 content by bytes transferred, click the respective radio buttons located above the chart.

Average ABR Session Bitrate by Content

The following table describes the information in the tabular column:

Videoscape Distribution Suite Service Manager User Guide

43

Home

Top Content by Delivery Server

Table 19: Average ABR Session Bitrate by Content Table & Description

Table

Average ABR Session Bitrate by Content

Table Information

Formula

Filters

Description

Illustrates the content delivered with highest/lowest bitrate.

The information within this table are Title and

Average Bitrate.

The formula used is: the top/bottom content title by average bitrate.

This table uses Time Range (Previous day and Last

7 days), Delivery Server Group, Delivery Server,

Provider, Service Type (Live and VOD), Delivery

Service, Resolution (HD and SD), and Genre as filters.

Note To view the top 10 average ABR session bitrate by content and the bottom 10 average ABR session bitrate by content, click the respective radio buttons located above the table.

Top Content by Delivery Server

The following table describes the information in the tabular column:

Table 20: Top Content by Delivery Server Table & Description

Table

Top Content by Delivery Server

Table Information

Description

Illustrates the most popular content served by each delivery server.

The information within this table are Delivery Server,

Title, and Count.

44

Videoscape Distribution Suite Service Manager User Guide

Home

Table

Formula

Filters

Top Content by City

Top Content by City

Description

The formula used is: the top content title (based on count) by delivery server.

This table uses Time Range (Previous day and Last

7 days), Delivery Server Group, Delivery Server,

Provider, Service Type (Live and VOD), Delivery

Service, Resolution (HD and SD), and Genre as filters.

The following table describes the information in the tabular column:

Table 21: Top Content by City Table & Description

Table

Top Content by City

Table Information

Formula

Description

Illustrates the most popular content viewed in a city.

The information within this table are City, Title, and

Count.

The formula used is: the top content title (based on count) by city.

Videoscape Distribution Suite Service Manager User Guide

45

Home

Top Content by Client Type

Table

Filters

Description

This table uses Time Range (Previous day and Last

7 days), Delivery Server Group, Delivery Server,

Provider, Service Type (Live and VOD), Delivery

Service, Resolution (HD and SD), and Genre as filters.

To view the list of viewers accessing ISP and Net Speed network, click the respective radio buttons located above the chart.

Note The city will be resolved only for public IPs. IPs which cannot be resolved by MaxMind will not be displayed.

Top Content by Client Type

The following table describes the information in the tabular column:

Table 22: Top Content by Client Type Table & Description

Table

Top Content by Client Type

Table Information

Formula

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 are Client Type,

Title, and Count.

The formula used is: the top content title (based on count) by client type.

46

Videoscape Distribution Suite Service Manager User Guide

Home

Viewers

Table

Filters

Description

This table uses Time Range (Previous day and Last

7 days), Delivery Server Group, Delivery Server,

Provider, Service Type (Live and VOD), Delivery

Service, Resolution (HD and SD), and Genre as filters.

Viewers

This tab displays charts that explains the viewer density, based on different parameters such as city, ISP, Net speed, session duration, and download size. By default, the data for the previous day is displayed in the scorecard.

To access this tab, choose Home > Viewers .

The following metrics are displayed here:

• Unique Viewers

• Viewers by Client Type

• Viewers by City

• Viewers by ISP and Net Speed

• Viewers by Download Size

• Viewers by Session Duration

Videoscape Distribution Suite Service Manager User Guide

47

Home

Unique Viewers

Unique Viewers

The following table describes the chart within this scorecard:

Table 23: Unique Viewers Chart & Description

Table

Unique Viewers

Chart Information

Formula

Filters

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 Time Range (Previous Day and Last

7 Days), Delivery Server Group, Delivery Server,

Provider, Delivery Service, and Media Format as filters.

48

Videoscape Distribution Suite Service Manager User Guide

Home

Viewers by Client Type

Viewers by Client Type

The following table describes the information in the tabular column:

Table 24: Viewers by Client Type Table & Description

Table

Viewers by Client Type

Table Information

Formula

Filters

Description

Illustrates the number of viewers accessing the network through each client.

The information within this table are Client Type and

Count.

The formula used is: unique viewer by client type and request count.

This table uses Time Range (Previous Day and Last

7 Days), Delivery Server Group, Delivery Server,

Provider, Delivery Service, and Media Format as filters.

Videoscape Distribution Suite Service Manager User Guide

49

Home

Viewers by City

Viewers by City

The following table describes the information in the tabular column:

Table 25: Viewers by City Table & Description

Table

Viewers by City

Table Information

Formula

Filters

Description

Illustrates the number of viewers accessing the network in each city.

The information within this table are City and Count.

Note Viewers by city count appears in descending order of views.

The formula used is: the number of unique viewers in each city.

This table uses Time Range (Previous Day and Last

7 Days), Delivery Server Group, Delivery Server,

Provider, Delivery Service, and Media Format as filters.

Note The city will be resolved only for public IPs. IPs which cannot be resolved by MaxMind will not be displayed.

50

Videoscape Distribution Suite Service Manager User Guide

Home

Viewers by ISP and Net Speed

Viewers by ISP and Net Speed

The following table describes the information in the tabular column:

Table 26: Viewers by ISP and Net Speed Table & Description

Table

Viewers by ISP and Net Speed

Table Information

Formula

Filters

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 table uses Time Range (Previous Day and Last

7 Days), Delivery Server Group, Delivery Server,

Provider, Delivery Service, and Media Format as filters.

To view the list of viewers accessing ISP and Net Speed network, click the respective radio buttons located above the table.

Note Other than public IPs, "unknown" value will be displayed.

Videoscape Distribution Suite Service Manager User Guide

51

Home

Viewers by Download Size

Viewers by Download Size

The following table describes the information in the tabular column:

Table 27: Viewers by Download Size Table & Description

Table

Viewers by Download Size

Table Information

Formula

Filters

Description

Illustrates the number of viewers, based on the download size.

The information within this table are Download Size and Count.

The formula used is: the number of viewers bucketed by the download size in MB.

This table uses Time Range (Previous Day and Last

7 Days), Delivery Server Group, Delivery Server,

Provider, Delivery Service, and Media Format as filters.

52

Videoscape Distribution Suite Service Manager User Guide

Home

Viewers by Session Duration

Viewers by Session Duration

The following table describes the information in the tabular column:

Table 28: Viewers by Session Duration Table & Description

Table

Viewers by Session Duration

Table Information

Formula

Filters

Description

Illustrates the number of viewers, based on session duration.

The information within this table are Average Session

Duration (minutes) and Count.

The formula used is: the number of unique viewers bucketed by the average session duration.

This table uses Time Range (Previous Day and Last

7 Days), Delivery Server Group, Delivery Server,

Provider, Delivery Service, and Media Format as filters.

Content Origin

In VDS-IS, the ingest transaction logs are used to log details of every request sent to the upstream SEs and origin servers. The Content Origin scorecard contains the metrics derived from the ingest transaction logs.

These metrics provide insights into the interactions between Content Acquirers and Origin Servers.

To access this tab, click Home > Content Origin .

The following metrics are displayed here:

• Ingest Requests

• Origin/Ingest Volume

• Bytes Read by Protocol

• Download Speed

Videoscape Distribution Suite Service Manager User Guide

53

Home

Enabling Ingest Transaction Log

• Ingest Response Codes

• Origin Server Failures

Enabling Ingest Transaction Log

Content Origin charts will be displayed only when the Ingest transaction log is forwarded from VDS-IS to

VDS-SM. To enable and export Ingest transaction log, perform the following steps:

Note You can perform the below steps only if you have installed VDS-IS version that supports Ingest log functionality.

Step 1

Step 2

Step 3

Step 4

Step 5

Login to the CDSM UI.

Click Devices and select the required Service Engine.

In the right pane, choose Service Control > Transaction Logging .

From Monitors table, check the WMT Ingest and Web Engine Ingest check box.

Click Submit .

Ingest Requests

The following table describes the chart within this dashlet:

Table 29: Ingest Requests Chart & Description

Chart

Ingest Requests

Description

Illustrates the total number of requests (cache miss and revalidation) sent to origin server(s), for the specified time interval..

54

Videoscape Distribution Suite Service Manager User Guide

Home

Origin/Ingest Volume

Chart

Chart Information

Formula

Chart Filters

Description

The information within this chart is shown in a column graph with Date/Time along the X-axis and ingest request Count along the Y-axis.

The formula used to derive the graph is: Count of ingest requests from the content acquirer for the given time frame.

This chart uses Time Range, Origin Server, and

Content Acquirer as filters.

Note Revalidation-Request field is not applicable to WMT ingest logs.

Origin/Ingest Volume

The following table describes the chart within this scorecard:

Table 30: Origin/Ingest Volume Chart & Description

Chart

Origin/Ingest Volume

Description

Illustrates the comparison between Origin and Edge

Volume, for the specified time interval. Origin

Volume is the bytes read from the Origin Server(s).

Videoscape Distribution Suite Service Manager User Guide

55

Bytes Read by Protocol

Chart

Chart Information

Chart Formula

Chart Filters

Bytes Read by Protocol

Home

Description

The information within this chart is a line graph with

Date/Time along the X-axis and the Origin and Edge

Volume in GB along the Y-axis.

The formulae used to derive the graph are:

Origin — Total bytes read from Origin Server(s).

Edge — Total bytes delivered from edge SEs.

This chart uses Time Range, Origin Server, and

Content Acquirer as filters.

Note The Edge is unaffected by Origin Server and

Content Acquirer filters.

The following table describes the chart within this dashlet:

Table 31: Bytes Read by Protocol Chart & Description

Chart

Bytes Read by Protocol

Description

Illustrates the total bytes read from Origin Server(s) by traffic type, for the specified time interval.

56

Videoscape Distribution Suite Service Manager User Guide

Home

Chart

Chart Information

Formula

Chart Filters

Download Speed

Download Speed

Description

The information within this chart is shown in a stacked area graph with Date/Time along the X-axis and bytes read in GB along the Y-axis. The legends representing the graph are protocols.

The formula used to derive the graph is: Total bytes read from Origin Server(s) split by traffic type.

This chart uses Time Range, Origin Server, and

Content Acquirer as filters.

The following table describes the information in the tabular column:

Table 32: Download Speed Table & Description

Table

Download Speed

Table Information

Formula

Filters

Description

Illustrates the number of data ingests based on the download speed, for the specified time interval.

The information within this table are Download Speed

(MB/s) and Count.

The formula used is: Number of ingests based on the download speed.

This table uses Time Range, Origin Server, and

Content Acquirer as filters.

Videoscape Distribution Suite Service Manager User Guide

57

Home

Ingest Response Codes

Ingest Response Codes

The following table describes the chart within this dashlet:

Table 33: Ingest Response Codes Chart & Description

Chart

Ingest Response Codes

Chart Information

Formula

Chart Filters

Description

Illustrates the ingest response by status codes, for the specified time interval.

The information within this chart is shown in a bar graph with response Count along the X-axis and

Protocol type along the Y-axis. The legends representing the graph are status codes.

The formula used to derive the graph is: Count of ingest requests by status codes.

This chart uses Time Range, Origin Server, and

Content Acquirer as filters.

58

Videoscape Distribution Suite Service Manager User Guide

Home

Origin Server Failures

Origin Server Failures

The following table describes the chart within this dashlet:

Table 34: Origin Server Failures Chart & Description

Chart

Origin Server Failures

Chart Information

Formula

Chart Filters

Description

Illustrates the count of ingest requests that failed due to single server and all server, for the specified time interval.

The information within this chart is shown in a stacked area graph with Data/Time along the X-axis and Count of all server and single server failures along the Y-axis. The legends representing the graph are

All Server Failures and Single Server Failures.

The formulae used to derive the graph are:

Single Server Failures — Count of Server Failures encountered while processing ingest requests.

All Server Failures — Origin Server(s) with backup server(s) - All Origin Servers(s) failed.

This chart uses Time Range, and Content Acquirer as filters.

Note This chart is unaffected by Origin Server filter.

Videoscape Distribution Suite Service Manager User Guide

59

Origin Server Failures

Note FailoverAction field is not applicable to WMT ingest logs.

Home

60

Videoscape Distribution Suite Service Manager User Guide

C H A P T E R

4

Analytics

Analytics Overview, page 61

Analytics Overview

This section provides an overview of the VDS-SM Analytics, which provides the ability to view and analyze data that are collected about trends, reports, content, and sessions in textual and graphical form.

Data is pushed from various streaming devices to the Splunk Universal Forwarder, and then to the VDS-SM.

The data available is used to provide a multitude of historical search capabilities. Data is gathered using predefined indexing metrics, designed to provide data that is monitored by service provider operators. The data output is viewed in the form of a dashlet.

Analyze Metrics with Pivoting

This feature allows the CDN 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

• Concurrent Active Sessions

• GigaBytes Delivered

• Requests

• Response Codes

• Storage Usage

• Viewers

You can view the data in the following ways:

• On clicking the Both tab, the data will be displayed, in a tabular column and chart.

Videoscape Distribution Suite Service Manager User Guide

61

Analytics

Analyze Metrics with Pivoting

• On clicking the Table tab, the data will be displayed in a tabular column.

• On clicking the Chart tab, the data will be displayed in a chart/graph.

You can 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.

62

Videoscape Distribution Suite Service Manager User Guide

Analytics

Trends

To further enhance the analysis, three more dimensions namely Session Duration , Bytes Delivered , and City are added to the Viewers Category under the over and split by drop-down lists in Cisco VDS-SM Release

3.2.

Note We have assumed that the users are aware of selecting the relevant dimensions in both the drop-down lists to view the desired result.

To access this feature, perform the following steps:

Step 1

Step 2

Step 3

Choose Analytics > Analyze Metrics with Pivoting .

From the Pivot on: drop-down list, choose the category for which you need to analyze the data.

From the Analyze , of , over , and split by drop-down lists, choose the required options.

Note Make sure that you choose different options from over and split by drop-down lists.

Trends

This feature allows you to view the historical data (more than 7 days), in a graph and tabular column. VDS-SM

Analytics gather historical data from different perspectives, such as the following:

• Network

• Streaming

• Viewers

• Content

• Content Origin

• Billing

When you click each of these categories, the respective subcategories are expanded. On further expanding the subcategories, the respective dashlets are listed.

When each of these dashlets are 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 log information corresponding to the dashlet is 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.

Videoscape Distribution Suite Service Manager User Guide

63

Analytics

Trends

Network

Network trends dashboard provides an historical information on volume, caching, request, and response of the managed CDN network.

To access this feature, perform the following:

1. From the main page, choose Analytics > Trends .

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

This category includes data and charts for Throughput, Volume of Data Delivered, Delivery Services by Bytes

Delivered, Origin/Ingest Volume, Average Download Speed, and Predict Throughput.

Throughput

For details, see

Throughput , on page 29

Note This chart is available to the Wholesale users and CDN Operators.

Volume of Data Delivered

For details, see

Volume Delivered by Protocol , on page 35

Note This chart is available to the Wholesale users and CDN Operators.

Delivery Services by Bytes Delivered

The following table describes the chart within this dashlet:

64

Videoscape Distribution Suite Service Manager User Guide

Analytics

Trends

Table 35: Delivery Services by Bytes Delivered Chart & Description

Chart

Delivery Services by Bytes Delivered

Chart Information

Formula

Chart Filters

Availability

Description

Illustrates the top delivery services, based on the content delivered, for the specified time interval.

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.

The formula used to derive the graph is: Top 'n' delivery services by total bytes delivered.

This chart uses Delivery Server Group, Delivery

Server, Provider, Delivery Service, and the Time

Range Picker as filters.

This chart is available only to the CDN Operators.

You can also view the top delivery services, such as top 10 and top 20, by clicking the Sorting Criteria drop-down list.

Origin/Ingest Volume

For details, see

Origin/Ingest Volume, on page 55

Note This chart is available only to the CDN Operators.

Average Download Speed

The following table describes the chart within this dashlet:

Videoscape Distribution Suite Service Manager User Guide

65

Analytics

Trends

Table 36: Average Download Speed Chart & Description

Chart

Average Download Speed

Chart Information

Formula

Description

Illustrates the average download speed of the content providers, for the specified time interval.

The information within this chart is a line graph with

Date/Time along the X-axis and average download speed in KB\s along the Y-axis. The legends representing the graph are Content Providers.

The formula used to calculate average download speed is:

1 Dividing total bytes delivered by total time to serve.

2 Drop the lowest 15% of the download speeds and then calculate the average per Content Provider.

Chart Filters

Availability

This chart uses Content Provider, and Time Range

Picker as filters.

This chart is available only to the CDN Operators.

Predict Throughput

The following table describes Predict Throughput - Seasonal chart within this dashlet:

Table 37: Predict Throughput - Seasonal Chart & Description

Chart

Predict Throughput - Seasonal `

Description

Illustrates the predicted bandwidth of the network using the seasonal approach, for the specified time interval.

66

Videoscape Distribution Suite Service Manager User Guide

Analytics

Chart

Chart Information

Formula

Chart Filter

Availability

Trends

Description

The information within this chart is a line graph with

Date/Time along the X-axis and bandwidth in Gbps along the Y-axis. The legends representing the graph are Average Bandwidth, Ceiling, Floor, and Predicted

Bandwidth.

The formula used to derive the graph is: Take a series of throughput numbers observed over time and then apply Seasonal Local Level forecasting algorithm on these previous throughput numbers.

This chart uses Time Range Picker as filter.

This chart is available only to the CDN Operators.

The following table describes Predict Throughput - Trend chart within this dashlet:

Table 38: Predict Throughput - Trend Chart & Description

Chart

Predict Throughput - Trend

Chart Information

Formula

Chart Filter

Description

Illustrates the predicted bandwidth of the network by trend approach, for the specified time interval.

The information within this chart is a line graph with

Date/Time along the X-axis and bandwidth in Gbps along the Y-axis. The legends representing the graph are Average Bandwidth, Ceiling, Floor, and Predicted

Bandwidth.

The formula used to derive the graph is: Take a series of throughput numbers observed over time and then apply Local Level Trend forecasting algorithm on these previous throughput numbers.

This chart uses Time Range Picker as filter.

Videoscape Distribution Suite Service Manager User Guide

67

Analytics

Trends

Chart

Availability

Description

This chart is available only to the CDN Operators.

Caching

This category includes the data and charts for Cache Hit and Miss Rate by Request Count, % Cache Hit and

Miss, Storage Usage, and Cache Hit Ratio by Protocol.

Cache Hit and Miss Rate by Request Count

The following table describes the chart within this dashlet:

Table 39: Cache Hit and Miss Rate by Request Count Chart & Description

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 Delivery Server Group, Delivery

Server, Provider, Delivery Service, and the Time

Range Picker as filters.

This chart is available to the Wholesale users and

CDN Operators.

68

Videoscape Distribution Suite Service Manager User Guide

Analytics

% Cache Hit and Miss

Trends

The following table describes the chart within this dashlet:

Table 40: % Cache Hit and Miss Chart & Description

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 Delivery Server Group, Delivery

Server, Provider, Delivery Service, and the Time

Range Picker as filters.

This chart is available to the Wholesale users and

CDN Operators.

You can view the request served and bytes delivered by clicking the respective radio buttons.

Storage Usage

For details, see

Storage Usage, on page 33

Note This chart is available only to the CDN Operators.

Cache Hit Ratio by Protocol

For details, see

Cache Hit Ratio by Protocol, on page 38

Videoscape Distribution Suite Service Manager User Guide

69

Analytics

Trends

Note This chart is available only to the CDN Operators.

Request

Request Rate

This category includes data and charts for Request Rate, Total Requests and Errors, and Top Delivery Services by Request Count.

The following table describes the chart within this dashlet:

Table 41: Request Rate Chart & Description

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 Delivery Server Group, Delivery

Server, Provider, Delivery Service, and the Time

Range Picker as filters.

This chart is available to the Wholesale users and

CDN Operators.

Total Requests and Errors

70

Videoscape Distribution Suite Service Manager User Guide

Analytics

Trends

The following table describes the chart within this dashlet:

Table 42: Total Requests and Errors Chart & Description

Chart

Total Requests and Errors

Chart Information

Formula

Chart Filters

Availability

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 Delivery Server Group, Delivery

Server, Provider, Delivery Service, and the Time

Range Picker as filters.

This chart is available to the Wholesale users and

CDN Operators.

Top Delivery Services by Request Count

The following table describes the chart within this dashlet:

Table 43: Top Delivery Services by Request Count Chart & Description

Chart

Top Delivery Services by Request Count

Chart Information

Formula

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.

Videoscape Distribution Suite Service Manager User Guide

71

Analytics

Trends

Chart

Chart Filters

Availability

Description

This chart uses Delivery Server Group, Delivery

Server, Provider, Delivery Service, and the Time

Range Picker as filters.

This chart is available only to the CDN Operators.

Response

This category includes data and charts for Response Count by Status Codes, Response Codes by Delivery

Servers, Response Codes by Service Routers, Sorted Delivery Services by Client Errors on Delivery Servers,

4xx Error Rate on Delivery Servers, 4xx Error Rate on Service Routers, Total Rejections due to Quota Limits,

4xx Errors, Sorted Delivery Services by Client Errors on Service Routers, Response Codes by Protocol, and

4xx Errors by Protocol.

Response Count by Status Codes

For details, see

Response Status Codes, on page 32

Note This chart is available only to the CDN Operators.

Response Codes by Delivery Servers

The following table describes the chart within this dashlet:

Table 44: Response Codes by Delivery Servers Chart & Description

Chart

Response Codes by Delivery Servers

Chart Information

Formula

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 delivery server.

The information within this chart is a stacked bar graph with response Count along the X-axis and the

Delivery Server 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 delivery server.

72

Videoscape Distribution Suite Service Manager User Guide

Analytics

Chart

Chart Filters

Availability

Response Codes by Service Routers

Trends

Description

This chart uses Delivery Server Group, Delivery

Server, Provider, Delivery Service, and the Time

Range Picker as filters.

This chart is available only to the CDN Operators.

The following table describes the chart within this dashlet:

Table 45: Response Codes by Service Routers Chart & Description

Chart

Response Codes by Service Routers

Chart Information

Formula

Chart Filters

Availability

Description

Illustrates the responses that are grouped by status codes (client and server errors), for a given service router, for the specified time interval.

The information within this chart is a stacked area graph with response code Count along the X-axis and

Service Router along the Y-axis.

The formula used to derive the graph is: the number of responses grouped by the response codes for each service router.

This chart uses Service Router, Provider, Delivery

Service, and the Time Range Picker as filters.

This chart is available only to the CDN Operators.

Sorted Delivery Services by Client Errors on Delivery Servers

Videoscape Distribution Suite Service Manager User Guide

73

Analytics

Trends

The following table describes the chart within this dashlet:

Table 46: Sorted Delivery Services by Client Errors on Delivery Servers Chart & Description

Chart Description

Sorted Delivery Services by Client Errors on Delivery

Servers

Illustrates the top 10 delivery services by client errors.

Chart Information

Formula

The information within this chart is a bar graph with error Count along the X-axis and 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.

Chart Filters

Availability

This chart uses Delivery Server Group, Delivery

Server, Provider, Delivery Service, and the Time

Range Picker as filters.

This chart is available only to the CDN Operators.

4xx Error Rate on Delivery Servers

The following table describes the chart within this dashlet:

Table 47: 4xx Error Rate on Delivery Servers Chart & Description

Chart

4xx Error Rate on Delivery Servers

Chart Information

Formula

Chart Filters

Availability

Description

Illustrates the number of 4xx errors per second for each delivery server, 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 legends are Delivery Servers.

The formula used to derive the graph is: the number of errors per day for each delivery server.

This chart uses Delivery Server Group, Delivery

Server, Provider, Delivery Service, and the Time

Range Picker as filters.

This chart is available only to the CDN Operators.

74

Videoscape Distribution Suite Service Manager User Guide

Analytics

4xx Error Rate on Service Routers

Trends

The following table describes the chart within this dashlet:

Table 48: 4xx Error Rate on Service Routers Chart & Description

Chart

4xx Error Rate on Service Routers

Chart Information

Formula

Chart Filters

Availability

Description

Illustrates the number of 4xx errors per second for each service router, for the specified time interval.

The information within this chart is a line graph with

Date/Time along the X-axis and Errors/Second along the Y-axis. The legends are Service Routers.

The formula used to derive the graph is: the number of errors per second for each service router.

This chart uses Service Router, Provider, Delivery

Service, and the Time Range Picker as filters.

This chart is available only to the CDN Operators.

Total Rejections due to Quota Limits

The following table describes the chart within this dashlet:

Table 49: Total Rejections due to Quota Limits Chart & Description

Chart

Total Rejections due to Quota Limits

Description

Illustrates the number of sessions rejected due to quota limits, for the specified time interval.

Videoscape Distribution Suite Service Manager User Guide

75

Description

The information within this chart is a line graph with

Date/Time along the X-axis and Total Sessions and

Sessions Rejected along the Y-axis. The legends are

Total Sessions and Sessions Declined.

The formula used to derive the graph is: total requests and requests with response code 453 or 499 plotted over time.

This chart uses Delivery Server Group, Delivery

Server, Provider, Delivery Service, and the Time

Range Picker as filters.

This chart is available to the Wholesale users and

CDN Operators.

Analytics

Trends

4xx Errors

Chart

Chart Information

Formula

Chart Filters

Availability

The following table describes the chart within this dashlet:

Table 50: 4xx Errors Chart & Description

Chart

4xx Errors

Chart Information

Formula

Chart Filters

Availability

Description

Illustrates the number of 4xx errors for each delivery service over a selected period of time.

The information within this chart is a line graph with

Date/Time along the X-axis and Count along the

Y-axis.

The formula used to derive the graph is: the number of errors per day for each delivery service.

This chart uses Provider, Delivery Service, and the

Time Range Picker as filters.

This chart is available only to the wholesale users.

76

Videoscape Distribution Suite Service Manager User Guide

Analytics

Sorted Delivery Services by Client Errors on Service Routers

Trends

The following table describes the chart within this dashlet:

Table 51: Sorted Delivery Services by Client Errors on Service Routers Chart & Description

Chart Description

Sorted Delivery Services by Client Errors on Service

Routers

Illustrates the top 10 delivery services by client errors on service routers.

Chart Information

Formula

The information within this chart is a bar graph with error Count along the X-axis and Delivery Services along the Y-axis.

The formula used to derive the graph is: top 10 delivery services by the number of 4xx errors occurring at the service router.

Chart Filters

Availability

This chart uses Service Router, Provider, Delivery

Service, and the Time Range Picker as filters.

This chart is available only to the CDN Operators.

Response Codes by Protocol

For details, see

Response Codes by Protocol, on page 37

Note This chart is available only to the CDN Operators.

4xx Errors by Protocol

For details, see

4xx Errors by Protocol, on page 40

Note This chart is available only to the CDN Operators.

Streaming

Streaming trends dashboard provides an historical information on sessions and ABR of the managed CDN network.

To access this feature, perform the following steps:

1 From the main page, choose Analytics > Trends .

Videoscape Distribution Suite Service Manager User Guide

77

Analytics

Trends

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

The following subcategories are displayed in Streaming:

• Sessions

• ABR

Sessions

This category includes data and charts for Concurrent Active Sessions, Total Sessions by Protocol, and Session

Download Size.

Concurrent Active Sessions

For details, see

Concurrent Active Sessions, on page 30

Note This chart is available only to the CDN Operators.

Total Sessions by Protocol

The following table describes the chart within this dashlet:

Table 52: Total Sessions by Protocol Chart & Description

Chart

Total Sessions by Protocol

Chart Information

Formula

Chart Filters

Availability

Description

Illustrates the number of sessions by protocol, for the specified time interval.

The information within this chart is a stacked area graph with Date/Time along the X-axis and FMS,

HLS, HSS, PDL_WE, and WMS Count along the

Y-axis. The legends are FMS, HLS, HSS, PDL_WE, and WMS.

The formula used to derive the graph is: number of sessions grouped by protocol.

This chart uses Delivery Server Group, Delivery

Server, Provider, Delivery Service, and the Time

Range Picker as filters.

This chart is available only to the CDN Operators.

78

Videoscape Distribution Suite Service Manager User Guide

Analytics

Session Download Size

Trends

The following table describes the chart within this dashlet:

Table 53: Session Download Size Chart & Description

Chart

Session Download Size

Chart Information

Formula

Chart Filters

Availability

Description

Illustrates the maximum, minimum, and average bytes delivered per session, for the specified time interval.

The information within this chart is a line graph with

Date/Time along the X-axis and the Maximum,

Minimum, and Average download size in MB along the Y-axis. The legends are Maximum, Minimum, and Average.

The formula used to derive the graph is: the maximum, minimum, and average bytes delivered in

MB plotted over time.

This chart uses Delivery Server Group, Delivery

Server, Provider, Delivery Service, and the Time

Range Picker as filters.

This chart is available only to the CDN Operators.

ABR

Bitrate

For details, see

ABR Session Bitrate by Protocol, on page 39

Note This chart is available only to the CDN Operators.

Videoscape Distribution Suite Service Manager User Guide

79

Analytics

Trends

Bitrate Oscillations

Total Requests

The following table describes the chart within this dashlet:

Table 54: Bitrate Oscillations Chart & Description

Chart

Bitrate Oscillations

Chart Information

Formula

Chart Filters

Availability

Description

Illustrates the number of bitrate shifts for the specified time interval.

The information within this chart is a line graph with

Date/Time along the X-axis and bitrate oscillation

Count along the Y-axis.

The formula used to derive the graph is: bitrate shifts over time.

This chart uses Delivery Server Group, Delivery

Server, Provider, Delivery Service, and the Time

Range Picker as filters.

This chart is available only to the CDN Operators.

The following table describes the chart within this dashlet:

Table 55: Total Requests Chart & Description

Chart

Total Requests

Description

Illustrates the number of requests by traffic type (only

ABR), for the specified time interval.

80

Videoscape Distribution Suite Service Manager User Guide

Analytics

Chart

Chart Information

Request Rate

Formula

Chart Filters

Availability

Trends

Description

The information within this chart is a stacked area graph with Date/Time along the X-axis and the total request Count along the Y-axis. The legends are HLS,

MobiTV, and HSS.

The formula used to derive the graph is: the number of requests per ABR protocol.

This chart uses Delivery Server Group, Delivery

Server, Provider, Delivery Service, and the Time

Range Picker as filters.

This chart is available only to the CDN Operators.

The following table describes the chart within this dashlet:

Table 56: Request Rate Chart & Description

Chart

Request Rate

Chart Information

Formula

Chart Filters

Availability

Description

Illustrates the number of requests per second for each traffic type (HLS, HSS and MobiTV), for the specified time interval.

The information within this chart is a line graph with

Date/Time along the X-axis and the Requests per

Second along the Y-axis. The legends are HLS,

MobiTV, and HSS.

The formula used to derive the graph is: the number of requests per second for each traffic type of ABR protocol.

This chart uses Delivery Server Group, Delivery

Server, Provider, Delivery Service, and the Time

Range Picker as filters.

This chart is available only to the CDN Operators.

Videoscape Distribution Suite Service Manager User Guide

81

Analytics

Trends

MobiTV Client Log Analysis

The following table describes the chart within this dashlet:

Table 57: MobiTV Client Log Analysis Chart & Description

Chart

MobiTV Client Log Analysis

Chart Information

Formula

Chart Filters

Availability

Description

Illustrates the number of MobiTV client log events per category, for the specified time interval.

The information within this chart is a column graph with Date/Time along the X-axis and the MobiTV client event Count along the Y-axis. The legends are

MobiTV Client events.

The formula used to derive the graph is: the number of events for the specified event category split by events over time.

This chart uses Event Type Categories and Time

Range Picker as filters.

This chart is available only to the CDN Operators.

Viewers

Viewers trends dashboard provides an historical information on the 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, and viewers by download size on the managed CDN network.

To access this feature, perform the following:

1. From the main page, choose Analytics > Trends .

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

Number of Unique Viewers

For details, see

Unique Viewers, on page 48

82

Videoscape Distribution Suite Service Manager User Guide

Analytics

Note This chart is available to the Wholesale users and CDN Operators.

Viewers by Client Type

For details, see

Viewers by Client Type, on page 49

Note This chart is available to the Wholesale users and CDN Operators.

Viewer Density by Location

Trends

The following table describes the chart within this dashlet:

Table 58: Viewer Density by Location Chart & Description

Chart

Viewer Density by Location

Chart Information

Formula

Chart Filters

Availability

Description

Illustrates the viewer density per city, for a specified time interval.

The information within this table are City and Count.

The formula used to derive the table is: number of viewers in each city.

This table uses Delivery Server Group, Delivery

Server, Provider, Delivery Service, and the Time

Range Picker as filters.

This table is available to the Wholesale users and

CDN Operators.

Videoscape Distribution Suite Service Manager User Guide

83

Analytics

Trends

Top Viewers

The following table describes the chart within this dashlet:

Table 59: Top Viewers Chart & Description

Chart

Top Viewers

Chart Information

Formula

Chart Filters

Availability

Description

Illustrates the top viewers by total bytes delivered and request count, for a specified time interval.

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.

The formula used to derive the graph is: top 'n' viewers of requests and bytes delivered.

This chart uses Delivery Server Group, Delivery

Server, Provider, Delivery Service, and the Time

Range Picker as filters.

This chart is available to the Wholesale users and

CDN Operators.

You can 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

For details, see

Viewers by Session Duration, on page 53

Note This chart is available to the Wholesale users and CDN Operators.

Viewers by ISP, Net Speed

For details, see

Viewers by ISP and Net Speed, on page 51

84

Videoscape Distribution Suite Service Manager User Guide

Analytics

Note This chart is available to the Wholesale users and CDN Operators.

Viewers by Protocol

Trends

The following table describes the chart within this dashlet:

Table 60: Viewers by Protocol Chart & Description

Chart

Viewers by Protocol

Chart Information

Formula

Chart Filters

Availability

Description

Illustrates the number of viewers per protocol, for the specified time interval.

The information within this chart is a column graph with Protocol along the X-axis and viewer Count along the Y-axis.

The formula used to derive the graph is: number of viewers grouped by protocol.

This chart uses Delivery Server Group, Delivery

Server, Provider, Delivery Service, and the Time

Range Picker as filters.

This chart is available to the Wholesale users and

CDN Operators.

Viewers by Download Size

For details, see

Viewers by Download Size, on page 52

Note This chart is available to the Wholesale users and CDN Operators.

Content

Content trends dashboard provides an historical information on content by client requests, content by bytes transferred, top content by delivery server, average ABR session bitrate by content, top content by city, and top content by client type on the managed CDN network.

Videoscape Distribution Suite Service Manager User Guide

85

Trends

To access this feature, perform the following:

1. From the main page, choose Analytics > Trends .

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

Content by Client Requests

For details, see

Content by Client Request, on page 41

Note This chart is available to the Wholesale users and CDN Operators.

Content by Bytes Transferred

For details, see

Content by Bytes Transferred, on page 42

Note This chart is available to the Wholesale users and CDN Operators.

Top Content by Delivery Server

For details, see

Top Content by Delivery Server, on page 44

Note This chart is available only to the CDN Operators.

Average ABR Session Bitrate by Content

For details, see

Average ABR Session Bitrate by Content, on page 43

Note This chart is available only to the CDN Operators.

Top Content by City

For details, see

Top Content by City, on page 45

Note This chart is available to the Wholesale users and CDN Operators.

Top Content by Client Type

For details, see

Top Content by Client Type, on page 46

Note This chart is available to the Wholesale users and CDN Operators.

86

Videoscape Distribution Suite Service Manager User Guide

Analytics

Analytics

Trends

Content Origin

Content Origin trends dashboard provides historical information on ingest requests, bytes read, download speed, ingest response codes, and origin server failures on the managed CDN network.

To access this feature, perform the following:

1. From the main page, choose Analytics > Trends .

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

Note Content Origin charts will be displayed only when the Ingest transaction log is forwarded from VDS-IS to VDS-SM.

Ingest Requests

For details, see

Ingest Requests, on page 54

Note This chart is available only to the CDN Operators.

Bytes Read

For details, see

Bytes Read by Protocol, on page 56

Note This chart is available only to the CDN Operators.

Videoscape Distribution Suite Service Manager User Guide

87

Analytics

Trends

Download Speed

The following table describes the chart within this dashlet:

Table 61: Download Speed Chart & Description

Chart

Download Speed

Chart Information

Formula

Chart Filters

Availability

Description

Illustrates the download speed of data ingest, for the specified time interval.

The information within this chart is shown in a line graph with Date/Time along the X-axis and the download speed in MB/s along the Y-axis.

The formula used to derive the graph is: Total bytes read by total download duration with respect to time intervals.

This chart uses Origin Server, Content Acquirer, and

Time Range picker as filters.

This chart is available only to the CDN Operators.

Ingest Response Codes

For details, see

Ingest Response Codes, on page 58

88

Videoscape Distribution Suite Service Manager User Guide

Analytics

Trends

Note This chart is available only to the CDN Operators.

Origin Server Failures

For details, see

Origin Server Failures, on page 59

Note This chart is available only to the CDN Operators.

Billing

Billing trends dashboard provides an historical information on 95/5 billing and Pay Go Billing on the managed

CDN network.

To access this feature, perform the following:

1. From the main page, choose Analytics > Trends .

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

95/5 Billing

The following table describes the chart within this dashlet:

Table 62: 95/5 Billing Chart & Description

Chart

95/5 Billing

Chart Information

Formula

Description

Illustrates the billing data of previous months, which uses the 95/5 billing method.

The information within this chart is an area graph with Date/Time along the X-axis and Bandwidth in

Mbps along Y-axis.

The formula used to derive this is: The average bandwidth from SR Snapshot log by hour. The red line is the 95/5 high bandwidth within the whole month.

Videoscape Distribution Suite Service Manager User Guide

89

Trends

Analytics

Chart

Chart Filters

Availability

Description

This chart uses Month and Delivery Service as filters.

This chart is available only to the CDN Operators.

Billing Functionalities

By default, billing will be automatically generated daily at 21:30. It creates the billing csv file (detail, summary) for the delivery services in the delivery_service_topology.csv file, which has the billing item.

The path to view the billing.csv is:

Go to LWF node and navigate to /home/bnisplunk/data/billing

Running billing manually

To run the billing manually, perform the following steps:

1 Login to the JS node and navigate to opt/splunk/etc/apps/CDN_JS/bin

2 In the above path, run ./hourlyDataCheck.sh -F YYYYMMDD (replace the date for which hourlyDataCheck needs to be executed).

The above mentioned script, marks the status as FIXED for every hour of that date in the

"cdn_billing_session" index, which means there are NO missing logs.

To verify this, perform the following steps: a) Login to JS node and navigate to / opt/splunk/bin b) Run ./splunk search 'index=cdn_billing_session | table Status,TimeId .

c) Enter the username and password; Username : admin and Password : Beaumaris1 d) Check the status by verifying that the record is "FIXED YYYYMMDD". This implies that it is in FIXED status for all 24 hours in date YYYYMMDD.

3 In the path mentioned in step 1, run ./repeatCheck.sh -F YYYYMMDD (replace the date for which repeatCheck needs to be executed).

This will mark the status as FORCED for every hour of that date in the "cdn_billing_session" index. Also, an "INDEXED" record for that day is created. This implies that all the logs of that date are indexed. You can verify this by performing the following steps: a) Login to the JS node and navigate to /opt/splunk/bin b) Run ./splunk search 'index=cdn_billing_session | table Status,TimeId' c) Enter the username and password; Username : admin and Password : Beaumaris1 d) Check the status by verifying that the record is "INDEXED YYYYMMDD. This implies that the date

YYYYMMDD is already indexed.

4 Login to the LWF node and navigate to opt/splunkforwarder/etc/apps/Billing/bin and run ./billing.sh

. The billing files will be generated under the dir "/home/bnisplunk/data/billing".

a) Login to the JS node and navigate to /opt/splunk/bin b) Run ./splunk search 'index=cdn_billing_session | table Status,TimeId.

c) Enter the username and password; Username : admin and Password : Beaumaris1

90

Videoscape Distribution Suite Service Manager User Guide

Analytics

Trends

Pay Go Billing d) Check the status by verifying that the record is "BILLED YYYYMMDD". This implies that billing records have been generated for the date YYYYMMDD.

The generated CSV files will have the following fields:

Detailed csv

Delivery_Service:<Delivery Service Name> FQDN:<fqdn> provider:<Provider Name> reseller:<Reseller

Name> StartTime,EndTime,ClientIP,ServerIP,URL,MB_Bytes_Delivered,error_code

Summary csv

Date,Total_GB_Bytes_Delivered,Total_Session_Declined_due_to_quota_limits,Total_Sessions_Delivered

The following table describes the chart within this dashlet:

Table 63: Pay Go Billing Chart & Description

Chart

Pay Go Billing

Chart Information

Formula

Chart Filters

Availability

Description

Illustrates the volume delivered, which is calculated based on the pay as you go method of billing.

The information within this chart is a column graph with Date/Time along the X-axis and volume delivered in GB along the Y-axis.

The formula used to derive this chart is: flat traffic volume is computed as trapezoid area over flat throughput in a five minute slot.

This chart uses Delivery Service, Time Range Picker, and Span (5 minutes, 1 hour, 1 day) as filters.

This chart is available only to the CDN Operators.

Videoscape Distribution Suite Service Manager User Guide

91

Analytics

Reports

Reports

This feature allows you to view the daily, weekly, and monthly reports for CDN traffic, traffic summary by delivery servers, traffic summary by delivery services, delivery server traffic, delivery service traffic, all assets

- video, and all assets - non-video.

To access this feature, from the main page, choose Analytics > Reports .

Daily

To view the daily reports, select Daily from the Reports main page.

CDN Traffic [5 min Intervals]

Table 64: CDN Traffic [5 min Intervals] Table & Description

Table

CDN Traffic [5 min Intervals]

Table Information

Description

Illustrates CDN Traffic for the past day in 5 minute intervals.

The information within this table is: _time, peak bandwidth, mean bandwidth, bandwidth peak mean ratio, 95%ile bandwidth, total GB delivered, total GB ingested, cache hits, cache misses, cache hit ratio, mean sessions, peak sessions, sessions peak mean ratio, 95%ile sessions, total requests, successful requests, unsuccessful requests, 4xx errors, 5xx errors, success %.

Traffic Summary by Delivery Servers

92

Videoscape Distribution Suite Service Manager User Guide

Analytics

Reports

Table 65: Traffic Summary by Delivery Servers Table & Description

Table

Traffic Summary by Delivery Servers

Information

Description

Illustrates the traffic summary for the past day for each delivery server.

The information within this table is: delivery server, peak bandwidth, mean bandwidth, bandwidth peak mean ratio, 95%ile bandwidth, total GB delivered, total GB ingested, cache hits, cache misses, cache hit ratio, mean sessions, peak sessions, sessions peak mean ratio, 95%ile sessions, total requests, successful requests, unsuccessful requests, 4xx errors, 5xx errors, success %.

Traffic Summary by Delivery Services

Table 66: Traffic Summary by Delivery Services Table & Description

Table

Traffic Summary by Delivery Services

Information

Description

Illustrates the traffic summary for the past day for each delivery service.

The information within this table is: delivery service, peak bandwidth, mean bandwidth, bandwidth peak mean ratio, 95%ile bandwidth, total GB delivered, total GB ingested, cache hits, cache misses, cache hit ratio, mean sessions, peak sessions, sessions peak mean ratio, 95%ile sessions, total requests, successful requests, unsuccessful requests, 4xx errors, 5xx errors, success %.

Videoscape Distribution Suite Service Manager User Guide

93

Analytics

Reports

Delivery Server Traffic [5 min Intervals]

Table 67: Delivery Server Traffic [5 min Intervals] Table & Description

Table

Delivery Server Traffic [5 min Intervals]

Information

Description

Illustrates the delivery server traffic details for a selected delivery server in 5 minute intervals

The information within this table is: _time, peak bandwidth, mean bandwidth, bandwidth peak mean ratio, 95%ile bandwidth, total GB delivered, total GB ingested, cache hits, cache misses, cache hit ratio, mean sessions, peak sessions, sessions peak mean ratio, 95%ile sessions, total requests, successful requests, unsuccessful requests, 4xx errors, 5xx errors, success %.

Choose the required delivery server from the Delivery Server drop-down list located above the chart.

Delivery Service Traffic [5 min Intervals]

94

Videoscape Distribution Suite Service Manager User Guide

Analytics

Reports

Table 68: Delivery Service Traffic [5 min Intervals] Table & Description

Table

Delivery Service Traffic [5 min Intervals]

Information

Description

Illustrates the delivery service traffic details for a selected delivery service in 5 minute intervals.

The information within this table is: _time, peak bandwidth, mean bandwidth, bandwidth peak mean ratio, 95%ile bandwidth, total GB delivered, total GB ingested, cache hits, cache misses, cache hit ratio, mean sessions, peak sessions, sessions peak mean ratio, 95%ile sessions, total requests, successful requests, unsuccessful requests, 4xx errors, 5xx errors, success %.

Choose the required delivery service from the Delivery Service drop-down list located above the chart.

All Assets - Video

Table 69: All Assets - Video Table & Description

Table

All Assets - Video

Information

Description

Illustrates various metrics for video assets for the past day.

The information within this table is: URL, Plays,

UniqueUsers, Bytes, Minutes, MinutesPerPlay,

MinutesPerUser, and PlaysPerUser.

Choose the required delivery service from the Delivery Service drop-down list located above the chart.

Videoscape Distribution Suite Service Manager User Guide

95

Analytics

Reports

All Assets - Non-Video

Table 70: All Assets - Non-Video Table & Description

Table

All Assets - Non-Video

Information

Description

Illustrates various metrics for non-video assets for the past day.

The information within this table is: URL, Bytes,

Requests, and UniqueUsers.

Choose the required delivery service from the Delivery Service drop-down list located above the chart.

Weekly

To view the daily reports, select Weekly from the Reports main page.

CDN Traffic [1 hour Intervals]

Table 71: CDN Traffic [1 hour Intervals] Table & Description

Table

CDN Traffic [1 hour Intervals]

Description

Illustrates CDN Traffic for the past week in 1 hour intervals.

96

Videoscape Distribution Suite Service Manager User Guide

Analytics

Table

Information

Reports

Description

The information within this table is: _time, peak bandwidth, mean bandwidth, bandwidth peak mean ratio, 95%ile bandwidth, total GB delivered, total GB ingested, cache hits, cache misses, cache hit ratio, mean sessions, peak sessions, sessions peak mean ratio, 95%ile sessions, total requests, successful requests, unsuccessful requests, 4xx errors, 5xx errors, success %.

Traffic Summary by Delivery Servers

Table 72: Traffic Summary by Delivery Servers Table & Description

Table

Traffic Summary by Delivery Servers

Information

Description

Illustrates the traffic summary for the past week for each delivery server.

The information within this table is: delivery server, peak bandwidth, mean bandwidth, bandwidth peak mean ratio, 95%ile bandwidth, total GB delivered, total GB ingested, cache hits, cache misses, cache hit ratio, mean sessions, peak sessions, sessions peak mean ratio, 95%ile sessions, total requests, successful requests, unsuccessful requests, 4xx errors, 5xx errors, success %.

Traffic Summary by Delivery Services

Videoscape Distribution Suite Service Manager User Guide

97

Analytics

Reports

Table 73: Traffic Summary by Delivery Services Table & Description

Chart

Traffic Summary by Delivery Services

Information

Description

Illustrates the traffic summary for the past week for each delivery service.

The information within this table is: delivery service, peak bandwidth, mean bandwidth, bandwidth peak mean ratio, 95%ile bandwidth, total GB delivered, total GB ingested, cache hits, cache misses, cache hit ratio, mean sessions, peak sessions, sessions peak mean ratio, 95%ile sessions, total requests, successful requests, unsuccessful requests, 4xx errors, 5xx errors, success %.

Delivery Server Traffic [1 hour Intervals]

Table 74: Delivery Server Traffic [1 hour Intervals] Table & Description

Table

Delivery Server Traffic [1 hour Intervals]

Information

Description

Illustrates the delivery server traffic details for a selected delivery server in 1 hour intervals

The information within this table is: _time, peak bandwidth, mean bandwidth, bandwidth peak mean ratio, 95%ile bandwidth, total GB delivered, total GB ingested, cache hits, cache misses, cache hit ratio, mean sessions, peak sessions, sessions peak mean ratio, 95%ile sessions, total requests, successful requests, unsuccessful requests, 4xx errors, 5xx errors, success %.

Choose the required delivery server from the Delivery Server drop-down list located above the chart.

98

Videoscape Distribution Suite Service Manager User Guide

Analytics

Delivery Service Traffic [1 hour Intervals]

Reports

Table 75: Delivery Service Traffic [1 hour Intervals] Table & Description

Table

Delivery Service Traffic [1 hour Intervals]

Information

Description

Illustrates the delivery service traffic details for a selected delivery service in 1 hour intervals.

The information within this table is: _time, peak bandwidth, mean bandwidth, bandwidth peak mean ratio, 95%ile bandwidth, total GB delivered, total GB ingested, cache hits, cache misses, cache hit ratio, mean sessions, peak sessions, sessions peak mean ratio, 95%ile sessions, total requests, successful requests, unsuccessful requests, 4xx errors, 5xx errors, success %.

Choose the required delivery service from the Delivery Service drop-down list located above the chart.

All Assets - Video

Table 76: All Assets - Video Table & Description

Table

All Assets - Video

Information

Description

Illustrates various metrics for video assets for the past week.

The information within this table is: URL, Plays,

UniqueUsers, Bytes, Minutes, MinutesPerPlay,

MinutesPerUser, and PlaysPerUser.

Videoscape Distribution Suite Service Manager User Guide

99

Analytics

Reports

Choose the required delivery service from the Delivery Service drop-down list located above the chart.

All Assets - Non-Video

Table 77: All Assets - Non-Video Table & Description

Table

All Assets - Non-Video

Information

Description

Illustrates various metrics for non-video assets for the past week.

The information within this table is: URL, Bytes,

Requests, and UniqueUsers.

Choose the required delivery service from the Delivery Service drop-down list located above the chart.

Monthly

To view the daily reports, select Monthly from the Reports main page.

CDN Traffic [1 day Intervals]

Table 78: CDN Traffic [1 day Intervals] Table & Description

Table

CDN Traffic [1 hour Intervals]

Description

Illustrates CDN Traffic for the past month in 1 day intervals.

100

Videoscape Distribution Suite Service Manager User Guide

Analytics

Table

Information

Reports

Description

The information within this table is: _time, peak bandwidth, mean bandwidth, bandwidth peak mean ratio, 95%ile bandwidth, total GB delivered, total GB ingested, cache hits, cache misses, cache hit ratio, mean sessions, peak sessions, sessions peak mean ratio, 95%ile sessions, total requests, successful requests, unsuccessful requests, 4xx errors, 5xx errors, success %.

Traffic Summary by Delivery Servers

Table 79: Traffic Summary by Delivery Servers Table & Description

Table

Traffic Summary by Delivery Servers

Information

Description

Illustrates the traffic summary for the past month for each delivery server.

The information within this table is: delivery server, peak bandwidth, mean bandwidth, bandwidth peak mean ratio, 95%ile bandwidth, total GB delivered, total GB ingested, cache hits, cache misses, cache hit ratio, mean sessions, peak sessions, sessions peak mean ratio, 95%ile sessions, total requests, successful requests, unsuccessful requests, 4xx errors, 5xx errors, success %.

Traffic Summary by Delivery Services

Videoscape Distribution Suite Service Manager User Guide

101

Analytics

Reports

Table 80: Traffic Summary by Delivery Services Table & Description

Table

Traffic Summary by Delivery Services

Information

Description

Illustrates the traffic summary for the past month for each delivery service.

The information within this table is: delivery service, peak bandwidth, mean bandwidth, bandwidth peak mean ratio, 95%ile bandwidth, total GB delivered, total GB ingested, cache hits, cache misses, cache hit ratio, mean sessions, peak sessions, sessions peak mean ratio, 95%ile sessions, total requests, successful requests, unsuccessful requests, 4xx errors, 5xx errors, success %.

Delivery Server Traffic [1 day Intervals]

Table 81: Delivery Server Traffic [1 day Intervals] Table & Description

Table

Delivery Server Traffic [1 hour Intervals]

Information

Description

Illustrates the delivery server traffic details for a selected delivery server in 1 day intervals

The information within this table is: _time, peak bandwidth, mean bandwidth, bandwidth peak mean ratio, 95%ile bandwidth, total GB delivered, total GB ingested, cache hits, cache misses, cache hit ratio, mean sessions, peak sessions, sessions peak mean ratio, 95%ile sessions, total requests, successful requests, unsuccessful requests, 4xx errors, 5xx errors, success %.

Choose the required delivery server from the Delivery Server drop-down located above the chart.

102

Videoscape Distribution Suite Service Manager User Guide

Analytics

Delivery Service Traffic [1 day Intervals]

Reports

Table 82: Delivery Service Traffic [1 day Intervals] Table & Description

Table

Delivery Service Traffic [1 hour Intervals]

Information

Description

Illustrates the delivery service traffic details for a selected delivery service in 1 day intervals.

The information within this table is: _time, peak bandwidth, mean bandwidth, bandwidth peak mean ratio, 95%ile bandwidth, total GB delivered, total GB ingested, cache hits, cache misses, cache hit ratio, mean sessions, peak sessions, sessions peak mean ratio, 95%ile sessions, total requests, successful requests, unsuccessful requests, 4xx errors, 5xx errors, success %.

Choose the required delivery service from the Delivery Service drop-down list located above the chart.

All Assets - Video

Table 83: All Assets - Video Table & Description

Table

All Assets - Video

Information

Description

Illustrates various metrics for video assets for the past month.

The information within this table is: URL, Plays,

UniqueUsers, Bytes, Minutes, MinutesPerPlay,

MinutesPerUser, and PlaysPerUser.

Videoscape Distribution Suite Service Manager User Guide

103

Analytics

Custom Searches and Reports

Choose the required delivery service from the Delivery Service drop-down list located above the chart.

All Assets - Non-Video

Table 84: All Assets - Non-Video Table & Description

Table

All Assets - Non-Video

Information

Description

Illustrates various metrics for non-video assets for the past month.

The information within this table is: URL, Bytes,

Requests, and UniqueUsers.

Choose the required delivery service from the Delivery Service drop-down list located above the chart.

Custom Searches and Reports

This feature displays all the saved searches as reports. The logged in user can view both, public and private reports. However, the logged in user cannot view the private reports saved by another user. In this feature, only the Delete and Refresh options are available. The user will not be able to modify any saved reports. To view custom reports, perform the following:

From the main page, choose Analytics > Custom Searches and Reports .

Note When a user has multiple reports, enter the search name in the filter, which is located in the left pane and the particular saved search will be displayed.

104

Videoscape Distribution Suite Service Manager User Guide

Analytics

Custom Searches and Reports

Creating a Custom Report

To create custom reports, perform the following steps:

Step 1

Step 2

Step 3

Choose Analytics > Custom Searches and Reports .

In the Search field, enter the query for which you want to generate a report and click , in the right pane.

Choose Save As > Report .

Step 4

Step 5

Step 6

Step 7

The Save As Report panel appears.

Provide the report Title, and Description (optional).

Click the preferred Visualization button on how you want the report to appear.

Click Yes to add Time Range Picker, and click No to create a report without time range picker.

Click Save .

Step 8

The Your Report Has Been Created panel appears.

Click View to see the created report.

Click Add to Dashboard to create a custom dashboard for given search query (see Adding a Custom Dashboard topic in

Custom Dashboards, on page 106

), or click Continue Editing to navigate to the search page.

Remember

Created custom report will be added to the tree view only after clicking in the left pane.

Videoscape Distribution Suite Service Manager User Guide

105

Analytics

Custom Dashboards

Deleting a Custom Report

To delete a custom report, perform the following steps:

Step 1

Step 2

Step 3

Choose Analytics > Custom Searches and Reports .

From the left pane, select the custom report, which you want to delete and click .

The delete confirmation dialog box appears.

Click Yes to permanently delete the custom report, or click No to cancel the deletion.

Custom Dashboards

This feature allows the CDN operators to create and save dashboards using the search application. You can view the list of all custom dashboards created by you and other users.

To access this feature, from the main page, choose Analytics > Custom Dashboards . You can view the custom dashboards in the left pane. Click the arrow next to My Dashboards and select the custom dashboard, which you want to view. The details will be displayed in the right pane.

This feature allows you to create, delete, and refresh dashboards. By default, the dashboards are grouped by username.

Note If you manually modify the savedsearches.conf file in the JS node, the savedsearches.conf file under the

SH node will be updated and thereby, all the searches will be deleted.

Adding a Custom Dashboard

To add a custom dashboard, perform the following steps:

Step 1

Step 2

Step 3

Step 4

Choose Analytics > Custom Dashboards .

Click .

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

Choose Save As > Dashboard Panel .

106

Videoscape Distribution Suite Service Manager User Guide

Analytics

Custom Dashboards

Step 5

The Save As Dashboard Panel appears.

To create a new custom dashboard, perform the following: a) Click New .

b) Dashboard Title (Optional) — Enter the dashboard title.

c) Dashboard ID — Enter the dashboard ID.

Note The dashboard ID can contain only alpha numeric characters and underscores.

d) Dashboard Description (Optional) — Enter the dashboard description.

e) Dashboard Permissions — Select the dashboard permissions as Private or Shared in App .

• Private — You can only view and edit the custom dashboard.

• Shared in App — All users can view the created dashboard.

Note You can edit the custom dashboard based on the role.

The following table provides the role and permission details:

Table 85: Permission Details

Role

1

Role based Permissions

Admin User Power Can_delete Splunk_System_Role

Videoscape Distribution Suite Service Manager User Guide

107

Analytics

Custom Dashboards

Admin Edit, Delete, Edit

Permissions and

Clone

Clone

User

Power

Sharing option is not available

Edit, Delete , Edit

Permissions and

Clone

Clone

Search is not possible Can_delete

Splunk_System_Role Edit, Delete , Edit

Permissions and

Clone

Clone

Edit, Delete and

Clone

Edit, Delete , Edit

Permissions and

Clone

Edit, Delete and

Clone

No

No

No

Edit, Delete , Edit

Permissions and

Clone

Edit, Delete , Edit

Permissions and

Clone

Edit, Delete , Edit

Permissions and

Clone

1

Refers to the role of the user who created the custom dashboard.

f) Panel Title (Optional) — Enter the panel title.

g) Panel Content — Select the panel content as Statistics or Column .

• Statistics — Displays data in table format.

• Column — Displays data as column chart.

Step 6 h) Click Save .

To add a panel in an existing dashboard, in the Save As Dashboard Panel dialog box perform the following: a) Click Existing .

b) From the drop-down list, choose the required dashboard.

Note You can only add panels to the dashboards that are created using the custom dashboard interface.

c) Panel Content — Select the panel content as Statistics or Column .

• Statistics — Displays data in table format.

• Column — Displays data as column chart.

d) Click Save .

Your Dashboard Panel Has Been Created dialog box appears.

108

Videoscape Distribution Suite Service Manager User Guide

Analytics

Content

Step 7 Click View Dashboard .

Remember

Note

Refresh the dashboards by clicking in the left pane to view the created dashboard name in the tree view.

The respective searches will be saved under Custom Searches and Reports.

Deleting a Custom Dashboard

To delete a custom dashboard, perform the following steps:

Step 1

Step 2

Step 3

Step 4

Choose Analytics > Custom Dashboards .

From the left pane, select the 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 that is being used by one or more custom dashboards, then those dashboards will not work. Also, the search saved as part of custom dashboards will have to be deleted manually.

Remember

Deleted custom dashboard will be removed from the tree view only after clicking in the left pane.

Content

In this feature, the users will be able to analyze the data, based on the content title. They can also generate viewership report, based on various metrics.

Analyze by Content Title

This feature provides a platform for the users to analyze individual asset (content title), based on various metrics such as Usage, Audience, QoS, and Errors.

Videoscape Distribution Suite Service Manager User Guide

109

Analytics

Content

To analyze the content title, perform the following steps:

Step 1 From the main page, choose Analytics > Content > Analyze by Content Title .

Step 2 Choose the desired delivery service and the time range from the respective drop-down lists, and enter the search asset name in the Search Asset name field. Then, click Search .

Note Entering certain search asset name values such as space and individual characters in the Search Asset Name text box will display large results. This may impact the system's performance.

Step 3 From the list of unique content titles that are displayed in a tabular format, choose the desired Title.

Different tabs such as Usage, Audience, QoS, and Errors for that particular title are displayed. Click the respective tabs to view the corresponding charts.

The different charts are explained in detail here.

Usage

Bytes Delivered

The following table describes the information in the chart:

Table 86: Bytes Delivered Chart & Description

Chart

Bytes Delivered

Description

Illustrates the bytes delivered (MB) over time for the given content title.

110

Videoscape Distribution Suite Service Manager User Guide

Analytics

Chart

Chart Information

Formula

Filters

Bytes Delivered by Delivery Server

Content

Description

The information within this chart is shown in a column graph with the Date/Time along the X-axis and the bytes delivered in MB along the Y-axis.

The formula used to derive this graph is: the total bytes delivered for the given content title plotted over time.

This chart uses Delivery Service, and Time Range (Previous day and Last 7 days), as filters.

The following table describes the information in the tabular column:

Table 87: Bytes Delivered by Delivery Server Table & Description

Table

Bytes Delivered by Delivery Server

Information

Formula

Filters

Description

Illustrates the bytes delivered (MB) per delivery server for the given content title.

The information within this table are Delivery Server and

MB.

The formula used is: total bytes delivered for the given content title in each delivery server.

This table uses Delivery Service, and Time Range (Previous day and Last 7 days), as filters.

Bytes Delivered by City

The following table describes the information in the tabular column:

Videoscape Distribution Suite Service Manager User Guide

111

Analytics

Content

Table 88: Bytes Delivered by City Table & Description

Table

Bytes Delivered by City

Information

Formula

Filters

Description

Illustrates the bytes delivered (MB) per city for the given content title.

The information within this table are City and MB.

The formula used is: total bytes delivered for the given content title in each city.

This table uses Delivery Service, and Time Range (Previous day and Last 7 days), as filters.

Note The city will be resolved only for public IPs. IPs which cannot be resolved by MaxMind will not be displayed.

Bytes Delivered by ISP and Net Speed

The following table describes the information in the tabular column:

Table 89: Bytes Delivered by ISP and Net Speed Table & Description

Table

Bytes Delivered by ISP and Net Speed

Table Information

Formula

Filters

Description

Illustrates the bytes delivered (MB), grouped by ISP or Net

Speed for the given content title.

The information within this table are ISP or Net Speed and

MB.

The formula used is: total bytes delivered for the given content title grouped by the client ISP or Net Speed.

This table uses Delivery Service, and Time Range (Previous day and Last 7 days), as filters.

Note Other than public IPs, "unknown" value will be displayed.

Bytes Delivered by Client Type

112

Videoscape Distribution Suite Service Manager User Guide

Analytics

Content

The following table describes the information in the tabular column:

Table 90: Bytes Delivered by Client Type Table & Description

Table

Bytes Delivered by Client Type

Table Information

Formula

Filters

Description

Illustrates the bytes delivered per client type (MB) for the given content title.

The information within this table are Client Type and MB.

The formula used is: total bytes delivered for the given content title grouped by the client type.

This table uses Delivery Service, and Time Range (Previous day and Last 7 days), as filters.

Audience

Total Sessions

The following table describes the information in the chart:

Table 91: Total Sessions Chart & Description

Chart

Total Sessions

Chart Information

Formula

Description

Illustrates the number of sessions over time for the given content title.

The information within this chart is shown in a column graph with the Date/Time along the X-axis and the Total

Sessions Count along the Y-axis.

The formula used to derive this graph is: the total number of sessions for a given content title plotted over time.

Videoscape Distribution Suite Service Manager User Guide

113

Content

Chart

Filters

Unique Viewers

Analytics

Description

This chart uses Delivery Service, and Time Range (Previous day and Last 7 days), as filters.

The following table describes the information in the chart:

Table 92: Unique Viewers Chart & Description

Chart

Unique Viewers

Chart Information

Formula

Filters

Description

Illustrates the number of unique viewers over time for the given content title.

The information within this chart is shown in a column graph with the Date/Time along the X-axis and the Unique

Viewers count along the Y-axis.

The formula used to derive this graph is: the number of unique viewers for the given content title plotted over time.

This chart uses Delivery Service, and Time Range (Previous day and Last 7 days), as filters.

Viewers by Download Size and Session Duration

The following table describes the information in the tabular column:

114

Videoscape Distribution Suite Service Manager User Guide

Analytics

Content

Table 93: Viewers by Download Size and Session Duration Table & Description

Table

Viewers by Download Size and Session Duration

Table Information

Formula

Filters

Description

Illustrates the number of sessions grouped by download size or duration for the given content title.

The information within this table are Download Size,

Session Duration, and Count.

The formula used is: the number of viewers bucketed by the download size in MB, for the given content title. The formula used for Duration is: the number of viewers bucketed by the average session duration for the given content title.

This table uses Delivery Service, and Time Range (Previous day and Last 7 days), as filters.

Viewers by ISP and Net Speed

The following table describes the information in the tabular column:

Table 94: Viewers by ISP and Net Speed Table & Description

Table

Viewers by ISP and Net Speed

Table Information

Formula

Filters

Description

Illustrates the number of sessions grouped by ISP and Net

Speed for the given content title.

The information within this table are ISP, Net Speed and the Viewer count.

The formula used is: the number of viewers grouped by client ISP/Net Speed for the given content title.

This table uses Delivery Service, and Time Range (Previous day and Last 7 days), as filters.

Note Other than public IPs, "unknown" value will be displayed.

Viewers by City

Videoscape Distribution Suite Service Manager User Guide

115

Analytics

Content

The following table describes the information in the tabular column:

Table 95: Viewers by City Table & Description

Table

Viewers by City

Table Information

Formula

Filters

Description

Illustrates the number of viewers per city for the given content title.

The information within this table are City and Count.

The formula used is: the number of viewers in each city for the given content title.

This table uses Delivery Service, and Time Range (Previous day and Last 7 days), as filters.

Note The city will be resolved only for public IPs. IPs which cannot be resolved by MaxMind will not be displayed.

QoS

Average ABR Session Bitrate

The following table describes the information in the chart:

Table 96: Average ABR Session Bitrate Chart & Description

Chart

Average ABR Session Bitrate

Chart Information

Formula

Description

Illustrates the average ABR session bitrate (Kbps) over time for the given content title.

The information within this chart is shown in a column graph with the Date/Time along the X-axis and the ABR

Session Bitrate (Kbps) along the Y-axis.

The formula used to derive this graph is: the average bitrate plotted over time for the given content title.

116

Videoscape Distribution Suite Service Manager User Guide

Analytics

Chart

Filters

Bitrate Oscillations

Content

Description

This chart uses Delivery Service, and Time Range (Previous day and Last 7 days), as filters.

The following table describes the information in the chart:

Table 97: Bitrate Oscillations Chart & Description

Chart

Bitrate Oscillations

Chart Information

Formula

Filters

Description

Illustrates the number of bitrate oscillations for the given content title over time.

The information within this chart is shown in a column graph with the Date/Time along the X-axis and oscillation

Count along the Y-axis.

The formula used to derive this graph is: the number of bitrate shift events for a given content title.

This chart uses Delivery Service, and Time Range (Previous day and Last 7 days), as filters.

Average ABR Session Bitrate by Client Type

Videoscape Distribution Suite Service Manager User Guide

117

Analytics

Content

The following table describes the information in the tabular column:

Table 98: Average ABR Session Bitrate by Client Type Table & Description

Table

Average ABR Session Bitrate by Client Type

Table Information

Formula

Filters

Description

Illustrates the average ABR session bitrate (Kbps) per client type for the given content title.

The information within this table are Client Type and

Bitrate.

The formula used is: average ABR session bitrate (Kbps) for the given content title, grouped by the client type.

This table uses Delivery Service, and Time Range (Previous day and Last 7 days), as filters.

Average ABR Session Bitrate by City

The following table describes the information in the tabular column:

Table 99: Average ABR Session Bitrate by City Table & Description

Table

Average ABR Session Bitrate by City

Table Information

Formula

Filters

Description

Illustrates the average ABR session bitrate (Kbps) per city for the given content title.

The information within this table are City and Bitrate.

The formula used is: average ABR session bitrate (Kbps) for the given content title in each city.

This table uses Delivery Service, and Time Range (Previous day and Last 7 days), as filters.

Note The city will be resolved only for public IPs. IPs which cannot be resolved by MaxMind will not be displayed.

Average ABR Session Bitrate by ISP and Net Speed

118

Videoscape Distribution Suite Service Manager User Guide

Analytics

Content

The following table describes the information in the tabular column:

Table 100: Average ABR Session Bitrate by ISP and Net Speed Table & Description

Table

Average ABR Session Bitrate by ISP and Net Speed

Table Information

Formula

Filters

Description

Illustrates the average ABR session bitrate (Kbps) grouped by ISP and Net Speed for the given content title.

The information within this table are Client ISP/Net Speed and Bitrate.

The formula used is: average ABR session bitrate (Kbps) for the given content title grouped by the client ISP and

Net Speed.

This table uses Delivery Service, and Time Range (Previous day and Last 7 days), as filters.

Note Other than public IPs, "unknown" value will be displayed.

Errors

4xx and 5xx Errors

The following table describes the information in the chart:

Table 101: 4xx and 5xx Errors Chart & Description

Chart

4xx and 5xx Errors

Description

Illustrates the number of 4xx and 5xx (client and server) errors over time for the given content title.

Videoscape Distribution Suite Service Manager User Guide

119

Description

The information within this chart is shown in a column graph with the Date/Time along the X-axis and the Error count along the Y-axis.

The formula used to derive this graph is: the number of

4xx and 5xx errors plotted over time for the given content title.

This chart uses Delivery Service, and Time Range (Previous day and Last 7 days), as filters.

Analytics

Content

Chart

Chart Information

Formula

Filters

4xx and 5xx Errors

The following table describes the information in the tabular column:

Table 102: 4xx and 5xx Errors Table & Description

Table

4xx and 5xx Errors

Table Information

Formula

Filters

Description

Illustrates the number of 4xx and 5xx (client and server) errors for the given content title.

The information within this table are 4xx Errors, and 5xx

Errors.

The formula used is: the number of 4xx and 5xx errors occurred for the given content title.

This chart uses Delivery Service, and Time Range (Previous day and Last 7 days), as filters.

4xx and 5xx Errors by Device

The following table describes the information in the tabular column:

120

Videoscape Distribution Suite Service Manager User Guide

Analytics

Content

Table 103: 4xx and 5xx Errors by Device Table & Description

Table

4xx and 5xx Errors by Device

Table Information

Formula

Filters

Description

Illustrates the number of 4xx and 5xx (client and server) errors per device (delivery servers and service routers) for the given content title.

The information within this table are Device Name, 4xx, and 5xx Errors.

The formula used is: the number of 4xx and 5xx errors occurring in each device (delivery servers and service routers) for the given content title.

This table uses Delivery Service, and Time Range (Previous day and Last 7 days), as filters.

4xx and 5xx Errors by City

The following table describes the information in the tabular column:

Table 104: 4xx and 5xx Errors by City Table & Description

Table

4xx and 5xx Errors by City

Table Information

Formula

Filters

Description

Illustrates the number of 4xx and 5xx (client and server) errors per city for the given content title.

The information within this table are City, 4xx, and 5xx errors.

The formula used is: the number of 4xx and 5xx errors occurring in each city for the given content title.

This table uses Delivery Service, and Time Range (Previous day and Last 7 days), as filters.

4xx and 5xx Errors by Client Type

Videoscape Distribution Suite Service Manager User Guide

121

Analytics

Content

The following table describes the information in the tabular column:

Table 105: 4xx and 5xx Errors by Client Type Table & Description

Table

4xx and 5xx Errors by Client Type

Table Information

Formula

Filters

Description

Illustrates the number of 4xx and 5xx (client and server) errors grouped by client type for the given content title.

The information within this table are Client Type, 4xx, and

5xx errors.

The formula used is: the number of 4xx and 5xx errors occurring in each client type for the given content title.

This table uses Delivery Service, and Time Range (Previous day and Last 7 days), as filters.

Viewership Report

This feature provides a platform for the users to generate viewership reports, based on various metrics such as Delivery Server Group, Delivery Server, Provider, Service Type, Delivery Service, Resolution, and Genre.

To generate viewership report, perform the following steps:

Step 1

Step 2

From the main page, choose Analytics > Content > Viewership Report .

Choose the Delivery Server Group, Delivery Server, Provider, Service Type, Delivery Service, Resolution, Genre, and

Time Range Picker from the respective drop-down lists and click Filter .

The viewership report is displayed.

By clicking an asset name in the Viewership report, you will be navigated to the Analyze by Content Title page with the selected asset name pre-populated in the search Asset Name field.

122

Videoscape Distribution Suite Service Manager User Guide

Analytics

Sessions

Sessions

In this feature, the users will be able to analyze the data, based on the session title. They can also generate session report, based on various metrics.

Analyze by Client IP

This feature provides a platform for users to analyze the individual client IP, based on various parameters such as sessions created for the IP, session duration, protocol used to serve the content, and title viewed during the session.

To access this feature, perform the following steps:

Step 1

Step 2

From the main page, choose Analytics > Sessions > Analyze by Client IP .

Choose the desired delivery service, select the time range from the respective drop-down lists, and enter the client IP in the search Client IP field. Click Search .

Note In the search Client IP field, enter the exact client

IP.

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

Videoscape Distribution Suite Service Manager User Guide

123

Analytics

Sessions

Session Report

This feature provides a platform for the users to generate session reports, based on various metrics such as

Delivery Server Group, Delivery Server, Provider, and Delivery Service.

To access this feature, perform the following steps:

Step 1

Step 2

From the main page, choose Analytics > Sessions > Session Report .

Choose the Delivery Server Group, Delivery Server, Provider, Delivery Service, and Time Range Picker from the respective drop-down lists and click Filter .

The session report is displayed.

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 pre-populated in the search Client IP field.

124

Videoscape Distribution Suite Service Manager User Guide

Analytics

Geo Analysis

Geo Analysis

This feature allows to analyze some core CDN metrics over geographic dimension.

To access this feature, from the main page, choose Analytics > Geo Analysis . You can view Geo Analysis in the left pane. Click the arrow next to Geo Analysis and select the required map you want to view. The details will be displayed in the right pane.

By default, the Cache Hit Ratio by Location map is displayed.

Cache Hit Ratio by Location

The Cache Hit Ratio by Location map displays the delivery server location as points. When you mouse over a point (server location), the server name and its cache hit ratio will be displayed.

The Cache Hit Ratio by Location map uses Time Range, Delivery Server Group, Delivery Server, Provider, and Delivery Service as filters.

Viewers Density by Location

The Viewers Density by Location map displays the client locations as points. When you mouse over a point

(client location), the city name and the number of viewers from that particular city will be displayed.

The Viewers Density by Location map uses Time Range, Delivery Server Group, Delivery Server, Provider,

Delivery Service, and Media Format as filters.

Videoscape Distribution Suite Service Manager User Guide

125

Analytics

Geo Analysis

Bytes Delivered by City

The Bytes Delivered by City map displays the client locations as points. When you mouse over a point (client location), the city name and the number of bytes delivered (GB) to that particular city will be displayed.

The Bytes Delivered by City map uses Time Range, Delivery Server Group, Delivery Server, Provider,

Delivery Service, Resolution, and Genre as filters.

126

Videoscape Distribution Suite Service Manager User Guide

Analytics

Geo Analysis

Average ABR Bitrate by City

The Average ABR Bitrate by City map displays the client locations as points. When you mouse over a point

(client location), the city name and the average ABR bitrate (Kbps) in that particular city will be displayed.

The Average ABR Bitrate by City map uses Time Range, and Delivery Service as filters.

4xx and 5xx Errors by City

The 4xx and 5xx Errors by City map displays locations of the viewers who are receiving 4xx and 5xx errors.

When you mouse over a point (client location), the city name, count of 4xx (client) errors, and count of 5xx

(server) errors in that particular city will be displayed.

The 4xx and 5xx Errors by City map uses Time Range, and Delivery Service as filters.

Videoscape Distribution Suite Service Manager User Guide

127

Analytics

North Bound Application Programming Interface

North Bound Application Programming Interface

North Bound Application Programming Interface (NB API) is a programming interface for north bound analytics systems to integrate with VDS-SM and leverage the data maintained in VDS-SM for higher level aggregation and analysis. VDS-SM provides a RESTful Web Services API to query data from VDS-SM for analytics. VDS-SM supports predefined queries/searches to query data corresponding to reports. Each predefined query/search is identified by a name, which corresponds to a particular dashboard. You can query the data by specifying the search name alone.

For example, in the CDN Traffic report, the search name is cdntraffic_daily.

To obtain the result for a query, you need to perform the HTTPS GET request using the following URL:

With Delivery Service Name https://< UI

Node IP >:8443/bnimgmt/api/analytics/search/systemdefined/< searchname >?delsvc=<delivery service name>

With Delivery Server Name https://< UI

Node IP >:8443/bnimgmt/api/analytics/search/systemdefined/< searchname >?host=<delivery server name>

Without Delivery Service or Delivery Server Name https://< UI Node IP >:8443/bnimgmt/api/analytics/search/systemdefined/<searchName>

For example, to execute the search “ cdntraffic_daily ” , you need to perform GET request using the following

URL: https://<UI Node IP>:8443/bnimgmt/api/analytics/search/systemdefined/ cdntraffic_daily

You need to specify the Username and Password (CDN Operator Admin and CDN Viewer) for authentication in the “ Authorization ” header fields of the HTTPS GET request. For example, in command line tools such as curl, provide the following command with credentials: curl -k -u bniadmin:admin --request GET 'https:// < UI Node IP

>:8443/bnimgmt/api/analytics/search/ systemdefined/cdntraffic_daily

In the URL, you need to pass the delivery service name or delivery server name for a search and not any special characters or space.

Note The URL should be exactly the same as mentioned here and they should be entered in a single line. Also,

HTTPS is authenticated through self-signed OpenSSL certificate for NB API and NB API does not support

HTTP.

Result Format

Analytics API provides the results in CSV format. The first line is the header line with fields, followed by the data. Following is an example of Console Output.

curl -k -u bniadmin:admin --request GET

'https://10.77.246.184:8443/bnimgmt/api/analytics/search/systemdefined/cdntraffic_weekly'

128

Videoscape Distribution Suite Service Manager User Guide

Analytics

North Bound Application Programming Interface

Supported Predefined Searches

Table 106: Search Name & Optional Parameters

11

12

13

14

15

7

8

9

10

5

6

3

4

1

2

Sl.

No.

Search Name cdntraffic_daily cdntraffic_weekly cdntraffic_monthly trafficsummary_by_deliveryservers_daily trafficsummary_by_deliveryservers_weekly trafficsummary_by_deliveryservers_monthly trafficsummary_by_deliveryservices_daily trafficsummary_by_deliveryservices_weekly trafficsummary_by_deliveryservices_monthly deliveryserver_traffic_daily deliveryserver_traffic_weekly deliveryserver_traffic_monthly deliveryservice_traffic_daily deliveryservice_traffic_weekly deliveryservice_traffic_monthly

Optional Parameters delivery_server_name delivery_server_name delivery_server_name delivery_service_name delivery_service_name delivery_service_name

Videoscape Distribution Suite Service Manager User Guide

129

North Bound Application Programming Interface

Analytics

130

Videoscape Distribution Suite Service Manager User Guide

C H A P T E R

5

Monitor

Monitor Overview, page 131

Monitor Overview

CDN hosts different content, such as live and archived, to viewers around the world. For the CDN Operators to quickly check the performance of the network, real-time monitoring is performed on Throughput, Cache

Hit Ratio, Concurrent Active Sessions, and Responses.

Note Only Throughput, Cache Hit Ratio, Concurrent Active Sessions, and Responses charts are refreshed real-time (with minimum delay).

To access this feature, click Monitor from the main page.

The following categories are displayed in Monitor:

• CDN Overview

• Throughput

• Cache Hit Ratio

• Concurrent Active Sessions

• Responses

• Bitrates

These categories are explained in detail here.

CDN Overview

Displays the number of delivery services, delivery servers, and edge locations. These values are refreshed every eight minutes.

Videoscape Distribution Suite Service Manager User Guide

131

Monitor

Monitor Overview

Throughput (Gbps)

The following table describes the Throughput chart:

Table 107: Throughput Chart & Description

Chart

Throughput

Chart Information

Chart Filters

Description

Illustrates the data delivered by the network at real-time.

The information within this chart is shown in a line graph with Date/Time along the X-axis and the throughput in Gbps along the Y-axis. The legends representing the graph are maximum, minimum, and average.

This chart uses Delivery Server, and Delivery Service as filters.

Cache Hit Ratio

132

Videoscape Distribution Suite Service Manager User Guide

Monitor

Monitor Overview

The following table describes the Cache Hit Ratio chart:

Table 108: Cache Hit Ratio Chart & Description

Chart

Cache Hit Ratio

Chart Information

Chart Filters

Description

Provides client request cache hit and miss percentage at 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 Delivery Server, and Delivery Service as filters.

Concurrent Active Sessions

Videoscape Distribution Suite Service Manager User Guide

133

Monitor

Monitor Overview

The following table describes the Concurrent Active Sessions chart:

Table 109: Concurrent Active Sessions Chart & Description

Chart

Concurrent Active Sessions

Chart Information

Chart Filters

Description

Illustrates the concurrent client sessions at real-time.

The information within this chart is a line graph with

Date/Time along the X-axis and Maximum, Minimum and Average count along the Y-axis. The legends representing the graph are maximum, average, and minimum.

This chart uses Delivery Server, and Delivery Service as filters.

Responses

The following table describes the Responses chart:

Table 110: Responses Chart & Description

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 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 Delivery Server, and Delivery Service as filters.

134

Videoscape Distribution Suite Service Manager User Guide

Monitor

Bitrates

Monitor Overview

The following table describes the Bitrates chart:

Table 111: Bitrates Chart & Description

Chart

Bitrates

Chart Information

Chart Filters

Description

Illustrates the bitrate used to serve the content through

CDN.

The information within this chart is shown in a column graph with Bitrate along the X-axis and Count along the Y-axis. The bitrate values in the chart are refreshed every minute.

This chart uses Delivery Server, and Delivery Service as filters.

Videoscape Distribution Suite Service Manager User Guide

135

Monitor Overview

Monitor

136

Videoscape Distribution Suite Service Manager User Guide

C H A P T E R

6

Alerts

Alerts Overview, page 137

Managing Alerts, page 137

Alerts Overview

Alerts display the exceptions that arise as a result of exceeded quota limits.

Managing Alerts

VDS-IS allows the Operator to set quota limits for Bandwidth, Storage, and Sessions at the delivery service level. The CDN still caters the service to the providers when they exceed the quota limit (depending on buffer).

When the quota limit is exceeded, alerts are triggered.

From the main page, choose Alerts > Manage Alerts . This displays the Bandwidth, Session, and Storage alerts.

Bandwidth Alerts

Chart

Bandwidth Alerts

Filter

Description

Illustrates all bandwidth alerts that are triggered.

This chart uses Provider, Delivery Service, and the

Time Range Picker as filters.

Videoscape Distribution Suite Service Manager User Guide

137

Alerts

Session Alerts

Session Alerts

Storage Alerts

Chart

Session Alerts

Filter

Chart

Storage Alerts

Filter

Description

Illustrates all session alerts that are triggered.

This chart uses Provider, Delivery Service, and the

Time Range Picker as filters.

Description

Illustrates all storage alerts that are triggered.

This chart uses Provider, Delivery Service, and the

Time Range Picker as filters.

138

Videoscape Distribution Suite Service Manager User Guide

C H A P T E R

7

Configuration

VDS Manager Configuration, page 139

Adding a CDN, page 140

Managing a VDS-IS CDN, page 141

Distribution Hierarchy Function Overview, page 142

Delivery Servers, page 144

URL Signing, page 145

Delivery Services, page 149

Reseller Function Overview, page 152

Content Provider Function Overview, page 154

Services, page 158

Geo Fencing, page 160

Content Purging, page 161

VDS Manager Configuration

VDS Manager enables CDN Operators to deploy and manage the VDS-IS configuration such as delivery services.

Multi-Tiered and Multi-Tenancy

The Operator can manage the simple profile (name, contact info, and quota), users for content providers (CP) and Resellers. Once a CP or Reseller user is created, the newly created user can log in and view its own dashboards. The VDS Operator can manage the hierarchical relationship among CDN, CP, and Services. The

CP or Reseller user can view dashboards at the Delivery Service level for all Delivery Services under its domain.

Videoscape Distribution Suite Service Manager User Guide

139

Configuration

Adding a CDN

Services (1-to-1 with Delivery Service) are synchronized from the Content Delivery Service Manager (CDSM) periodically. All Delivery Services should be synchronized from the CDSM to the VDS Manager, including both live and VOD Content Delivery Services.

Adding a CDN

To deploy VDS-SM, you must configure CDN. CDN enables VDS-SM to gather topology information from the Service and allows the service to be controlled by the VDS-SM solution.

To add a CDN, perform the following steps:

Step 1

Step 2

From the main page, choose Configuration > CDN .

The CDN page, listing all configured CDN devices and their status is displayed.

Click to create a new CDN.

In the Create CDN popup, enter the appropriate CDN information for the VDS-IS CDSM as mentioned here.

140

Videoscape Distribution Suite Service Manager User Guide

Configuration

Managing a VDS-IS CDN

Table 112: Create CDN Field & Description

Field

Name

Provider

Device Address

Control Port

Location

Service State

Description

A unique name for the device.

The content provider for this CDN.

The IP address or Fully Qualified Domain Name (FQDN) of this device.

A pre-existing port number specified for this device. Contact your System Administrator for this information.

The location to which this device is associated.

The service state of the service:

• In Service: Enables the service.

When a device is in this state, all read and write operations to this device are allowed.

• Out of Service: Disables the service.

When a device is in this state, all write operations are not allowed. However, the read operation is still allowed, whereby the periodic sync, operational state check, and manual sync will still happen.

Username

Password/Confirm Password

Description

The user name associated with the device.

The password associated with the username for this CDN service.

Optional. User defined description for the CDN service.

Step 3

Step 4

Step 5

On completion, click Create . The CDN is created and a validation message is displayed.

Click Close .

From within the CDN screen, click Refresh to view the newly added CDN service.

Note that the CDN synchronization will take a few minutes.

Managing a VDS-IS CDN

To manage a VDS-IS CDN, perform the following steps:

Step 1

Step 2

From the main page, choose Configuration > CDN .

Click the arrow next to the name of the CDN you want to manage. The Distribution Hierarchy maps to the CDSM location.

Videoscape Distribution Suite Service Manager User Guide

141

Configuration

Distribution Hierarchy Function Overview

The following table provides a description of the key elements contained within the selected CDN page.

Table 113: CDN - Field & Description

Element

Distribution Hierarchy

Service Routers

Delivery Servers

Delivery Services

Description

The Distribution Hierarchy maps to CDSM locations (see

Distribution Hierarchy

Function Overview, on page 142

).

The VDS-SM Service Routers map to the CDSM devices (SRs).

The VDS-SM Delivery Servers map to the CDSM devices (SEs) (see

Delivery

Servers, on page 144

).

The VDS-SM Delivery Services map to the CDSM Delivery Services (see

Delivery Services, on page 149

).

Distribution Hierarchy Function Overview

Adding a Distribution Hierarchy

To add a Distribution Hierarchy, perform the following steps:

Step 1

Step 2

Step 3

Step 4

From the main page, choose Configuration > CDN .

Select the CDN to which you want to add Distribution Hierarchy and click .

In the Distribution Hierarchy tab, click .

In the dialog box that appears in the right pane, enter the following details:

142

Videoscape Distribution Suite Service Manager User Guide

Configuration

Modifying a Distribution Hierarchy

Table 114: Adding Distribution Hierarchy - Field & Description

Field

Name

Parent Server Group

Topology Location

Level

Description

Description

Specify the Server Group name.

Specify the Parent Server Group.

Specify the Topology Location.

Specify the level to which the Delivery Server belongs.

Optional. Additional information about the Distribution

Hierarchy.

Step 5

Step 6

Click OK .

Click Save .

Modifying a Distribution Hierarchy

To modify a Distribution Hierarchy, perform the following steps:

Step 1

Step 2

Step 3

Step 4

Step 5

From the main page, choose Configuration > CDN .

Select the CDN that you want to modify and click .

From the Distribution Hierarchy tab, select the Distribution Hierarchy that you want to modify and click

Enter the modification in the dialog box that appears on the right pane and click OK .

Click Save .

.

Cloning a Distribution Hierarchy

This feature helps you to replicate an existing Distribution Hierarchy. This is helpful when you want to create the same Distribution Hierarchy again.

Videoscape Distribution Suite Service Manager User Guide

143

Configuration

Deleting a Distribution Hierarchy

To clone a distribution hierarchy, perform the following steps:

Step 1

Step 2

Step 3

Step 4

Step 5

From the main page, choose Configuration > CDN .

Select the CDN that you want to clone and click .

From the Distribution Hierarchy tab, select the Distribution Hierarchy, which you want to clone and click

Click

Click Save .

and then click OK .

.

Deleting a Distribution Hierarchy

To delete a Distribution Hierarchy, perform the following steps:

Step 1

Step 2

From the main page, choose Configuration > CDN .

From the Distribution Hierarchy tab, select the Distribution Hierarchy that you want to delete and click .

You can also undo a task that you have just performed. This option is not feasible for an existing Delivery Hierarchy.

For example, you can undo a Distribution Hierarchy, immediately after it has been added. For this, select the task that you want to undo (the task that you just performed), and click .

Delivery Servers

Modifying a Delivery Server

To modify a Delivery Server, perform the following steps:

Step 1

Step 2

Step 3

Step 4

Step 5

From the main page, choose Configuration > CDN .

Select the CDN that you want to modify and click .

In the Delivery Servers tab, select the Delivery Server that you want to modify and click

Enter the modification and click OK .

Click Save .

Note You can only modify the Description and Server Group fields.

.

144

Videoscape Distribution Suite Service Manager User Guide

Configuration

URL Signing

URL Signing

Cisco Internet Streamer CDS provides the option for signing and validating content URLs, thus restricting access to some users and limiting the viewing time. For signing and validating the URL, the CDS rely on a set of one or more secret keys shared among the portal and the devices within CDS. This information needs to be configured on the participating Service Engines by the CDN Operator.

To access this feature, perform the following steps:

Step 1

Step 2

From the main page, choose Configuration > CDN . The CDN page is displayed.

Click , which is located next to the CDN.

Step 3

In the Delivery Servers tab, click .

Step 4 The following URL Signing page is displayed.

Column Name

Key Id Owner

Description

Specify the ID number for the owner of this encryption key. Valid entries are from 1 to 32.

Videoscape Distribution Suite Service Manager User Guide

145

URL Signing

Column Name

Key Id Number

Key

Public Key URL

Private Key URL

Symmetric Key

Configuration

Description

Specify the encryption key ID number. Valid entries are from 1 to 16.

Field for Symmetric Key only. Enter a unique URL signature key with up to 16 characters (excluding double quotes at the beginning and end of the string). This field accepts only 7-bit printable ASCII characters (alphabetic, numerics, and others) and does not support a space or the following special characters: pipe (|), question mark (?), double quotes ("), and apostrophe ( ’ ). The following special characters are allowed: {}!#$%&()*+,-./;:<=>@\~^[]_

Quoted and unquoted strings are allowed. Double quotes

(") are allowed at the beginning and end of the string only.

If you do not surround the key string with double quotes, quotes are added when you click Submit .

Field for Asymmetric Key only. The location of the public key file. Only HTTP, HTTPS, or FTP addresses are supported. The public/private key pair is stored in Privacy

Enhanced Mail (PEM) format.

Note While Validation, the public key file is checked if the file size exceeds 2000 bytes and if the file starts with "-----BEGIN PUBLIC KEY-----" and contains "-----END PUBLIC KEY-----" line

Field for Asymmetric Key only. The location of the private key file. Only HTTP, HTTPS, or FTP addresses are supported. The public/private key pair is stored in Privacy

Enhanced Mail (PEM) format.

Note While Validation, the private key file is checked if the file size exceeds 2000 bytes and if the file starts with "-----BEGIN EC PRIVATE KEY-----" and contains "-----END EC PRIVATE KEY-----" line

Field for Asymmetric Key only. A 16-byte American

Encryption Standard (AES) key used for AES encryption of the signed URL.

146

Videoscape Distribution Suite Service Manager User Guide

Configuration

Creating URL Signature

To create a URL Signature, perform the following steps:

Step 1

Step 2

From the main page, choose Configuration > CDN . The CDN page is displayed.

After navigating to the URL Signing page, click .

Creating URL Signature

Step 3 Enter the details as mentioned in the following table:

Field

Cryptographic Algorithm

Description

Choose either Symmetric Key or Asymmetric Key .

Step 4

Note For all the other field information, refer the previous table.

Click Submit .

Editing URL Signature

To edit a URL Signature, perform the following steps:

Step 1

Step 2

From the main page, choose Configuration > CDN . The CDN page is displayed.

After navigating to the URL Signing page, select the URL Signature information, which you want to edit.

Videoscape Distribution Suite Service Manager User Guide

147

Configuration

Deleting URL Signature

Step 3

Step 4

Click .

Enter the required changes and click Submit .

Note For Asymmetric Key, only Private Key URL and Symmetric Key fields can be edited. For Symmetric Key, only the Key field can be edited.

Deleting URL Signature

To delete a URL Signature, perform the following steps:

Step 1

Step 2

Step 3

Step 4

From the main page, choose Configuration > CDN . The CDN page is displayed.

After navigating to the URL Signing page, select the URL Signature information, which you want to delete.

Click .

Click Yes in the Confirmation dialog box.

148

Videoscape Distribution Suite Service Manager User Guide

Configuration

Delivery Services

Adding a Delivery Service

To add a Delivery Service, perform the following steps:

Step 1

Step 2

Step 3

From the main page, choose Configuration > CDN .

Select the CDN to which you want to add a Delivery Service and click .

On the Delivery Services tab, click .

Delivery Services

Step 4 Enter the following details in the Create Delivery Service dialog box:

Videoscape Distribution Suite Service Manager User Guide

149

Configuration

Adding a Delivery Service

Table 115: Adding Delivery Service - Field & Description

Field

Name

Origin FQDN

Preposition Storage Quota (MB)

Skip Encryption for Distribution

Session Quota

Session Quota Augment Buffer (%)

Bandwidth Quota (kbps)

Content Delivery QoS

Service Routing Domain

Bandwidth Quota Augment Buffer (%)

Description

Specify the Delivery Service name.

Specify the FQDN of the Content Provider.

Maximum content disk storage size for each SE, in megabytes, for pre-fetched content and metadata, and hybrid metadata for this delivery service.

Note The Preposition Storage Quota configured does not affect cache content quota size; it only restricts prefetched content storage for each SE. If the total prefetched content storage size is less than the configured quota, then the extra storage is used for dynamic cache files.

Specify whether you need to skip encryption for distribution. Select No for encryption and Yes to skip encryption.

Maximum number of concurrent sessions allowed for this delivery service. The default is zero, which means no session limits are set for this delivery service.

Buffer, as a percentage, of the maximum number of concurrent sessions allowed over the Session Quota. If this threshold is exceeded, no new sessions are created until the number of concurrent sessions is below this threshold.

The range is from 0 to 1000. The default is 10.

Maximum bandwidth allowed for this delivery service. The default is zero, which means no bandwidth limits are set for this delivery service.

This is automatically set as default.

Specify the Service Routing Domain Name.

Buffer, as a percentage, of the maximum bandwidth allowed over the Bandwidth Quota. If this threshold is exceeded, no new sessions are created until the bandwidth used is below this threshold. The range is from 0 to 1000.

The default is 10.

150

Videoscape Distribution Suite Service Manager User Guide

Configuration

Adding a Delivery Service

Field

Is Live

Storage Priority Class

Content Provider

Description

Description

When checked, creates a live program to distribute live or scheduled programs to the SEs associated with this delivery service and with the live program. This delivery service does not have a related Manifest file and cannot be used to distribute file-based content as regular delivery services do. The live program learns about a live stream through a program file that describes the attributes of the program.

Checking this check box disables the Delivery Service

Quota field and fields in the Acquisition and Distribution

Properties section.

Choose the correct option from the drop-down list.

Note This is configured in VDS-IS and is synced automatically.

Associate the delivery service with the content provider.

Optional. Additional information about the Delivery

Service.

Step 5

Step 6

Step 7

Step 8

Step 9

Click Create .

Verify that the Delivery Service has been created successfully by selecting Delivery Services within the CDN page and then verifying that the newly created Delivery Service is present.

Click next to the newly created delivery service to associate delivery servers to it.

Display a list of available delivery servers by clicking .

Select one or multiple delivery servers that will be associated to the delivery service. Then, select the delivery server, which will be the Content Acquirer, from the drop-down list and then click OK .

The Content Acquirer can be changed at any time from the main Delivery Service configuration page, using the Assign

Content Acquirer icon.

Videoscape Distribution Suite Service Manager User Guide

151

Configuration

Deleting a Delivery Service

Deleting a Delivery Service

To delete a delivery service, perform the following steps:

Step 1

Step 2

Step 3

Step 4

From the main page, choose Configuration > CDN .

Select the CDN that you want to delete and click .

In the Delivery Services tab, select the Delivery Service that you want to delete.

Click and in the confirmation dialog box, click Yes to permanently delete the Delivery Service, and click No to cancel the deletion.

Reseller Function Overview

A reseller is a user who buys delivery services from CDN and sells to the content providers. A reseller is allocated a specific session bandwidth storage quota.

Adding a Reseller

To add a reseller, perform the following steps:

Step 1

Step 2

From the main page, choose Configuration > Customers > Reseller .

Click to open the Create Reseller dialog box.

152

Videoscape Distribution Suite Service Manager User Guide

Configuration

Adding a Reseller

Adding a Reseller involves configuring or modifying the following fields:

Table 116: Adding a Reseller - Field & Description

Field

Reseller Name

Reseller Id

Address

Phone

Email

Website

Description

Preposition Storage Quota

(MB)

Description

Specify a unique name for the reseller.

Specify the ID for the reseller.

Specify the IP address or FQDN (full qualified domain name) of this reseller.

Specify the phone number for the reseller.

Specify the email address for the reseller.

Specify the web site URL for the reseller.

Optional. Additional information about the reseller.

Specify the maximum data in MB that can be prepositioned for the reseller.

Videoscape Distribution Suite Service Manager User Guide

153

Configuration

Modifying a Reseller

Field

Session Quota

Bandwidth Quota (Kbps)

User Name

Password

Confirm Password

Description

Specify the maximum number of sessions that can be active for the reseller.

Specify the maximum bandwidth allowed for the reseller.

Specify a user name associated with the reseller.

Specify the user's password associated with this reseller.

Re-enter the user's password associated with this reseller.

Step 3 Click Create to add the Reseller.

Modifying a Reseller

To modify a Reseller, perform the following steps:

Step 1

Step 2

Step 3

From the main page, choose Configuration > Customers > Reseller .

Select the Reseller that you want to modify and click .

On the left pane, enter the modification and click Save .

Deleting a Reseller

To delete a Reseller, perform the following steps:

Step 1

Step 2

Step 3

From the main page, choose Configuration > Customers > Reseller .

Select the Reseller that you want to delete and click .

Click Yes to permanently delete the Reseller, and click No to cancel the deletion.

Content Provider Function Overview

A content provider is a user who buys delivery services from CDN and serves the content.

154

Videoscape Distribution Suite Service Manager User Guide

Configuration

Adding a Content Provider

To add a content provider, perform the following steps:

Step 1

Step 2

From the main page, choose Configuration > Customers > Content Provider .

Click to open the Create Content Provider dialog box.

Adding a Content Provider

Adding a Content Provider involves configuring or modifying the following fields:

Table 117: Adding a Content Provider - Field & Description

Field

Provider Name

Provider Id

Description

Specify a unique name for the content provider.

Specify the ID for the content provider.

Videoscape Distribution Suite Service Manager User Guide

155

Configuration

Mapping a Content Provider and Delivery Service

Field

Address

Phone

Email

Website

Description

Preposition Storage Quota

(MB)

Session Quota

Bandwidth Quota (Kbps)

User Name

Password

Confirm Password

Description

Specify the IP address or FQDN of this content provider.

Specify the phone number for this content provider.

Specify the email address for this content provider.

Specify the web site URL for this content provider.

Optional. Additional information about the content provider.

Specify the maximum data in MB that can be prepositioned for the reseller.

Specify the maximum number of sessions that can be active for the reseller.

Specify the maximum bandwidth allowed for the reseller.

Specify a user name associated with the content provider.

Specify the user's password associated with this content provider.

Re-enter the user's password associated with this content provider.

Step 3

A Content Provider that is not a global Content Provider, will be available under the Reseller option. To view the Reseller option, uncheck Global Content Provider. From the Reseller drop-down, choose the Reseller, which you want to associate the Content Provider to.

Click Create to add the Content Provider.

Mapping a Content Provider and Delivery Service

To map a Content Provider and Delivery Service, perform the following steps:

Before You Begin

Before you map a Content Provider and Delivery Service, you need to first create the Delivery Service in

CDN. For this, you need to add CDN (see

Adding a CDN, on page 140

). After you add CDN, you need to add a Delivery Service (see

Adding a Delivery Service, on page 149

).

Step 1

Step 2

Step 3

Step 4

Step 5

From the main page, choose Configuration > Customers > Content Provider .

Select the Content Provider that you want to assign Delivery Service, and click .

Click and select the Delivery Service that you need to map.

Select the CDN that you want to map and click .

Click Save .

156

Videoscape Distribution Suite Service Manager User Guide

Configuration

Assigning Multiple Content Providers to a Single Delivery Service

If you want to assign multiple Content Providers to a single Delivery Service, you must not map Content Provider and

Delivery Service.

Assigning Multiple Content Providers to a Single Delivery Service

This feature enables the user to set up multiple Content Providers to a single Delivery Service. This is feasible by providing custom Regex option, wherein the CDN Operator can provide the Regex for new field CP_ID.

This custom regex is used to extract CP_ID from the URL and then perform a lookup to get a meaningful CP name. If the CDN Operator needs to use Asset ID to obtain meaningful CP name, then the Asset ID and CP_ID will have the same Regex for token extraction from the URL. CDN Operators can either create or update

Regex for CP_ID extraction. Regex is maintained in props.conf, a Splunk configuration file.

To create or update Regex for CP_ID, perform the following steps:

Step 1

Step 2

Log in to the analytics JS node using the following credentials:

Username: bnisplunk

Password: password

Execute the script configure_regex.py using the following command to add/update:

$SPLUNK_HOME/bin/splunk cmd python $SPLUNK_HOME/etc/apps/CDN_JS/bin/configure_regex.py add

<sourcetype> <fieldname> "<regex>"

Where, <sourcetype> is the sourcetype for which the regex is provided.

The valid source types are: fms_disconnect, wmt_logplaystats, we_access, abr_session and sr_transaction

<regex> — regex to extract the Content Provider information from the log data

<fieldname> — the valid field names are CP_ID and Asset

Example:

For the following log file entry:

[28/Nov/2012:23:54:42.315+0000] 1799 74.126.71.217 TCP_HIT/206 2458 GET http://ccp-cmc-smooth-localpod02linear.cdn2.net/content/CP1/hls/file0/file_500.m3u8 application/x-mpegURL - hls 0 - 20121129100000000100000001

[29/Nov/2012:00:00:02.317+0000] External –

Case1 : If you want to extract content/CP1 as CP_ID, then the Regex is:

“ (?i)^(?:[^ ]*( {1,2})){6}(?:[a-z]+://)(?:[^ /:]+[^ /]+/)(?P<CP_ID>[^ /]+/[^ /]+) ”

Case 2 : If you want to extract CP1 as CP_ID, then the Regex is:

“ (?i)^(?:[^ ]*( {1,2})){6}(?:[a-z]+://)(?:[^ /:]+[^ /]+/[^ /]+/)?(?P<CP_ID>[^ /]+) ”

Case 3 : If you want to extract file_500.m3u8 as Asset, then the Regex is:

“ (?i)^(?:[^ ]*( {1,2})){6}(?:[a-z]+://)(?:[^ /:]+[^ /]+/[^ /]+/[^ /]+/[^ /]+/[^ /]+/)(?P<Asset>[^ ]+) ”

Once this script is executed, redeployment of the server is initiated automatically.

To delete Regex for CP_ID, use the following command:

Videoscape Distribution Suite Service Manager User Guide

157

Configuration

Modifying a Content Provider

#$SPLUNK_HOME/bin/splunk cmd python configure_regex.py <remove> <sourcetype> <fieldname>

Modifying a Content Provider

To modify a Content Provider, perform the following steps:

Step 1

Step 2

Step 3

From the main page, choose Configuration > Customers > Content Provider .

Select the Content Provider that you want to modify and click .

In the left pane, enter the modification and click Save .

Deleting a Content Provider

To delete a Content Provider, perform the following steps:

Step 1

Step 2

Step 3

From the main page, choose Configuration > Customers > Content Provider .

Select the Content Provider that you want to delete and click .

Click Yes to permanently delete the Content Provider, and click No to cancel deletion.

Services

This feature provides a quick overview of the bandwidth, session, and storage quota for each reseller, content provider, and delivery service in the CDN to the CDN Operator. These quotas need to be specified when you create delivery service, content provider, and reseller.

To access this feature, from the main page, click Configuration > Services .

On the right pane, the overall CDN Operator allocation is displayed.

To view the bandwidth, session, and storage quota for each reseller, on the left pane, click the arrow next to the CDN Operator. The resellers under the CDN Operator are displayed. Select a specific reseller to view the allocation.

158

Videoscape Distribution Suite Service Manager User Guide

Configuration

Services

To view the bandwidth, session, and storage quota of each content provider, on the left pane, click the arrow next to the respective reseller. The content providers under the resellers are displayed. Select a specific content provider to view the allocation.

To view the delivery services of each content provider, on the left pane, click the arrow next to the respective content provider. The delivery services under the content providers are displayed.

Note Utilization shown in the data grid is the actual CDN utilization.

Videoscape Distribution Suite Service Manager User Guide

159

Configuration

Geo Fencing

Geo Fencing

A Geo/IP file is an XML file that configures the delivery service to allow or deny client requests, based on the client ’ s IP address or client ’ s geographic locations (country, state, city). Each Service Engine participating in the Authorization Service must have Authorization Service enabled and the IP address and port of the

Geo-Location server specified. VDS-IS provides an option to apply Geo/IP file and restrict access to the content, based on location. Geo Fencing enables the Content Providers and CDN Operators to assign a Geo

IP file to a delivery service or to disassociate a Geo IP file from a delivery service.

Assigning a Geo/IP file to a Delivery Service

To assign a Geo IP file to a delivery service, perform the following steps:

Step 1 From the main page, choose Configuration > Geo Fencing .

Step 2

Step 3

Step 4

Choose the CDN from the Select CDN drop-down list.

Click Browse next to Geo/IP File Upload text box to select the Geo IP file. The Geo IP file is an XML file.

Click Validate to validate the selected Geo IP file. This displays the details on the right pane.

160

Videoscape Distribution Suite Service Manager User Guide

Configuration

Disassociating a Geo/IP file from a Delivery Service

Step 5

Step 6

Step 7

The Destination File Name is auto populated when you select a Geo IP file. If the users want to edit, they can edit as desired.

Choose the delivery service from the Apply to Delivery Service drop-down list to which the file needs to be assigned to.

Click Submit . The Geo IP file will be associated with the delivery service successfully.

Disassociating a Geo/IP file from a Delivery Service

To disassociate a Geo IP file associated with a delivery service, perform the following steps:

Step 1

Step 2

Step 3

From the main page, choose Configuration > Geo Fencing .

Choose the delivery service from the Apply to Delivery Service drop-down list.

Click Delete . This will disassociate the Geo IP file from the selected delivery service and this deletes the file from the system.

Note To delete a Geo IP file, the file should not be associated with any delivery services.

Content Purging

Content purging enables the wholesale users (both the Resellers and Content Providers) to delete the dynamically cached content from the delivery servers that deliver content through the delivery services assigned to them.

Videoscape Distribution Suite Service Manager User Guide

161

Configuration

Deleting Content

By default, all content deletion requests will be sent as synchronous requests. To send requests that have wildcard characters in a URL as asynchronous, add the following configuration in Global Configurations after choosing cdnmanager from the Property View drop-down list

Deleting Content

To delete the content, perform the following steps:

Step 1 From the main page, choose Configuration > Content Purging . This shows the deletion tasks table where the tasks for deletion requests are created.

Table 118: Deletion Tasks Table

Column Name

Created Date

Type

Total SEs

Completed SEs

Status

Comment

162

Videoscape Distribution Suite Service Manager User Guide

Description

Date on which content deletion request is created on

VDS-IS.

Two types namely API and GUI.

• API — Tasks created through VDS-SM by using REST

APIs that are exposed by VDS-IS.

• CDSM GUI — Tasks created through VDS-IS GUI.

Total number of Service Engines to which the deletion request is sent.

Number of Service Engines in which the deletion request is completed.

Status of deletion task.

Comments given at the time of deletion request.

Configuration

Deleting Content

When you click , the Task Result page is displayed. This displays the content deletion request details.

Step 2

Click to open the Content Deletion dialog box.

Videoscape Distribution Suite Service Manager User Guide

163

Configuration

Deleting Content

Step 3

Step 4

Step 5

Step 6

Step 7

Choose the CDN from the Select CDN drop-down list.

Enter the content URL in the Content URL text box. By entering the content URL, the Delivery Server(s) field will be populated with the delivery servers associated with the delivery services that serve the given content URL.

Enter the comments in the Comments text box.

Select the desired delivery server(s) from the Delivery Server(s) field from which the content needs to be deleted. If no delivery servers are selected, then the content will be deleted from all delivery servers that are associated with the delivery services that serve the given content.

Click Submit . The content from the selected delivery server(s) will be deleted successfully and the deletion details will be included in the deletion tasks table.

By clicking the Refresh icon, the content deletion task table is refreshed.

164

Videoscape Distribution Suite Service Manager User Guide

C H A P T E R

8

Administration

System Load Dashboard, page 165

License Usage , page 167

Managing Users and Roles Overview, page 168

About User Accounts, page 168

Roles, page 169

Global Configurations, page 170

CDN Health, page 171

System Load Dashboard

Displays charts that represents Percent Load by Host, Percent Memory Used by Host , Disk Used by Host and Volume, and Interface Throughput, across the nodes in the system.

To access System Load Dashboard, from the main page, choose Administration > System Load Dashboard .

Percent Load by Host

Videoscape Distribution Suite Service Manager User Guide

165

System Load Dashboard

Percent Memory Used by Host

Disk Used by Host and Volume

166

Videoscape Distribution Suite Service Manager User Guide

Administration

Administration

License Usage

Interface Throughput

License Usage

The License Usage dashboard displays the amount of logs indexed in the system.

To access the License Usage dashboard, from the main page, choose Administration > License Usage .

Videoscape Distribution Suite Service Manager User Guide

167

Administration

Managing Users and Roles Overview

The following table describes the chart available within this dashboard.

Table 119: License Usage Chart & Description

Chart Description

License Usage Illustrates the amount of logs indexed in the system.

Chart

Information

The information within this chart is shown as a line graph with the Date/Time along the

X-axis and the License Usage in GB along the Y-axis. The legends representing the graph are by total data Delivered and GB data indexed.

Chart Formula The formula used to derive the graph is: total log files indexed in the system vs. the total data delivered within the CDN.

Chart Filters This chart uses Time Range Picker - Last 7 days, Last 30 days, Last 90 days, Last 365 days, and Custom time, as filters.

Note You can configure the group ID and label in the common.conf

file according to your splunk license. The common.conf file is available in the Job Scheduler node at the following location:

/opt/splunk/etc/deployment-apps/appnormalize/bin

Depending on the configuration made in the common.conf file, the License Quota value will vary.

Managing Users and Roles Overview

Administrators can create specific users and set their roles from the User Management page.

To access User Management, from the main page, choose Administration > User Management . In this feature, you can add and delete a user.

About User Accounts

User accounts define user roles and access privileges to system configuration and management functional areas.

The CDN Manager includes a default user profile with Cisco Administrator access privileges, to provide the

Network Administrator first-time access to the CDN Manager system.

Administrator privileges provide full rights to all system functions. You must have Administrator privileges to define roles and grant access permissions to system functions.

Note For added security, we recommend that you replace the Cisco Administrator account with a new

Administrator user account, specific to only your network management.

168

Videoscape Distribution Suite Service Manager User Guide

Administration

Roles

A user's role dictates the functional area and level of access that is granted to the user.

Following is a list of the supported roles:

• CDN Operator Administrator

• CDN Operator Viewer

• Reseller Administrator

• Reseller Viewer

• Content Provider Administrator

• Content Provider Viewer

Adding a User

Adding a user involves:

• Creating the user

• Defining the user's role

Note You must have Administrator rights to add a user.

To add a user, perform the following steps:

Step 1 From the main page, choose Administration > User Management .

Roles

Step 2

Step 3

Step 4

Step 5

Click to add the user and define the user's role.

In the Create New User dialog, type the values in the fields or select an option from the drop-down list.

Add the user's name and password. By default, the role is set to Admin.

Click Create .

Videoscape Distribution Suite Service Manager User Guide

169

Administration

Deleting a User

Deleting a User

To delete a user, perform the following steps:

Step 1

Step 2

Step 3

Step 4

From the main page, choose Administration > User Management .

From the User Management page, select the user you want to delete.

Click .

Click Yes in the confirmation dialog box.

The user will be deleted.

Global Configurations

Configuration includes any settings that exist on an Appliance , which an end-user might modify in the following ways:

• Using the Appliance Agent (rAPA) User Interface (UI) or Manager User Interface

• A manual edit to a specific file using a documented procedure; for example, file system modification of jboss-log4j.xml or workflows

• By copying a modified file onto the appliance from elsewhere

Important!

Modifying a Global Configuration can have a major impact on the running system. A parameter change should only be made by a System Administrator who has a detailed understanding about the impact of the change on the running system.

A baseline configuration is established at the conclusion of installing each appliance. Any parameters not mentioned in this document (for example, tty device definitions) should be considered non-modifiable.

The following lists the configuration parameter elements:

• Configuration Elements : Kinds of configuration settings used by the system; for example, topology or configuration database, workflow, and so on.

• Appliance Configuration Parameters : Summary of all parameters used in configuring appliances with description, value type, and so on.

• Solution Node Settings : Settings recorded on each node, which define that node's specific role in the overall solution.

• Global Configuration Settings : Globally visible configuration sections, each containing a description of all parameters in the section, including the product defaults.

• System Topology : Topology data and its usage, import/export operations and the export schema.

170

Videoscape Distribution Suite Service Manager User Guide

Administration

Adding Global Configurations

• Configuration Files : Essential files for each appliance that contain the configuration for the appliance.

To access Global Configurations, choose Administration > Global Configurations .

Adding Global Configurations

To add global configurations, perform the following steps:

Step 1

Step 2

Step 3

From the main page, choose Administration > Global Configurations .

Click to add global configurations.

Enter the details and click OK and then click Save .

Deleting Global Configurations

To delete global configurations, perform the following steps:

Step 1

Step 2

Step 3

Step 4

From the main page, choose Administration > Global Configurations .

Select the Global configuration you want to delete.

Click .

Click OK and then click Save .

CDN Health

Monitoring the health of CDN network can help prevent the CDN network from getting to a state in which your users cannot access the network or the data on it. VDS-SM provides an option to monitor the health of the CDN network resources in real-time and as trends.

The following categories are displayed in CDN Health:

• Monitor

• Trend

Enabling Service Monitor Transaction Log

CDN Health charts will be displayed only when the Service Monitor transaction log is forwarded from VDS-IS to VDS-SM.

Videoscape Distribution Suite Service Manager User Guide

171

Administration

Monitor

Enabling Service Monitor (SE) Transaction Log

To enable and export Service Engine transaction log, perform the following steps:

Note You can perform the below steps only if you have installed VDS-IS version that supports Service Monitor functionality.

Step 1

Step 2

Step 3

Step 4

Step 5

Login to the CDSM UI.

Click Devices and select the required Service Engine.

In the right pane, choose Service Control > Transaction Logging .

From Monitors table, check the Service Monitor check box.

Click Submit .

Enabling Service Monitor (SR) Transaction Log

To enable and export Service Router transaction log, perform the following steps:

Note You can perform the below steps only if you have installed VDS-IS version that supports Service Monitor functionality.

Step 1

Step 2

Step 3

Step 4

Step 5

Login to the CDSM UI.

Click Devices and select the required Service Router.

In the right pane, choose General Settings > Notification and Tracking > Transaction Logging .

From Monitors table, check the Service Monitor check box.

Click Submit .

Monitor

Monitor dashboard displays metrics indicating the health of system resources in real-time.

To access the Monitor dashboard, from the Home page, choose Administration > CDN Health > Monitor .

The following parameters are displayed in the Monitor dashboard:

• CPU Usage

• Memory Usage

172

Videoscape Distribution Suite Service Manager User Guide

Administration

CPU Usage

• Disk Usage

• CPU Usage by Protocol Engines

• Memory Usage by Protocol Engines

• Stopped Protocol Engines

• Threshold Exceeded Protocol Engines

Monitor

The following table describes the CPU Usage chart:

Table 120: CPU Usage Chart & Description

Chart

CPU Usage

Chart Information

Chart Filters

Description

Illustrates the percentage of CPU consumed by a delivery server in real-time.

The information within this chart is shown in an area graph with Date/Time along the X-axis and the CPU usage as Percentage along the Y-axis. The legend representing the graph is Average.

This chart uses Delivery Server as a filter.

Videoscape Distribution Suite Service Manager User Guide

173

Administration

Monitor

Memory Usage

The following table describes the Memory Usage chart:

Table 121: Memory Usage Chart & Description

Chart

Memory Usage

Chart Information

Chart Filters

Description

Illustrates the percentage of memory consumed by a delivery server in real-time.

The information within this chart is shown in an area graph with Date/Time along the X-axis and the memory usage as Percentage along the Y-axis. The legend representing the graph is Average.

This chart uses Delivery Server as a filter.

174

Videoscape Distribution Suite Service Manager User Guide

Administration

Disk Usage

Monitor

The following table describes the Disk Usage chart:

Table 122: Disk Usage Chart & Description

Chart

Disk Usage

Chart Information

Chart Filters

Description

Illustrates the percentage of disk consumed by a delivery server in real-time.

The information within this chart is shown in an area graph with Date/Time along the X-axis and the disk usage as Percentage along the Y-axis. The legend representing the graph is Average.

This chart uses Delivery Server as a filter.

Videoscape Distribution Suite Service Manager User Guide

175

Administration

Monitor

CPU Usage by Protocol Engines

The following table describes the CPU Usage by Protocol Engines chart:

Table 123: CPU Usage by Protocol Engines Chart & Description

Chart

CPU Usage by Protocol Engines

Chart Information

Chart Filters

Description

Illustrates the percentage of CPU consumed by the protocol engines of a delivery server in real-time.

The information within this chart is shown in a line graph with Date/Time along the X-axis and the CPU usage as Percentage along the Y-axis. The legends representing the graph are protocol engines.

This chart uses Delivery Server as a filter.

176

Videoscape Distribution Suite Service Manager User Guide

Administration

Memory Usage by Protocol Engines

Monitor

The following table describes the Memory Usage by Protocol Engines chart:

Table 124: Memory Usage by Protocol Engines Chart & Description

Chart

Memory Usage by Protocol Engines

Chart Information

Chart Filters

Description

Illustrates the memory consumed by the protocol engines of a delivery server in real-time.

The information within this chart is shown in a line graph with Date/Time along the X-axis and the memory usage as MB along the Y-axis. The legends representing the graph are protocol engines.

This chart uses Delivery Server as a filter.

Videoscape Distribution Suite Service Manager User Guide

177

Administration

Monitor

Stopped Protocol Engines

The following table describes the information in the table:

Table Description

Stopped Protocol Engines Illustrates whether the protocol engines were fully functional without any stoppages in a given minute.

• Red — Protocol Engine stopped at least once.

• Green — Protocol Engine was fully functional.

Table Information

Table Filters

The information within this table are -time, and protocol engines.

This table uses Delivery Server as a filter.

178

Videoscape Distribution Suite Service Manager User Guide

Administration

Threshold Exceeded Protocol Engines

Trend

The following table describes the information in the table:

Table Description

Threshold Exceeded Protocol Engines Indicates whether the protocol engines exceeded the thresholds in a given minute.

• Red — Threshold exceeded at least once.

• Green — Below the threshold.

Table Information

Table Filters

The information within this table are -time, and protocol engines.

This table uses Delivery Server as a filter.

Trend

This features allows you to view the health of system resources based on the historical data (up to seven days) gathered. The following tabs are displayed in Trend:

• Service Engine

• Service Router

Service Engine

This tab displays charts that indicates the health of system resources at service engine level.

To access this tab, from the Home page, choose Administration > CDN Health > Trend > Service Engine .

The following metrics are displayed here:

Videoscape Distribution Suite Service Manager User Guide

179

Trend

CPU Usage

• CPU Usage

• Memory Usage

• Disk Usage

• CPU Usage by Protocol Engines

• Memory Usage by Protocol Engines

• TCP Server Connections

• TCP Client Connections

Administration

The following table describes the CPU Usage chart:

Table 125: CPU Usage Chart & Description

Chart

CPU Usage

Chart Information

Description

Illustrates the percentage of CPU consumed by a delivery server for the specified time range.

The information within this chart is shown in an area graph with Date/Time along the X-axis and the CPU usage as Percentage along the Y-axis. The legend representing the graph is Average.

180

Videoscape Distribution Suite Service Manager User Guide

Administration

Memory Usage

Chart Formula

Chart Filters

Trend

The formula used to derive the graph is: average of

CPU usage (%) for the given delivery server.

This chart uses Time Range, Delivery Server Group, and Delivery Server as filters.

The following table describes the Memory Usage chart:

Table 126: Memory Usage Chart & Description

Chart

Memory Usage

Chart Information

Chart Formula

Description

Illustrates the percentage of memory consumed by a delivery server for the specified time range.

The information within this chart is shown in an area graph with Date/Time along the X-axis and the memory usage as Percentage along the Y-axis. The legend representing the graph is Average.

The formula used to derive the graph is: average of memory usage (%) for the given delivery server.

Videoscape Distribution Suite Service Manager User Guide

181

Trend

Disk Usage

Chart Filters

Administration

This chart uses Time Range, Delivery Server Group, and Delivery Server as filters.

The following table describes the Disk Usage chart:

Table 127: Disk Usage Chart & Description

Chart

Disk Usage

Chart Information

Chart Formula

Chart Filters

Description

Illustrates the percentage of disk consumed by a delivery server for the specified time range.

The information within this chart is shown in an area graph with Date/Time along the X-axis and the disk usage as Percentage along the Y-axis. The legend representing the graph is Average.

The formula used to derive the graph is: average of disk usage (%) for the given delivery server.

This chart uses Time Range, Delivery Server Group, and Delivery Server as filters.

182

Videoscape Distribution Suite Service Manager User Guide

Administration

CPU Usage by Protocol Engines

Trend

The following table describes the CPU Usage by Protocol Engines chart:

Table 128: CPU Usage by Protocol Engines Chart & Description

Chart

CPU Usage by Protocol Engines

Chart Information

Chart Formula

Description

Illustrates the percentage of CPU consumed by a protocol engine of a delivery server for the specified time range.

The information within this chart is shown in a line graph with Date/Time along the X-axis and the CPU usage as Percentage along the Y-axis. The legends representing the graph are Maximum, Minimum, and

Average.

The formula used to derive the graph is:

• Maximum — Maximum of CPU usage (%) for the given delivery server.

• Minimum — Minimum of CPU usage (%) for the given delivery server.

• Average — Average of CPU usage (%) for the given delivery server.

Chart Filters This chart uses Protocol Engine, Time Range,

Delivery Server Group, and Delivery Server as filters.

Videoscape Distribution Suite Service Manager User Guide

183

Administration

Trend

Memory Usage by Protocol Engines

The following table describes the Memory Usage by Protocol Engines chart:

Table 129: Memory Usage by Protocol Engines Chart & Description

Chart

Memory Usage by Protocol Engines

Chart Information

Chart Formula

Description

Illustrates the memory consumed by a protocol engine of a delivery server for the specified time range.

The information within this chart is shown in a line graph with Date/Time along the X-axis and the memory usage as MB along the Y-axis. The legends representing the graph are Maximum, Minimum, and

Average.

The formula used to derive the graph is:

• Maximum — Maximum of memory usage (MB) for the given delivery server.

• Minimum — Minimum of memory usage (MB) for the given delivery server.

• Average — Average of memory usage (MB) for the given delivery server.

Chart Filters This chart uses Protocol Engine, Time Range,

Delivery Server Group, and Delivery Server as filters.

184

Videoscape Distribution Suite Service Manager User Guide

Administration

TCP Server Connections

Trend

The following table describes the TCP Server Connections chart:

Table 130: TCP Server Connections Chart & Description

Chart

TCP Server Connections

Chart Information

Chart Formula

Chart Filters

Description

Illustrates the number of TCP server connections established in a delivery server for the specified time range.

The information within this chart is shown in a line graph with Date/Time along the X-axis and Count of

TCP server connections along the Y-axis. The legends representing the graph are Maximum, Minimum, and

Average.

The formula used to derive the graph is: maximum, minimum, and average TCP server connections for the given delivery server.

This chart uses Time Range, Delivery Server Group, and Delivery Server as filters.

Videoscape Distribution Suite Service Manager User Guide

185

Administration

Trend

TCP Client Connections

The following table describes the TCP Client Connections chart:

Table 131: TCP Client Connections Chart & Description

Chart

TCP Client Connections

Chart Information

Chart Formula

Chart Filters

Description

Illustrates the number of TCP client connections established in a delivery server for the specified time range.

The information within this chart is shown in a line graph with Date/Time along the X-axis and Count of

TCP client connections along the Y-axis. The legends representing the graph are Maximum, Minimum, and

Average.

The formula used to derive the graph is: maximum, minimum, and average TCP client connections for the given delivery server.

This chart uses Time Range, Delivery Server Group, and Delivery Server as filters.

186

Videoscape Distribution Suite Service Manager User Guide

Administration

Trend

Service Router

This tab displays charts that indicates the health of system resources at service router level.

To access this tab, from the Home page, choose Administration > CDN Health > Trend > Service Router .

The following metrics are displayed here:

• CPU Usage

• Memory Usage

• Disk Usage

• CPU Usage for Service Routing

• Memory Usage for Service Routing

• TCP Server Connections

• TCP Client Connections

CPU Usage

The following table describes the CPU Usage chart:

Table 132: CPU Usage Chart & Description

Chart Description

Videoscape Distribution Suite Service Manager User Guide

187

Trend

Memory Usage

CPU Usage

Chart Information

Chart Formula

Chart Filters

Administration

Illustrates the percentage of CPU consumed by a service router for the specified time range.

The information within this chart is shown in an area graph with Date/Time along the X-axis and the CPU usage as Percentage along the Y-axis. The legend representing the graph is Average.

The formula used to derive the graph is: average of

CPU usage (%) for the given service router.

This chart uses Time Range, and Service Router as filters.

The following table describes the Memory Usage chart:

Table 133: Memory Usage Chart & Description

Chart

Memory Usage

Description

Illustrates the percentage of memory consumed by a service router for the specified time range.

188

Videoscape Distribution Suite Service Manager User Guide

Administration

Disk Usage

Chart Information

Chart Formula

Chart Filters

Trend

The information within this chart is shown in an area graph with Date/Time along the X-axis and the memory usage as Percentage along the Y-axis. The legend representing the graph is Average.

The formula used to derive the graph is: average of memory usage (%) for the given service router.

This chart uses Time Range, and Service Router as filters.

The following table describes the Disk Usage chart:

Table 134: Disk Usage Chart & Description

Chart

Disk Usage

Chart Information

Description

Illustrates the percentage of disk consumed by a service router for the specified time range.

The information within this chart is shown in an area graph with Date/Time along the X-axis and the disk usage as Percentage along the Y-axis. The legend representing the graph is Average.

Videoscape Distribution Suite Service Manager User Guide

189

Trend

Chart Formula

Chart Filters

CPU Usage for Service Routing

Administration

The formula used to derive the graph is: average of disk usage (%) for the given service router.

This chart uses Time Range, and Service Router as filters.

The following table describes the CPU Usage for Service Routing chart:

Table 135: CPU Usage for Service Routing Chart & Description

Chart

CPU Usage for Service Routing

Chart Information

Description

Illustrates the maximum, minimum, and average percentage of CPU consumed by a service router for the specified time range.

The information within this chart is shown in a line graph with Date/Time along the X-axis and the CPU usage as percentage along the Y-axis. The legends representing the graph are Maximum, Minimum, and

Average

190

Videoscape Distribution Suite Service Manager User Guide

Administration

Chart Formula

Chart Filters

Memory Usage for Service Routing

Trend

The formula used to derive the graph is:

• Maximum — Maximum of CPU usage (%) for the given service router.

• Minimum — Minimum of CPU usage (%) for the given service router.

• Average — Average of CPU usage (%) for the given service router.

This chart uses Time Range, and Service Router as filters.

The following table describes the Memory Usage for Service Routing chart:

Table 136: Memory Usage for Service Routing Chart & Description

Chart

Memory Usage for Service Routing

Description

Illustrates the maximum, minimum, and average memory consumed by a service router for the specified time range.

Videoscape Distribution Suite Service Manager User Guide

191

Trend

Chart Information

Chart Formula

Chart Filters

TCP Server Connections

Administration

The information within this chart is shown in a line graph with Date/Time along the X-axis and the memory usage as MB along the Y-axis. The legends representing the graph are Maximum, Minimum, and

Average.

The formula used to derive the graph is:

• Maximum — Maximum of memory usage (MB) for the given service router.

• Minimum — Minimum of memory usage (MB) for the given service router.

• Average — Average of memory usage (MB) for the given service router.

This chart uses Time Range, and Service Router as filters.

The following table describes the TCP Server Connections chart:

Table 137: TCP Server Connections Chart & Description

Chart Description

192

Videoscape Distribution Suite Service Manager User Guide

Administration

TCP Server Connections

Chart Information

Chart Formula

Chart Filters

TCP Client Connections

Trend

Illustrates the number of TCP server connections established in a service router for the specified time range.

The information within this chart is shown in a line graph with Date/Time along the X-axis and Count of

TCP server connections along the Y-axis. The legends representing the graph are Maximum, Minimum, and

Average.

The formula used to derive the graph is: maximum, minimum, and average TCP server connections for the given service router.

This chart uses Time Range, and Service Router as filters.

The following table describes the TCP Client Connections chart:

Table 138: TCP Client Connections Chart & Description

Chart

TCP Client Connections

Description

Illustrates the number of TCP client connections established in a service router for the specified time range.

Videoscape Distribution Suite Service Manager User Guide

193

Trend

Chart Information

Chart Formula

Chart Filters

Administration

The information within this chart is shown in a line graph with Date/Time along the X-axis and Count of

TCP client connections along the Y-axis. The legends representing the graph are Maximum, Minimum, and

Average.

The formula used to derive the graph is: maximum, minimum, and average TCP client connections for the given service router.

This chart uses Time Range, and Service Router as filters.

194

Videoscape Distribution Suite Service Manager User Guide

C H A P T E R

9

Troubleshooting

Troubleshooting Analytics Dashboards, page 195

Troubleshooting Splunk Licensing Issues, page 196

Troubleshooting Splunk Forwarder Issues, page 197

Troubleshooting the Splunk Indexer, page 198

Troubleshooting the Analytics Search Head, page 199

Troubleshooting VDS-IS Provisioning, page 201

Deleting Summarized Data, page 201

Splunk License Violation, page 202

Troubleshooting Analytics Dashboards

The analytics system is a critical tool for troubleshooting run-time issues, as well as providing trending information that can be used for capacity planning and other purposes. If it is not properly operating, the ability to use it for troubleshooting is lost.

The most commonly observed behavior of the analytics system that is not working, is a lack of data. If any of the above functions are not operating properly, the Dashboards and Reports data may not appear, and the message “ no result found ” is displayed.

The following list provides possible problems that could arise while using the VDS Analytics:

• Splunk licensing

• Splunk Forwarder not operating correctly

• Analytics Indexer not operating

• Search Head not operating

Videoscape Distribution Suite Service Manager User Guide

195

Troubleshooting

Troubleshooting Splunk Licensing Issues

Troubleshooting Splunk Licensing Issues

Depending on the browser being used, either Internet Explorer (IE) or Firefox, Splunk licensing issues may cause different errors to appear.

The following are examples of a Splunk licensing errors.

• Splunk licensing issues in IE.

• Splunk licensing issues in Firefox. In Firefox, an insecurelogin file will start to download. For example:

To troubleshoot Splunk licensing issues, perform the following steps:

Step 1

Step 2

Copy the Splunk license file to your local machine, taking care to note the location, which will be used later in this procedure.

Open the Splunk manager app on the Job Scheduler. Using the following:

Example: http://<IP of Job Sched>:8000/en-us/manager

Username: Admin or admin

Example:

196

Videoscape Distribution Suite Service Manager User Guide

Troubleshooting

Troubleshooting Splunk Forwarder Issues

Step 3

Step 4

Step 5

Step 6

Step 7

Password: Beaumaris1

Choose Settings > Licensing .

Select Add License .

Browse your machine to the location where you copied the license file.

Note: Do not change the filename.

Select Install .

Return to the Licensing page and confirm whether the new license is added and is valid.

Troubleshooting Splunk Forwarder Issues

To verify that the Splunk Forwarder is functioning correctly, ensure that the application node expected to supply data, has an active forwarder.

To do this, perform the following steps:

Step 1

Step 2

Step 3

Step 4

SSH to the Forwarder.

Login to the Forwarder using, username: bninet and password: password .

At the Forwarder prompt, enter the PS command to verify that the Splunk Forwarder is running. For example:

Example:

[ bninet@FW ~]$ ps eax | grep splunkd | grep 8088

2256 ? Sl 0:52 splunkd -p 8088 start CONSOLE=/ dev /console SELINUX_IN IT=YES SHELL=/bin/bash TERM= linux USER= bninet INIT_VERSION=sysvinit-2.86 PATH=/h ome / bninet / splunkforwarder /bin:/ sbin :/ usr / sbin

:/bin:/ usr /bin _=/home/ bninet / splu nkforwarder /bin/ splunk runlevel =3 RUNLEVEL=3 PWD=/ LANG=en_US.UTF-8 previous=N P REVLEVEL=N SHLVL=3 HOME=/home/ bninet LOGNAME= bninet HOSTNAME=FW

SPLUNK_HOME=/ hom e/ bninet / splunkforwarder SPLUNK_DB=/home/ bninet / splunkforwarder / var /lib/ splunk

S PLUNK_SERVER_NAME= splunkforwarder SPLUNK_WEB_NAME= splunkweb LD_LIBRARY_PATH=/ hom e/ bninet / splunkforwarder /lib LDAPCONF=/home/ bninet / splunkforwarder / etc / openldap / ldap.conf

2257 ? Ss 0:04 splunkd -p 8088 start CONSOLE=/ dev /console SELINUX_IN IT=YES SHELL=/bin/bash TERM= linux USER= bninet INIT_VERSION=sysvinit-2.86 PATH=/h ome / bninet / splunkforwarder /bin:/ sbin :/ usr / sbin

:/bin:/ usr /bin _=/home/ bninet / splu nkforwarder /bin/ splunk runlevel =3 RUNLEVEL=3 PWD=/ LANG=en_US.UTF-8 previous=N P REVLEVEL=N SHLVL=3 HOME=/home/ bninet LOGNAME= bninet HOSTNAME=FW

SPLUNK_HOME=/ hom e/ bninet / splunkforwarder SPLUNK_DB=/home/ bninet / splunkforwarder / var /lib/ splunk

S PLUNK_SERVER_NAME= splunkforwarder SPLUNK_WEB_NAME= splunkweb LD_LIBRARY_PATH=/ hom e/ bninet / splunkforwarder /lib LDAPCONF=/home/ bninet / splunkforwarder / etc / openldap / ldap.conf

[ bninet@FW ~]$

If Splunk Forwarder is not running, restart it by using the following command. In the following example, a Splunk

Forwarder restart example is shown.

Example:

/ etc / init.d / splunkforwarder restart

Restarting Splunk ...

Videoscape Distribution Suite Service Manager User Guide

197

Troubleshooting

Troubleshooting the Splunk Indexer

Password:

Stopping splunkd ...

Shutting down. Please wait, as this may take a few minutes.

. [ OK ]

Stopping splunk helpers...

[ OK ]

Done.

Splunk > Needle. Haystack. Found.

Checking prerequisites...

Checking mgmt port [8088]: open

Checking conf files for typos...

All preliminary checks passed.

Starting splunk server daemon ( splunkd )...

[ OK ]

Done.touch : cannot touch `/ var /lock/ subsys / splunk ': Permission denied

If the nodes are forwarding, there should be constant updates in the splunkd log file located in

"/opt/splunkforwarder/var/log/splunk". If the processes are running and the log is not being updated, contact Cisco

Customer Support.

Troubleshooting the Splunk Indexer

Once the Analytic Forwarder is verified to be functioning properly, verify the operation of Splunk Indexer.

To do this, perform the following steps:

Step 1

Step 2

Step 3 ssh into the IP address of the Indexer.

Using the netstat command, list the monitoring ports. For example:

Example:

[ bninet@IDX netstat -a 2>>/ dev /null | grep 8089t tcp 0 0 *:8089 *:* LISTEN

[bninet@IDX ~]$

If there are no jobscheduler processes listening on port 8089, then the indexer is not functioning. Restart the indexer.

For example:

Example:

[ bninet@IDX ~]$ sudo / etc / init.d / splunk restart

198

Videoscape Distribution Suite Service Manager User Guide

Troubleshooting

Troubleshooting the Analytics Search Head

Restarting Splunk ...

splunkweb is not running.

Stopping splunkd ...

Shutting down. Please wait, as this may take a few minutes.

....... [ OK ]

Stopping splunk helpers... [ OK ]

Done.

Splunk > The IT Search Engine.

Checking prerequisites...

Checking mgmt port [8089]: open

Checking configuration... Done.

Checking index directory...

Validated databases: _audit _ blocksignature _internal _ thefishbucket cdn-mgr cdnmanager cms dsm history main os summary

Done

Bypassing local license checks since this instance is configured with a remote license master.

Success

Checking conf files for typos...

All preliminary checks passed.

Starting splunk server daemon ( splunkd )...

[ OK ]

Done.

Troubleshooting the Analytics Search Head

To verify that the Analytics Node (often referred to as the search head) is operating properly, perform the following steps:

Step 1

Step 2 ssh into the IP address of the analytics node.

Using the netstat command, list the monitoring ports. For example:

Example:

[ bninet@IDX netstat -a 2>>/ dev /null | grep 8089 tcp 0 0 *:8089 *:* LISTEN

Videoscape Distribution Suite Service Manager User Guide

199

Troubleshooting

Troubleshooting the Analytics Search Head

Step 3

[bninet@IDX ~]$

If there are no analytics node processes listening on port 8089, then the nodes are not functioning. Restart Splunk. For example:

Example:

[ bninet@IDX ~]$ sudo / etc / init.d / splunk restart

Restarting Splunk ...

splunkweb is not running.

Stopping splunkd ...

Shutting down. Please wait, as this may take a few minutes.

....... [ OK ]

Stopping splunk helpers... [ OK ]

Done.

Splunk > The IT Search Engine.

Checking prerequisites...

Checking mgmt port [8089]: open

Checking configuration... Done.

Checking index directory...

Validated databases: _audit _ blocksignature _internal _ thefishbucket cdn-mgr cdnmanager cms dsm history main os summary

Done

Bypassing local license checks since this instance is configured with a remote license master.

Success

Checking conf files for typos...

All preliminary checks passed.

Starting splunk server daemon ( splunkd )...

[ OK ]

Done.

In addition, the command sudo /home/ bninet /splunk/bin/splunk search 'index= dsm | stats count' - auth admin:changeme can be run to show that the analytics node is capable of processing data from the indexer, as shown below. This command sends scrolling data to the screen, which is compressed in the output below:

Example:

[ bninet@Search ~]$ /home/bninet/splunk/bin/splunk search 'index= dsm | stats count' -auth admin:changeme count

-----

0

200

Videoscape Distribution Suite Service Manager User Guide

Troubleshooting

Troubleshooting VDS-IS Provisioning

Troubleshooting VDS-IS Provisioning

The server.log file, located within the /home/bninet/jbossesb/server/default/log/ folder, can be used to troubleshoot VDS-IS provisioning problems.

To access the server.log file, perform the following step: ssh into the CDN Manager node and then enter the following command:

/home/bninet/jbossesb/server/default/log/server.log

Deleting Summarized Data

To delete the summarized data, perform the following steps:

Step 1

Step 2

Step 3

Step 4

Launch the JS node web interface http://<JSipaddress>:8000

Login to the Splunk web interface by providing the credentials; Username: admin and Password: Beaumaris1

Select App and then select Search .

Execute the search query [index=summary report="<Report Name>" host="<JS Host Name>" | delete]

Provide the appropriate report name and hostname in the query.

Videoscape Distribution Suite Service Manager User Guide

201

Troubleshooting

Splunk License Violation

Step 5

Example:

[index=summary report=mobitv_client_daily host= secondary-JS | delete]

Validate the count by issuing the search query [index=summary report=mobitv_client_daily]

Note can_delete role is already added for Admin. However, the above query will not work in a normal search page.

Splunk License Violation

Violations occur when you exceed the maximum indexing volume allowed for your license. If you exceed your licensed daily volume on any one calendar day, you will get a violation warning . The message persists for 14 days. If you have 5 or more warnings on an Enterprise license or 3 warnings on a Free license in a rolling 30-day period, you are in violation of your license and search will be disabled.

Note Summary index volume is not counted against your license.

If you get a violation warning, you have until midnight (going by the time on the license master) to resolve it before it counts against the total number of warnings within the rolling 30-day period.

During a license violation period:

• Splunk does not stop indexing your data. Splunk only blocks search while you exceed your license.

• Searches to the _internal index are not disabled. This means that you can still access the Indexing Status dashboard or run searches against _internal to diagnose the licensing problem.

For any queries on licensing, contact the Cisco Accounting team.

202

Videoscape Distribution Suite Service Manager User Guide

advertisement

Was this manual useful for you? Yes No
Thank you for your participation!

* Your assessment is very important for improving the workof artificial intelligence, which forms the content of this project

Related manuals

Download PDF

advertisement

Table of contents