Known issues

Site Failover and responseProvider built-in variable

When you include the responseProvider debug Pragma header, akamai-x-ew-debug-rp in the request, the AK_EDGEWORKERS_RP_STATUS built-in variable:

  • Returns an inaccurate status.
  • Indicates success, even on a failure.
  • Prevents the Site Failover behavior from responding to an EdgeWorkers failover accurately.

To resolve this issue you need to remove the akamai-x-ew-debug-rp Pragma header when testing Site Failover.

Application Load Balancer and Site Failover

To set the failover host to the true incoming URL you need to add the AK_HOST built-in variable before it is modified by Application Load Balancer.

Variable propagation to onClientResponse

Cache hierarchy metadata variables set with request.setVariable() in onOriginResponse do not propagate to onClientResponse.

Cache hierarchy categorizes the bytes served to the client by the forward server type that sent them.

cacheKey modifications and Phased Release Cloudlet

When the Phased Release Cloudlet is included in a request, cacheKey modifications are not applied.

If both Phased Release and EdgeWorkers are working on the same request the last behavior in the property (from a top-to-bottom perspective) controls the forward path and forward origin routing. This is expected behavior.

EdgeWorkers cannot be invoked from within a Conditional Origin rule

The EdgeWorkers behavior must be placed before Conditional Origin behaviors in Property Manager rules.


An EdgeWorkers function can be used to select a Conditional Origin using request.route() within the onClientRequest event handler.

Bot Manager Premier interoperability

Bot Manager Premier applies detections related to transactional URL endpoints:

  • After the execution of the onClientRequest event handler.
  • Before the execution of the onOriginRequest, onOriginResponse, onClientResponse, and responseProvider event handlers.

The partial execution of EdgeWorkers event handlers may result in unexpected logic if the Bot Manager Premier response action is set to Deny.

Requests forwarded to NetStorage require the CP Code Root

To forward a request to NetStorage using the route() function, you need to include the CP Code Root in the NetStorage path.

NetSorage Known Issue

A 403 Forbidden error will occur if the path doesn't include the CP Code Root.

In the example below [CP Code Root] is the value for the storage group you're using. [Content Path] is the path to the content on NetStorage.

export function onClientRequest(request) {
    var destination1 = {origin: 'origin1', path: '/[CP Code Root]/[Content Path]'}

Use Billing Center for accurate EdgeWorkers event data

To check the actual number of EdgeWorkers events invoked on the network, refer to the data reported in the Billing Center.

You can use EdgeWorkers execution reports to analyze resource consumption metrics such as the CPU execution time, memory usage, and success/error ratio related to your EdgeWorkers functions.

During periods of network congestion, the metrics streaming into the data warehouse may be dropped. When metrics are dropped, the number of EdgeWorkers events invoked displayed in the EdgeWorkers reports may be less than the official amount.

Response status not updated when Quick-IMS and Fast-IMS enabled

When you enable Quick-IMS or Fast-IMS on your Akamai edge servers the 200 response status remains in cache. When a subsequent request generates a "304 Not Modified" response after the metadata stage, the original 200 response isn’t replaced.