Introducing the Adaptive Acceleration Reset Feature for Ion

May 31, 2019 · by Carm Janneteau and Evan Hughes ·

Akamai Adaptive Acceleration, the performance-optimization feature set included with Ion, uses real user monitoring (RUM) data—with Akamai mPulse as the data beacon source—to identify and preemptively push and preconnect elements in order to optimize website performance. Adaptive Acceleration Reset is a new tool to ensure that you have all of the latest optimizations available for your site.

Adaptive Acceleration Reset is a package for the Akamai command-line interface (CLI) and is designed to be integrated into your continuous deployment (CD) toolchain to inform Akamai whenever your site changes; this enables Adaptive Acceleration to constantly provide your site with peak performance optimizations.

Before getting into the details, here’s some context to consider: Adaptive Acceleration works by leveraging real user data (i.e., what specific parts of your site your visitors are visiting) to determine the most important resources for your site load; it then produces a set of optimizations that tells Akamai edge servers to run various optimizations (such as HTTP/2 pushes, preconnects, or preloads) to speed up your site. If you regularly remove resources from pages when you update your site, there may occasionally be a brief period where Adaptive Acceleration is attempting to push or preload a removed resource, which is not optimal.

To avoid pushing or preloading removed resources, you can reset Adaptive Acceleration. A reset causes Adaptive Acceleration to delete the existing optimizations and schedule a new analysis. When the next analysis runs, Adaptive Acceleration will only consider real user data received after the reset to calculate your new set of ideal optimizations.

Previously, you could manually trigger a reset by resetting a property report via the API or using the "Reset" button on the Adaptive Acceleration policy page in Akamai Control Center. We’ve added this new Adaptive Acceleration package to the Akamai CLI so you can more easily and seamlessly integrate the reset within your CD workflow.  

How to use Adaptive Acceleration Reset

  1. First, download and install Akamai CLI per the “Get Started” instructions here. Once installed, then download the Akamai CLI for Adaptive Acceleration package.
  2. Next, to authorize your installation to work on your behalf, follow the instructions on the  Create A New Client For Yourself page in Akamai Control Center.
  3. Find the ID of your property (a property is how you define the configuration of domains using Akamai). Once you have the ID, you’ll be able to run a reset with the CLI.
  4. In Akamai Control Center, find your property, then open the “Related Apps” drop down and go to the “Automatic Push and Preconnect” entry. Click on the “Reset” button. There you’ll find the exact command line you need to run the Adaptive Acceleration Reset. Copy the sample command line.
  5. You can now reset the policy on the property. Run the command line you copied a moment ago. The output is minimal, but sufficient. As you’d expect, if the reset succeeds, we get a zero. If the reset fails, for any reason, you’ll get a non-zero value.
  6. Once you issue the reset, Adaptive Acceleration removes the current policy soon thereafter.

Adaptive Acceleration will generate a new policy shortly after you issue the reset. It will be based on real user traffic received from that point on, so it will only contain optimizations matched to the updated version of your site.

To see a full walkthrough of the setup, watch this tutorial video:

What should you do next?

If you’re an Ion customer, you can start using the Adaptive Acceleration Reset package today.

If you’re not currently an Ion customer, sign up for a free trial of Ion that includes Adaptive Acceleration and much more here.

Carm Janneteau is a senior product manager at Akamai Technologies.
Evan Hughes is a senior software engineer at Akamai Technologies.