> ## 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 Collector

O collector pode ser [configurado](/collector/configuration) na inicialização usando variáveis de ambiente ou um arquivo de configuração.

A lista a seguir inclui todas as opções de configuração com o nome da variável de ambiente e o nome da chave no arquivo de configuração.

Para mais informações sobre como configurar o AppSignal Collector com um arquivo de configuração ou usando variáveis de ambiente, consulte nossa [seção de configuração](/collector/configuration).

## Opções disponíveis

* Opções obrigatórias
  * [`push_api_key`](#option-push_api_key)
* Opções
  * [`cpu_count`](#option-cpu_count)
  * [`enable_host_metrics`](#option-enable_host_metrics)
  * [`files_world_accessible`](#option-files_world_accessible)
  * [`hostname`](#option-hostname)
  * [`http_port`](#option-http_port)
  * [`log_level`](#option-log_level)
  * [`push_api_endpoint`](#option-push_api_endpoint)
  * [`running_in_container`](#option-running_in_container)
  * [`working_directory_path`](#option-working_directory_path)

## 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                             | nil (não definido por padrão) |
| Disponível desde a versão                | `0.1.0`                       |

### Descrição

A chave de autenticação no nível da organização para autenticar com nossa Push API.

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

## cpu\_count

<a id="option-cpu_count" />

| Campo                                    | Valor                 |
| ---------------------------------------- | --------------------- |
| Chave do arquivo de configuração         | `cpu_count`           |
| Chave de variável de ambiente do sistema | `APPSIGNAL_CPU_COUNT` |
| Obrigatório                              | não                   |
| Tipo                                     | `Float`               |
| Valor padrão                             | `undefined`           |
| Disponível desde a versão                | `0.3.0`               |

### Descrição

A capacidade de CPU disponível do host, em número de CPUs. Isso é usado para calcular o percentual de uso de CPU nas métricas do host. Se não for definido, o agente tentará detectá-lo automaticamente a partir dos cgroups.

O número de CPUs pode ser uma fração, por exemplo, `0.5`.

## enable\_host\_metrics

<a id="option-enable_host_metrics" />

| Campo                                    | Valor                                                                                                                              |
| ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| Chave do arquivo de configuração         | `enable_host_metrics`                                                                                                              |
| Chave de variável de ambiente do sistema | `APPSIGNAL_ENABLE_HOST_METRICS`                                                                                                    |
| Obrigatório                              | não                                                                                                                                |
| Tipo                                     | Booleano (`true` / `false`)                                                                                                        |
| Valor padrão                             | `false`                                                                                                                            |
| Disponível desde a versão                | `0.3.0`                                                                                                                            |
|                                          | <ul><li>`0.8.0`: Desabilitado por padrão.</li><li>`0.3.0`: Desabilitado por padrão na imagem Docker appsignal/collector.</li></ul> |

### Descrição

Defina esta opção como `false` para desativar a coleta de [métricas do host](/metrics/host-metrics).

No Heroku e no Dokku, as métricas do host são desabilitadas por padrão. Isso é feito porque esses sistemas reportam métricas imprecisas a partir dos containers. A coleta de métricas do host nesses sistemas não pode ser habilitada. Para o Heroku, use o [Heroku log drain](/heroku/host-metrics).

## files\_world\_accessible

<a id="option-files_world_accessible" />

| Campo                                    | Valor                              |
| ---------------------------------------- | ---------------------------------- |
| Chave do arquivo de configuração         | `files_world_accessible`           |
| Chave de variável de ambiente do sistema | `APPSIGNAL_FILES_WORLD_ACCESSIBLE` |
| Obrigatório                              | não                                |
| Tipo                                     | Booleano (`true` / `false`)        |
| Valor padrão                             | `true`                             |
| Disponível desde a versão                | `0.1.0`                            |

### Descrição

Se esta opção for definida como `true`, o [diretório de trabalho do AppSignal](/appsignal/how-appsignal-operates#working-directory) criado fica acessível para todos os usuários (permissões Unix `0666`). Isso geralmente é necessário porque processos do mesmo aplicativo são executados sob usuários diferentes. Defina como `false` para desativar esse comportamento (permissões Unix `0644`).

## 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 pelo sistema |
| Disponível desde a versão                | `0.3.0`                |

### Descrição

Isto substitui o hostname do servidor. Útil quando você não consegue definir um hostname personalizado ou quando um id pouco descritivo é gerado para você em serviços de hospedagem.

## http\_port

<a id="option-http_port" />

| Campo                                    | Valor                 |
| ---------------------------------------- | --------------------- |
| Chave do arquivo de configuração         | `http_port`           |
| Chave de variável de ambiente do sistema | `APPSIGNAL_HTTP_PORT` |
| Obrigatório                              | não                   |
| Tipo                                     | `Integer`             |
| Valor padrão                             | `8099`                |
| Disponível desde a versão                | `0.3.0`               |

### Descrição

A porta usada pelo servidor HTTP do coletor para receber requisições de exportação do OpenTelemetry.

## log\_level

<a id="option-log_level" />

| Campo                                    | Valor                 |
| ---------------------------------------- | --------------------- |
| Chave do arquivo de configuração         | `log_level`           |
| Chave de variável de ambiente do sistema | `APPSIGNAL_LOG_LEVEL` |
| Obrigatório                              | não                   |
| Tipo                                     | `String`              |
| Valor padrão                             | `info`                |
| Disponível desde a versão                | `0.1.0`               |

### Descrição

<Note>
  Esta opção define o nível de severidade do logger interno do AppSignal e
  não afeta o [recurso de logging](/logging).
</Note>

Define o nível de severidade do logger interno do AppSignal. Se estiver configurado como "info", ele registrará todas as mensagens de erro, aviso e info, mas não as mensagens de debug.

Definir como "debug" ou "trace" geralmente só é necessário a pedido do suporte. Definir o nível como "debug"/"trace" pode ter um leve impacto no uso de disco e IO, especialmente em sites de alto tráfego. A sobrecarga de CPU é mínima com a opção de debug habilitada.

Valores aceitos:

* error
* warning
* info
* debug
* trace

## push\_api\_endpoint

<a id="option-push_api_endpoint" />

| Campo                                    | Valor                         |
| ---------------------------------------- | ----------------------------- |
| Chave do arquivo de configuração         | `push_api_endpoint`           |
| Chave de variável de ambiente do sistema | `APPSIGNAL_PUSH_API_ENDPOINT` |
| Obrigatório                              | não                           |
| Tipo                                     | `String`                      |
| Valor padrão                             | `https://push.appsignal.com`  |
| Disponível desde a versão                | `0.1.0`                       |

### Descrição

Configura o endpoint para enviar dados ao AppSignal. Esta configuração não precisa ser alterada.

## running\_in\_container

<a id="option-running_in_container" />

| Campo                                    | Valor                            |
| ---------------------------------------- | -------------------------------- |
| Chave do arquivo de configuração         | `running_in_container`           |
| Chave de variável de ambiente do sistema | `APPSIGNAL_RUNNING_IN_CONTAINER` |
| Obrigatório                              | não                              |
| Tipo                                     | Booleano (`true` / `false`)      |
| Valor padrão                             | detectado pelo coletor           |
| Disponível desde a versão                | `0.3.0`                          |

### Descrição

O AppSignal espera ser executado na mesma máquina entre diferentes deploys. Defina esta chave como `true` se a aplicação estiver rodando em um container, como com o Docker.

Versões mais recentes da integração do AppSignal detectam automaticamente o ambiente em container, portanto, nenhuma configuração manual é necessária. Se você estiver tendo problemas com a detecção automática, [entre em contato com o suporte](mailto:support@appsignal.com).

Esta opção é definida automaticamente como `true` no [Heroku](http://heroku.com/).

## working\_directory\_path

<a id="option-working_directory_path" />

| Campo                                    | Valor                                                                                                     |
| ---------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| Chave do arquivo de configuração         | `working_directory_path`                                                                                  |
| Chave de variável de ambiente do sistema | `APPSIGNAL_WORKING_DIRECTORY_PATH`                                                                        |
| Obrigatório                              | não                                                                                                       |
| Tipo                                     | `String`                                                                                                  |
| Valor padrão                             | detectado pelo coletor                                                                                    |
| Disponível desde a versão                | `0.1.0`                                                                                                   |
|                                          | <ul><li>Esta opção de configuração era chamada de `working_dir_path` nas versões 0.1.0 a 0.3.x.</li></ul> |

### Descrição

Substitui o local onde o AppSignal Collector pode armazenar arquivos temporários. Use esta opção se o local padrão não for adequado. Veja nossa página [como o AppSignal opera](/appsignal/how-appsignal-operates) para mais informações sobre o propósito desse diretório de trabalho.

Se você estiver executando várias aplicações usando o AppSignal no mesmo servidor, use esta opção de configuração para selecionar diretórios de trabalho diferentes para cada instância do AppSignal; caso contrário, as duas instâncias podem entrar em conflito. Para mais informações sobre esse cenário, consulte nossa documentação [executando várias aplicações em um host](/guides/application/multiple-applications-on-one-host).

<Note>
  **Nota**: O caminho especificado não pode conter abstrações de sistema de
  arquivos específicas do sistema operacional, como o símbolo de diretório
  pessoal `~` para sistemas \*NIX. Isso será considerado um caminho malformado.
</Note>
