Reporter configuration optionsedit

secret_tokenedit

This string is used to ensure that only your agents can send data to your APM server.

Both the agents and the APM server have to be configured with the same secret token. Use if APM Server requires a token.

Default Type Dynamic

<none>

String

false

Java System Properties Property file Environment

elastic.apm.secret_token

secret_token

ELASTIC_APM_SECRET_TOKEN

server_urlsedit

The URLs must be fully qualified, including protocol (http or https) and port.

Note

Providing multiple URLs only works if intake API v2 is enabled.

Default Type Dynamic

http://localhost:8200

List

false

Java System Properties Property file Environment

elastic.apm.server_urls

server_urls

ELASTIC_APM_SERVER_URLS

server_timeoutedit

If a request to the APM server takes longer than the configured timeout, the request is cancelled and the event (exception or transaction) is discarded. Set to 0 to disable timeouts.

Warning

If timeouts are disabled or set to a high value, your app could experience memory issues if the APM server times out.

Supports the duration suffixes ms, s and m. Example: 5s. The default unit for this option is s

Default Type Dynamic

5s

TimeDuration

false

Java System Properties Property file Environment

elastic.apm.server_timeout

server_timeout

ELASTIC_APM_SERVER_TIMEOUT

verify_server_certedit

By default, the agent verifies the SSL certificate if you use an HTTPS connection to the APM server.

Verification can be disabled by changing this setting to false.

Default Type Dynamic

true

Boolean

false

Java System Properties Property file Environment

elastic.apm.verify_server_cert

verify_server_cert

ELASTIC_APM_VERIFY_SERVER_CERT

flush_intervaledit

Interval with which transactions should be sent to the APM server.

A lower value will increase the load on your APM server, while a higher value can increase the memory pressure on your app.

A higher value also impacts the time until transactions are indexed and searchable in Elasticsearch.

Supports the duration suffixes ms, s and m. Example: 1s. The default unit for this option is s

Default Type Dynamic

1s

TimeDuration

false

Java System Properties Property file Environment

elastic.apm.flush_interval

flush_interval

ELASTIC_APM_FLUSH_INTERVAL

max_queue_sizeedit

The maximum size of buffered events.

Events like transactions and spans are buffered when the agent can’t keep up with sending them to the APM Server or if the APM server is down.

If the queue is full, events are rejected which means you will lose transactions and spans in that case. This guards the application from crashing in case the APM server is unavailable for a longer period of time.

A lower value will decrease the heap overhead of the agent, while a higher value makes it less likely to lose events in case of a temporary spike in throughput.

Default Type Dynamic

512

Integer

true

Java System Properties Property file Environment

elastic.apm.max_queue_size

max_queue_size

ELASTIC_APM_MAX_QUEUE_SIZE

include_process_argsedit

Whether each transaction should have the process arguments attached. Disabled by default to save disk space.

Default Type Dynamic

false

Boolean

false

Java System Properties Property file Environment

elastic.apm.include_process_args

include_process_args

ELASTIC_APM_INCLUDE_PROCESS_ARGS