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 :

Traçage personnalisé

.NET Le SDK de traçage disponible sur Instana permet de configurer un traçage personnalisé pour les composants que Instana ne trace pas automatiquement.

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 variable d'environnement INSTANA_NET_WHITELIST n'est pas définie ou est vide, tous les processus peuvent faire l'objet d'un suivi (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 ».

Configuration des traces de pile

Important :
Avec l'introduction de la configuration des traces de pile, la variable d'environnement INSTANA_OMIT_CALLBACK est désormais obsolète dans le traceur.NET Framework 1.321.2.

Utilisez la configuration de la trace de pile pour contrôler la quantité de données de trace de pile collectées et traitées par Instana. Vous pouvez configurer l'outil «.NET Framework Tracer » pour qu'il effectue l'une des actions suivantes :

  • Ne collecter les traces de pile que pour les segments EXIT présentant des erreurs
  • Désactiver la collecte des traces de pile
  • Contrôler la profondeur de la trace de pile
Remarque :
HTTP Les portées d'entrée et de sortie qui génèrent une erreur (span.ec=1) renvoient toujours une trace de pile, quel que soit le mode de trace de pile configuré.

Pour plus d'informations, consultez la section « Configuration des traces de pile pour l'.NET Framework ».

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