Procedura: creare categorie di contatori delle prestazioni

Aggiornamento: novembre 2007

È possibile creare una nuova categoria che contenga i contatori personalizzati. Se ad esempio si prevede di creare una serie di contatori per tenere traccia di dati diversi sugli ordini elaborati in un sito Web, sarà possibile creare una categoria chiamata OrderData sul server, quindi creare i contatori necessari all’interno di essa.

La creazione di una categoria non è un processo diverso dalla creazione dei contatori in essa contenuti. I contatori possono essere creati solo nel momento in cui si crea la categoria stessa. Non è possibile creare categorie e contatori in computer remoti né eseguirne la rimozione.

Esistono diversi modi per creare contatori e categorie:

• È possibile utilizzare il metodo Create della classe PerformanceCounterCategory per creare contemporaneamente una nuova categoria e un singolo contatore delle prestazioni al suo interno.

• È possibile creare una matrice di oggetti CounterCreationData e passarla come parametro dei metodi Create, creando un insieme di contatori all’interno della categoria. Per ulteriori informazioni, vedere Procedura: creare contatori delle prestazioni personalizzati.

• È possibile utilizzare la finestra di dialogo Contatore di prestazioni, che può essere aperta da Esplora server, per creare più contatori contemporaneamente alla creazione di una nuova categoria. Per ulteriori informazioni, vedere Procedura: creare contatori delle prestazioni personalizzati.

  Nota:
  Esistono restrizioni di protezione che influiscono sulla possibilità dell'utente di utilizzare i contatori delle prestazioni. Per ulteriori informazioni, vedere Introduzione al monitoraggio dei valori limite delle prestazioni.

  Nota:
  La classe PerformanceCounter non è completamente supportata in Microsoft Windows NT versione 4.0. È possibile leggere dai contatori di sistema, ma non è possibile creare o eliminare i contatori personalizzati, né scrivervi.

Per creare una categoria e un solo contatore all’interno di essa

• Chiamare il metodo Create della classe PerformanceCounterCategory e specificare i seguenti parametri:

  Parametro	Valore
  CategoryName	Qualunque nome di categoria che non sia già in uso su questo server.
  CategoryHelp	Una descrizione della categoria.
  CounterName	Un nome per il contatore.
  CounterHelp	Una descrizione del contatore. Questo testo viene visualizzato in Performance Monitor di Windows quando un utente seleziona un contatore e sceglie il pulsante Descrizione.

  Nell’esempio riportato di seguito viene illustrato come creare una categoria semplice con il metodo Create.

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

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

Nota:
Per impostazione predefinita, i contatori creati mediante questo codice sono abilitati per la lettura e la scrittura. Se si utilizza tuttavia un'istanza del componente PerformanceCounter, tali contatori risultano in sola lettura, se non diversamente specificato. Per apportare modifiche a un contatore, è possibile impostare il valore della proprietà ReadOnly dell'istanza di un componente su false.

Vedere anche

Attività

Procedura: creare contatori delle prestazioni personalizzati

Concetti

Gestione di categorie e contatori