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

Diese Dokumentation erklärt, wie Sie AppSignal für Ruby so konfigurieren, dass es den [AppSignal Collector](/collector) verwendet, um Daten an AppSignal zu senden. In dieser Dokumentation wird vorausgesetzt, dass Sie bereits [die Installationsanleitung](/ruby/installation) befolgt haben.

**Dies ist ein experimentelles Feature.** [Distributed tracing](/distributed-tracing) **ist nur verfügbar**, wenn Sie den gehosteten AppSignal Collector verwenden.

## Voraussetzungen

Der Collector-Modus wird in einer Vorabversion des `appsignal`-Gems ausgeliefert.

Der Collector-Modus erfordert **Ruby 3.1 oder neuer**. Bei älteren Ruby-Versionen wird die Option `collector_endpoint` ignoriert.

Der Collector-Modus unterstützt **JRuby** nicht. Das liegt daran, wie Ruby mit Forking umgeht, was JRuby anders handhabt.

## Installation der OpenTelemetry-Gems

Der Collector-Modus sendet Daten über OpenTelemetry. Das `appsignal`-Gem installiert die OpenTelemetry-Gems nicht selbst. Fügen Sie deshalb `appsignal-opentelemetry` neben der bereits vorhandenen Zeile `gem "appsignal"` in Ihrem `Gemfile` hinzu:

<CodeGroup>
  ```ruby title="Gemfile" theme={null}
  gem "appsignal", ">= 5.0.0.rc1", "< 6"
  gem "appsignal-opentelemetry", ">= 5.0.0.rc1", "< 6"
  ```
</CodeGroup>

Führen Sie anschließend `bundle install` aus.

Das `appsignal-opentelemetry`-Gem macht für sich genommen nichts. Es installiert lediglich die OpenTelemetry-Gem-Versionen, die der Collector-Modus unterstützt, sodass Sie diese nicht selbst verfolgen müssen. Seine Version stimmt mit der des `appsignal`-Gems überein, sodass `appsignal-opentelemetry` 5.0.0 zu `appsignal` 5.0.0 passt.

Fehlen diese Gems oder werden nicht unterstützte Versionen verwendet, protokolliert AppSignal beim Start eine Warnung und wechselt nicht in den Collector-Modus.

## Einen Collector bereitstellen

Sie können AppSignal einen Collector für Sie hosten lassen, indem Sie die Seite ["Hosted Collector"](https://appsignal.com/redirect-to/organization?to=admin/hosted_collectors) in den Einstellungen Ihrer Organisation verwenden.

## Den Collector konfigurieren

Setzen Sie [die Konfigurationsoption `collector_endpoint`](/ruby/configuration/options#option-collector_endpoint) auf die Adresse Ihres Collectors. Bei Verwendung eines gehosteten Collectors finden Sie diese Adresse unter "Collector URL" auf der Einstellungsseite "Hosted Collector".

Setzen Sie außerdem [die Option `service_name`](/ruby/configuration/options#option-service_name). Sie benennt diese Anwendung unter den Services, die an Ihren Collector melden, sodass ein Trace, der mehrere davon durchläuft, zeigt, welcher Service was getan hat.

<CodeGroup>
  ```ruby title="config/appsignal.rb" theme={null}
  Appsignal.configure do |config|
    # ... other settings ...
    config.collector_endpoint = "https://collector.example"
    config.service_name = "web-server"
  end
  ```

  ```sh title="Environment variables" theme={null}
  APPSIGNAL_COLLECTOR_ENDPOINT="https://collector.example"
  APPSIGNAL_SERVICE_NAME="web-server"
  ```
</CodeGroup>

AppSignal für Ruby sendet seine Traces, Metriken und Logs nun an den konfigurierten Collector.

AppSignal baut seine Traces beim Melden an einen Collector aus OpenTelemetry-Spans auf. Lesen Sie [AppSignal für Ruby und OpenTelemetry](/ruby/instrumentation/opentelemetry), um zu erfahren, wie Sie diese Spans selbst beschreiben können und wie AppSignal mit einer Instrumentierung zusammenarbeitet, die Sie mit dem OpenTelemetry SDK schreiben.