Edgecast

Type of Data

CDN Bandwidth, CDN Usage

Description

Data Feed Format

Fusion OM Data Feed - Monthly Bandwidth and Usage

      {
        "bandwidth": {
          "unit": "Mbps",
          "value": "6.33"
          },
        "usage": {
          "unit": "GB",
          "value": "532.98"
          }
      }
<!--NeedCopy-->

Fusion OM Data Feed - Latest Measured Bandwidth

      {
        "bandwidth": {
          "unit": "Mbps",
          "value": "3.05"
        },
      }
<!--NeedCopy-->

Fusion OM Data Feed - Latest Measured Bandwidth (POPs)

    {
      "sjc": {
        "bandwidth": {
          "unit": "Mbps",
          "value": "4.68"
        }
      }
    }
<!--NeedCopy-->

Implementation Notes

Default Behavior: Monthly Billing Bandwidth and Usage

  • Edgecast main API endpoint for traffic and bandwidth reporting.
  • During Edgecast Data Feed installation, the user credentials are authenticated by calling a standard Edgecast API endpoint: /v2/reporting/customers/0DE9/bytestransferred?begindate=2015-03-01T00:00:00&enddate=2015-03-22T15:49:19
  • Reporting metrics are obtained for the current month time period for all possible Edgecast media types and billing regions
  • Edgecast media Types: HTTP Large Object, HTTPS Large Object, Flash (live or On Demand), HTTP small Object, HTTPS Small Object, ADN, ADN SSL
  • Usage Reporting: for each possible media type, call the API metrics reporting URL to obtain GB Data Transferred. Key URI parameters: /region/-1/ = All billing regions, /units/2/ = Data Transferred in GB
  • Bandwidth Reporting: for each possible media type, call the API metrics reporting URL to obtain Mbps Data Transferred as it relates to 95% peak contract usage. Key URI parameters: /region/-1/ = All billing regions, /units/1/ = Mbps bandwidth.
  • Regarding bandwidth, from the Edgecast API docs: “Bandwidth usage information for the specified platform and billing region over the specified month can be viewed by setting the Units request parameter to 1. This setting causes this method to report the amount of data (Mb) transferred per second during peak usage. This information is useful for viewing whether 95% usage of the bandwidth specified in your contract has been exceeded”
  • Regarding usage, from the Edgecast API docs: “The total amount of data transferred (GB) for the specified platform and billing region over the specified month can be viewed by setting the Units request variable to 2.”

Latest Measured Bandwidth

  • Edgecast real-time stats - bandwidth API endpoint is hit and results retrieved for each supported product platform.

  • 2 - Flash Media Streaming
  • 3 - HTTP Large
  • 8 - HTTP Small
  • 14 - Application Delivery Network (ADN)
  • Values for all product platforms are totaled.
  • The total is converted from bits per second to megabits per second (Mbps) as expected by the normal Fusion format.

Latest Measured Bandwidth (POPs)

  • Edgecast Current Edge CNAME Statistics (II) Endpoint URL is hit and results retrieved or each supported product platform.

  • cache - HTTP Large
  • wac - HTTP Small
  • ADN \ Application Delivery Network (ADN)

  • Values for all product platforms are totaled per POP.
  • Total is converted from bytes per second to megabits per second (Mbps) as expected by the normal Fusion format.
  • Total of all POPs correspond to the value when using the “Latest Measured Bandwidth” configuration (unless the customer uses Flash not available from the edge statistics).
  • If there is no data for any POP, instead of generating an empty feed result, a Runtime Exception is thrown to prevent any feed data from being sent.

Reconciliation Steps

How to reconcile Edgecast Monthly Billing Bandwidth and Usage reporting with Fusion Openmix Data Feeds

For Monthly Billing Bandwidth and Usage

  • In the Edgecast portal, select Analytics, Core Reports, Traffic Summary.
  • Monthly Usage is shown under the Data Transferred GB total column.
  • Monthly Bandwidth is shown under the 95% Bandwidth column.

For Latest Measured Bandwidth

  • In the Edgecast portal, select Analytics, Real-Time-Status, and select your product platform
  • See bandwidth over time for the selected product platform
  • Hover over the graph shortly after seeing the Fusion data update. You find a result that matches in the graph a short time in the past.

For Latest Measured Bandwidth (POPs)

  • The total of all POPs for all product platforms match the Latest Measured Bandwidth
  • Though POP data is not available for the Flash Streaming Services product
  • In Fusion, create the Edgecast Data Feed, then view the log output under the gear icon on the right.

Where Fusion and Edgecast portal metrics have to match

  • For “Monthly Billing Bandwidth and Usage,” Fusion feed data matches the Edgecast portal Traffic Summary report.
  • For “Latest Measured Bandwidth,” Fusion results match total of “Real-Time” stats for each product. View each Product Platform Real-Time Stats report and try to match up the point in time. If there is only one product platform in use, the number matches. Hover over a value in the “Bandwidth Over Time” Graph from a short time in the past.

Set up in Fusion

You can access Fusion Data Feeds from the left navigation pane, under Openmix. For initial steps refer to the Fusion Integration Documentation.

When you get to the service-specific configuration dialog box, enter the following:

  • Name: The name given to the data feed. This defaults to <Service><Platform Name> if not specified.
  • Run Every: How often the data feed is updated from the service.
  • Platform: The Platform that is associated with the data feed.
  • Rest API Token: This can be found under My Settings in the Edgecast Portal
  • Account Number: This is displayed under the top navigation Help and Support in the Edgecast Portal.
  • Metrics: Choose either Monthly billing bandwidth and usage, Latest measured bandwidth, and Latest measured bandwidth (POPs).
  • Restrict POP Data by Edge CNAME: This is only applied if “Latest Measured Bandwidth (POPs)” is chosen in the metrics. If not, set bandwidth represents all edge CNAMEs served from each POP.

Once the installation is complete, it is listed on the Fusion data feeds home page with a green status and monitoring metrics in the log history.

To edit a Fusion data feed click the data feed in the list and then click the Edit button. Once you have changed the configuration, click Save. This brings you back to the data feed list with your changes saved and applied to the data feed.

Edgecast