Crear registradores de reenvío

  • Artículo

Los registradores de reenvío mejoran la eficacia del registro, ya que le permiten elegir los eventos que quiere supervisar al compilar proyectos en un sistema de varios procesadores. Al habilitar los registradores de reenvío, puede evitar que eventos no deseados sobrecarguen el registrador central, ralenticen el tiempo de compilación y saturen el registro.

Para crear un registrador de reenvío, puede implementar la interfaz IForwardingLogger y después implementar manualmente sus métodos, o bien usar la clase ConfigurableForwardingLogger y sus métodos preconfigurados. (Esto último será suficiente para la mayoría de las aplicaciones).

Registrar eventos y responder a ellos

Un registrador de reenvío recopila información sobre los eventos de compilación tal y como los notifica el motor de compilación secundaria, que es un proceso de trabajo que el proceso de compilación principal crea durante una compilación en un sistema de varios procesadores. Después, el registrador de reenvío selecciona los eventos que va a reenviar al registrador central, en función de las instrucciones que se le hayan dado.

Debe registrar los registradores de reenvío para controlar los eventos que quiere supervisar. Para registrar los eventos, los registradores deben invalidar el método Initialize. Este método ahora incluye un parámetro opcional, nodecount, que puede establecerse en el número de procesadores del sistema. (De forma predeterminada, el valor es 1).

Algunos ejemplos de los eventos que puede supervisar son TargetStarted, ProjectStarted y ProjectFinished.

En un entorno de varios procesadores, es probable que los mensajes de evento se reciban desordenados. Por lo tanto, debe evaluar los eventos mediante el uso del controlador de eventos del registrador de reenvío y programarlo para determinar qué eventos se deben pasar al redirector para realizar el reenvío al registrador central. Para ello, puede usar la clase BuildEventContext, que se adjunta a todos los mensajes, para ayudar a identificar los eventos que quiere reenviar y, después, pasar los nombres de los eventos a la clase ConfigurableForwardingLogger (o a una subclase de ella). Cuando use este método, no se requiere otra codificación específica para reenviar eventos.

Especificar un registrador de reenvío

Una vez que el registrador de reenvío se ha compilado en un ensamblado, debe indicarle a MSBuild que lo use durante las compilaciones. Para ello, use los modificadores -FileLogger, -FileLoggerParameters y -DistributedFileLogger junto con MSBuild.exe. El modificador -FileLogger le indica a MSBuild.exe que el registrador se adjunta directamente. El modificador -DistributedFileLogger significa que hay un archivo de registro por nodo. Para establecer parámetros en el registrador de reenvío, use el modificador -FileLoggerParameters. Para obtener más información sobre estos y otros modificadores de MSBuild.exe, vea Referencia de la línea de comandos.

Registradores que reconocen varios procesadores

Cuando se compila un proyecto en un sistema de varios procesadores, los mensajes de compilación de cada procesador no se intercalan automáticamente en una secuencia unificada. Por ello, debe establecer una prioridad de agrupación de mensajes mediante el uso de la clase BuildEventContext adjuntada a cada mensaje. Para obtener más información sobre la compilación con varios procesadores, vea Registrar en un entorno de varios procesadores.

Contenido relacionado