AppSignal for PHP configuration options

AppSignal for PHP can be configured through the config/appsignal.php file or by using environment variables. This page lists all available configuration options. Learn more about the configuration load order. Once you have configured AppSignal, you can validate the current config:

Shell

vendor/bin/appsignal validate

collector_endpoint

Field	Value
Config file key	`collector_endpoint`
System environment key	`APPSIGNAL_COLLECTOR_ENDPOINT`
Required	yes
Type	`String`
Default value	`null` (unset by default)

Description

The URL of the AppSignal collector to send trace, metric, and log data to. AppSignal shows this URL when you create a new application, and it’s also available for existing applications.

config/appsignal.php

return [
    'collector_endpoint' => $_ENV['APPSIGNAL_COLLECTOR_ENDPOINT'] ?? null,
    // ... other options
];

environment

Field	Value
Config file key	`environment`
System environment key	`APPSIGNAL_APP_ENV`
Required	yes
Type	`String`
Default value	`null` (unset by default)

Description

The environment of the app to be reported to AppSignal.

config/appsignal.php

return [
    'environment' => $_ENV['APPSIGNAL_APP_ENV'] ?? 'production',
    // ... other options
];

Note: Changing the name or environment of an existing app will create a new app on AppSignal.com.

name

Field	Value
Config file key	`name`
System environment key	`APPSIGNAL_APP_NAME`
Required	yes
Type	`String`
Default value	`null` (unset by default)

Description

The display name of your application on AppSignal.com.

config/appsignal.php

return [
    'name' => 'My App',
    // ... other options
];

Note: Changing the name or environment of an existing app will create a new app on AppSignal.com.

push_api_key

Field	Value
Config file key	`push_api_key`
System environment key	`APPSIGNAL_PUSH_API_KEY`
Required	yes
Type	`String`
Default value	`null` (unset by default)

Description

The organization-level key used to authenticate with the Push API. Read more about the AppSignal Push API key.

config/appsignal.php

return [
    'push_api_key' => $_ENV['APPSIGNAL_PUSH_API_KEY'] ?? '00000000-0000-0000-0000-000000000000',
    // ... other options
];

active

Field	Value
Config file key	`active`
System environment key	`APPSIGNAL_ACTIVE`
Required	no
Type	Boolean (`true` / `false`)
Default value	`false`

Description

Configure whether AppSignal is active for a given environment. Most commonly used in the file configuration per environment.

app_path

Field	Value
Config file key	`app_path`
Required	no
Type	`String`
Default value	detected from project root

Description

The location of the app on the host’s file system. Helps AppSignal clean up backtraces by stripping the absolute app path from backtrace lines, showing only paths within the project directory. This makes our Backtrace links feature possible. The AppSignal package sets this value automatically based on the detected project root. If the automatic app path detection doesn’t work, you can override it:

config/appsignal.php

return [
	'app_path' => '/var/www/html/your-app'
    // ... other options
];

filter_attributes

Field	Value
Config file key	`filter_attributes`
System environment key	`APPSIGNAL_FILTER_ATTRIBUTES`
Required	no
Type	`Array<String>`
Default value	`[]`

Description

The filter_attributes config option allows you to filter out specific attributes from being reported to AppSignal. This can be useful to filter out sensitive or non-relevant information from being reported. If an attribute is filtered out this way, it will not show up in the interface at all.

config/appsignal.php

return [
    'filter_attributes' => ['my.secret.attribute', 'some.opentelemetry.attribute'],
    // ... other options
];

filter_function_parameters

Field	Value
Config file key	`filter_function_parameters`
System environment key	`APPSIGNAL_FILTER_FUNCTION_PARAMETERS`
Required	no
Type	`Array<String>`
Default value	`[]`

Description

This config option allows you to filter out any function parameters set in the appsignal.function.parameters span attribute. AppSignal replaces values for the keys listed in the filter_function_parameters config option with [FILTERED].

config/appsignal.php

return [
    'filter_function_parameters' => ['api_token', 'secret'],
    // ... other options
];

filter_request_payload

Field	Value
Config file key	`filter_request_payload`
System environment key	`APPSIGNAL_FILTER_REQUEST_PAYLOAD`
Required	no
Type	`Array<String>`
Default value	`[]`

Description

This config option allows you to filter out any request payload data set in the appsignal.request.payload span attribute. AppSignal replaces values for the keys listed in the filter_request_payload config option with [FILTERED]. Read more about request query parameter filtering.

config/appsignal.php

return [
    'filter_request_payload' => ['password', 'cvv'],
    // ... other options
];

filter_request_query_parameters

Field	Value
Config file key	`filter_request_query_parameters`
System environment key	`APPSIGNAL_FILTER_REQUEST_QUERY_PARAMETERS`
Required	no
Type	`Array<String>`
Default value	`[]`

Description

This config option allows you to filter out any request query parameters set in the appsignal.request.query_parameters span attribute. AppSignal replaces values for the keys listed in the filter_request_query_parameters config option with [FILTERED]. Read more about request query parameter filtering.

config/appsignal.php

return [
    'filter_request_query_parameters' => ['password', 'cvv'],
    // ... other options
];

filter_request_session_data

Field	Value
Config file key	`filter_request_session_data`
System environment key	`APPSIGNAL_FILTER_REQUEST_SESSION_DATA`
Required	no
Type	`Array<String>`
Default value	`[]`

Description

The filter_request_session_data config option allows you to filter out any request session data set in the appsignal.request.session_data span attribute. AppSignal replaces values for the keys listed in the filter_request_session_data config option with [FILTERED]. Read more about request session data filtering.

config/appsignal.php

return [
    'filter_request_session_data' => ['password', 'cvv'],
    // ... other options
];

hostname

Field	Value
Config file key	`hostname`
System environment key	`APPSIGNAL_HOSTNAME`
Required	no
Type	`String`
Default value	detected from system

Description

Helps AppSignal recognize different hosts for traces and tag them automatically with the hostname. The AppSignal package sets this value automatically using gethostname().

ignore_actions

Field	Value
Config file key	`ignore_actions`
System environment key	`APPSIGNAL_IGNORE_ACTIONS`
Required	no
Type	`Array<String>`
Default value	`[]`

Description

With this config option you can specify a list of actions that will be ignored by AppSignal. Everything that happens including exceptions will not be transmitted to AppSignal. This can be useful to ignore health check endpoints or other actions that you don’t want to monitor. Read more about ignoring actions.

config/appsignal.php

return [
    'ignore_actions' => ['GET /health_check', 'POST /ping'],
    // ... other options
];

ignore_errors

Field	Value
Config file key	`ignore_errors`
System environment key	`APPSIGNAL_IGNORE_ERRORS`
Required	no
Type	`Array<String>`
Default value	`[]`

Description

This config option allows you to ignore specific errors from being reported to AppSignal. This can be useful to ignore expected errors or errors that can’t be solved. Read more about ignoring errors.

config/appsignal.php

return [
    'ignore_errors' => ['MyCustomError', 'ExpectedError'],
    // ... other options
];

ignore_logs

Field	Value
Config file key	`ignore_logs`
System environment key	`APPSIGNAL_IGNORE_LOGS`
Required	no
Type	`Array<String>`
Default value	`[]`

Description

List of log messages that will be ignored. Any log message containing any of the elements of the list will not be transmitted to AppSignal. A small subset of regex syntax is supported, read more about it in our Ignore Logs guide. The expected format is a comma-separated list of values.

config/appsignal.php

return [
	'ignore_logs' => ["^success", "OK"],
	// ... other options
];

ignore_namespaces

Field	Value
Config file key	`ignore_namespaces`
System environment key	`APPSIGNAL_IGNORE_NAMESPACES`
Required	no
Type	`Array<String>`
Default value	`[]`

Description

This config option allows you to ignore specific namespaces from being reported to AppSignal. This can be useful to ignore specific parts of your application from being monitored. Read more about namespaces.

config/appsignal.php

return [
    'ignore_namespaces' => ['admin', 'secret'],
    // ... other options
];

request_headers

Field	Value
Config file key	`request_headers`
System environment key	`APPSIGNAL_REQUEST_HEADERS`
Required	no
Type	`Array<String>`
Default value	`["accept", "accept-charset", "accept-encoding", "accept-language", "cache-control", "connection", "content-length", "host", "range"]`

Description

Configure which request headers to include when a request is made to an HTTP server. This option is an allowlist. It only includes the headers that are configured. If the list is empty, no headers are included. AppSignal reads request headers from the HTTP request. Each key is a normalized (lowercase) header name.

config/appsignal.php

return [
	'request_headers' => ['accept-encoding', 'content-length', 'user-agent'],
	// ... other options
];

To configure AppSignal to not store any HTTP request headers, explicitly set the config value to an empty array.

config/appsignal.php

return [
    'request_headers' => [],
	// ... other options
];

response_headers

Field	Value
Config file key	`response_headers`
System environment key	`APPSIGNAL_RESPONSE_HEADERS`
Required	no
Type	`Array<String>`
Default value	`["accept", "accept-charset", "accept-encoding", "accept-language", "cache-control", "connection", "content-length", "date", "range"]`

Description

Configure which response headers to include when a request is made by an HTTP client. This option is an allowlist. It only includes the headers that are configured. If the array is empty, no headers are included. Each item in this array should be a normalized HTTP response header name (lowercase).

config/appsignal.php

return [
    'response_headers' => ['accept', 'accept-charset', 'accept-encoding'],
	// ... other options
];

To configure AppSignal to not store any HTTP response headers, explicitly set the config value to an empty array.

config/appsignal.php

return [
    'response_headers' => [],
	// ... other options
];

revision

Field	Value
Config file key	`revision`
System environment key	`APPSIGNAL_REVISION`
Required	no
Type	`String`
Default value	detected from git

Description

The currently running version of your app. AppSignal will create a deploy marker when this value changes, and tag all incoming data with the current revision. The AppSignal package sets this value automatically using git rev-parse HEAD. Read more about deploy markers in the deploy markers topic.

send_function_parameters

Field	Value
Config file key	`send_function_parameters`
System environment key	`APPSIGNAL_SEND_FUNCTION_PARAMETERS`
Required	no
Type	Boolean (`true` / `false`)
Default value	`true`

Description

Configure whether to include function parameters in traces. If set to false no such data is sent to our servers. These values are set with the appsignal.function.parameters span attribute.

config/appsignal.php

return [
    'send_function_parameters' => false,
    // ... other options
];

send_request_payload

Field	Value
Config file key	`send_request_payload`
System environment key	`APPSIGNAL_SEND_REQUEST_PAYLOAD`
Required	no
Type	Boolean (`true` / `false`)
Default value	`true`

Description

Configure whether to send request payload data in traces. If set to false no such data is sent to our servers. These values are set with the appsignal.request.payload span attribute. For more information please read about request payload filtering.

config/appsignal.php

return [
    'send_request_payload' => false,
    // ... other options
];

send_request_query_parameters

Field	Value
Config file key	`send_request_query_parameters`
System environment key	`APPSIGNAL_SEND_REQUEST_QUERY_PARAMETERS`
Required	no
Type	Boolean (`true` / `false`)
Default value	`true`

Description

Configure whether to include request query parameters in traces. If set to false no such data is sent to our servers. These values are set with the appsignal.request.query_parameters span attribute. For more information please read about request parameter filtering.

config/appsignal.php

return [
    'send_request_query_parameters' => false,
    // ... other options
];

send_request_session_data

Field	Value
Config file key	`send_request_session_data`
System environment key	`APPSIGNAL_SEND_REQUEST_SESSION_DATA`
Required	no
Type	Boolean (`true` / `false`)
Default value	`true`

Description

Configure whether to send request session data in traces. If set to false no such data is sent to our servers. These values are set with the appsignal.request.session_data span attribute. For more information please read about request session data filtering.

config/appsignal.php

return [
    'send_request_session_data' => false,
    // ... other options
];

service_name

Field	Value
Config file key	`service_name`
System environment key	`APPSIGNAL_SERVICE_NAME`
Required	no
Type	`String`
Default value	`null` (unset by default)

Description

The service name helps AppSignal recognize different services and automatically groups their traces into a matching namespace. Choose a name that fits your application, like “Web server”, “Background worker”, “Email service”, “Authentication service”, etc.

config/appsignal.php

return [
    'service_name' => 'My service name',
    // ... other options
];

​Available options

​collector_endpoint

​Description

​environment

​Description

​name

​Description

​push_api_key

​Description

​active

​Description

​app_path

​Description

​filter_attributes

​Description

​filter_function_parameters

​Description

​filter_request_payload

​Description

​filter_request_query_parameters

​Description

​filter_request_session_data

​Description

​hostname

​Description

​ignore_actions

​Description

​ignore_errors

​Description

​ignore_logs

​Description

​ignore_namespaces

​Description

​request_headers

​Description

​response_headers

​Description

​revision

​Description

​send_function_parameters

​Description

​send_request_payload

​Description

​send_request_query_parameters

​Description

​send_request_session_data

​Description

​service_name

​Description

Available options

collector_endpoint

Description

environment

Description

name

Description

push_api_key

Description

active

Description

app_path

Description

filter_attributes

Description

filter_function_parameters

Description

filter_request_payload

Description

filter_request_query_parameters

Description

filter_request_session_data

Description

hostname

Description

ignore_actions

Description

ignore_errors

Description

ignore_logs

Description

ignore_namespaces

Description

request_headers

Description

response_headers

Description

revision

Description

send_function_parameters

Description

send_request_payload

Description

send_request_query_parameters

Description

send_request_session_data

Description

service_name

Description