Elastic Limits for Asynchronous Apex Jobs (Beta)

Elastic Limits Overview

If you enable the “Use elastic limits for asynchronous Apex jobs (Beta)” setting, you can enqueue Queueable Apex and future method jobs up to an increased elastic asynchronous job limit. This elastic limit is the org’s daily asynchronous job limit plus either the org’s licensed daily asynchronous job limit (defined as 250,000 jobs or 200 times the number of applicable user licenses, whichever is greater) or 10 million jobs, whichever is less.

In other words, the DailyAsyncApexElasticExecutions limit is calculated according to this formula:

1// DailyAsyncApexElasticExecutions limit calculation (pseudocode)
2DailyAsyncApexElasticExecutions = DailyAsyncApexExecutions + min(licensed DailyAsyncApexExecutions, 10000000)

For example, if an org’s daily asynchronous Apex job limit is 250,000 and the org’s licensed daily asynchronous job limit is 250,000, then the org’s elastic limit is 500,000 jobs (250,000 + 250,000). However, if an org’s daily asynchronous Apex job limit is 12 million and the org’s licensed daily asynchronous job limit is 12 million, then the org’s elastic limit is 22 million jobs (12 million + 10 million).

If an org reaches both the daily asynchronous Apex job limit and the elastic asynchronous job limit, exceptions are thrown for enqueued jobs that exceed the elastic limit.

If the number of asynchronous Apex jobs processed over a rolling 24-hour period exceeds the daily limit, Salesforce processes any additional enqueued asynchronous jobs at a throttled rate of one concurrent job per asynchronous Apex type. Processing resumes the regular, non-throttled concurrency rate only after the number of executed asynchronous jobs in the past 24 hours falls below the daily limit.

Enable Elastic Limits

To enable elastic limits for asynchronous Apex:

1. In Setup, in the Quick Find box, enter Apex Settings, and then select Apex Settings.
2. Select Use elastic limits for asynchronous Apex jobs (Beta).
3. Save your changes.

Monitor Asynchronous Job Usage

To check your asynchronous job usage against the daily and elastic limits, see the Apex Jobs page in Setup. A banner shows the number of asynchronous jobs processed in the past 24 hours, along with the org’s daily and elastic limits. It also indicates whether asynchronous processing is currently being throttled.

You can also use these methods on the OrgLimits class to check asynchronous job usage.

1// Map of OrgLimit instances
2Map<String,System.OrgLimit> limitsMap = OrgLimits.getMap();
3
4// Daily Limit Methods
5System.OrgLimit asyncApexDailyLimit = limitsMap.get('DailyAsyncApexExecutions');
6System.debug('Limit Name: ' + asyncApexDailyLimit.getName());
7
8// The total async jobs enqueued in the past 24 hours.
9// Gives the same value as asyncApexElasticLimit.getValue()
10System.debug('Usage Value: ' + asyncApexDailyLimit.getValue());
11
12// The daily async job limit 
13System.debug('Maximum Limit: ' + asyncApexRequestsLimit.getLimit());
14
15// -------------------------------------------------
16
17// Elastic Limit Methods
18System.OrgLimit asyncApexElasticLimit = limitsMap.get('DailyAsyncApexElasticExecutions');
19System.debug('Limit Name: ' + asyncApexElasticLimit.getName());
20
21// The total async jobs enqueued in the past 24 hours. 
22// Gives the same value as the asyncApexDailyLimit.getValue() 
23System.debug('Usage Value: ' + asyncApexElasticLimit.getValue()); 
24
25// The sum of the daily limit and the additional jobs allowed up to the elastic limit
26System.debug('Maximum Limit: ' + asyncApexElasticLimit.getLimit());

For example, let’s say an org’s daily limit is 400,000 asynchronous jobs, and it enqueues 700,000 asynchronous jobs within a 24-hour period. Here’s the org’s DailyAsyncApexExecutions and DailyAsyncApexElasticExecutions OrgLimits instance values.

1// Example Org Limits for Async Jobs
2
3// Daily Limit Methods
4Limit Name: DailyAsyncApexExecutions
5Usage Value: 700000
6Maximum Limit: 400000
7
8// Elastic Limit Methods
9Limit Name: DailyAsyncApexElasticExecutions
10Usage Value: 700000
11Maximum Limit: 800000

When you use the OrgLimits class, keep these considerations in mind.

• If the “Use elastic limits for asynchronous Apex jobs (Beta)” setting isn’t enabled, the OrgLimits.getMap() method doesn’t return a DailyAsyncApexElasticExecutions key-value pair.
• The getValue() method returns the total number of asynchronous jobs enqueued over the last 24 hours, not the number executed. Because asynchronous jobs are throttled only when actual executions exceed the daily limit, the enqueued jobs count may surpass the daily limit when asynchronous jobs are still being processed at the regular concurrency rate.