Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit

This commit adds a logic in to configuration module to collect agent, environment and configuration info. For info it shows where the non-default values come from. Also it simplifies the `agent.start()` method delegating the `serverUrl` validoty check to normalizers module.

Co-authored-by: Trent Mick <>

Git stats


Failed to load latest commit information.
Latest commit message
Commit time
June 28, 2021 12:44

Elastic APM Node.js Agent

This is the official Node.js agent for Elastic APM.

If you have any feedback or questions, please post them on the Discuss forum.

npm Build Status


npm install elastic-apm-node --save

Quick start

  1. To run Elastic APM for your own applications, make sure you have the prerequisites in place first. This agent is compatible with APM Server v6.5 and above. For support for previous releases of the APM Server, use version 1.x of the agent. For details see Getting Started with Elastic APM

  2. Now follow the documentation links below relevant to your framework or stack to get set up



Contributions are welcome, but we recommend that you take a moment and read our contribution guide first.

To see what data is being sent to the APM Server, use the environment variable ELASTIC_APM_PAYLOAD_LOG_FILE (or the config option payloadLogFile) to specify a log file, e.g:


Please see for instructions on how to run the test suite.



Made with ♥️ and ☕️ by Elastic and our community.