Configure the output for the Elastic Cloud

edit

This page refers to using a separate instance of APM Server with an existing Elasticsearch Service deployment. If you want to use APM on Elastic Cloud, see the cloud docs: Create your deployment or Add APM user settings.

APM Server comes with two settings that simplify the output configuration when used together with Elastic Cloud. When defined, these setting overwrite settings from other parts in the configuration.

Example:

cloud.id: "staging:dXMtZWFzdC0xLmF3cy5mb3VuZC5pbyRjZWM2ZjI2MWE3NGJmMjRjZTMzYmI4ODExYjg0Mjk0ZiRjNmMyY2E2ZDA0MjI0OWFmMGNjN2Q3YTllOTYyNTc0Mw=="
cloud.auth: "elastic:YOUR_PASSWORD"

These settings can be also specified at the command line, like this:

apm-server -e -E cloud.id="<cloud-id>" -E cloud.auth="<cloud.auth>"

cloud.id

edit

The Cloud ID, which can be found in the Elastic Cloud web console, is used by APM Server to resolve the Elasticsearch and Kibana URLs. This setting overwrites the output.elasticsearch.hosts and setup.kibana.host settings.

cloud.auth

edit

When specified, the cloud.auth overwrites the output.elasticsearch.username and output.elasticsearch.password settings. Because the Kibana settings inherit the username and password from the Elasticsearch output, this can also be used to set the setup.kibana.username and setup.kibana.password options.