Surveillance des applications basées sur l'.NET Framework

Les extensions de capteur et de traçage sont activées par défaut. Au démarrage de l'agent, le fichier « InstanaPCP » enregistre des informations relatives au processus d'activation de la trace.

L'exemple suivant montre le fichier de l'agent configuration.yaml avec le suivi d'.NET Framework s activé :

# .NET Full Framework tracing
com.instana.plugin.clr:
#  # Tracing for .NET Full Framework CLR. Enabled by default
  tracing:
#    # Enabling tracing will instruct the agent to register the IL-rewriting components for .NET
#    # alongside with the instrumentation-libraries.
#    # It will also set the environment-variables for any IIS hosted .NET applications.
#    # Non-IIS hosted applications which you want to trace need these env-vars to be set
#    # manually before starting the actual process
#    # (see the docs here: https://docs.instana.io/ecosystem/dot-net/#enabling-tracing-for-non-iis-hosted-applications)
    enabled: true
  instrumentation:
    suppressions:
#    # The absolute path to a batch-file that should be executed when the tracing-components for
#    # NET Full Framework (Windows) have been updated. You can use this script to automate tasks
#    # that should be executed when new tracing-components get installed. This usually will be
#    # process-restarts or issuing an iisreset command, so that the processes can pickup the new components.
#    # The commands issued in the script should be executed asynchronously (start /b <cmd>) in order to not
#    # slow down the startup-time of InstanaPCP. In case of long-running synchronous tasks (like iisreset) you might
#    # see warnings in the log concerning the unavailability of InstanaPCP for the duration of the execution.
#    update_script: <absolute_path_to_batchfile>
#  # Memory-limits for InstanaPCP.
#  # You can specify these limits to account for high expected load and/or a lot of
#  # infrastructure-components being monitored. Values are in mega-bytes.
#  pcp_warn_limit: 150
#  pcp_stop_limit: 250

Sélectionnez le guide correspondant à votre environnement de déploiement :

Pour obtenir un aperçu complet de toutes les options de configuration, consultez la section « Configuration du traçage d'.NET Framework ».

Une fois la surveillance de base mise en place, vous pouvez configurer les fonctionnalités optionnelles suivantes pour améliorer les capacités de surveillance d'.NET Framework :

• Tracé personnalisé : ajoutez des segments personnalisés à l'aide du SDK d'.NET.
• Ignorer des processus : exclure certains processus du suivi d'.NET s en configurant une variable d'environnement.
• Liste blanche des processus : ne surveiller que certains processus.
• Filtrage des segments : réduisez le volume de données en filtrant certains segments.
• AutoProfile : Activez le profilage continu pour optimiser les performances.

Pour obtenir des instructions détaillées sur la configuration, consultez la section « Configuration des fonctionnalités supplémentaires ».

Instana évalue en permanence les indicateurs de santé par rapport aux données reçues et signale les problèmes ou les incidents en fonction de leur impact sur les utilisateurs.

Les événements intégrés déclenchent des tickets ou des incidents en cas de signatures de santé défaillantes sur des entités, tandis que les événements personnalisés déclenchent des tickets ou des incidents en fonction des seuils d'une métrique spécifique à une entité donnée.

Pour plus d'informations sur les événements intégrés d'.NET Framework, consultez la référence des événements intégrés.

Pour plus d'informations sur les compteurs de performances d' InstanaPCP, consultez les pages InstanaPCP et Windows.

Instana avec CLR Sensor 1.1.148 et .NET La version du Tracer Framework 1.315.1 (13 mars 2026) limite l'instrumentation aux versions des bibliothèques explicitement répertoriées dans la section « Bibliothèques et frameworks pris en charge pour le traçage ». Les versions non prises en charge ne sont pas instrumentées.

Pour bénéficier d'une assistance continue, effectuez la mise à niveau vers les versions prises en charge. Pour plus de détails et pour connaître les solutions de contournement possibles, consultez la note technique.

Lorsqu'une application initialement développée sur .NET Framework est migrée vers .NET 5 ou une version ultérieure (y compris .NET 6, 7, 8 et les versions ultérieures) et hébergée sur IIS, le pool d'applications doit être configuré pour s'exécuter avec No Managed Code. Dans ce mode, Instana ne peut pas collecter de métriques au niveau d'IIS.

Lorsqu'un pool d'applications IIS est défini sur No Managed Code, Instana ne peut pas collecter les métriques IIS suivantes :

• Noms des pools d'applications
• w3wp.exe indicateurs de processus
• Données de surveillance au niveau des processus de travail

Cette limitation est inhérente à la manière dont IIS héberge les applications .NET 5 et versions ultérieures. L'instrumentation et le traçage au niveau des applications continuent de fonctionner comme prévu, mais les métriques au niveau d'IIS ne sont pas disponibles.

Si vous avez besoin de métriques au niveau d'IIS, envisagez d'utiliser des applications .NET Framework 4 ou antérieures, qui prennent en charge les pools d'applications en code managé.

Lors de l'instrumentation d'applications d' multi-AppDomain (telles que SharePoint ), le fichier System.dll est chargé dans des instances multiples ou partagées d' AppDomains. Cependant, lorsque Instana tente d'instrumenter la classe System.Net.HttpWebRequest dans System.dll, il ne réécrit les méthodes que dans le domaine principal de l'application, ce qui entraîne l'erreur suivante :

Loading this assembly would produce a different grant set from other instances.

Si vous rencontrez cette erreur, définissez les variables d'environnement suivantes :

INSTANA_REWRITER_SUPPRESSION=System.Net.HttpWebRequest
INSTANA_TRACER_SUPPRESSION_ENABLED=1

Lorsque cette option est activée, la réécriture est ignorée pour System.Net.HttpWebRequest, et le reste de l'instrumentation fonctionne comme prévu.

Si vous ne voyez pas de traces ou de métriques dans l'interface utilisateur d' Instana, suivez les étapes générales de dépannage suivantes :

1. Vérifier les conditions préalables :
   • Assurez-vous que la version d'exécution d'.NET Framework s est prise en charge (.NET Framework 4.5.2 ou version ultérieure)
   • Vérifiez que l'agent d' Instana ation est en cours d'exécution et accessible
   • InstanaPCP.exeVérifiez que le service « InstanaPCP » est en cours d'exécution (consultez le Gestionnaire des tâches pour vous en assurer)
   • Vérifiez la connexion réseau entre votre application et l'agent
2. Vérifiez les variables d'environnement :
   • Vérifiez que toutes les variables d'environnement requises sont correctement définies
   • Assurez-vous que les chemins d'accès sont valides et accessibles
   • Vérifiez que les noms des variables sont correctement orthographiés
3. Vérifier la configuration du traçage :
   • Vérifiez que le traçage est activé dans le fichier de l'agent configuration.yaml
   • Redémarrez l'agent et l'application après avoir modifié la configuration
   • Pour les applications IIS, relancez-les iisreset après avoir modifié la configuration
4. Vérifiez s'il existe des outils APM incompatibles :
   • Vérifiez qu'aucun autre outil APM n'utilise les mêmes points de profilage
   • Désactivez les autres agents APM s'il y en a

Pour obtenir des scénarios de dépannage détaillés spécifiques à chaque plateforme ainsi que les solutions correspondantes, consultez le guide de dépannage approprié dans la section suivante.

Pour obtenir un aperçu de toutes les options de dépannage, consultez la section « Dépannage du traçage d'.NET Framework ».