Configurar un agente de escucha de eventos y una suscripción de eventos

En este tema se describe la parte del ejemplo que contiene el código para crear un agente de escucha de eventos que se establece para suscribirse a eventos específicos en un registro de eventos y recibir notificación cuando se publican eventos específicos en el registro de eventos. El agente de escucha supervisa los registros de eventos basados en una consulta de XPath para un grupo de eventos que coincide con un determinado criterio de búsqueda. La consulta filtra los eventos en función de las propiedades de eventos.

Ejemplo

Descripción

En esta parte del ejemplo de código se utilizan las clases de espacios de nombres System.Diagnostics.Eventing.Reader para suscribirse con objeto de recibir notificaciones de eventos del registro de eventos de aplicaciones. La clase EventLogQuery se utiliza para crear una consulta de eventos que coincida con determinados criterios. La clase EventLogWatcher se utiliza para crear la suscripción mediante el establecimiento de un método de controlador de eventos para el evento EventRecordWritten. Se llama al método de controlador de eventos cuando un evento que coincide con el criterio de búsqueda se publica en el registro de eventos de Windows.

A continuación, se describen partes del código y se resaltan los correspondientes ejemplos de código.

1. Cree una instancia de la clase EventLogQuery especificando una cadena de consulta usada para filtrar eventos así como el nombre o la ubicación del registro de eventos al que suscribirse. Para obtener más información sobre cómo crear una cadena de consulta de eventos, vea Consultas de eventos y XML de eventos.
2. (Opcional) Para suscribirse a eventos en un equipo remoto, establezca la propiedad Session en una instancia de la clase EventLogSession y especifique el nombre del equipo remoto, el dominio y el nombre de usuario y la contraseña usados para conectarse al equipo remoto.
3. Cree una nueva instancia de EventLogWatcher pasando la instancia de EventLogQuery creada en el paso 1 al constructor EventLogWatcher.
4. Cree un método de devolución de llamada que se ejecutará cuando se informe de un evento a la suscripción. Este método acepta argumentos de tipo Object y EventRecordWrittenEventArgs.
5. Establezca el controlador de eventos EventRecordWritten en un nuevo controlador de eventos que apunte al método de devolución de llamada creado en el paso 4.
6. Establezca la propiedad Enabled en true para iniciar la suscripción de eventos y en false para detenerla.
7. Ésta es la parte del ejemplo que procesa los datos de eventos si se recibe un evento completo. Según el valor del parámetro XMLMode, guarda los datos de eventos en un archivo o lo escribe en la base de datos.

Compilar el código

Este ejemplo de código requiere referencias a los archivos System.dll y System.Core.dll. Además, hace referencia a System.Data.dll y System.Xml.dll para manipular el XML del evento y escribir los datos en una base de datos SQL.

Consulte también

Conceptos

Escenarios de registros de eventos
Cómo escuchar eventos y almacenarlos en una base de datos SQL
Cómo suscribirse a eventos de un registro de eventos

Send comments about this topic to Microsoft.

Copyright © 2007 Microsoft Corporation. Reservados todos los derechos.