Configuration de fonctionnalités supplémentaires pour la surveillance d'.NET Framework

Une fois la surveillance de base d'.NET Framework s mise en place, vous pouvez configurer des fonctionnalités supplémentaires pour améliorer vos capacités de surveillance.

Cette rubrique traite des fonctionnalités supplémentaires suivantes :

Ignorer les processus

Vous pouvez exclure certains processus du suivi d'.NET Framework s en configurant une variable d'environnement.

Pour désactiver la surveillance de certains processus dans l' Windows, procédez comme suit :

  1. Ajoutez la INSTANA_REWRITER_BACKOFF variable d'environnement au niveau de l'hôte.
  2. Définissez sa valeur sur une liste de noms de pools ou de processus séparés par des points-virgules, comme le montre l'exemple suivant :
    INSTANA_REWRITER_BACKOFF=my_pool_1;process_1;my_pool_2
  3. Redémarrez les services IIS à l'aide de la iisreset commande afin qu'IIS puisse charger le nouvel environnement.

Procédures de mise sur liste blanche

Vous pouvez configurer Instana pour qu'il ne surveille que certains processus spécifiques en utilisant la fonctionnalité de liste blanche. Une fois la liste blanche configurée, seuls les processus correspondant aux modèles spécifiés sont instrumentés pour le traçage. Tous les autres processus sont exclus.

La fonctionnalité de liste blanche utilise des expressions régulières insensibles à la casse et prend en charge les valeurs séparées par des points-virgules, ce qui vous permet de définir plusieurs modèles pour une correspondance flexible des processus.

Pour activer la liste blanche pour certains processus, procédez comme suit :

  1. Ajoutez la INSTANA_NET_WHITELIST variable d'environnement au niveau de l'hôte.
  2. Définissez sa valeur sous la forme d'une liste de noms de processus ou de modèles d'expressions régulières séparés par des points-virgules, comme le montre l'exemple suivant :
    INSTANA_NET_WHITELIST="^(weBapi|cORe).*;DefaultAppPool;myApp.exe"

    où :

    • ^(weBapi|cORe).* correspond aux processus commençant par webapi ou core (sans distinction de majuscules/minuscules). Ce modèle utilise des ancrages et des caractères génériques d'expressions régulières pour correspondre à plusieurs applications associées.
    • DefaultAppPool effectue une recherche sans distinction de majuscules/minuscules parmi les noms de pools d'applications IIS commençant par DefaultAppPool. Par exemple, cela correspond à des pools IIS tels que DefaultAppPool ou DefaultAppPoolAPI.
    • myApp.exe correspond à l'application spécifique avec le nom complet et l'extension du fichier.
  3. Pour les applications hébergées par IIS, redémarrez les services IIS à l'aide de la iisreset commande afin que la variable d'environnement prenne effet. Pour les applications non IIS, redémarrez l'application.

Une fois la liste blanche configurée, le profileur vérifie, lors de l'initialisation, que chaque processus correspond aux modèles de la liste blanche. Seuls les processus qui correspondent à au moins un modèle sont instrumentés. Si aucune correspondance n'est trouvée, le profileur se ferme sans se connecter au processus.

La fonctionnalité de liste blanche est particulièrement utile dans les environnements où vous souhaitez :

  • Réduire la charge système en surveillant uniquement les applications critiques
  • Isoler certains services à des fins de surveillance
  • Exclure les processus hors production ou de test du suivi
Remarque : si la INSTANA_NET_WHITELIST variable d'environnement n'est pas définie ou est vide, tous les processus peuvent faire l'objet d'un traçage (sous réserve des règles de liste noire configurées avec INSTANA_REWRITER_BACKOFF).

Configuration du filtrage des segments

Vous pouvez utiliser la fonctionnalité de filtrage des segments pour contrôler quels segments sont collectés et envoyés à Instana, ce qui vous permet de réduire le volume de données et de vous concentrer sur les traces les plus pertinentes. Le capteur.NET permet un filtrage flexible de la plage de mesure grâce à plusieurs méthodes de configuration.

Pour plus de détails, consultez la section « Filtrage par intervalle ».

Activer l' AutoProfile

Pour les utilisateurs d'.NET Framework, AutoProfile est disponible pour les applications fonctionnant sous .NET Framework 4.7.2 ou une version ultérieure.

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

  1. Ajoutez les paramètres suivants au fichier de configuration.yml votre agent :
    com.instana.plugin.clr:
      profiling:
        enabled: true
  2. Définissez la variable INSTANA_AUTO_PROFILE d'environnement sur true.

Pour plus d'informations, consultez la section « Analyser les profils ».