System.Diagnostics Espacio de nombres

Proporciona clases que permiten interactuar con los procesos del sistema, registros de eventos y contadores de rendimiento.

Clases

Activity

Representa una operación con el contexto que se usará para el registro.

ActivityListener

Permite escuchar los eventos de actividad de inicio y detención y brinda la oportunidad de decidir la creación de una actividad para los escenarios de muestreo.

ActivitySource

Proporciona las API para crear e iniciar objetos Activity, así como para registrar objetos ActivityListener, a fin de escuchar los eventos de Activity.

ActivityTagsCollection

ActivityTagsCollection es una clase de colección que se usa para almacenar etiquetas de seguimiento.

Esta colección se usará con clases como ActivityEvent y ActivityLink.

Esta colección se comporta de la siguiente manera:

  • Los elementos de la colección se ordenarán en función de cómo se agreguen.
  • No se permite la duplicación de elementos con la misma clave.
  • Cuando se usa el indexador para almacenar un elemento en la colección:
    • Si el elemento tiene una clave que existía anteriormente en la colección y el valor es null, el elemento de colección que coincide con la clave se quitará de la colección.
    • Si el elemento tiene una clave que existía anteriormente en la colección y el valor no nulles , el nuevo valor del elemento reemplazará el valor antiguo almacenado en la colección.
    • De lo contrario, el elemento se agregará a la colección.
  • El método Add agregará un elemento nuevo a la colección si todavía no existe un elemento con la misma clave. De lo contrario, se generará una excepción.
BooleanSwitch

Proporciona un conmutador de activado/desactivado sencillo que controla los resultados de depuración y traza.

ConditionalAttribute

Indica a los compiladores que se debe omitir una llamada al método o un atributo a menos que se defina un símbolo de compilación condicional especificado.

ConsoleTraceListener

Dirige el resultado de la traza o la depuración a la salida estándar o a la secuencia de error estándar.

CorrelationManager

Establece una correlación entre los seguimientos que forman parte de una transacción lógica.

CounterCreationData

Define el tipo de contador, el nombre y la cadena de Ayuda de un contador personalizado.

CounterCreationDataCollection

Proporciona una colección fuertemente tipada de objetos CounterCreationData.

CounterSampleCalculator

Proporciona un conjunto de funciones de utilidad para interpretar los datos del contador de rendimiento.

DataReceivedEventArgs

Proporciona datos para los eventos OutputDataReceived y ErrorDataReceived.

Debug

Proporciona un conjunto de métodos y propiedades que ayudan a depurar el código.

DebuggableAttribute

Modifica la generación de código para la depuración Just-In-Time (JIT) en tiempo de ejecución. Esta clase no puede heredarse.

Debugger

Permite la comunicación con un depurador. Esta clase no puede heredarse.

DebuggerBrowsableAttribute

Determina si se muestra un miembro en las ventanas de variables del depurador y cómo se muestra. Esta clase no puede heredarse.

DebuggerDisplayAttribute

Determina cómo se muestran una clase o un campo en las ventanas de variables del depurador.

DebuggerHiddenAttribute

Especifica el DebuggerHiddenAttribute. Esta clase no puede heredarse.

DebuggerNonUserCodeAttribute

Identifica un tipo o un miembro que no forman parte del código de usuario de una aplicación.

DebuggerStepperBoundaryAttribute

Indica que el código después del atributo debe ejecutarse en modo de ejecución y no en modo paso a paso.

DebuggerStepThroughAttribute

Indica al depurador que recorra el código en lugar de ejecutarlo paso a paso. Esta clase no puede heredarse.

DebuggerTypeProxyAttribute

Especifica el proxy de presentación para un tipo.

DebuggerVisualizerAttribute

Especifica que el tipo tiene un visualizador. Esta clase no puede heredarse.

DefaultTraceListener

Proporciona los métodos de salida predeterminados y el comportamiento para el seguimiento.

DelimitedListTraceListener

Dirige los resultados de traza o de depuración a un escritor de texto, como un escritor de secuencias, o a una secuencia, como una secuencia de archivo.

DiagnosticListener

Proporciona una implementación de la clase abstracta DiagnosticSource que representa una ubicación con nombre a la que un origen envía su información (eventos).

DiagnosticListenerExtensions

Proporciona clases que permiten interactuar con los procesos del sistema, registros de eventos y contadores de rendimiento.

DiagnosticsConfigurationHandler

Controla la sección de diagnósticos de archivos de configuración.

DiagnosticSource

Clase abstracta que permite instrumentar el código para el registro de tiempo de producción de las cargas de datos enriquecidos para su uso dentro del proceso que se ha instrumentado.

DistributedContextPropagator

Una implementación de DistributedContextPropagator determina si y cómo se codifica y descodifica la información de contexto distribuida a medida que atraviesa la red. La codificación se puede transportar mediante cualquier protocolo de red que admita pares clave-valor de cadena. Por ejemplo, cuando se usa HTTP, cada par clave-valor es un encabezado HTTP. DistributedContextPropagator inserta valores en y extrae valores de operadores como pares clave-valor de cadena.

EntryWrittenEventArgs

Proporciona datos para el evento EntryWritten.

EventInstance

Representa la información independiente del idioma de una entrada del registro de eventos.

EventLog

Proporciona interacción con los registros de eventos de Windows.

EventLogEntry

Encapsula un único registro en el registro de eventos. Esta clase no puede heredarse.

EventLogEntryCollection

Define el tamaño y los enumeradores de una colección de instancias de EventLogEntry.

EventLogInstaller

Permite instalar y configurar un registro de eventos en el que la aplicación lee o escribe cuando se ejecuta.

EventLogPermission

Controla los permisos de acceso al código para el registro de eventos.

EventLogPermissionAttribute

Permite realizar comprobaciones declarativas de permisos para registros de eventos.

EventLogPermissionEntry

Define la unidad más pequeña de un permiso de seguridad de acceso del código que se establece para EventLog.

EventLogPermissionEntryCollection

Contiene una colección fuertemente tipada de objetos EventLogPermissionEntry.

EventLogTraceListener

Proporciona un agente de escucha simple que dirige el resultado de la traza o la depuración a EventLog.

EventSchemaTraceListener

Dirige los resultados de seguimiento o de depuración de eventos de un extremo a otro a un archivo de registro con codificación XML conforme al esquema.

EventSourceCreationData

Representa los valores de configuración utilizados para crear un origen de registro de eventos en el equipo local o un equipo remoto.

EventTypeFilter

Indica si un agente de escucha debe realizar el seguimiento basándose en el tipo de evento.

FileVersionInfo

Proporciona información de versión para un archivo físico en disco.

InitializingSwitchEventArgs

Proporciona datos para el evento Switch.Initializing .

InitializingTraceSourceEventArgs

Proporciona datos para el evento TraceSource.Initializing .

InstanceData

Contiene los datos de instancia asociados a un contador de rendimiento de ejemplo.

InstanceDataCollection

Proporciona una colección fuertemente tipada de objetos InstanceData.

InstanceDataCollectionCollection

Proporciona una colección fuertemente tipada de objetos InstanceDataCollection.

MonitoringDescriptionAttribute

Especifica una descripción para una propiedad o evento.

PerformanceCounter

Representa un componente de contador de rendimiento de Windows NT.

PerformanceCounterCategory

Representa un objeto de rendimiento que define una categoría de contadores de rendimiento.

PerformanceCounterInstaller

Especifica un instalador para el componente PerformanceCounter .

PerformanceCounterManager

Prepara los datos de rendimiento para el archivo performance.dll que carga el sistema al trabajar con contadores de rendimiento.

PerformanceCounterPermission

Permite controlar los permisos de acceso al código para PerformanceCounter.

PerformanceCounterPermissionAttribute

Permite comprobaciones declarativas de permiso de contador de rendimiento.

PerformanceCounterPermissionEntry

Define la unidad más pequeña de un permiso de seguridad de acceso del código que se establece para PerformanceCounter.

PerformanceCounterPermissionEntryCollection

Contiene una colección fuertemente tipada de objetos PerformanceCounterPermissionEntry.

PresentationTraceSources

Ofrece compatibilidad de traza de depuración que está específicamente destinada para aplicaciones de Windows Presentation Foundation (WPF).

Process

Proporciona acceso a procesos locales y remotos, y permite iniciar y detener procesos del sistema local.

ProcessModule

Representa un archivo .dll o .exe que se carga en un proceso determinado.

ProcessModuleCollection

Proporciona una colección fuertemente tipada de objetos ProcessModule.

ProcessStartInfo

Especifica un conjunto de valores que se usa cuando se inicia un proceso.

ProcessThread

Representa un subproceso del sistema operativo.

ProcessThreadCollection

Proporciona una colección fuertemente tipada de objetos ProcessThread.

SourceFilter

Indica si un agente de escucha debe realizar el seguimiento de un mensaje basándose en el origen de un seguimiento.

SourceSwitch

Proporciona un modificador multinivel para controlar la generación de traza y depuración sin recompilar su código.

StackFrame

Proporciona información sobre un StackFrame, que representa una llamada de función en la pila de llamadas del subproceso actual.

StackFrameExtensions

Proporciona métodos de extensión para la clase StackFrame, que representa una llamada de función en la pila de llamadas del subproceso actual.

StackTrace

Representa un seguimiento de pila, que es una colección ordenada de uno o más marcos de pila.

StackTraceHiddenAttribute

Los tipos y métodos con atributos StackTraceHidden se omitirán en el texto de seguimiento de la pila que se muestra en StackTrace.ToString() y Exception.StackTrace.

Stopwatch

Proporciona un conjunto de métodos y propiedades que puede usar para medir el tiempo transcurrido con precisión.

Switch

Proporciona una clase base abstracta para crear nuevos modificadores de depuración y traza.

SwitchAttribute

Identifica un modificador utilizado en un ensamblado, una clase o un miembro.

SwitchLevelAttribute

Identifica el tipo de nivel de un modificador.

TextWriterTraceListener

Dirige los resultados de la traza o la depuración a un objeto TextWriter o a un objeto de la clase Stream como un archivo FileStream.

Trace

Proporciona un conjunto de métodos y propiedades que ayudan a realizar un seguimiento del código. Esta clase no puede heredarse.

TraceConfiguration

Proporciona clases que permiten interactuar con los procesos del sistema, registros de eventos y contadores de rendimiento.

TraceEventCache

Proporciona los datos de evento de seguimiento específicos de un subproceso y un proceso.

TraceFilter

Proporciona la clase base para las implementaciones de los filtros de seguimiento.

TraceListener

Proporciona la clase base abstract a los agentes de escucha que supervisan los resultados de seguimiento y de depuración.

TraceListenerCollection

Proporciona una lista de objetos TraceListener segura para subprocesos.

TraceSource

Proporciona un conjunto de métodos y propiedades que permiten que las aplicaciones realicen un seguimiento de la ejecución de código y asocien mensajes de seguimiento con su origen.

TraceSwitch

Proporciona un modificador multinivel para controlar la generación de traza y depuración sin recompilar su código.

UnescapedXmlDiagnosticData

Proporciona datos XML sin escape para el registro de la información de seguimiento proporcionada por el usuario.

UnreachableException

Excepción que se produce cuando el programa ejecuta una instrucción a la que se pensaba que no se iba a llegar.

XmlWriterTraceListener

Dirige los resultados de traza o de depuración como datos en código XML a un TextWriter o a una Stream, como una FileStream.

Estructuras

Activity.Enumerator<T>

Enumera los datos almacenados en un Activity objeto .

ActivityChangedEventArgs

Proporciona datos para el evento CurrentChanged.

ActivityContext

Representación que se ajusta a la especificación TraceContext de W3C. Contiene dos identificadores: TraceId y SpanId, junto con un conjunto de valores TraceFlags comunes y TraceState específicos del sistema.

ActivityCreationOptions<T>

Encapsula toda la información que se envía al cliente de escucha de actividad para tomar decisiones sobre la creación de la instancia de la actividad, así como su estado.

Los parámetros de tipo genérico posibles son ActivityContext o String.

ActivityEvent

Representa un evento que contiene un nombre y una marca de tiempo, así como una lista opcional de etiquetas.

ActivityLink

Las actividades pueden estar vinculadas a cero o más instancias de contexto de actividad que están relacionadas de manera causal.

Los vínculos de actividad pueden apuntar a contextos de actividad dentro de un único seguimiento o a través de varios seguimientos.

Los vínculos de actividad se pueden utilizar para representar operaciones por lotes en las que varias actividades de inicio iniciaron una actividad, donde cada una de las cuales representa un único elemento entrante que se está procesando en el lote.

ActivitySpanId

Representa un elemento SpanId con formato según un estándar W3C.

ActivityTagsCollection.Enumerator

Enumera los elementos de un objeto ActivityTagsCollection.

ActivityTraceId

Representa un elemento TraceId cuyo formato se basa en un estándar W3C.

CounterSample

Define una estructura que contiene los datos sin procesar de un contador de rendimiento.

Debug.AssertInterpolatedStringHandler

Proporciona un controlador de cadenas interpolado para Assert(Boolean) que solo realice el formato si se produce un error en la aserción.

Debug.WriteIfInterpolatedStringHandler

Proporciona un controlador de cadenas interpolado para WriteIf(Boolean, String) y WriteLineIf(Boolean, Object) que solo realiza el formato si se aplica la condición.

TagList

Representa una lista de etiquetas a las que puede acceder el índice. Proporciona métodos para buscar, ordenar y manipular listas.

TagList.Enumerator

Enumerador para recorrer una colección de listas de etiquetas.

Interfaces

ICollectData

Prepara los datos de rendimiento para el archivo DLL de rendimiento que el sistema carga al trabajar con los contadores de rendimiento.

Enumeraciones

ActivityIdFormat

Especifica el formato de la propiedad Id.

ActivityKind

Describe la relación entre la actividad, sus elementos primarios y sus elementos secundarios en un seguimiento.

ActivitySamplingResult

Valores de enumeración utilizados por ActivityListener para indicar la cantidad de datos que se van a recopilar para el elemento Activity relacionado. La solicitud de más datos provoca una mayor sobrecarga de rendimiento.

ActivityStatusCode

Defina el código de estado de la actividad que indica el estado de la operación instrumentada.

ActivityTraceFlags

Especifica las marcas definidas por el estándar W3C asociadas a una actividad.

DebuggableAttribute.DebuggingModes

Especifica el modo de depuración para el compilador Just-In-Time (JIT).

DebuggerBrowsableState

Proporciona instrucciones de presentación para el depurador.

EventLogEntryType

Especifica el tipo de evento de una entrada del registro de eventos.

EventLogPermissionAccess

Define los niveles de acceso utilizados por las clases de permiso EventLog.

OverflowAction

Especifica el modo de tratar las entradas de un registro de eventos que ha alcanzado el tamaño de archivo máximo.

PerformanceCounterCategoryType

Indica si la categoría de contador de rendimiento puede tener varias instancias.

PerformanceCounterInstanceLifetime

Especifica la duración de una instancia del contador de rendimiento.

PerformanceCounterPermissionAccess

Define los niveles de acceso utilizados por las clases de permiso PerformanceCounter.

PerformanceCounterType

Especifica los tipos de contadores de rendimiento que se asignan directamente a los tipos nativos.

PresentationTraceLevel

Describe el nivel de detalle que se va a obtener de un objeto determinado.

ProcessPriorityClass

Indica la prioridad que el sistema asocia a un proceso. Este valor, junto con el valor de prioridad de cada subproceso del proceso, determina el nivel de prioridad base de cada subproceso.

ProcessWindowStyle

Determinaba cómo debe aparecer una ventana cuando el sistema inicia un proceso.

SourceLevels

Especifica los niveles de los mensajes de seguimiento filtrados por el modificador de origen y el filtro de tipo de evento.

ThreadPriorityLevel

Especifica el nivel de prioridad de un subproceso.

ThreadState

Especifica el estado de ejecución actual del subproceso.

ThreadWaitReason

Especifica la razón por la que el subproceso está esperando.

TraceEventType

Identifica el tipo de evento que ha originado el seguimiento.

TraceLevel

Especifica qué mensajes se van a enviar para las clases Debug, Trace y TraceSwitch.

TraceLogRetentionOption

Especifica la estructura de archivos que se utilizará para el registro de EventSchemaTraceListener.

TraceOptions

Especifica las opciones de los datos de seguimiento que se van a escribir en el resultado de seguimiento.

Delegados

DataReceivedEventHandler

Representa el método que controlará los eventos OutputDataReceived o ErrorDataReceived de un Process.

DistributedContextPropagator.PropagatorGetterCallback

Representa el método de devolución de llamada que se usa en los métodos de extracción de propagadores. La devolución de llamada se invoca para buscar el valor de un campo con nombre.

DistributedContextPropagator.PropagatorSetterCallback

Representa el método de devolución de llamada que se usa en los métodos de inserción de propagadores. Esta devolución de llamada se invoca para establecer el valor de un campo con nombre. Los propagadores pueden invocarlo varias veces para establecer varios campos.

EntryWrittenEventHandler

Representa el método que controlará el evento EntryWritten de EventLog.

SampleActivity<T>

Delegado que define la firma de las devoluciones de llamadas de ActivityListener utilizadas en el proceso de muestreo.

Comentarios

  • El EventLog componente proporciona funcionalidad para escribir en registros de eventos, leer entradas del registro de eventos y crear y eliminar registros de eventos y orígenes de eventos en la red. EntryWrittenEventHandler proporciona una manera de interactuar con los registros de eventos de forma asincrónica. Las clases auxiliares proporcionan acceso a un control más detallado, incluidas las restricciones de permisos, la capacidad de especificar tipos de registro de eventos (que controlan el tipo de datos predeterminados que se escriben con una entrada del registro de eventos) y recorrer en iteración las colecciones de entradas del registro de eventos. Para obtener más información sobre estas tareas, vea las EventLogPermissionclases , EventLogEntryTypey EventLogEntryCollection .

  • La Process clase proporciona funcionalidad para supervisar los procesos del sistema a través de la red y para iniciar y detener los procesos del sistema local. Además de recuperar listas de procesos en ejecución (especificando el equipo, el nombre del proceso o el identificador de proceso) o viendo información sobre el proceso que actualmente tiene acceso al procesador, puede obtener conocimientos detallados de los subprocesos y módulos de proceso tanto a través de la propia clase como mediante la Process interacción con las ProcessThread clases y ProcessModule . La ProcessStartInfo clase permite especificar una variedad de elementos con los que iniciar un nuevo proceso, como flujos de entrada, salida y errores, directorios de trabajo y verbos y argumentos de línea de comandos. Esto le proporciona un control preciso sobre el comportamiento de los procesos. Otras clases relacionadas permiten especificar los estilos de ventana, las prioridades de procesos y subprocesos e interactuar con colecciones de subprocesos y módulos.

  • La PerformanceCounter clase permite supervisar el rendimiento del sistema, mientras que la PerformanceCounterCategory clase proporciona una manera de crear nuevos contadores y categorías personalizados. Puede escribir en los contadores personalizados locales y leer desde los contadores locales y los remotos (del sistema, así como personalizados). Puede muestrear contadores mediante la PerformanceCounter clase y calcular los resultados de muestras de contadores de rendimiento sucesivos mediante la CounterSample clase . La CounterCreationData clase permite crear varios contadores en una categoría y especificar sus tipos. Otras clases asociadas al componente de contadores de rendimiento proporcionan acceso a colecciones de contadores, permisos de contadores y tipos de contadores.

El System.Diagnostics espacio de nombres también proporciona clases que permiten depurar la aplicación y realizar un seguimiento de la ejecución del código. Para obtener más información, vea las clases Trace y Debug.