General configuration options

edit

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 integration’s 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)