This documentation contains work-in-progress information for future Elastic Stack and Cloud releases. Use the version selector to view supported release docs. It also contains some Elastic Cloud serverless information. Check out our serverless docs for more details.
Upgrading to version 4 of the agent
editUpgrading to version 4 of the agent
edit4.0 of the Elastic APM Python Agent comes with several backwards incompatible changes.
APM Server 6.5 required
editThis version of the agent is only compatible with APM Server 6.5+. To upgrade, we recommend to first upgrade APM Server, and then the agent. APM Server 6.5+ is backwards compatible with versions 2.x and 3.x of the agent.
Configuration options
editSeveral configuration options have been removed, or renamed
-
flush_interval
has been removed -
the
flush_interval
andmax_queue_size
settings have been removed. -
new settings introduced:
api_request_time
andapi_request_size
. - Some settings now require a unit for duration or size. See size format and duration format.
Processors
editThe method to write processors for sanitizing events has been changed. It will now be called for every type of event (transactions, spans and errors), unless the event types are limited using a decorator. See Sanitizing data for more information.