Ruby composants et versions pris en charge

Pour vous assurer que le gem « Instana » est compatible avec votre configuration actuelle, consultez les sections suivantes consacrées aux informations de prise en charge.

Pour plus d'informations sur la surveillance des applications Ruby, consultez la page Surveillance Ruby.

Ruby Composants pris en charge

Versions prises en charge par Ruby

Le tableau suivant répertorie les versions d' Ruby prises en charge par le gem Instana :

Ruby Versions Ruby version du capteur
CRuby > = 2.1 et < 2.7 <= 1.209.4
CRuby > = 2.7 et < = 3.3 <= 1.213.3
CRuby >= 3.0 et <= 3.4 >= 1.217.1
CRuby >= 3.1 et <= 4.0 <= 2.5.1
CRuby >= 3.2 et <= 4.0 >= 2.6.0

Assistance à long terme

Le calendrier officiel des versions LTS et de fin de vie (EOL) disponible sur Ruby est respecté.

Remarque : lorsqu'une version d' Ruby e arrive à sa date de fin de vie (EOL), Instana propose une année supplémentaire de support. Pour éviter tout problème, mettez régulièrement à jour votre version d' Ruby.

Infrastructures prises en charge

Le tableau suivant répertorie les frameworks d' Ruby s pris en charge par le gem Instana :

Infrastructures Politique de support Versions Important
Cuba A la demande > = 3.0.0 et < = 4.0.3
Armoire 45 jours >= 1.4.5 et <= 3.2.6
Ruby on Rails 45 jours >= 0.4.0 et <= 8.1.3 L'instrumentation de la méthode `render_partial` des modules `ActionController` et `ActionView ` est prise en charge.
Rails :: API 45 jours > = 0.4.0 et < = 0.4.1 Rails:: API a été intégré à Rails 5.0.0
Rails LTS A la demande >= 2.3 et <= 6.1
Roda 45 jours >= 2.0.0 et <= 3.105.0
Sinatra 45 jours >= 1.1.4 et <= 4.2.1

Clients et bibliothèques pris en charge

Remarque : la continuité de trace ne s'applique pas aux bibliothèques de bases de données et de journalisation.

Le tableau suivant répertorie les bibliothèques client d' Ruby s prises en charge par le gem Instana :

Client Politique de support Versions Important
Excon 45 jours >= 0.21.0 et <= 1.5.0
gRPC 45 jours >= 1.0.1 et <= 1.81.1
Net::HTTP 0 jour >= 2.1 et <= 0.9.1
Client REST 45 jours > = 1.6.0 et < = 2.1.0
Suite 45 jours >= 5.60 et <= 5.105.0

Le tableau suivant répertorie les bibliothèques Memcache prises en charge par le gem « Instana » :

Memcache Politique de support Versions
Dalli 45 jours >= 2.0.0 et <= 5.0.5

Le tableau suivant répertorie les bibliothèques de messagerie et de traitement des tâches en arrière-plan d' Ruby prises en charge par le gem Instana :

Traitement des travaux de messagerie et d'arrière-plan Politique de support Versions
Resque 45 jours >= 1.22.0 et <= 3.0.0
Sidekiq 45 jours >= 2.12.0 et <= 8.1.6
Lapin 45 jours >= 2.23.0 et <= 2.24.0

Le tableau suivant répertorie les langages de requête pris en charge par le gem « Instana » :

Langues de requête Politique de support Versions
GraphQL 45 jours >= 1.8.8 et <= 2.6.3

Serveurs Web pris en charge

Le gem « Instana » prend en charge les serveurs Web suivants :

  • Apache
  • Nginx
  • Passenger
  • Puma
  • Rhebok
  • Thin
  • Unicorn

Collecte de données du capteur

Le gem « Instana » recueille les données de configuration et de métriques suivantes :

Configuration suivie Métriques
Version Ruby Temps consacré au nettoyage de la mémoire (GC)
Arguments d'environnement d'exécution Utilisation de la mémoire
Infrastructure Emplacements de segment de mémoire
Bundle Gem Unités d'exécution

Traçage

Vous pouvez activer le traçage pour vos applications Ruby.

Notes et limites relatives au traçage

Instana présente les limitations suivantes lors du traçage des applications Ruby :

Tracé avec plusieurs traceurs

Il n'est pas possible de suivre simultanément une application Ruby à l'aide d' Instana et d'un outil de traçage tiers, par exemple New Relic ou OpenTelemetry.

Évitez d'activer des gemmes incompatibles

Lorsque vous utilisez le webhook Instana AutoTrace ou le traceur Instana Ruby, les gemmes de dépendances correspondantes doivent être fournies pour l'application instrumentée. Les gems de dépendance sont distribués une fois que l'application a sélectionné ses propres dépendances. Il peut donc y avoir un chevauchement entre les deux arborescences de dépendances (à savoir le traceur Instana Ruby et l'application Ruby ). Le traceur « Instana » prend des mesures précises pour éviter d'activer plusieurs versions du même gem « Ruby ». L'application doit agir de manière responsable en n'activant pas tous les gems ou les gems sélectionnés de manière aléatoire qui sont disponibles pour elle de sorte qu'elle ne provoque pas de conflits. Par conséquent, vous ne pouvez pas utiliser des méthodes d'activation explicites et des méthodes avec des effets secondaires d'activation inconditionnellement.

Les méthodes suivantes peuvent être utilisées de manière conditionnelle:

  • Gem::Specification.activate
  • Gem::Specification.activate_dependencies
  • Gem.activate_bin_path