« Configure Configure anonymous authentication »

› › ›

General configuration options

General APM Server configuration options.

Example config file:

apm-server:
  host: "localhost:8200"
  rum:
    enabled: true

max_procs: 4

Configuration options

edit

Host

edit

Defines the host and port the server is listening on. Use "unix:/path/to.sock" to listen on a Unix domain socket. Defaults to localhost:8200. (text)

APM Server binary	`apm-server.host`
Fleet-managed	`Host`

URL

edit

The publicly reachable server URL. For deployments on Elastic Cloud or ECK, the default is unchangeable.

APM Server binary	N/A
Fleet-managed	`URL`

Max header size

edit

Maximum permitted size of a request’s header accepted by the server to be processed (in Bytes). Defaults to 1048576 Bytes (1 MB). (int)

APM Server binary	`apm-server.max_header_size`
Fleet-managed	`Maximum size of a request's header`

Idle timeout

edit

Maximum amount of time to wait for the next incoming request before underlying connection is closed. Defaults to 45s (45 seconds). (text)

APM Server binary	`apm-server.idle_timeout`
Fleet-managed	`Idle time before underlying connection is closed`

Read timeout

edit

Maximum permitted duration for reading an entire request. Defaults to 3600s (3600 seconds). (text)

APM Server binary	`apm-server.read_timeout`
Fleet-managed	`Maximum duration for reading an entire request`

Write timeout

edit

Maximum permitted duration for writing a response. Defaults to 30s (30 seconds). (text)

APM Server binary	`apm-server.write_timeout`
Fleet-managed	`Maximum duration for writing a response`

Shutdown timeout

edit

Maximum duration in seconds before releasing resources when shutting down the server. Defaults to 30s (30 seconds). (text)

APM Server binary	`apm-server.shutdown_timeout`
Fleet-managed	`Maximum duration before releasing resources when shutting down`

Max event size

edit

Maximum permitted size of an event accepted by the server to be processed (in Bytes). Defaults to 307200 Bytes. (int)

APM Server binary	`apm-server.max_event_size`
Fleet-managed	`Maximum size per event`

Max connections

edit

Maximum number of TCP connections to accept simultaneously. Default value is 0, which means unlimited. (int)

APM Server binary	`apm-server.max_connections`
Fleet-managed	`Simultaneously accepted connections`

Custom HTTP response headers

edit

Custom HTTP headers to add to HTTP responses. Useful for security policy compliance. (text)

APM Server binary	`apm-server.response_headers`
Fleet-managed	`Custom HTTP response headers`

Capture personal data

edit

If true, APM Server captures the IP of the instrumented service and its User Agent if any. Enabled by default. (bool)

APM Server binary	`apm-server.capture_personal_data`
Fleet-managed	`Capture personal data`

Default service environment

edit

Sets the default service environment to associate with data and requests received from agents which have no service environment defined. Default: none. (text)

APM Server binary	`apm-server.default_service_environment`
Fleet-managed	`Default Service Environment`

expvar support

edit

When set to true APM Server exposes golang expvar under /debug/vars. Disabled by default.

APM Server binary	`apm-server.expvar.enabled`
Fleet-managed	`Enable APM Server Golang expvar support`

expvar URL

edit

Configure the URL to expose expvar. Defaults to debug/vars.

APM Server binary	`apm-server.expvar.url`
Fleet-managed	N/A

Data stream namespace

edit

Change the default namespace. This setting changes the name of the data stream.

For Fleet-managed users, the namespace is inherited from the selected Elastic Agent policy.

APM Server binary	`apm-server.data_streams.namespace`
Fleet-managed	`Namespace` (Integration settings > Advanced options)

« Configure Configure anonymous authentication »