Share via

Procédure pas à pas : modification et récupération des valeurs de compteurs de performance

  • Article

Mise à jour : novembre 2007

Les procédures pas à pas décrites ici expliquent comment utiliser les valeurs d'un compteur de performance en utilisant les méthodes sur la classe PerformanceCounter. Le mécanisme par lequel Windows collecte les données de performance relatives aux différentes ressources système est appelé compteur de performance. Windows fournit un ensemble de compteurs prédéfinis, classés par catégorie, avec lesquels vous pouvez interagir. Les valeurs récupérées d'un compteur peuvent être des valeurs brutes ou des valeurs calculées qui peuvent varier dans le temps. Il existe plusieurs façons d'augmenter et de diminuer la valeur actuelle d'un compteur.

Au cours de cette procédure pas à pas, vous allez :

  • créer et configurer un composant PerformanceCounter pour interagir avec un compteur fourni par le système ;

  • créer une application Windows comprenant des éléments d'interface utilisateur qui récupèrent et affichent les valeurs d'un compteur ;

  • écrire du code à l'aide de la propriété RawValue pour définir et récupérer la valeur brute du compteur ;

  • écrire du code à l'aide des méthodes Increment, IncrementBy et M:System.Diagnostics.PerformanceCounter.Decrement pour changer la valeur du compteur et récupérer sa nouvelle valeur.

Remarque :

Il est possible que votre ordinateur affiche des noms ou des emplacements différents pour certains des éléments d'interface utilisateur Visual Studio dans les instructions suivantes. L'édition de Visual Studio dont vous disposez et les paramètres que vous utilisez déterminent ces éléments. Pour plus d'informations, consultez Paramètres Visual Studio.

Pour créer une application Windows

  1. Dans le menu Fichier, pointez sur Nouveau, puis cliquez sur Projet.

  2. Dans la boîte de dialogue Nouveau projet, créez une application WindowsVisual Basic ou Visual C#. Appelez le projet PerformanceCounterExample.

  3. Sous l'onglet Windows Forms de la boîte à outils, ajoutez les contrôles suivants à votre application :

    • deux étiquettes ;

    • une zone de texte ;

    • cinq boutons.

  4. Définissez les propriétés suivantes pour vos contrôles :

    Contrôle

    Propriété

    Valeur

    Label1

    Name

    lblCounterValue

     

    Text

    (vide)

    Label2

    Name

    lblSystemCounterValue

     

    Text

    (vide)

    Textbox1

    Name

    txtValue

     

    Text

    (vide)

    Button1

    Name

    btnSetRawValue

     

    Text

    Définir la valeur brute du compteur personnalisé

    Button2

    Name

    btnGetNextValue

     

    Text

    Obtenir la valeur suivante du compteur système

    Button3

    Name

    btnIncrement

     

    Text

    Incrémenter le compteur personnalisé de 1

    Button4

    Name

    btnDecrement

     

    Text

    Décrémenter le compteur personnalisé de 1

    Button5

    Name

    btnIncrementBy

     

    Text

    Incrémenter le compteur personnalisé d'une valeur

  5. Disposez les contrôles comme vous le souhaitez.

  6. Enregistrez votre travail.

Pour créer et configurer le composant PerformanceCounter

  1. Ouvrez l'Explorateur de serveurs et accédez au nœud Serveurs. Pour plus d'informations, consultez Comment : accéder à l'Explorateur de serveurs/bases de données et l'initialiser.

  2. Recherchez le nom de votre ordinateur sous le nœud Serveurs et développez-le. Vous voyez des entrées relatives aux compteurs de performance, aux files d'attente de messages, aux journaux des événements et aux services.

  3. Développez le nœud Compteurs de performance et recherchez le nœud Processeur.

  4. Recherchez le nœud % Temps processeur et développez-le.

  5. Faites glisser le compteur _Total jusqu'au formulaire. Un composant PerformanceCounter configuré pour le compteur _Total est ajouté à votre projet. Le composant est nommé PerformanceCounter1 dans Visual Basic et performanceCounter1 dans Visual C#.

Pour récupérer la valeur brute du compteur système

  • Dans le concepteur, double-cliquez sur le bouton Obtenir la valeur suivante du compteur système pour créer le gestionnaire d'événements Click. Cette méthode affiche la valeur calculée du compteur et non sa valeur brute. Ajoutez le code suivant pour récupérer et afficher la valeur suivante du compteur surveillé par votre instance de PerformanceCounter :

    Private Sub btnGetNextValue_Click(ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles btnGetNextValue.Click
   lblSystemCounterValue.Text = _
      "The current value of the system counter is: " _
      & PerformanceCounter1.NextValue().ToString()
End Sub

    private void btnGetNextValue_Click(object sender, System.EventArgs e)
{
   lblSystemCounterValue.Text = 
      "The current value of the system counter is: " 
      + performanceCounter1.NextValue().ToString();
}

Pour les procédures suivantes, vous utiliserez une catégorie et un compteur personnalisés.

Pour créer un compteur et une catégorie personnalisés

  1. Dans le menu Affichage, cliquez sur Concepteur afin d'ouvrir le concepteur pour Form1.

  2. Dans le concepteur, ouvrez l'Explorateur de serveurs et accédez au nœud Serveurs. Pour plus d'informations, consultez Comment : accéder à l'Explorateur de serveurs/bases de données et l'initialiser.

  3. Recherchez le nom de votre ordinateur sous le nœud Serveurs et développez-le.

  4. Cliquez avec le bouton droit sur le nœud Compteurs de performance et cliquez sur Créer une nouvelle catégorie.

    Vous voyez s'afficher la boîte de dialogue Générateur de compteurs de performance.

  5. Entrez MyNewCategory comme Nom de la catégorie.

  6. Cliquez sur Nouveau pour ajouter un nouveau compteur et appelez-le MyNewCounter. Cliquez sur OK pour créer la nouvelle catégorie et le nouveau compteur.

    Remarque :

    Vous devez disposer d'une autorisation en écriture sur le Registre pour cette étape. Contactez l'administrateur système si vous ne parvenez pas à créer le nouveau compteur.

  7. Dans l'Explorateur de serveurs, accédez au nouveau compteur et faites-le glisser jusqu'au formulaire. Un nouveau composant PerformanceCounter configuré pour le nouveau compteur, MyNewCounter, est ajouté au projet.

    Remarque :

    Cette procédure permet de créer le compteur sur votre ordinateur. Si vous souhaitez déployer cette application, vous devrez créer le compteur sur l'ordinateur cible. Vous pouvez pour ce faire ajouter un programme d'installation au projet. Sélectionnez l'objet PerformanceCounter et cliquez sur Ajouter le programme d'installation dans la fenêtre Propriétés. (Si cette commande n'est pas disponible, cliquez avec le bouton droit sur la fenêtre Propriétés puis cliquez sur Commandes.) Pour plus d'informations, consultez Introduction aux composants d'installation.

Pour récupérer la valeur brute du compteur personnalisé

  1. Dans le concepteur, sélectionnez le PerformanceCounter2 en Visual Basic ou performanceCounter2 en Visual C#.

  2. Affectez à la propriété ReadOnly la valeur false.

  3. Double-cliquez sur le bouton btnSetRawValue pour créer le gestionnaire d'événements Click dans l'éditeur de code.

  4. Ajoutez le code ci-dessous pour définir la valeur brute du compteur créé et l'afficher dans le premier des contrôles label.

    Private Sub btnSetRawValue_Click(ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles btnSetRawValue.Click
   PerformanceCounter2.RawValue = CLng(txtValue.Text)
   lblCounterValue.Text = PerformanceCounter2.NextValue().ToString()
End Sub

    private void btnSetRawValue_Click(object sender, System.EventArgs e)
{
   performanceCounter2.RawValue = long.Parse(txtValue.Text);
   lblCounterValue.Text = performanceCounter2.NextValue().ToString();

    }

Pour incrémenter la valeur du compteur personnalisé d'une unité et l'afficher

  1. Dans le concepteur, double-cliquez sur le bouton Incrémenter le compteur personnalisé de 1 pour créer le gestionnaire d'événements Click dans l'éditeur de code.

  2. Ajoutez le code suivant pour incrémenter d'une unité la valeur de votre compteur personnalisé et l'afficher dans le premier des contrôles label.

    Private Sub btnIncrement_Click(ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles btnIncrement.Click
   PerformanceCounter2.Increment()
   lblCounterValue.Text = PerformanceCounter2.NextValue().ToString()
End Sub

    private void btnIncrement_Click(object sender, System.EventArgs e)
{
   performanceCounter2.Increment();
   lblCounterValue.Text = performanceCounter2.NextValue().ToString();

    }

Pour décrémenter la valeur du compteur personnalisé et l'afficher

  1. Dans le concepteur, double-cliquez sur le bouton Décrémenter le compteur personnalisé de 1 pour créer le gestionnaire d'événements Click dans l'éditeur de code.

  2. Ajoutez le code ci-dessous pour décrémenter d'une unité la valeur du compteur et l'afficher dans le premier des contrôles label.

    Private Sub btnDecrement_Click(ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles btnDecrement.Click
   PerformanceCounter2.Decrement()
   lblCounterValue.Text = PerformanceCounter2.NextValue().ToString()
End Sub

    private void btnDecrement_Click(object sender, System.EventArgs e)
{
   performanceCounter2.Decrement();
   lblCounterValue.Text = performanceCounter2.NextValue().ToString();

    }

Pour incrémenter le compteur personnalisé d'une valeur définie par l'utilisateur

  1. Dans le concepteur, double-cliquez sur le bouton Incrémenter le compteur personnalisé d'une valeur pour créer le gestionnaire d'événements Click dans l'éditeur de code.

  2. Ajoutez le code ci-dessous pour incrémenter de la valeur entrée dans la zone de texte la valeur du compteur et l'afficher dans le premier des contrôles label.

    Private Sub btnIncrementBy_Click(ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles btnIncrementBy.Click
   PerformanceCounter2.IncrementBy(CLng(txtValue.Text))
   lblCounterValue.Text = PerformanceCounter2.NextValue().ToString()
End Sub

    private void btnIncrementBy_Click(object sender, System.EventArgs e)
{
   performanceCounter2.IncrementBy(long.Parse(txtValue.Text));
   lblCounterValue.Text = performanceCounter2.NextValue().ToString();
}

Pour tester votre application

  1. Enregistrez les fichiers.

  2. Appuyez sur F5 pour compiler et exécuter votre application.

  3. Cliquez sur le bouton Obtenir la valeur suivante du compteur système pour récupérer la valeur actuelle du compteur de la catégorie Processeur. Puisque vous allez récupérer la valeur à l'aide de la méthode NextValue(), le premier appel va retourner 0.

    La valeur actuelle doit s'afficher dans l'étiquette.

  4. Tapez 25 dans la zone de texte et cliquez sur Définir la valeur brute du compteur personnalisé.

    Le champ de l'étiquette doit être mis à jour pour indiquer que la valeur brute est désormais 25.

  5. Cliquez sur le bouton Incrémenter le compteur personnalisé de 1.

    La valeur dans l'étiquette doit être incrémentée de 1.

  6. Cliquez sur le bouton Décrémenter le compteur personnalisé de 1.

    La valeur dans l'étiquette doit être décrémentée de 1.

  7. Entrez 25 dans la zone de texte et cliquez sur Incrémenter le compteur personnalisé d'une valeur.

    La valeur dans l'étiquette doit être incrémentée de 25.

    Vous pouvez également afficher votre compteur de performance dans l'outil d'analyse des performances Windows.

Pour afficher votre compteur de performance dans l'outil d'analyse des performances Windows

  1. Ouvrez l'outil d'analyse des performances qui fait partie de Microsoft Management Console. Consultez l'aide du système d'exploitation pour rechercher les étapes permettant d'ouvrir l'outil d'analyse des performances.

  2. Cliquez avec le bouton droit sur la liste des compteurs sous le graphique de performance, puis cliquez sur Ajouter des compteurs.

  3. Sélectionnez MyNewCategory dans la liste Objet de performance et MyNewCounter dans la liste des compteurs. Cliquez sur Ajouter pour terminer.

  4. Cliquez sur Afficher le rapport dans la barre d'outils afin d'afficher la valeur de votre compteur.

Voir aussi

Concepts

Introduction à l'analyse des seuils de performance

Autres ressources

Analyse des seuils de performance

Procédures des compteurs de performance