Product Documentation

Keynote

Type of Data

Web Monitoring

Description

The Keynote Fusion recipe produces an Openmix data feed that is a combination of geo location, performance and availability. The data feed format section shows an example of the JSON produced by the Keynote Fusion recipe that is consumed in an Openmix application.

Keynote Agents

Keynote deploys agents or nodes around the world (in over 200 locations). The unique thing about Keynote agents is that it reports DOM events similar to radar scores. We have many more measurements that can be used for Openmix DNS routing decisions, we started with performance and availability. When setting up a monitoring script in Keynote, the user selects which agents run the script. The script can be a simple URL or a browser based recording created by the user which basically just records the user navigation events (i.e. go to URL home page, navigate to charts, click on button, etc.). This script has a unique identifier called a “Slot Id”.

Keynote Openmix Application

The keynote Openmix app template can be found here:https://github.com/cedexis/openmixapplib/tree/master/apps-javascript/keynote-geo-perf-avail. The Openmix application first tries to use the requestor country as a match to obtain the performance and availability scores from the Fusion data feed. If there are no matching countries, the app rolls up and tries to match on market. In all cases, if a country or market match was found, the Openmix app will choose the lowest Keynote performance score. If there is no country or market match, the recipe uses the default provider. There are thresholds for the performance and availability scores in the Openmix app which can be modified to meet specific customer needs. In order for a platform to be considered as a viable candidate, the Keynote scores for a matching geo location must not be out of bounds from the threshold.

Keynote Data Feed

The performance measurement is similar to radar RTT and measured in seconds. The availability score is a percentage between 0 - 100.

Note: If you look at China and Japan below, it appears as if the Asia market score is incorrect. What you don’t see is that China actually has two Keynote agents reporting scores and the result display for China is the median of the two scores. For the Asia market, the individual perf scores are: 37.178 (Beijing agent), 1.4550 (Hong Kong Agent) and 1.2460 (Japan). Using the median, we obtain the middle value to report for the Asia market.

Data Feed Format

  {
    "countries": {
      "CN": {
        "avail_data": "97.85"
        "avail_data": "97.85"
      },

      "DE": {
        "avail_data": "1.3980"
        "avail_data": "100"
      },

      "JP": {
        "avail_data": "1.2460"
        "avail_data": "100"
      },

      "FR": {
        "avail_data": "1.1200"
        "avail_data": "100"
      },

      "US": {
        "avail_data": "1.0765"
        "avail_data": "100"
      },

      "GB": {
        "avail_data": "1.0630"
        "avail_data": "100"
      }
    },

      "markets": {
        "AS": {
          "avail_data": "1.4550"
          "avail_data": "100"
        },

      "EU": {
        "avail_data": "1.1200"
        "avail_data": "100"
      },

      "NA": {
        "avail_data": "1.0765"
        "avail_data": "100"
      }
    }
  }

Implementation Notes

How to Install

In order to install, the user will need a Keynote portal account, an API key and a “Slot Id”. In the Keynote portal the “Slot Id” and a Keynote portal chart shows the data we collect and pass to the Openmix app.

How it Works

Based on the recipe frequency interval, Fusion will obtain the performance and availability data for each Keynote agent configured in the customer defined script. The recipe currently polls for Keynote chart data for the last 5 minutes. Once we have the raw keynote feed, we perform Keynote agent location lookups using portal geo locations to map the Keynote agent node to our Country and Market ISO codes. From this, the Keynote data feed is produced and sent to the workers (if a destination platform was selected).

If multiple Keynote agents are configured for the same country and/or market (the Keynote script can select many agents from the US for example), Fusion uses a median value for all measurements within the geo location in order to report a single score for use in the Openmix application.

Once the installation is complete, the data feed will be 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 on the data feed in the list and then click the Edit button. Once you have changed the configuration, click Save. This will bring you back to the data feed list with your changes saved and applied to the data feed.

Setup in Fusion

You can access Fusion Data Feeds from the left navigation pane, under Openmix. For initial steps please 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 will default to “Service - Platform Name” if not specified.
  • Run Every: The frequency with which the data feed is updated from the service.
  • Platform: The Platform that is associated with the data feed.
  • API Key: Found in the Keynote Portal.
  • Slot ID: Slot ID is available in the Keynote portal chart that shows the data that is passed to the Openmix app.

Once the installation is complete, it will be 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 on the data feed in the list and then click the Edit button. Once you have changed the configuration, click Save. This will bring you back to the data feed list with your changes saved and applied to the data feed.

Keynote