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.
« Upgrade Elastic Cloud with the APM integration to 8.0 Switch a self-installation to the APM integration »
Elastic Docs ›Elastic Observability [8.16] ›Application and service monitoring ›Application performance monitoring (APM) ›Upgrade

Switch to the Elastic APM integration

edit

Switch to the Elastic APM integration

edit

The APM integration offers a number of benefits over the standalone method of running APM Server:

Fleet:

  • A single, unified way to add monitoring for logs, metrics, traces, and other types of data to each host — install one thing instead of multiple
  • Central, unified configuration management — no need to edit multiple configuration files

Data streams:

  • Reduced number of fields per index, better space efficiency, and faster queries
  • More granular data control
  • Errors and metrics data streams are shared with other data sources — which means better long-term integration with the logs and metrics apps
  • Removes template inheritance for ILM policies and makes use of new Elasticsearch index and component templates
  • Fixes resource 'apm-8.16.0-$type' exists, but it is not an alias error

APM Integration:

  • Easier to install APM on edge machines
  • Improved source map handling and APM agent configuration management
  • Less configuration
  • Easier and less error-prone upgrade path
  • Zero-downtime configuration changes
APM integration architecture
edit

Elastic APM consists of four components: APM agents, the Elastic APM integration, Elasticsearch, and Kibana. Generally, there are two ways that these four components can work together:

APM agents on edge machines send data to a centrally hosted APM integration:

Or, APM agents and the APM integration live on edge machines and enroll via a centrally hosted Elastic Agent:

In order to collect data from RUM and mobile agents, which run in browser and mobile applications, you must run Elastic Agent centrally. For other applications, such as backend services, Elastic Agent may be co-located on the edge machine.

Limitations
edit

There are some limitations to be aware of:

  • This change cannot be reverted
  • Currently, only the Elasticsearch output is supported
  • APM runs under Elastic Agent which, depending on the installation method, might require root privileges
  • An Elastic Agent with the APM integration enabled must be managed by Fleet.
Make the switch
edit

Select a guide below to get started.

« Upgrade Elastic Cloud with the APM integration to 8.0 Switch a self-installation to the APM integration »