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.

Did this page help you?