HTTP configuration optionsedit

capture_bodyedit

For transactions that are HTTP requests, the Java agent can optionally capture the request body (e.g. POST variables).

Possible values: errors, transactions, all, off.

If the request has a body and this setting is disabled, the body will be shown as [REDACTED].

For requests with a content type of multipart/form-data, any uploaded files will be referenced in a special _files key. It contains the name of the field, and the name of the uploaded file, if provided.

Warning

request bodies often contain sensitive values like passwords, credit card numbers etc.If your service handles data like this, we advise to only enable this feature with care.

Default Type Dynamic

OFF

EventType

true

Java System Properties Environment

elastic.apm.capture_body

ELASTIC_APM_CAPTURE_BODY

ignore_urlsedit

Used to restrict requests to certain URLs from being instrumented.

This property should be set to an array containing one or more strings. When an incoming HTTP request is detected, its URL will be tested against each element in this list. Entries can have a wildcard at the beginning and at the end. Prepending an element with (?i) makes the matching case-insensitive.

Note

All errors that are captured during a request to an ignored URL are still sent to the APM Server regardless of this setting.

Default Type Dynamic

/VAADIN/*, (?i)/heartbeat/*, /favicon.ico, *.js, *.css, *.jpg, *.jpeg, *.png, *.webp, *.svg, *.woff, *.woff2

List

true

Java System Properties Environment

elastic.apm.ignore_urls

ELASTIC_APM_IGNORE_URLS

ignore_user_agentsedit

Used to restrict requests from certain User-Agents from being instrumented.

When an incoming HTTP request is detected, the User-Agent from the request headers will be tested against each element in this list. Entries can have a wildcard at the beginning and at the end. Prepending an element with (?i) makes the matching case-insensitive. Example: curl/*, (?i)*pingdom*

Note

All errors that are captured during a request by an ignored user agent are still sent to the APM Server regardless of this setting.

Default Type Dynamic

<none>

List

true

Java System Properties Environment

elastic.apm.ignore_user_agents

ELASTIC_APM_IGNORE_USER_AGENTS