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

# Configuração do AppSignal Standalone agent

Configurar o standalone agent do AppSignal é importante porque, sem isso, ele não saberá para qual aplicação está reportando dados.

Nesta documentação vamos explicar como e o que pode ser configurado no standalone agent e como a configuração é carregada.

## Configuração mínima

Com uma configuração mínima, o AppSignal receberá informações suficientes para reportar os dados coletados pelo agent a partir de um dos seus apps.

Uma configuração mínima exige que as seguintes opções de configuração sejam definidas:

* [Nome do app](/standalone-agent/configuration/options#option-app_name)
* [Ambiente do app](/standalone-agent/configuration/options#option-environment)
* [Push API key](/standalone-agent/configuration/options#option-push_api_key)

## Métodos de configuração

### Arquivo de configuração

O AppSignal standalone agent pode ser configurado com um arquivo de configuração. Este método é obrigatório para o [método de instalação via pacote Linux][linux package].

Você precisa localizar, ou criar, o arquivo de configuração em `/etc/appsignal-agent.conf`. Depois de encontrar ou criar um arquivo de configuração, você pode então configurar o agent com as opções listadas na [página de opções][options].

#### Exemplo de arquivo de configuração

Abaixo está um exemplo de um arquivo de configuração `appsignal-agent.conf`.

Para a lista completa de opções, consulte a página de [opções de configuração][options].

<CodeGroup>
  ```toml TOML theme={null}
  # /etc/appsignal-agent.conf
  push_api_key = "0000-0000-0000-000"
  app_name = "My app name"
  environment = "production"
  hostname = "hostname"
  ```
</CodeGroup>

### Variável de ambiente do sistema

Outra forma de configurar o AppSignal é usando variáveis de ambiente do sistema no host em que a aplicação monitorada pelo AppSignal está em execução.

Este método de configuração é usado pela [imagem Docker do standalone agent][docker image]. Ele também pode ser usado para o [pacote Linux][linux package] em combinação com o [arquivo de configuração](#configuration-file).

Garanta que essas variáveis de ambiente sejam configuradas de uma forma compatível com seu sistema operacional e que a configuração seja carregada antes que o standalone agent seja iniciado.

A página de [opções de configuração][options] lista a variável de ambiente do sistema equivalente para cada opção. Você pode usar essas variáveis para configurar o standalone agent, por exemplo, ao configurar o nome do seu app:

<CodeGroup>
  ```sh Shell theme={null}
  # Exemplo comum em Bash no Linux
  export APPSIGNAL_APP_NAME="My app"
  ```
</CodeGroup>

[linux package]: /standalone-agent/installation/linux-package.html

[docker image]: /standalone-agent/installation/docker-image.html

[options]: /standalone-agent/configuration/options.html