The APM Server receives data from the Elastic APM agents and stores the data into Elasticsearch. The APM Server and the APM agents are currently in beta and under heavy development which might result in breaking changes. If you are trying out APM and have feedback or problems, please post them on the Discuss forum.
To get started with APM please see our Getting Started Guide.
- Golang 1.9.2
- Fork the repo with the Github interface and clone it:
cd ${GOPATH}/src/github.com/elastic/
git clone git@github.com:[USER]/apm-server.git
Note that it should be cloned from the fork (replace [USER] with your Github user), not from origin.
- Add the upstream remote:
git remote add elastic git@github.com:elastic/apm-server.git
To build the binary for APM Server run the command below. This will generate a binary in the same directory with the name apm-server.
make
You also need to create all files needed by the APM Server by running the additional command below.
make update
Note that this requires to have virtualenv installed.
To run APM Server with debugging output enabled, run:
./apm-server -c apm-server.yml -e -d "*"
For Testing check out the testing guide
Each beat has a template for the mapping in elasticsearch and a documentation for the fields
which is automatically generated based on fields.yml.
To generate required configuration files and templates run:
make index-template update
To clean APM Server source code, run the following commands:
make fmt
To clean up the build directory and generated artifacts, run:
make clean
For further development, check out the beat developer guide.
The apm-server has two types of dependencies,
the Golang packages managed with Govendor and a dependency to the Beats Framework.
Checkout the govendor tool.
To update beats to the most recent version from your go path for example use: govendor fetch github.com/elastic/beats/....
Govendor will automatically pick the files needed.
To update the beats framework run make update-beats. This will fetch the most recent version of beats from master and copy
the files which are needed for the framework part to the _beats directory. These are files like libbeat config files and
scripts which are used for testing or packaging.
It is recommended to keep the version of the beats framework and libbeat in sync. To make an update of both, run:
make update-beats
To update the dependency to a specific commit or branch run command as following:
BEATS_VERSION=f240148065af94d55c5149e444482b9635801f27 make update-beats
The beat frameworks provides tools to crosscompile and package your beat for different platforms. This requires docker and vendoring as described above. To build packages of your beat, run the following command:
make package
This will fetch and create all images required for the build process. The whole process can take several minutes.
The Documentation for the APM Server can be found in the docs folder.
make help