Audit API - new audit event for bulk upload of job field (job property) values
Description
We are introducing a new public audit event JOB_PROPERTY_UPDATED_VALUES_PARTITIONED to improve the reliability of audit logs
for high-volume job field (job property) bulk updates and deprecating JOB_PROPERTY_UPDATED_VALUES event.
The previous event JOB_PROPERTY_UPDATED_VALUES is now deprecated in the public specification and documentation.
It remains supported for backward compatibility during the deprecation period but should not be used for new development.
New JOB_PROPERTY_UPDATED_VALUES_PARTITIONED event context extends the previous event context of
JOB_PROPERTY_UPDATED_VALUES with an additional field aggregationId.
aggregationId will always be sent in context, no matter the update size.
For small-volume bulk updates, a single JOB_PROPERTY_UPDATED_VALUES_PARTITIONED event is emitted.
For high-volume bulk updates, multiple JOB_PROPERTY_UPDATED_VALUES_PARTITIONED events are emitted with partitioned value sets,
all sharing the same aggregationId so they can be merged back into one logical change.
Impact
The Audit API introduces a new public event JOB_PROPERTY_UPDATED_VALUES_PARTITIONED.
During a 10-month deprecation period, both public events are available:
JOB_PROPERTY_UPDATED_VALUES(deprecated, supported until March 2027)JOB_PROPERTY_UPDATED_VALUES_PARTITIONED(new, preferred)
It may occur that, for certain high-volume bulk updates, only the new JOB_PROPERTY_UPDATED_VALUES_PARTITIONED events would be emitted, including during the deprecation period.
This behavior depends on the overall audit payload size rather than a fixed item-count threshold. Typically, it corresponds to around
40,000 updated values per one operation, with the effective threshold being lower for larger payloads and higher for smaller ones.
In such cases, the legacy JOB_PROPERTY_UPDATED_VALUES audit event may not be present. Consumers are expected to look for
and rely on JOB_PROPERTY_UPDATED_VALUES_PARTITIONED (potentially multiple events sharing the same aggregationId) as the audit event for that operation.
After deprecation period, only JOB_PROPERTY_UPDATED_VALUES_PARTITIONED audit event will be emitted.