SPHttpThrottleSettings.AddPerformanceMonitor - Méthode (String, String, String, Double[], Boolean)
Ajoute à la collection PerformanceMonitors un objet qui conserve les données qui sont utilisées lors de l'exécution pour créer un analyseur de performances.
Espace de noms : Microsoft.SharePoint.Utilities
Assembly : Microsoft.SharePoint (dans Microsoft.SharePoint.dll)
Syntaxe
'Déclaration
Public Sub AddPerformanceMonitor ( _
category As String, _
counter As String, _
instance As String, _
buckets As Double(), _
isASC As Boolean _
)
'Utilisation
Dim instance As SPHttpThrottleSettings
Dim category As String
Dim counter As String
Dim instance As String
Dim buckets As Double()
Dim isASC As Boolean
instance.AddPerformanceMonitor(category, _
counter, instance, buckets, isASC)
public void AddPerformanceMonitor(
string category,
string counter,
string instance,
double[] buckets,
bool isASC
)
Paramètres
category
Type : System.StringLa catégorie de performance.
counter
Type : System.StringLe compteur de performance.
instance
Type : System.StringLe nom de l'instance du compteur
buckets
Type : []Un tableau de valeurs qui définissent les limites entre les plages de valeurs de compteur (« modules »).
isASC
Type : System.Booleantrue pour indiquer que les valeurs progressivement plus importante avec chaque membre du tableau successive (autrement dit, ils sont dans l'ordre croissant), false pour indiquer que les plus petits.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentNullException | L'un des paramètres est une référence Null (Rien dans Visual Basic) ou est une chaîne vide. |
| InvalidOperationException | counter n'est pas le nom d'un compteur réel dans le système d'exploitation. |
Remarques
Les paramètres buckets et isASC doivent remplir certaines conditions :
Les valeurs des éléments dans buckets doivent être bien ordonnées, du plus petit au plus grand ou du plus grand au plus petit.
isASC indique la direction de l'ordre de buckets.
Les valeurs de buckets doivent également être bien ordonnées de présentant un bon état au moins en bon état. Par conséquent, buckets[0] est une valeur plus sain à buckets[1] et ce dernier est une valeur plus sain à buckets[2] et ainsi de suite. Par conséquent, buckets[buckets.Length-1] doit toujours être la valeur moins saine dans buckets.
Un objet SPBucketHealthScoreCalculator convertit toute valeur mesurée en un entier entre 0 et 10, selon où la valeur est comprise dans les plages accompagnées des éléments de buckets. Toute valeur qui est inférieure à buckets[0] (ou supérieure à elle, si buckets est décroissant) est un score de 0, qui est le score possible présentant un bon état. Toute valeur qui est supérieure à buckets[buckets.Length-1] (ou inférieur à elle, si buckets est décroissant) est un score de 10, qui est le score moins sain. Autres valeurs mesurées aura une valeur de 1 à 9 en fonction de si elles relèvent en ce qui concerne les valeurs de buckets.
Il n'y a pas de point pour avoir plus de 10 éléments dans buckets parce que les scores de santé ultime doivent être comprise entre 0 et 10 malgré tout.
En fonction de quel type de performances est mesuré, il est souvent appropriée pour les valeurs de buckets à l'échelle de manière exponentielle.
AddPerformanceMonitor appelle Update() en interne, afin que votre code n'a pas besoin d'appeler Update() après un appel de AddPerformanceMonitor.
Exemples
L'exemple suivant est une déclaration d'un tableau qui peut être passé comme un paramètre buckets . Dans ce cas, le tableau indique les plages de mémoire, exprimée en mégaoctets.
double[] availableMemoryBuckets = new double[10]
{1000.0, 500.0, 400.0, 300.0, 200.0,
100.0, 80.0, 60.0, 40.0, 20.0};
Dim availableMemoryBuckets() As Double = {1000.0, 500.0, 400.0, 300.0, 200.0, 100.0, 80.0, 60.0, 40.0, 20.0}
Pour obtenir un exemple de cette méthode en cours d'utilisation, consultez How to: Register or Deregister a Performance Counter.
Voir aussi
Référence
SPHttpThrottleSettings - Membres