Tutorial: Recuperar categorías y contadores
Actualización: noviembre 2007
Los procedimientos de este tutorial le guiarán a través del proceso de crear y configurar instancias del componente PerformanceCounter y de utilizarlas para recuperar listas de categorías de contadores de rendimiento y de contadores del sistema. Un contador de rendimiento es el medio que utiliza Windows para recopilar datos de rendimiento de los diversos recursos del sistema. Windows contiene un conjunto de contadores predefinidos, organizados en categorías, con los que se puede interactuar. Cada categoría y cada contador están relacionados con un área específica de funcionalidad del sistema.
En este tutorial:
Creará una instancia del componente PerformanceCounter y la configurará de modo que interactúe con una categoría específica de contadores generados por el sistema.
Creará una aplicación para Windows que muestra información acerca de las categorías y contadores en un cuadro de lista.
Utilizará el método GetCategories para devolver una lista de categorías del equipo local.
Utilizará el método GetCounters para devolver una lista de contadores de la categoría especificada.
Para crear la aplicación para Windows
En el cuadro de diálogo Nuevo proyecto, cree una Aplicación para Windows de Visual Basic, Visual C# o Visual J#.
En la ficha Windows Forms del Cuadro de herramientas, agregue dos botones y dos cuadros de lista al formulario. Organícelos en el orden que desee y establezca las siguientes propiedades:
Control
Propiedad
Valor
Button1
Name
btnGetCounters
Text
Obtener contadores
Button2
Name
btnGetCategories
Text
Obtener categorías
ListBox1
Name
lstCounters
ScrollAlwaysVisible
True
ListBox2
Name
lstCategories
ScrollAlwaysVisible
True
Guarde su trabajo.
Para recuperar la lista de categorías
En la vista Diseño, haga doble clic en el botón Obtener categorías para tener acceso al Editor de código.
En la versión de Visual J#, en la parte superior de la pantalla, agregue una instrucción import que haga referencia al espacio de nombres System.Diagnostics.
En el procedimiento btnGetCategories_Click, agregue el código siguiente para recuperar la lista de categorías del equipo local.
Private Sub btnGetCategories_Click(ByVal sender As System.Object, _ ByVal e As System.EventArgs) Handles btnGetCategories.Click Dim myCat2 As PerformanceCounterCategory() Dim i As Integer ' Remove the current contents of the list. Me.lstCategories.Items.Clear() ' Retrieve the categories. myCat2 = PerformanceCounterCategory.GetCategories ' Add the retrieved categories to the list. For i = 0 To myCat2.Length - 1 Me.lstCategories.Items.Add(myCat2(i).CategoryName) Next End Sub
private void btnGetCategories_Click(object sender, System.EventArgs e) { System.Diagnostics.PerformanceCounterCategory[] myCat2; // Remove the current contents of the list. this.lstCategories.Items.Clear(); // Retrieve the categories. myCat2 = System.Diagnostics.PerformanceCounterCategory.GetCategories(); // Add the retrieved categories to the list. for (int i = 0; i < myCat2.Length; i++) { this.lstCategories.Items.Add(myCat2[i].CategoryName); } }
Para recuperar la lista de contadores
En la vista Diseño, haga doble clic en el botón Obtener contadores para tener acceso al Editor de código. El punto de inserción se situará en el evento btnGetCounters_Click.
Agregue el código siguiente para recuperar la lista de contadores de la categoría seleccionada.
Private Sub btnGetCounters_Click(ByVal sender As System.Object, _ ByVal e As System.EventArgs) Handles btnGetCounters.Click Dim instanceNames() As String Dim counters As New System.Collections.ArrayList() If (Me.lstCategories.SelectedIndex <> -1) Then Dim mycat As New PerformanceCounterCategory( _ Me.lstCategories.SelectedItem.ToString()) ' Remove the current contents of the list. Me.lstCounters.Items.Clear() ' Retrieve the counters. Try instanceNames = mycat.GetInstanceNames() If (instanceNames.Length = 0) Then counters.AddRange(mycat.GetCounters()) Else Dim i As Integer For i = 0 To instanceNames.Length - 1 counters.AddRange( _ mycat.GetCounters(instanceNames(i))) Next End If ' Add the retrieved counters to the list. Dim counter As PerformanceCounter For Each counter In counters Me.lstCounters.Items.Add(counter.CounterName) Next Catch ex As Exception MessageBox.Show( _ "Unable to list the counters for this category:" _ & ControlChars.CrLf & ex.Message) End Try End If End Sub
private void btnGetCounters_Click(object sender, System.EventArgs e) { string[] instanceNames; System.Collections.ArrayList counters = new System.Collections.ArrayList(); if (this.lstCategories.SelectedIndex != -1) { System.Diagnostics.PerformanceCounterCategory mycat = new System.Diagnostics.PerformanceCounterCategory( this.lstCategories.SelectedItem.ToString()); // Remove the current contents of the list. this.lstCounters.Items.Clear(); // Retrieve the counters. try { instanceNames = mycat.GetInstanceNames(); if (instanceNames.Length == 0) { counters.AddRange(mycat.GetCounters()); } else { for (int i = 0; i < instanceNames.Length; i++) { counters.AddRange(mycat.GetCounters(instanceNames[i])); } } // Add the retrieved counters to the list. foreach (System.Diagnostics.PerformanceCounter counter in counters) { this.lstCounters.Items.Add(counter.CounterName); } } catch (System.Exception ex) { MessageBox.Show( "Unable to list the counters for this category:\n" + ex.Message); } } }
Para probar la aplicación
Guarde y compile la aplicación.
Haga clic en el botón Obtener categorías. Verá una lista de categorías en el cuadro de lista.
Seleccione una de las categorías y haga clic en el botón Obtener contadores. Verá una lista de contadores para la categoría seleccionada.
Vea también
Conceptos
Introducción a la supervisión de umbrales de rendimiento