Skip to main content
Diese Dokumentation erklärt, wie Sie AppSignal für Ruby so konfigurieren, dass es den AppSignal Collector verwendet, um Daten an AppSignal zu senden. In dieser Dokumentation wird vorausgesetzt, dass Sie bereits die Installationsanleitung befolgt haben. Dies ist ein experimentelles Feature. 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:
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” in den Einstellungen Ihrer Organisation verwenden.

​
Den Collector konfigurieren

Setzen Sie die Konfigurationsoption 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. 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.
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, 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.