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 :
- Ajoutez la
INSTANA_REWRITER_BACKOFFvariable d'environnement au niveau de l'hôte. - 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 - Redémarrez les services IIS à l'aide de la
iisresetcommande 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 :
- Ajoutez la
INSTANA_NET_WHITELISTvariable d'environnement au niveau de l'hôte. - 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 parwebapioucore(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.DefaultAppPooleffectue une recherche sans distinction de majuscules/minuscules parmi les noms de pools d'applications IIS commençant parDefaultAppPool. Par exemple, cela correspond à des pools IIS tels queDefaultAppPoolouDefaultAppPoolAPI.myApp.execorrespond à l'application spécifique avec le nom complet et l'extension du fichier.
- Pour les applications hébergées par IIS, redémarrez les services IIS à l'aide de la
iisresetcommande 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
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 :
- Ajoutez les paramètres suivants au fichier de configuration.yml votre agent :
com.instana.plugin.clr: profiling: enabled: true - Définissez la variable
INSTANA_AUTO_PROFILEd'environnement surtrue.
Pour plus d'informations, consultez la section « Analyser les profils ».