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

# Intégration d'AppSignal dans Ruby

Il est possible qu'AppSignal ne fournisse pas d'intégration automatique pour le framework
de votre choix, ou peut-être utilisez-vous votre propre configuration d'application.

Consultez notre [liste des intégrations prises en charge](/ruby/integrations) pour voir
quels frameworks et gems nous prenons en charge avec la gem AppSignal.

Lorsqu'AppSignal ne prend pas en charge votre application automatiquement, il est toujours possible d'ajouter l'instrumentation AppSignal. Notre gem Ruby doit être configurée et démarrée une fois au début d'un processus. Elle peut être [configurée](/ruby/configuration) via un fichier de configuration ou en utilisant des variables d'environnement.

## Configuration

### Variables d'environnement

Lors de l'utilisation de [variables d'environnement](/ruby/configuration/load-order#environment-variables) pour configurer AppSignal, la gem lira la configuration depuis l'environnement une fois qu'elle démarrera. L'appel à `Appsignal.start` est suffisant.

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

  # Load your app

  Appsignal.start
  ```
</CodeGroup>

### Fichier de configuration

Lors de l'utilisation d'un [fichier de configuration](/ruby/configuration#ruby-configuration-file) pour configurer AppSignal, la gem Ruby doit être configurée avant d'être démarrée.
Elle recherchera le fichier `config/appsignal.rb` dans le répertoire de travail actuel du processus de l'application.
Alternativement, elle peut également être configurée à l'aide de l'[assistant `Appsignal.configure`](/ruby/configuration#appsignalconfigure-helper) comme illustré dans l'exemple ci-dessous.

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

AppSignal recherchera dans le chemin du premier argument un répertoire `config/` contenant un fichier `appsignal.rb` pour charger la configuration.
Le deuxième argument est l'environnement qu'il chargera depuis le fichier de configuration.

## Étapes suivantes

Continuez avec notre [guide d'instrumentation pour les scripts et les tâches en arrière-plan](/ruby/instrumentation/background-jobs) pour les applications que nous n'instrumentons pas automatiquement. Utilisez les [assistants d'instrumentation](/ruby/instrumentation/instrumentation) pour décomposer le code instrumenté plus en détail.