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

# Configuration du Collector pour AppSignal Ruby

Cette documentation explique comment configurer AppSignal pour Ruby afin d'utiliser le [Collector AppSignal](/collector) pour envoyer des données à AppSignal. Cette documentation suppose que vous avez déjà suivi [les instructions d'installation](/ruby/installation).

**Il s'agit d'une fonctionnalité expérimentale.** [Distributed tracing](/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` :

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

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 »](https://appsignal.com/redirect-to/organization?to=admin/hosted_collectors) dans les paramètres de votre organisation.

## Configurer le collector

Définissez [l'option de configuration `collector_endpoint`](/ruby/configuration/options#option-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`](/ruby/configuration/options#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.

<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 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](/ruby/instrumentation/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.