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

# Integrando o AppSignal no Ruby

É possível que o AppSignal não forneça integração automática para o framework de sua escolha,
ou talvez você esteja usando sua própria configuração de aplicação.

Veja nossa [lista de integrações suportadas](/ruby/integrations) para ver
quais frameworks e gems suportamos com a gem do AppSignal.

Quando o AppSignal não suporta sua aplicação automaticamente, ainda é possível adicionar instrumentação do AppSignal. Nossa gem Ruby precisa ser configurada e iniciada uma vez no início de um processo. Ela pode ser [configurada](/ruby/configuration) através de um arquivo de configuração ou usando variáveis de ambiente.

## Configuração

### Variáveis de ambiente

Ao usar [variáveis de ambiente](/ruby/configuration/load-order#environment-variables) para configurar o AppSignal, a gem lerá a configuração do ambiente assim que iniciar. Chamar `Appsignal.start` é suficiente.

<CodeGroup>
  ```ruby Ruby theme={null}
  require "appsignal"

  # Load your app

  Appsignal.start
  ```
</CodeGroup>

### Arquivo de configuração

Ao usar um [arquivo de configuração](/ruby/configuration#ruby-configuration-file) para configurar o AppSignal, a gem Ruby precisa ser configurada antes de ser iniciada.
Ela procurará pelo arquivo `config/appsignal.rb` no diretório de trabalho atual do processo da aplicação.
Alternativamente, ela também pode ser configurada usando o [helper `Appsignal.configure`](/ruby/configuration#appsignalconfigure-helper), como mostrado no exemplo abaixo.

<CodeGroup>
  ```ruby Ruby theme={null}
  require "appsignal" # Require the AppSignal gem

  # Optional: load integrations manually
  # These integrations need to be loaded before `Appsignal.configure` is called.
  # Appsignal.load(:sinatra)

  # Optional: Configure AppSignal via the configure helper
  # Appsignal.configure do |config|
  #   # Some config
  # end

  # Lastly, start AppSignal
  Appsignal.start
  ```
</CodeGroup>

O AppSignal procurará no caminho do primeiro argumento por um diretório `config/` contendo um arquivo `appsignal.rb` para carregar a configuração.
O segundo argumento é o ambiente que ele carregará do arquivo de configuração.

## Próximos passos

Continue com nosso [guia de instrumentação para scripts e background jobs](/ruby/instrumentation/background-jobs) para aplicações que não instrumentamos automaticamente. Use os [helpers de instrumentação](/ruby/instrumentation/instrumentation) para detalhar o código instrumentado em mais detalhes.