Configuration du profilage

Modifier en ligne

Vous pouvez configurer Instana AutoProfile™ sur les applications Java, Node.js, Go, Python, Ruby, .NET Core et PHP. Consultez les sections suivantes pour savoir comment configurer AutoProfile.

Configuration sur Java

Modifier en ligne

Vous pouvez activer ou désactiver le profilage pour votre application Java.

Machines JVM prises en charge

Modifier en ligne
  • Sur Linux, AutoProfile est pris en charge sur les machines virtuelles Java ( JVM ) basées sur HotSpot et OpenJ9.
  • Sur Windows, AutoProfile est pris en charge sur les machines virtuelles Java ( JVM ) qui prennent en charge JFR (JDK Flight Recorder).

HotSpot-based JVMs

Modifier en ligne

Les distributions suivantes d' HotSpot-based JVM sont prises en charge, à partir de la version JVM 1.8.152 et des versions ultérieures :

  • AdoptOpenJDK HotSpot
  • Amazon Corretto
  • Azul Zulu
  • Eclipse Temurin
  • OpenJDK
  • Oracle HotSpot
  • Sun HotSpot

OpenJ9-based JVMs

Modifier en ligne

Les distributions suivantes d' OpenJ9-based JVM sont prises en charge, à partir de la version JVM 0.29.0 et des versions ultérieures :

  • IBM Semeru

Plateformes prises en charge

Modifier en ligne

Actuellement, Java AutoProfile est pris en charge sur Linux ( x86_64, arm64, ppc64le et s390x ) et Windows ( x86_64 ).

Méthodes d'échantillonnage

Modifier en ligne

Java AutoProfile prend en charge deux méthodes d'échantillonnage : Async-Profiler (uniquement pour Linux ) et JFR (pour Windows et Linux ).

Sur Linux, la méthode d'échantillonnage par défaut est Async-Profiler pour les machines virtuelles Java (JVMs) HotSpot-based, et JFR pour les machines virtuelles Java (JVMs) OpenJ9-based. En définissant la variable d'environnement INSTANA_JFR_ENABLED sur 1, vous pouvez passer de la méthode d'échantillonnage Async-Profiler à JFR sur Linux.

Configuration d' AutoProfile

Modifier en ligne

Pour activer l' AutoProfile™ e, ajoutez les paramètres suivants au fichier de <agent_install_dir>/etc/instana/configuration.yamlconfiguration de l'agent :

com.instana.plugin.profiling.java:
  enabled: true

Options de configuration supplémentaires

Modifier en ligne

Le tableau suivant présente des options de configuration supplémentaires pour l' AutoProfile:

Paramètre Description
cpu-sampler-enabled Lorsque la valeur est true, active les profils d'unité centrale.
contention-sampler-enabled Lorsque la valeur est true, active les profils de conflit.
profiler-frames-enabled Lorsque cette option est activée true, les appels de méthode du profileur sont inclus dans les trames de pile.

Dépannage d' AutoProfile sur Java

Modifier en ligne

Problème : vous remarquerez peut-être l'erreur Cannot load JVM TI agent library: /tmp/libprofsensor-X.X.X-linux-x64-28c63c.so: libc.musl-x86_64.so.1: cannot open shared object file: No such file or directory.

Solution : Pour les JVM s'exécutant dans des images d' Alpine, le profileur s'attend musllibc à ce que soit disponible. Dans ce genre de cas, lorsque glibc est également installé pour des raisons de compatibilité, assurez-vous que le chemin d'accès aux musl versions des bibliothèques n'est pas écrasé ou endommagé.

Configuration sur Node.js

Modifier en ligne

Pour activer l' AutoProfile,, définissez la variable d'environnement INSTANA_AUTO_PROFILE=true ou ajoutez autoProfile: true l'option lors de l'initialisation du collecteur. Voir l'exemple suivant :

require('@instana/collector')({
  autoProfile: true
});

Cette fonction nécessite @instana/collector@1.98.1 ou version ultérieure et au moins Node.js 6.4.0.

Pour plus d'informations, consultez la section « Configuration du collecteur » sur Node.js.

Configuration sur Go

Modifier en ligne

Pour activer l' AutoProfile,, ajoutez EnableAutoProfile: true l'option à instana.InitSensor(opt), ou définissez la variable d'environnement INSTANA_AUTO_PROFILE=true pour github.com/instana/go-sensor@1.13.2 et les versions ultérieures.

Cette fonctionnalité nécessite l'activation d'un capteur d' Instana s dans le code de l'application. Pour plus d'informations sur la manière d'activer le capteur « Instana » pour l' AutoProfile,, consultez Instana AutoProfile.

Pour plus d'informations, consultez la section « Configuration du collecteur » sur Go.

Configuration sur Python

Modifier en ligne

Pour activer AutoProfile,, définissez INSTANA_AUTOPROFILE=true la variable d'environnement.

Cette fonction nécessite que le détecteur Instana Python soit activé dans le code de l'application. Pour plus d'informations sur la manière d'activer le capteur « Instana » pour l' AutoProfile,, consultez la section «Installation manuelle ».

Pour plus d'informations, consultez la section « Configuration de Python ».

Configuration sur Ruby

Modifier en ligne

Pour activer l' AutoProfile™ e, ajoutez les paramètres suivants au fichier de <agent_install_dir>/etc/instana/configuration.yamlconfiguration de l'agent :

com.instana.plugin.rubyprofile:
  enabled: true

Vous pouvez également activer l' AutoProfile™ e en définissant la variable d'environnement INSTANA_AUTO_PROFILE sur true.

Pour plus d'informations, consultez le site AutoProfile.

Configuration sur .NET Core

Modifier en ligne

Pour les utilisateurs d'.NET, AutoProfile™ n'est disponible que pour les applications .NET Core qui fonctionnent à la fois sur Linux et Windows. Pour plus d'informations, consultez la page « Surveillance » (.NET Core ).

Pour activer l' AutoProfile™ e, ajoutez les paramètres suivants au fichier de <agent_install_dir>/etc/instana/configuration.yamlconfiguration de l'agent :

com.instana.plugin.netcore:
  profiling:
    enabled: true

Vous pouvez activer l' AutoProfile™ e en définissant la variable d'environnement INSTANA_AUTO_PROFILE sur « true »; cette étape est obligatoire pour Windows et facultative pour Linux.

Configuration sur .NET Framework

Modifier en ligne

Pour les utilisateurs d'.NET, AutoProfile™ est disponible pour les applications .NET Framework fonctionnant sous .NET Framework 4.7.2 ou une version ultérieure. Pour plus d'informations, consultez la page « Surveillance » (.NET Framework ).

Pour activer l' AutoProfile™ e, procédez comme suit :

  1. Ajoutez les paramètres suivants au fichier configuration.yml de votre agent :
    com.instana.plugin.clr:
  profiling:
    enabled: true
```2. Set the environment variable **`INSTANA_AUTO_PROFILE`** to true.

Configuration sur PHP

Modifier en ligne

Pour les utilisateurs d' PHP, AutoProfile n'est pas disponible pour la surveillance sans serveur. Pour plus d'informations, consultez la section « Profilage » sur PHP.

Pour activer l' AutoProfile™, définissez la variable d'environnement INSTANA_AUTO_PROFILE=true ou ajoutez les paramètres suivants au fichier de <agent_install_dir>/etc/instana/configuration.yamlconfiguration de l'agent :

com.instana.plugin.php:
  profiling:
    enabled: true