Comment : créer des catégories de compteurs de performance

Mise à jour : novembre 2007

Vous pouvez créer une catégorie destinée à contenir les compteurs personnalisés. Par exemple, si vous prévoyez de créer un ensemble de compteurs pour suivre diverses données relatives aux commandes traitées sur un site Web, vous pouvez créer une catégorie appelée OrderData sur votre serveur, puis les compteurs dont vous avez besoin dans cette catégorie.

La création d'une catégorie et celle des compteurs qu'elle est appelée à contenir constituent un seul et même processus ; les compteurs ne peuvent être créés qu'à partir du moment où vous avez créé la catégorie elle-même. Vous ne pouvez pas créer de catégories et de compteurs sur des ordinateurs distants, ni même les supprimer.

Il existe différentes façons de créer des compteurs et des catégories :

• Vous pouvez utiliser la méthode Create sur la classe PerformanceCounterCategory pour simultanément créer une catégorie et un compteur de performance unique dans cette catégorie.

• Vous pouvez créer un tableau d'objets CounterCreationData et le passer en tant que paramètre des méthodes Create, créant ainsi un ensemble de compteurs dans la catégorie. Pour plus d'informations sur cette approche, consultez Comment : créer des compteurs de performance personnalisés.

• Vous pouvez utiliser la boîte de dialogue Compteur de performance à partir de l'Explorateur de serveurs pour créer simultanément plusieurs compteurs et une nouvelle catégorie. Pour plus d'informations sur cette approche, consultez Comment : créer des compteurs de performance personnalisés.

  Remarque :
  Certaines restrictions de sécurité s'appliquent à l'utilisation des compteurs de performance. Pour plus d'informations, consultez Introduction à l'analyse des seuils de performance.

  Remarque :
  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.

Pour créer une catégorie et un compteur unique dans cette catégorie

• Appelez la méthode Create sur la classe PerformanceCounterCategory et spécifiez les paramètres suivants :

  Paramètre	Valeur
  CategoryName	Tout nom de catégorie qui n'est pas déjà utilisé sur le serveur concerné.
  CategoryHelp	Description de la catégorie.
  CounterName	Nom du compteur.
  CounterHelp	Description du compteur. Ce texte est affiché dans l'Analyseur de performances de Windows lorsqu'un utilisateur sélectionne un compteur et clique sur le bouton Expliquer.

  L'exemple suivant illustre la création d'une catégorie simple à l'aide de la méthode Create :

  Sub CreateCustomCounter()
      PerformanceCounterCategory.Create("CategoryName", "CounterHelp", _
          PerformanceCounterCategoryType.MultiInstance, _
          "CounterName", "CounterHelp")
  End Sub
  

   void CreateCustomCounter()
      {
          PerformanceCounterCategory.Create("CategoryName", "CounterHelp",
              PerformanceCounterCategoryType.MultiInstance,
              "CounterName", "CounterHelp");
      }
  

Remarque :
Par défaut, les compteurs créés avec ce code sont en lecture/écriture, mais votre interaction sur ces compteurs, via une instance du composant PerformanceCounter, se limite à la lecture seule sauf spécification contraire de votre part. Pour modifier un compteur, vous pouvez affecter la valeur false à la propriété ReadOnly d'une instance du composant.

Voir aussi

Tâches

Comment : créer des compteurs de performance personnalisés

Concepts

Gestion des catégories et des compteurs