> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Opções de configuração do AppSignal for PHP

O AppSignal for PHP pode ser configurado através do arquivo `config/appsignal.php` ou usando variáveis de ambiente. Esta página lista todas as opções de configuração disponíveis.

Saiba mais sobre a [ordem de carregamento da configuração](/php/configuration/load-order).

Depois de configurar o AppSignal, você pode validar a configuração atual:

```sh Shell theme={null}
vendor/bin/appsignal validate
```

## Opções disponíveis

* Opções obrigatórias
  * [`collector_endpoint`](#option-collector_endpoint)
  * [`environment`](#option-environment)
  * [`name`](#option-name)
  * [`push_api_key`](#option-push_api_key)
* Opções
  * [`active`](#option-active)
  * [`app_path`](#option-app_path)
  * [`filter_attributes`](#option-filter_attributes)
  * [`filter_function_parameters`](#option-filter_function_parameters)
  * [`filter_request_payload`](#option-filter_request_payload)
  * [`filter_request_query_parameters`](#option-filter_request_query_parameters)
  * [`filter_request_session_data`](#option-filter_request_session_data)
  * [`hostname`](#option-hostname)
  * [`ignore_actions`](#option-ignore_actions)
  * [`ignore_errors`](#option-ignore_errors)
  * [`ignore_logs`](#option-ignore_logs)
  * [`ignore_namespaces`](#option-ignore_namespaces)
  * [`request_headers`](#option-request_headers)
  * [`response_headers`](#option-response_headers)
  * [`revision`](#option-revision)
  * [`send_function_parameters`](#option-send_function_parameters)
  * [`send_request_payload`](#option-send_request_payload)
  * [`send_request_query_parameters`](#option-send_request_query_parameters)
  * [`send_request_session_data`](#option-send_request_session_data)
  * [`service_name`](#option-service_name)

## collector\_endpoint

<a id="option-collector_endpoint" />

| Campo                                    | Valor                            |
| ---------------------------------------- | -------------------------------- |
| Chave do arquivo de configuração         | `collector_endpoint`             |
| Chave de variável de ambiente do sistema | `APPSIGNAL_COLLECTOR_ENDPOINT`   |
| Obrigatório                              | sim                              |
| Tipo                                     | `String`                         |
| Valor padrão                             | `null` (não definido por padrão) |

### Descrição

A URL do coletor do AppSignal para o qual enviar dados de trace, métricas e logs.

O AppSignal exibe esta URL ao criar um novo aplicativo, e também está disponível para aplicativos existentes.

```php title="config/appsignal.php" theme={null}
return [
    'collector_endpoint' => $_ENV['APPSIGNAL_COLLECTOR_ENDPOINT'] ?? null,
    // ... other options
];
```

## environment

<a id="option-environment" />

| Campo                                    | Valor                            |
| ---------------------------------------- | -------------------------------- |
| Chave do arquivo de configuração         | `environment`                    |
| Chave de variável de ambiente do sistema | `APPSIGNAL_APP_ENV`              |
| Obrigatório                              | sim                              |
| Tipo                                     | `String`                         |
| Valor padrão                             | `null` (não definido por padrão) |

### Descrição

O ambiente do aplicativo a ser reportado ao AppSignal.

```php title="config/appsignal.php" theme={null}
return [
    'environment' => $_ENV['APPSIGNAL_APP_ENV'] ?? 'production',
    // ... other options
];
```

<Note>
  **Nota**: Alterar o [nome](#option-name) ou o ambiente de um aplicativo existente
  criará um novo aplicativo no AppSignal.com.
</Note>

## name

<a id="option-name" />

| Campo                                    | Valor                            |
| ---------------------------------------- | -------------------------------- |
| Chave do arquivo de configuração         | `name`                           |
| Chave de variável de ambiente do sistema | `APPSIGNAL_APP_NAME`             |
| Obrigatório                              | sim                              |
| Tipo                                     | `String`                         |
| Valor padrão                             | `null` (não definido por padrão) |

### Descrição

O nome de exibição do seu aplicativo no AppSignal.com.

```php title="config/appsignal.php" theme={null}
return [
    'name' => 'My App',
    // ... other options
];
```

<Note>
  **Nota**: Alterar o nome ou o [ambiente](#option-env) de um aplicativo existente
  criará um novo aplicativo no AppSignal.com.
</Note>

## push\_api\_key

<a id="option-push_api_key" />

| Campo                                    | Valor                            |
| ---------------------------------------- | -------------------------------- |
| Chave do arquivo de configuração         | `push_api_key`                   |
| Chave de variável de ambiente do sistema | `APPSIGNAL_PUSH_API_KEY`         |
| Obrigatório                              | sim                              |
| Tipo                                     | `String`                         |
| Valor padrão                             | `null` (não definido por padrão) |

### Descrição

A chave em nível de organização usada para autenticar com a Push API.

Saiba mais sobre a [chave da Push API do AppSignal](/appsignal/terminology#push-api-key).

```php title="config/appsignal.php" theme={null}
return [
    'push_api_key' => $_ENV['APPSIGNAL_PUSH_API_KEY'] ?? '00000000-0000-0000-0000-000000000000',
    // ... other options
];
```

## active

<a id="option-active" />

| Campo                                    | Valor                      |
| ---------------------------------------- | -------------------------- |
| Chave do arquivo de configuração         | `active`                   |
| Chave de variável de ambiente do sistema | `APPSIGNAL_ACTIVE`         |
| Obrigatório                              | não                        |
| Tipo                                     | Boolean (`true` / `false`) |
| Valor padrão                             | `false`                    |

### Descrição

Configura se o AppSignal está ativo para um determinado ambiente. Mais comumente usado na [configuração por arquivo](/php/configuration) por ambiente.

## app\_path

<a id="option-app_path" />

| Campo                            | Valor                                 |
| -------------------------------- | ------------------------------------- |
| Chave do arquivo de configuração | `app_path`                            |
| Obrigatório                      | não                                   |
| Tipo                             | `String`                              |
| Valor padrão                     | detectado a partir da raiz do projeto |

### Descrição

A localização do aplicativo no sistema de arquivos do host.

Ajuda o AppSignal a limpar backtraces removendo o caminho absoluto do aplicativo das linhas de backtrace, mostrando apenas caminhos dentro do diretório do projeto. Isso torna possível nosso recurso de [Backtrace links](/application/backtrace-links).

O pacote AppSignal define este valor automaticamente com base na raiz do projeto detectada. Se a detecção automática do caminho do aplicativo não funcionar, você pode sobrescrevê-la:

```php title="config/appsignal.php" theme={null}
return [
	'app_path' => '/var/www/html/your-app'
    // ... other options
];
```

## filter\_attributes

<a id="option-filter_attributes" />

| Campo                                    | Valor                         |
| ---------------------------------------- | ----------------------------- |
| Chave do arquivo de configuração         | `filter_attributes`           |
| Chave de variável de ambiente do sistema | `APPSIGNAL_FILTER_ATTRIBUTES` |
| Obrigatório                              | não                           |
| Tipo                                     | `Array<String>`               |
| Valor padrão                             | `[]`                          |

### Descrição

A opção de configuração `filter_attributes` permite que você filtre atributos específicos para que não sejam reportados ao AppSignal. Isso pode ser útil para filtrar informações sensíveis ou não relevantes.

Se um atributo for filtrado dessa forma, ele não aparecerá na interface.

```php title="config/appsignal.php" theme={null}
return [
    'filter_attributes' => ['my.secret.attribute', 'some.opentelemetry.attribute'],
    // ... other options
];
```

## filter\_function\_parameters

<a id="option-filter_function_parameters" />

| Campo                                    | Valor                                  |
| ---------------------------------------- | -------------------------------------- |
| Chave do arquivo de configuração         | `filter_function_parameters`           |
| Chave de variável de ambiente do sistema | `APPSIGNAL_FILTER_FUNCTION_PARAMETERS` |
| Obrigatório                              | não                                    |
| Tipo                                     | `Array<String>`                        |
| Valor padrão                             | `[]`                                   |

### Descrição

Esta opção de configuração permite que você filtre quaisquer parâmetros de função definidos no [atributo de span `appsignal.function.parameters`](/guides/custom-data/function-parameters).

O AppSignal substitui os valores das chaves listadas na opção de configuração `filter_function_parameters` por `[FILTERED]`.

```php title="config/appsignal.php" theme={null}
return [
    'filter_function_parameters' => ['api_token', 'secret'],
    // ... other options
];
```

## filter\_request\_payload

<a id="option-filter_request_payload" />

| Campo                                    | Valor                              |
| ---------------------------------------- | ---------------------------------- |
| Chave do arquivo de configuração         | `filter_request_payload`           |
| Chave de variável de ambiente do sistema | `APPSIGNAL_FILTER_REQUEST_PAYLOAD` |
| Obrigatório                              | não                                |
| Tipo                                     | `Array<String>`                    |
| Valor padrão                             | `[]`                               |

### Descrição

Esta opção de configuração permite que você filtre quaisquer dados de payload de requisição definidos no [atributo de span `appsignal.request.payload`](/guides/custom-data/request-parameters).

O AppSignal substitui os valores das chaves listadas na opção de configuração `filter_request_payload` por `[FILTERED]`.

Saiba mais sobre [filtragem de parâmetros de query de requisição](/application/parameter-filtering).

```php title="config/appsignal.php" theme={null}
return [
    'filter_request_payload' => ['password', 'cvv'],
    // ... other options
];
```

## filter\_request\_query\_parameters

<a id="option-filter_request_query_parameters" />

| Campo                                    | Valor                                       |
| ---------------------------------------- | ------------------------------------------- |
| Chave do arquivo de configuração         | `filter_request_query_parameters`           |
| Chave de variável de ambiente do sistema | `APPSIGNAL_FILTER_REQUEST_QUERY_PARAMETERS` |
| Obrigatório                              | não                                         |
| Tipo                                     | `Array<String>`                             |
| Valor padrão                             | `[]`                                        |

### Descrição

Esta opção de configuração permite que você filtre quaisquer parâmetros de query de requisição definidos no [atributo de span `appsignal.request.query_parameters`](/guides/custom-data/request-parameters).

O AppSignal substitui os valores das chaves listadas na opção de configuração `filter_request_query_parameters` por `[FILTERED]`.

Saiba mais sobre [filtragem de parâmetros de query de requisição](/application/parameter-filtering).

```php title="config/appsignal.php" theme={null}
return [
    'filter_request_query_parameters' => ['password', 'cvv'],
    // ... other options
];
```

## filter\_request\_session\_data

<a id="option-filter_request_session_data" />

| Campo                                    | Valor                                   |
| ---------------------------------------- | --------------------------------------- |
| Chave do arquivo de configuração         | `filter_request_session_data`           |
| Chave de variável de ambiente do sistema | `APPSIGNAL_FILTER_REQUEST_SESSION_DATA` |
| Obrigatório                              | não                                     |
| Tipo                                     | `Array<String>`                         |
| Valor padrão                             | `[]`                                    |

### Descrição

A opção de configuração `filter_request_session_data` permite que você filtre quaisquer dados de sessão de requisição definidos no [atributo de span `appsignal.request.session_data`](/guides/custom-data/request-session-data).

O AppSignal substitui os valores das chaves listadas na opção de configuração `filter_request_session_data` por `[FILTERED]`.

Saiba mais sobre [filtragem de dados de sessão de requisição](/application/session-data-filtering).

```php title="config/appsignal.php" theme={null}
return [
    'filter_request_session_data' => ['password', 'cvv'],
    // ... other options
];
```

## hostname

<a id="option-hostname" />

| Campo                                    | Valor                         |
| ---------------------------------------- | ----------------------------- |
| Chave do arquivo de configuração         | `hostname`                    |
| Chave de variável de ambiente do sistema | `APPSIGNAL_HOSTNAME`          |
| Obrigatório                              | não                           |
| Tipo                                     | `String`                      |
| Valor padrão                             | detectado a partir do sistema |

### Descrição

Ajuda o AppSignal a reconhecer diferentes hosts para traces e marcá-los automaticamente com o hostname.

O pacote AppSignal define este valor automaticamente usando `gethostname()`.

## ignore\_actions

<a id="option-ignore_actions" />

| Campo                                    | Valor                      |
| ---------------------------------------- | -------------------------- |
| Chave do arquivo de configuração         | `ignore_actions`           |
| Chave de variável de ambiente do sistema | `APPSIGNAL_IGNORE_ACTIONS` |
| Obrigatório                              | não                        |
| Tipo                                     | `Array<String>`            |
| Valor padrão                             | `[]`                       |

### Descrição

Com esta opção de configuração você pode especificar uma lista de ações que serão ignoradas pelo AppSignal. Tudo que acontecer, incluindo exceções, não será transmitido ao AppSignal. Isso pode ser útil para ignorar endpoints de health check ou outras ações que você não deseja monitorar.

Saiba mais sobre [ignorar ações](/guides/filter-data/ignore-actions).

```php title="config/appsignal.php" theme={null}
return [
    'ignore_actions' => ['GET /health_check', 'POST /ping'],
    // ... other options
];
```

## ignore\_errors

<a id="option-ignore_errors" />

| Campo                                    | Valor                     |
| ---------------------------------------- | ------------------------- |
| Chave do arquivo de configuração         | `ignore_errors`           |
| Chave de variável de ambiente do sistema | `APPSIGNAL_IGNORE_ERRORS` |
| Obrigatório                              | não                       |
| Tipo                                     | `Array<String>`           |
| Valor padrão                             | `[]`                      |

### Descrição

Esta opção de configuração permite que você ignore erros específicos para que não sejam reportados ao AppSignal. Isso pode ser útil para ignorar erros esperados ou erros que não podem ser resolvidos.

Saiba mais sobre [ignorar erros](/guides/filter-data/ignore-errors).

```php title="config/appsignal.php" theme={null}
return [
    'ignore_errors' => ['MyCustomError', 'ExpectedError'],
    // ... other options
];
```

## ignore\_logs

<a id="option-ignore_logs" />

| Campo                                    | Valor                   |
| ---------------------------------------- | ----------------------- |
| Chave do arquivo de configuração         | `ignore_logs`           |
| Chave de variável de ambiente do sistema | `APPSIGNAL_IGNORE_LOGS` |
| Obrigatório                              | não                     |
| Tipo                                     | `Array<String>`         |
| Valor padrão                             | `[]`                    |

### Descrição

Lista de mensagens de log que serão ignoradas. Qualquer mensagem de log que contenha qualquer um dos elementos da lista não será transmitida ao AppSignal. Um pequeno subconjunto da sintaxe de regex é suportado, leia mais sobre isso em nosso guia [Ignorar Logs](/guides/filter-data/ignore-logs).

O formato esperado é uma lista de valores separados por vírgulas.

```php title="config/appsignal.php" theme={null}
return [
	'ignore_logs' => ["^success", "OK"],
	// ... other options
];
```

## ignore\_namespaces

<a id="option-ignore_namespaces" />

| Campo                                    | Valor                         |
| ---------------------------------------- | ----------------------------- |
| Chave do arquivo de configuração         | `ignore_namespaces`           |
| Chave de variável de ambiente do sistema | `APPSIGNAL_IGNORE_NAMESPACES` |
| Obrigatório                              | não                           |
| Tipo                                     | `Array<String>`               |
| Valor padrão                             | `[]`                          |

### Descrição

Esta opção de configuração permite que você ignore namespaces específicos para que não sejam reportados ao AppSignal. Isso pode ser útil para ignorar partes específicas do seu aplicativo do monitoramento.

Saiba mais sobre [namespaces](/application/namespaces).

```php title="config/appsignal.php" theme={null}
return [
    'ignore_namespaces' => ['admin', 'secret'],
    // ... other options
];
```

## request\_headers

<a id="option-request_headers" />

| Campo                                    | Valor                                                                                                                                  |
| ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| Chave do arquivo de configuração         | `request_headers`                                                                                                                      |
| Chave de variável de ambiente do sistema | `APPSIGNAL_REQUEST_HEADERS`                                                                                                            |
| Obrigatório                              | não                                                                                                                                    |
| Tipo                                     | `Array<String>`                                                                                                                        |
| Valor padrão                             | `["accept", "accept-charset", "accept-encoding", "accept-language", "cache-control", "connection", "content-length", "host", "range"]` |

### Descrição

Configura quais cabeçalhos de requisição incluir quando uma requisição é feita a um servidor HTTP. Esta opção é uma allowlist. Ela só inclui os cabeçalhos que são configurados. Se a lista estiver vazia, nenhum cabeçalho é incluído.

O AppSignal lê os cabeçalhos de requisição da requisição HTTP. Cada chave é um nome de cabeçalho normalizado (em letras minúsculas).

```php title="config/appsignal.php" theme={null}
return [
	'request_headers' => ['accept-encoding', 'content-length', 'user-agent'],
	// ... other options
];
```

Para configurar o AppSignal para não armazenar nenhum cabeçalho de requisição HTTP, defina explicitamente o valor da configuração como um array vazio.

```php title="config/appsignal.php" theme={null}
return [
    'request_headers' => [],
	// ... other options
];
```

## response\_headers

<a id="option-response_headers" />

| Campo                                    | Valor                                                                                                                                  |
| ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| Chave do arquivo de configuração         | `response_headers`                                                                                                                     |
| Chave de variável de ambiente do sistema | `APPSIGNAL_RESPONSE_HEADERS`                                                                                                           |
| Obrigatório                              | não                                                                                                                                    |
| Tipo                                     | `Array<String>`                                                                                                                        |
| Valor padrão                             | `["accept", "accept-charset", "accept-encoding", "accept-language", "cache-control", "connection", "content-length", "date", "range"]` |

### Descrição

Configura quais cabeçalhos de resposta incluir quando uma requisição é feita por um cliente HTTP. Esta opção é uma allowlist. Ela só inclui os cabeçalhos que são configurados. Se o array estiver vazio, nenhum cabeçalho é incluído.

Cada item neste array deve ser um nome de cabeçalho de resposta HTTP normalizado (em letras minúsculas).

```php title="config/appsignal.php" theme={null}
return [
    'response_headers' => ['accept', 'accept-charset', 'accept-encoding'],
	// ... other options
];
```

Para configurar o AppSignal para não armazenar nenhum cabeçalho de resposta HTTP, defina explicitamente o valor da configuração como um array vazio.

```php title="config/appsignal.php" theme={null}
return [
    'response_headers' => [],
	// ... other options
];
```

## revision

<a id="option-revision" />

| Campo                                    | Valor                     |
| ---------------------------------------- | ------------------------- |
| Chave do arquivo de configuração         | `revision`                |
| Chave de variável de ambiente do sistema | `APPSIGNAL_REVISION`      |
| Obrigatório                              | não                       |
| Tipo                                     | `String`                  |
| Valor padrão                             | detectado a partir do git |

### Descrição

A versão atualmente em execução do seu aplicativo. O AppSignal criará um marcador de deploy quando esse valor mudar e marcará todos os dados recebidos com a revisão atual.

O pacote AppSignal define este valor automaticamente usando `git rev-parse HEAD`.

Saiba mais sobre marcadores de deploy no [tópico de marcadores de deploy](/application/markers/deploy-markers).

## send\_function\_parameters

<a id="option-send_function_parameters" />

| Campo                                    | Valor                                |
| ---------------------------------------- | ------------------------------------ |
| Chave do arquivo de configuração         | `send_function_parameters`           |
| Chave de variável de ambiente do sistema | `APPSIGNAL_SEND_FUNCTION_PARAMETERS` |
| Obrigatório                              | não                                  |
| Tipo                                     | Boolean (`true` / `false`)           |
| Valor padrão                             | `true`                               |

### Descrição

Configura se deve incluir parâmetros de função em traces. Se definido como `false`, nenhum desses dados é enviado para nossos servidores.

Esses valores são definidos com o [atributo de span `appsignal.function.parameters`](/guides/custom-data/function-parameters).

```php title="config/appsignal.php" theme={null}
return [
    'send_function_parameters' => false,
    // ... other options
];
```

## send\_request\_payload

<a id="option-send_request_payload" />

| Campo                                    | Valor                            |
| ---------------------------------------- | -------------------------------- |
| Chave do arquivo de configuração         | `send_request_payload`           |
| Chave de variável de ambiente do sistema | `APPSIGNAL_SEND_REQUEST_PAYLOAD` |
| Obrigatório                              | não                              |
| Tipo                                     | Boolean (`true` / `false`)       |
| Valor padrão                             | `true`                           |

### Descrição

Configura se deve enviar dados de payload de requisição em traces. Se definido como `false`, nenhum desses dados é enviado para nossos servidores.

Esses valores são definidos com o [atributo de span `appsignal.request.payload`](/guides/custom-data/request-parameters).

Para mais informações, leia sobre [filtragem de payload de requisição](/application/parameter-filtering).

```php title="config/appsignal.php" theme={null}
return [
    'send_request_payload' => false,
    // ... other options
];
```

## send\_request\_query\_parameters

<a id="option-send_request_query_parameters" />

| Campo                                    | Valor                                     |
| ---------------------------------------- | ----------------------------------------- |
| Chave do arquivo de configuração         | `send_request_query_parameters`           |
| Chave de variável de ambiente do sistema | `APPSIGNAL_SEND_REQUEST_QUERY_PARAMETERS` |
| Obrigatório                              | não                                       |
| Tipo                                     | Boolean (`true` / `false`)                |
| Valor padrão                             | `true`                                    |

### Descrição

Configura se deve incluir parâmetros de query de requisição em traces. Se definido como `false`, nenhum desses dados é enviado para nossos servidores.

Esses valores são definidos com o [atributo de span `appsignal.request.query_parameters`](/guides/custom-data/request-parameters).

Para mais informações, leia sobre [filtragem de parâmetros de requisição](/application/parameter-filtering).

```php title="config/appsignal.php" theme={null}
return [
    'send_request_query_parameters' => false,
    // ... other options
];
```

## send\_request\_session\_data

<a id="option-send_request_session_data" />

| Campo                                    | Valor                                 |
| ---------------------------------------- | ------------------------------------- |
| Chave do arquivo de configuração         | `send_request_session_data`           |
| Chave de variável de ambiente do sistema | `APPSIGNAL_SEND_REQUEST_SESSION_DATA` |
| Obrigatório                              | não                                   |
| Tipo                                     | Boolean (`true` / `false`)            |
| Valor padrão                             | `true`                                |

### Descrição

Configura se deve enviar dados de sessão de requisição em traces. Se definido como `false`, nenhum desses dados é enviado para nossos servidores.

Esses valores são definidos com o [atributo de span `appsignal.request.session_data`](/guides/custom-data/request-session-data).

Para mais informações, leia sobre [filtragem de dados de sessão de requisição](/application/session-data-filtering).

```php title="config/appsignal.php" theme={null}
return [
    'send_request_session_data' => false,
    // ... other options
];
```

## service\_name

<a id="option-service_name" />

| Campo                                    | Valor                            |
| ---------------------------------------- | -------------------------------- |
| Chave do arquivo de configuração         | `service_name`                   |
| Chave de variável de ambiente do sistema | `APPSIGNAL_SERVICE_NAME`         |
| Obrigatório                              | não                              |
| Tipo                                     | `String`                         |
| Valor padrão                             | `null` (não definido por padrão) |

### Descrição

O nome do serviço ajuda o AppSignal a reconhecer diferentes serviços e agrupa automaticamente seus traces em um namespace correspondente.

Escolha um nome que se adeque ao seu aplicativo, como "Web server", "Background worker", "Email service", "Authentication service", etc.

```php title="config/appsignal.php" theme={null}
return [
    'service_name' => 'My service name',
    // ... other options
];
```