Partager via

Comment : configurer des instances du composant PerformanceCounter

  • Article

Mise à jour : novembre 2007

Vous devez définir un certain nombre de propriétés pour les composants PerformanceCounter que vous créez. Ces propriétés, qui déterminent le compteur avec lequel interagit le composant, sont les suivantes : Les propriétés que vous devez définir incluent les suivantes :

  • CategoryName qui détermine l'objet de performance avec lequel interagit le composant. Dans Windows, tous les compteurs de performance sont groupés par catégories telles que Mémoire, Processus et Processeur.

  • CounterName qui identifie, dans la catégorie spécifiée, le compteur avec lequel interagit le composant.

  • InstanceName qui identifie l'instance de la catégorie avec laquelle interagit le composant. Notez que de nombreuses catégories ne contiennent pas d'instances. Par conséquent, cette propriété peut ne pas être définie. Cela indique un compteur d'instance unique.

    Remarque :

    Si la catégorie n'a pas été définie par l'utilisateur, vous devez effectuer un choix parmi les instances et les compteurs existants. Vous ne pouvez créer de nouveaux compteurs et instances que dans des catégories personnalisées. Ainsi, vous ne pouvez pas créer un compteur dans la catégorie Mémoire, mais si vous créez une nouvelle catégorie appelée Orders, vous pouvez y définir autant de compteurs et d'instances que vous le souhaitez.

  • MachineName qui identifie le serveur hébergeant le compteur de performance avec lequel vous souhaitez que votre composant interagisse. Vous pouvez affecter la valeur "." à cette propriété pour indiquer l'ordinateur local ou la laisser vide pour utiliser cette valeur par défaut.

  • ReadOnly, qui détermine s'il est possible d'écrire sur un compteur personnalisé que vous créez. Par défaut, les instances du composant PerformanceCounter que vous configurez pour travailler avec la fonction de compteurs Windows existante est en lecture seule ; vous n'avez donc pas la possibilité de modifier les valeurs de ces compteurs. Lorsque vous configurez l'instance du composant de manière à travailler avec un compteur personnalisé, vous avez toutefois la possibilité d'accepter la valeur par défaut (lecture seule) ou d'affecter de nouveau la valeur false à la propriété pour autoriser l'écriture de valeurs.

    Remarque :

    Vous ne pouvez écrire des compteurs que sur l'ordinateur local. Si vous prévoyez de lire des valeurs de compteur, vous pouvez choisir tout ordinateur auquel vous avez accès.

Pour configurer une instance du composant PerformanceCounter

  1. Créez une instance du composant PerformanceCounter. Pour plus d'informations, consultez Comment : créer des instances du composant PerformanceCounter.

  2. Indiquez le compteur avec lequel votre composant doit interagir en définissant les propriétés suivantes.

    Propriété

    Valeur

    MachineName

    Tout serveur auquel vous avez accès.

    CategoryName

    Toute catégorie existant sur le serveur.

    CounterName

    Tout compteur appartenant à la catégorie sélectionnée.

  3. Si le compteur spécifié compte plusieurs instances, sélectionnez-en une comme valeur de la propriété InstanceName.

  4. Si vous travaillez avec un compteur personnalisé et souhaitez un accès en écriture, affectez la valeur false à la propriété ReadOnly.

    Remarque :

    Vous pouvez spécifier ces propriétés dans la fenêtre Propriétés, dans le code ou à l'aide de formes spéciales du constructeur pour l'instance du composant PerformanceCounter.

    L'exemple suivant montre comment vous définiriez ces valeurs par programme pour vous connecter à un compteur de performance Windows existant appelé "aborted transactions" sur le serveur local.

    ' Connect to an existing Windows counter and category
Dim abortedTransactions As New PerformanceCounter()
abortedTransactions.CategoryName = _
   "distributed transaction coordinator"
abortedTransactions.CounterName = "aborted transactions"
abortedTransactions.MachineName = "."
' Connect to a custom counter and category in writable mode
PerformanceCounterCategory.Create("orders", "desc", _
PerformanceCounterCategoryType.SingleInstance, "milk", "desc")
Dim myCounter2 As New PerformanceCounter("orders", "milk", False)

         // Connect to an existing Windows counter and category
        System.Diagnostics.PerformanceCounter abortedTransactions =
           new System.Diagnostics.PerformanceCounter();
        abortedTransactions.CategoryName =
           "distributed transaction coordinator";
        abortedTransactions.CounterName = "aborted transactions";
        abortedTransactions.MachineName = ".";
        // Connect to a custom counter and category in writable mode
        System.Diagnostics.PerformanceCounterCategory.Create(
           "orders", "desc", PerformanceCounterCategoryType.SingleInstance,
           "milk", "desc");
        System.Diagnostics.PerformanceCounter myCounter2 =
           new System.Diagnostics.PerformanceCounter("orders", "milk", false);
Remarque :

Dans ce code, "." représente l'ordinateur local.

Voir aussi

Tâches

Comment : créer des instances du composant PerformanceCounter

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

Concepts

Gestion des catégories et des compteurs