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

# AppSignal in Ruby integrieren

Es ist möglich, dass AppSignal keine automatische Integration für Ihr
gewähltes Framework bietet, oder dass Sie Ihr eigenes Anwendungs-Setup verwenden.

Sehen Sie sich unsere [Liste der unterstützten Integrationen](/ruby/integrations) an, um zu sehen,
welche Frameworks und Gems wir mit dem AppSignal-Gem unterstützen.

Wenn AppSignal Ihre Anwendung nicht automatisch unterstützt, ist es weiterhin möglich, AppSignal-Instrumentierung hinzuzufügen. Unser Ruby-Gem muss einmal zu Beginn eines Prozesses konfiguriert und gestartet werden. Es kann über eine [Konfigurationsdatei](/ruby/configuration) oder mithilfe von Umgebungsvariablen [konfiguriert](/ruby/configuration) werden.

## Konfiguration

### Umgebungsvariablen

Bei Verwendung von [Umgebungsvariablen](/ruby/configuration/load-order#environment-variables) zur Konfiguration von AppSignal liest das Gem die Konfiguration beim Start aus der Umgebung. Der Aufruf von `Appsignal.start` reicht aus.

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

  # Load your app

  Appsignal.start
  ```
</CodeGroup>

### Konfigurationsdatei

Bei Verwendung einer [Konfigurationsdatei](/ruby/configuration#ruby-configuration-file) zur Konfiguration von AppSignal muss das Ruby-Gem konfiguriert werden, bevor es gestartet wird.
Es sucht im aktuellen Arbeitsverzeichnis des Anwendungsprozesses nach der Datei `config/appsignal.rb`.
Alternativ kann es auch mit dem [`Appsignal.configure`-Helper](/ruby/configuration#appsignalconfigure-helper) konfiguriert werden, wie im folgenden Beispiel gezeigt.

<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 sucht im Pfad des ersten Arguments nach einem `config/`-Verzeichnis, das eine `appsignal.rb`-Datei enthält, um die Konfiguration zu laden.
Das zweite Argument ist die Umgebung, die es aus der Konfigurationsdatei lädt.

## Nächste Schritte

Fahren Sie mit unserem [Leitfaden zur Instrumentierung für Skripte und Hintergrundjobs](/ruby/instrumentation/background-jobs) für Anwendungen fort, die wir nicht automatisch instrumentieren. Verwenden Sie [Instrumentierungs-Helper](/ruby/instrumentation/instrumentation), um den instrumentierten Code detaillierter aufzuschlüsseln.