OMD Insights 12_10

 

 

           

 

   

Open Media Distribution Insights User Guide, Release 1.0 First Published: October 9, 2015

 

 

                               

Last Modified: December 10, 2015

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

 

 

 

 

 

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

 

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

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

   

   

   

 

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

2015 Cisco Systems, Inc. All rights reserved.

   

CONTENTS

 

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

 

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

 

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

 

 

 

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

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

 

C  H  A  P  T  E  R       4  -­‐  Monitor  

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

 

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

 

 

 

 

 

Preface

 

 

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

Document  Conventions   This  document  uses  the  following  conventions:    

Convention ^ or Ctrl

 

 

 

Description  

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

bold font

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

Italic font

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

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0 13

  Preface

 

         

Convention

Description

Courier font

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

Bold Courier font

Bold Courier font indicates the text that you must enter.

[x]

Elements in square brackets are optional.

...

An ellipsis (three consecutive non-bolded periods without spaces) after a syntax element indicates that the element can be repeated.

|

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

[x | y]

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

{x | y}

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

[x {y | z}]

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

string

A non-quoted set of characters. Do not use quotation marks around the string or the string will include the quotation marks.



Nonprinting characters such as passwords appear in angle brackets.

[]

Default responses to system prompts appear in square brackets.

!, #

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

     

 

       

   

       

Reader  Alert  Conventions    

This document uses the following conventions for reader alerts:

 

    Note

      Tip

 

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

Means the following information will help you solve a problem.

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0

 

 

Preface

Document Organization

 

    Caution

   

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

  Timesaver

 

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

    Warning

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

   

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0 15

 

Document  Organization    

This  document  is  organized  into  the  following  chapters:   Chapter  

Description  

Open  Media  Distribution  (OpenMD)  Overview   Home  

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

Analytics   Monitor  

Alerts  

Reporting  Problems    

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

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

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0

 

 

CHAPTER  

1

   

Open Media Distribution (OpenMD) Overview

 

 

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

Traffic  Ops   Traffic  Router   Traffic  Monitor   Traffic  Stats   Traffic  Vault  

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

 

 

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0

 

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

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

Single  logical  location   Single  physical  region   Single  group  membership   Either  EDGE  or  MID  

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

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0 17

 

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

Traffic  Ops   Traffic  Router   Traffic  Monitor   Traffic  Stats   Traffic  Vault  

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

Provides  a  WEB  Graphical  User  Interface  (GUI)  for  OpenMD  administrator.   Configures  and  monitors  the  OpenMD.   Exposes  the  HTTP  APIs  for  data  access.   Generates  the  application  specific  configuration  files  for  other  OpenMD  components.   Using  extensions,  it  runs  a  collection  of  periodic  checks  to  determine  the  operational  readiness  of  the  caches.  

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

DNS  content  routing.   HTTP  content  routing.  

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

Serves  the  url  with  the  hostname  beginning  with  'edge.'(e.g.http://edge.dsname.cdn.com/foo/bar/fun.html).   Considers  the  localization  between  the  Client's  LDNS  server  and  the  cache  groups.   Considers  the  health  of  the  cache  servers.  

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

 

Serves  the  url  with  the  hostname  beginning  with  'tr.'(e.g.http://tr.dsname.cdn.com/foo/bar/fun.html).   Considers  the  localization  between  the  client's  IP  address  and  the  cache  groups.   Considers  the  content  awareness  (like  the  content  based  routing  in  VDS-­‐IS)  to  make  sure  that  same  content   requests  go  to  same  cache  server.   Considers  the  health  of  the  cache  servers.  

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0

 

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

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

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

 

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

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0 19

 

 

CHAPTER  

2

   

Open Media Distribution (OpenMD) Homepage

 

 

The  OpenMD  homepage,  provides  information  and  reporting  for:   • • • • •

Network   Protocol   Content   Viewers   Content  Origin  

The  following  is  an  example  of  the  OpenMD  homepage.  

   

 

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0 21

 

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

Specific  Time  Range  of  either  60  minutes  or  24  hours.   Edge  Cache  Group  for  a  specific  group  or  all  groups.   Edge  Cache  for  a  specific  user  or  all  users.   Delivery  Service  for  a  specific  service  or  all  services.  

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

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

   

 

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0

 

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

 

Network     The  Network  tab  provides  the  following  information  and  reporting:   • • • •

Bandwidth   Request  Rate   Response  Status  Codes   Cache  Hit  Rates  

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

     

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0 23

 

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

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

   

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

     

 

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0

 

Protocol   The  Protocol  tab  provides  the  following  information  and  reporting:   • • • • • •

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

The  following  is  an  example  of  each.  

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

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0 25

 

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

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

The  following  is  an  example  of  each.  

 

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0

 

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

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

Viewers   The  Viewers  tab  provides  the  following  information  and  reporting:   • • • • • •

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

The  following  is  an  example  of  each.  

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0 27

 

 

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

 

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

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0

 

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

Ingest  Requests   Ingest  Bytes  Read    

The  following  is  an  example  of  each.  

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

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

 

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0 29

 

CHAPTER  

3

       

OpenMD Insights

 

   

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

Analyze  Metrics  with  Pivoting    

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

Bandwidth  Delivered   Cache  Efficiency   GigaBytes  Delivered   Requests   Response  Codes   Viewers  

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

   

 

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0

 

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

 

 

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

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

  •

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

   

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0 31

 

•

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

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

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

Network   Streaming   Viewers   Content  

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

 

 

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0

 

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

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

  The  following  subcategories  are  displayed  in  Network:   • • • •

Volume Caching Request Response

Volume   The  Volume  feature  include  the  following:   • • •

Bandwidth   Volume  of  Data  Delivered   Delivery  Services  by  Bytes  Delivered  

The  following  are  examples  of  each:  

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0 33

 

Bandwidth  

  Volume  of  Data  Delivered  

 

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0

 

Delivery  Services  by  Bytes  Delivered  

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

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

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0 35

 

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

Cache  Hit  and  Miss  Rate  by  Request  Count   %  Cache  Hit  and  Miss  

•

Cache  Hit  Ratio  by  Protocol  

The  following  are  examples  of  each:   Cache  Hit  and  Miss  Rate  by  Request  Count  

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

Formula   Chart  Filters   Availability  

 

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

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0

 

%  Cache  Hit  and  Miss  

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

Chart  Information  

Formula  

Chart  Filters   Availability  

 

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

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0 37

 

Cache  Hit  Ratio  by  Protocol  

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

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

Formula   Chart  Filters   Availability  

 

 

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0

 

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

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

The  following  are  examples  of  each:   Request  Rate  

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

 

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

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0 39

 

Total  Requests  and  Errors  

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

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

Chart  Information  

Formula   Chart  Filters   Availability    

 

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0

 

Top  Delivery  Services  by  Request  Count  

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

 

 

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

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0 41

 

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

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

Response  Count  by  Status  Codes  

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

Formula  

Chart  Filters   Availability  

 

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

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0

 

Response  Codes  by  Edge  Cache  

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

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

Chart  Information   Formula   Chart  Filters   Availability    

 

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0 43

 

Sorted  Delivery  Services  by  Client  Errors  on  Edge  Cache  

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

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

Formula   Chart  Filters   Availability    

 

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0

 

4xx  Error  Rate  on  Edge  Cache  

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

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

Chart  Information   Formula   Chart  Filters   Availability    

 

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0 45

 

Response  Codes  by  Protocol  

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

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

Formula   Chart  Filters   Availability    

 

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0

 

4xx  Errors  by  Protocol  

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

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

Formula   Chart  Filters   Availability  

 

 

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0 47

 

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

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

To  access  the  Trends  Viewer  feature,  complete  the  following:   1. From  the  OpenMD  main  page,  choose  Analytics   >  Trends.    The  Trends  page  is  displayed.    For  example:  

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

 

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0

 

Number  of  Unique  Viewers  

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

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

Viewers  by  Client  Type  

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

 

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

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0 49

 

Viewer  Density  by  Location  

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

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

Availability   Top  Viewers  

   

 

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0

 

The  following  table  describes  the  chart  within  this  dashlet:   Chart   Top  Viewers  

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

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

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

Chart  Filters   Availability   Viewers  by  ISP,  Net  Speed  

   

 

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0 51

 

The  following  table  describes  the  chart  within  this  dashlet:   Chart   Viewers  by  ISP  and  Net  Speed  

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

Table  Information   Formula   Chart  Filters   Availability   Viewers  by  Protocol  

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

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

Formula   Chart  Filters   Availability      

 

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0

 

Viewers  by  Download   Size  

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

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

Availability  

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

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

To  access  the  Trends  Content  feature,  complete  the  following:   1. From  the  OpenMD  main  page,  choose  Analytics   >  Trends.    The  Trends  page  is  displayed.    For  example:  

   

 

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0 53

 

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

  Content  by  Client  Requests  

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

 

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

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0

 

Content   by  Bytes  Transferred  

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

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

Formula   Chart  Filters   Availability    

 

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0 55

 

Top  Content   by  Edge  Cache  

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

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

Average  ABR  Session  Bitrate  by  Content  

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

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

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0

 

Top  Content  by  City  

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

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

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

Availability   Top  Content   by  Client  Type  

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

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

Table  Information   Formula   Chart  Filters   Availability  

 

 

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0 57

 

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

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

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

 

OpenMD  Traffic  

   

 

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0

 

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

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

Traffic  Summary  by  Edge  Caches  

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

 

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

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0

 

Traffic  Summary  by  Delivery  Services  

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

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

Edge  Cache  Traffic  

   

 

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0

 

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

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

Delivery  Service  Traffic    

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

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

   

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0

 

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

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

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

   

 

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0

 

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

.  

  4. Choose  Save   As  >  Dashboard  Panel.  

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

Dashboard  ID  –  Enter  the  custom  dashboard  ID.   NOTE:  The  custom  dashboard  ID  can  contain  only  alphanumeric  characters  and  underscores.  

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

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0

 

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

 

11. Click View Dashboard.

NOTE:    Refresh  the  custom  dashboards  by  clicking   name  in  the  tree  view.  

 in  the  left  pane  to  view  the  created  custom  dashboard  

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

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

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

 

 

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0

 in  the  left  pane.  

 

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

Analyze  by  Client  IP   Session  Reports  

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

Sessions  created  for  the  IP  address   Session  duration   Protocol  used  to  serve  the  content   Title  viewed  during  the  session  

To  access  this  feature,  complete  the  following:   1. From  within  the  OpenMD  main  page,  select  Analytics   >  Sessions   >  Analyze  by  Client   IP.  

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

   

 

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0

   

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

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

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

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0

 

 

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0

 

CHAPTER  

4

   

Monitor

 

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

   

 

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0

 

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

Bandwidth   Illustrates  the  bandwidth  consumed  to  deliver  content.  

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

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

Chart  Filters  

 

 

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0

 

Cache  Hit  Ratio   Illustrates  CDN’s  Cache  Hit  and  Miss  percentage  in  near  real-­‐time.  

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

Chart  Filters  

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

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

   

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0

 

The  following  table  describes  the  chart  within  this  dashlet:   Chart   Unique  Clients   Chart  Information   Chart  Filters  

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

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

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

Chart  Filters    

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

 

 

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0

 

   

CHAPTER  

5

   

Alerts

 

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

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

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

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

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0

 

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

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

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

   

             

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0

 

 

Open  Media  Distribution  Analytics  User  Guide,  Release  1.0