Administrar información sobre las compilaciones y controlar el nivel de detalle

Puede obtener información detallada sobre una compilación completada:

• ¿Cómo se ejecutó la compilación? ¿Fue correcta?¿Cuándo comenzó?¿Cuánto tiempo tardó en completarse?¿Cuál fue el resultado en comparación con otras anteriores?

• ¿Qué se compiló? ¿Qué soluciones, conjuntos de cambios y correcciones de errores entraron en esta compilación?

• ¿Qué salió mal? ¿Qué advertencias o errores se produjeron?¿Qué pruebas dieron errores?

Puede controlar sistemáticamente el nivel de detalle de la información almacenada en cada compilación completada cuando defina el proceso de compilación.Como alternativa, puede controlar esta detalle para una única ejecución de una compilación cuando la pone en cola manualmente.

En este tema

• Cómo se genera la información de compilación y los flujos

  • Definir el proceso de compilación

  • El proceso de compilación se pone en la cola y se ejecuta

  • Se muestra, filtra y se almacena la información de compilación

  • Recuperar información de compilación

• Establecer el parámetro del proceso de compilación para registrar el nivel de detalle

• Procedimiento recomendado: establecer el nivel de detalle tan bajo como sea posible

  • Emplear un nivel de detalle mínimo al ejecutar una compilación

  • Emplear un nivel de detalle mínimo al diseñar una plantilla personalizada del proceso de compilación

• Para obtener más información

Cómo se genera la información de compilación y los flujos

Definir el proceso de compilación

Puede controlar sistemáticamente el detalle de información cuando desarrolla el proceso de compilación.Cuando se crea o modifica una definición de compilación basada en la plantilla predeterminada o la plantilla de actualización, muestre la pestaña de Proceso.En el nodo Basic, puede seleccionar un valor en la lista de Nivel de detalle de registro para especificar este parámetro del proceso de compilación.

En los casos en que las plantillas integradas no resuelven sus necesidades, puede desarrollar una plantilla personalizada.Al crear este tipo de plantilla, debe escribir cuidadosamente la información de compilación.Para obtener más información, vea Utilice un nivel de detalle mínimo al diseñar una plantilla personalizada del proceso de compilación.

El proceso de compilación se pone en la cola y se ejecuta

Puede invalidar manualmente Nivel de detalle de registro estableciendo si se pone en cola una definición de compilación basada en la plantilla predeterminada o la plantilla de actualización.En el cuadro de diálogo Poner compilación en cola, muestre la pestaña Parámetros, expanda el nodo Basic y, a continuación, seleccione un valor de la lista Nivel de detalle de registro para especificar este parámetro del proceso de compilación.Este valor se aplica a una única ejecución de la compilación.

Se muestra, filtra y se almacena la información de compilación

El sistema de generación pasa el valor del parámetro del proceso de compilación de Nivel de detalle a Verbosity.Esta propiedad se utiliza para filtrar la información de compilación que se registra y se almacena en Team Foundation Server mediante Information de los orígenes siguientes:

• Actividades de flujo de trabajo: varias actividades de flujo de trabajo generan un mensaje si la operación se realiza correctamente, y una advertencia o un error si una operación da error.Por ejemplo, la actividad SyncWorkspace genera mensajes de importancia baja cuando descarga el código fuente y otros archivos del servidor al agente de compilación.Esta actividad genera errores cuando no puede descargar los archivos.Otro ejemplo, la actividad OpenWorkItem genera una advertencia cuando no se puede crear un elemento de trabajo.

  Puede utilizar otras actividades de flujo de trabajo para escribir directamente su propia información de compilación.Para obtener más información, vea Diseñar una plantilla personalizada de proceso de compilación que escriba información con el mínimo nivel de detalle necesario.

• gg265783(v=vs.110).md para aprovechar y compilar los binarios y realizar otras tareas fundamentales.La propiedad Nivel de detalle de esta actividad controla el nivel de detalle de la información que este proceso genera y publica en las siguientes ubicaciones:

  • Team Foundation Server almacena los resultados, errores, y las advertencias de compilación.

  • Un registro en la carpeta de entrega almacena la misma información que Team Foundation Server junto con el resto de los mensajes que MSBuild presente.

• código de prueba: El proceso de compilación utiliza RunTests o actividad de MSTest para ejecutar pruebas.Todos los mensajes que el registro de estas actividades se realiza con un valor de importancia alta si el controlador de compilación es local, o Baja si usa Controlador hospedado de compilación.

Recuperar información de compilación

A medida que la compilación se está ejecutando y una vez completada, puede recuperar la información de resumen y de detalle en la ventana de resultados de compilación.Puede copiar esta información de la ventana en el portapapeles.También puede vincular directamente con la carpeta de entrega y recuperar los registros, los binarios y otros datos.

Parámetro del proceso de compilación de nivel de detalle del registro

En un proceso de compilación basado en la plantilla predeterminada o en la plantilla de actualización, puede utilizar el parámetro del proceso de compilación Nivel de detalle de registro para administrar el nivel de detalle de la información que se ha registrado y almacenado.

En la tabla siguiente se enumeran los valores de Nivel de detalle de registro y sus efectos correspondientes:

Valor	Errores	Advertencias	Mensajes de compilación de importancia alta	Mensaje de importancia normal	Mensaje de importancia baja	Propiedades de actividades de flujo de trabajo (entradas y salidas)
Minimal	Y	N	N	N	N	N
Normal	Y	Y	Y	N	N	N
Detailed	Y	Y	Y	Y	N	N
Diagnóstico (Sugerencia: En la mayoría de los casos es usar los registros de diagnóstico.Vea Diagnosticar problemas de compilación.)	Y	Y	Y	Y	Controlador local de compilación: Y Controlador hospedado de compilación: N	Y

Procedimiento recomendado: establecer el nivel de detalle tan bajo como sea posible

Aunque la información de la compilación sea importante, un proceso de compilación que registra demasiada información puede producir problemas.Estos problemas pueden incluir el consumo excesivo almacenamiento en Team Foundation Server, reducir el rendimiento de Visual Studio, y sobrecargar miembros del equipo con más información que pueden controlar.

Emplear un nivel de detalle mínimo al ejecutar una compilación

Cuando se ejecuta una compilación, se debe seguir normalmente el procedimiento recomendado de utilizar la configuración de la información de nivel de detalle más baja que se necesita para lograr el objetivo.

Emplear un nivel de detalle mínimo al diseñar una plantilla personalizada del proceso de compilación

Los usuarios de su proceso de compilación dependen del filtrado de nivel de detalle para reducir la sobrecarga de información.Este filtrado es más eficaz si se siguen estos pasos:

• Asegúrese de seleccionar la actividad más adecuada para escribir un mensaje: Actividad WriteBuildMessage, Actividad WriteBuildWarning, Actividad WriteBuildError o WriteBuildTestError.

• Cuando se utiliza la actividad Actividad WriteBuildMessage para registrar información, aplique un enfoque intencionado y coherente para establecer la propiedad Importancia.Cuando utiliza un valor de mayor importancia para el mensaje, tenga en cuenta que está aumentando potencialmente la cantidad de datos que se almacenan y se muestran a los miembros del equipo.

[!NOTA]

El impacto de estas decisiones puede ser importante si usa estas actividades dentro de una estructura de bucle como DoWhile, ForEach<T> o While.

Para obtener más información

Diagnosticar problemas de compilación describe cómo recopilar registros de diagnóstico.

Actividades de Team Foundation Build describe las actividades de flujo de trabajo del proceso de compilación que se mencionan en este tema.

Definir un proceso de compilación basado en la plantilla predeterminada y Usar procesos de compilación heredados proporcionan instrucciones sobre cómo crear y mantener las definiciones de compilación basadas en la plantilla predeterminada y la plantilla de actualización

Ver resultados de la compilación proporciona directrices sobre cómo utilizar la ventana de resultados de compilación.

IBuildDetail, BuildMessageImportance y BuildVerbosity describen algunos elementos clave de la API de Team Foundation Build que proporcionan funcionalidad de información de compilación.

Referencia de la línea de comandos de MSBuild describe MSBuild.

Especificar desencadenadores y razones de compilación y Poner en cola una compilación describen cómo poner en cola automática y manualmente una compilación.