Skip to main content
Cette documentation explique comment configurer AppSignal pour Ruby afin d’utiliser le Collector AppSignal pour envoyer des données à AppSignal. Cette documentation suppose que vous avez déjà suivi les instructions d’installation. Il s’agit d’une fonctionnalité expérimentale. Distributed tracing n’est disponible que lorsque vous utilisez le collector hébergé par AppSignal.

​
Prérequis

Le mode collector est fourni dans une version préliminaire du gem appsignal. Le mode collector nécessite Ruby 3.1 ou une version plus récente. Sur les versions de Ruby plus anciennes, l’option collector_endpoint est ignorée. Le mode collector ne prend pas en charge JRuby. Cela dépend de la façon dont Ruby gère le forking, que JRuby traite différemment.

​
Installer les gems OpenTelemetry

Le mode collector envoie les données via OpenTelemetry. Le gem appsignal n’installe pas les gems OpenTelemetry. Ajoutez donc appsignal-opentelemetry à côté de la ligne gem "appsignal" déjà présente dans votre Gemfile :
Exécutez ensuite bundle install. Le gem appsignal-opentelemetry ne fait rien par lui-même. Il installe uniquement les versions des gems OpenTelemetry prises en charge par le mode collector, afin que vous n’ayez pas à les suivre vous-même. Sa version correspond à celle du gem appsignal, de sorte que appsignal-opentelemetry 5.0.0 va de pair avec appsignal 5.0.0. Si ces gems sont manquants ou si leurs versions ne sont pas prises en charge, AppSignal enregistre un avertissement au démarrage et n’entre pas en mode collector.

​
Déployer un collector

Vous pouvez également faire héberger un collector par AppSignal en utilisant la page « Hosted Collector » dans les paramètres de votre organisation.

​
Configurer le collector

Définissez l’option de configuration collector_endpoint sur l’adresse de votre collector. Lorsque vous utilisez un collector hébergé, cette adresse se trouve sous « Collector URL » dans la page de paramètres « Hosted Collector ». Définissez également l’option service_name. Elle nomme cette application parmi les services qui rapportent à votre collector, afin qu’une trace qui traverse plusieurs d’entre eux montre quel service a fait quoi.
AppSignal pour Ruby envoie désormais ses traces, ses métriques et ses logs au collector configuré. AppSignal construit ses traces à partir de spans OpenTelemetry lorsqu’il envoie des données à un collector. Consultez AppSignal pour Ruby et OpenTelemetry pour savoir comment décrire ces spans vous-même, et comment AppSignal fonctionne avec l’instrumentation que vous écrivez avec le SDK OpenTelemetry.