Reporter configuration optionsedit

ServerUrlsedit

Environment variable nameIConfiguration or Web.config key

ELASTIC_APM_SERVER_URLS

ElasticApm:ServerUrls

DefaultType

http://localhost:8200

String

The URL for your APM Server. The URL must be fully qualified, including protocol (http or https) and port.

Providing multiple URLs is not supported by the agent yet. If multiple URLs are provided only the first one will be used.

SecretTokenedit

Environment variable nameIConfiguration or Web.config key

ELASTIC_APM_SECRET_TOKEN

ElasticApm:SecretToken

DefaultType

<none>

String

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 this setting in case the APM Server requires a token (e.g. APM Server in Elastic Cloud).

FlushInterval ( [1.1] Added in 1.1. )edit

Environment variable nameIConfiguration or Web.config key

ELASTIC_APM_FLUSH_INTERVAL

ElasticApm:FlushInterval

DefaultType

10s

TimeDuration

The maximal amount of time events are held in the queue until there is enough to send a batch. It’s possible for a batch to contain less than MaxBatchEventCount events if there are events that need to be sent out because they were held for too long. 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: 30s. The default unit for this option is s.

If FlushInterval is set to 0 (or 0s, 0ms, etc.) and there’s no event sending operation still in progress then the Agent won’t hold events in the queue and instead will send them immediately.

Setting FlushInterval to a negative value (for example -1, -54s, -89ms, etc.) is invalid and in that case agent uses the default value instead.

MaxBatchEventCount ( [1.1] Added in 1.1. )edit

Environment variable nameIConfiguration or Web.config key

ELASTIC_APM_MAX_BATCH_EVENT_COUNT

ElasticApm:MaxBatchEventCount

DefaultType

10

Integer

The maximal number of events to send in a batch. It’s possible for a batch to contain less then the maximum events if there are events that need to be sent out because they were held for too long (see FlushInterval).

Setting MaxBatchEventCount to 0 or a negative value is invalid and in that case the Agent will use the default value instead.

MaxQueueEventCount ( [1.1] Added in 1.1. )edit

Environment variable nameIConfiguration or Web.config key

ELASTIC_APM_MAX_QUEUE_EVENT_COUNT

ElasticApm:MaxQueueEventCount

DefaultType

1000

Integer

The maximal number of events to hold in the queue as candidates to be sent. If the queue is at its maximum capacity then the agent discards the new events until the queue has free space.

Setting MaxQueueEventCount to 0 or a negative value is invalid and in that case the Agent will use the default value instead.

MetricsInterval ( [1.0.0-beta1] Added in 1.0.0-beta1. )edit

The interval at which the agent sends metrics to the APM Server. Must be at least 1s. Set to 0s to deactivate.

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

DefaultType

30s

TimeDuration

Environment variable nameIConfiguration or Web.config key

ELASTIC_APM_METRICS_INTERVAL

ElasticApm:MetricsInterval