Skip to main content
Esta documentação explica como configurar o AppSignal para Ruby para usar o AppSignal Collector para enviar dados ao AppSignal. Esta documentação assume que você já seguiu as instruções de instalação. Este é um recurso experimental. O Distributed tracing só está disponível ao usar o collector hospedado pelo AppSignal.

​
Requisitos

O modo collector é distribuído em uma versão pré-lançamento da gem appsignal. O modo collector requer Ruby 3.1 ou mais recente. Em versões mais antigas do Ruby, a opção collector_endpoint é ignorada. O modo collector não é compatível com JRuby. Isso depende de como o Ruby lida com forking, algo que o JRuby faz de forma diferente.

​
Instalando as gems do OpenTelemetry

O modo collector envia dados usando o OpenTelemetry. A gem appsignal não instala as gems do OpenTelemetry, então adicione appsignal-opentelemetry ao lado da linha gem "appsignal" já existente no seu Gemfile:
Em seguida, execute bundle install. A gem appsignal-opentelemetry não faz nada por conta própria. Ela apenas instala as versões das gems do OpenTelemetry compatíveis com o modo collector, para que você não precise controlá-las você mesmo. Sua versão corresponde à da gem appsignal, então appsignal-opentelemetry 5.0.0 combina com appsignal 5.0.0. Se essas gems estiverem ausentes ou suas versões não forem compatíveis, o AppSignal registra um aviso na inicialização e não entra no modo collector.

​
Implantando um collector

Você também pode fazer com que o AppSignal hospede um collector para você usando a página “Hosted Collector” nas configurações da sua organização.

​
Configurando o collector

Defina a opção de configuração collector_endpoint para o endereço do seu collector. Ao usar um collector hospedado, esse endereço pode ser encontrado em “Collector URL” na página de configurações “Hosted Collector”. Defina também a opção service_name. Ela nomeia essa aplicação entre os serviços que reportam ao seu collector, para que um trace que passe por vários deles mostre qual serviço fez o quê.
O AppSignal para Ruby agora envia seus traces, métricas e logs ao collector configurado. O AppSignal constrói seus traces a partir de spans do OpenTelemetry ao reportar para um collector. Leia AppSignal para Ruby e OpenTelemetry para saber como descrever esses spans você mesmo, e como o AppSignal funciona junto com a instrumentação que você escreve com o SDK do OpenTelemetry.