Gestion des catégories et des compteurs
Mise à jour : novembre 2007
Vous créez des catégories et des compteurs de performance personnalisés pour suivre les données qui ne sont pas capturées par les compteurs standard fournis dans Microsoft Windows. Par exemple, vous pouvez créer un compteur personnalisé pour suivre le nombre total d'utilisateurs connectés à votre site Web ou celui des commandes traitées chaque seconde par votre site. Lorsque vous créez un compteur, vous l'ajoutez à une catégorie et vous lui assignez un type qui détermine son comportement. Pour plus d'informations sur le choix du type approprié, consultez Types de compteurs de performance.
Création de compteurs de performance personnalisés
Il existe différentes façons de créer des compteurs personnalisés :
Vous pouvez créer un compteur unique dans une catégorie en appelant la méthode Create de la classe PerformanceCounterCategory. Pour plus d'informations, consultez Comment : créer des catégories de compteurs de performance.
Vous pouvez créer plusieurs compteurs dans une même catégorie à l'aide de la classe CounterCreationData. Pour plus d'informations, consultez Comment : créer des compteurs de performance personnalisés.
Vous devez créer des compteurs dans une catégorie définie par l'utilisateur plutôt que dans les objets de performance (appelés « catégories » dans Visual Studio et le .NET Framework) fournis par Windows. Autrement dit, vous ne pouvez pas créer un compteur dans la catégorie Processeur ni dans n'importe quelle autre catégorie définie par le système. En outre, vous devez créer un compteur dans une nouvelle catégorie ; l'ajout d'un compteur à une catégorie existante définie par l'utilisateur lèvera une exception.
Le processus de création de nouveaux compteurs est soumis aux restrictions suivantes :
Vous pouvez créer des compteurs personnalisés sur l'ordinateur local auquel vous avez un accès administrateur.
Remarque : Pour accéder aux compteurs de performance, vous devez être un membre du groupe de sécurité qui a accès aux compteurs de performance (par exemple, le groupe Utilisateurs de l'Analyseur de performances). En outre, vous pouvez recevoir des invites sur Windows Vista lorsque vous essayez d'exécuter une action qui requiert des privilèges élevés, même lors d'une exécution sous des autorisations administratives. Pour plus d'informations, consultez Windows Vista et Visual Studio.
Si vous ne spécifiez pas de type lorsque vous créez un compteur et sa catégorie, il prendra par défaut le type NumberofItems32.
Vous ne pouvez pas créer de nouveaux compteurs dans des catégories existantes. Si vous avez besoin d'ajouter des compteurs à des catégories existantes, la seule solution consiste à supprimer cette catégorie et à la recréer avec tout son contenu. Cela inclut les nouveaux compteurs que vous souhaitez ajouter.
Certaines restrictions de sécurité s'appliquent à la création de compteurs et de catégories. Pour plus d'informations, consultez Introduction à l'analyse des seuils de performance.
La classe PerformanceCounter n'est pas entièrement prise en charge sur Microsoft Windows NT version 4.0. Vous pouvez lire des données à partir des compteurs système, mais vous ne pouvez pas créer ou supprimer des compteurs personnalisés, ni y écrire.
Voir aussi
Tâches
Comment : créer des compteurs de performance personnalisés
Comment : créer des catégories de compteurs de performance
Comment : supprimer des catégories de compteurs de performance
Comment : vérifier l'existence de compteurs et de catégories
Comment : ajouter et supprimer des instances de compteur de performance