Integración de elementos de trabajo

La funcionalidad de integración de elementos de trabajo le permite crear fácilmente en GitHub o Azure DevOps elementos de trabajo que tienen datos de Application Insights pertinentes insertados en ellos.

La nueva integración de elementos de trabajo ofrece las características siguientes respecto a la versión clásica:

  • Campos avanzados, como persona asignada, proyectos o hitos.
  • Iconos de repositorio para que pueda diferenciar entre los libros de Azure DevOps & GitHub.
  • Varias configuraciones para cualquier número de repositorios o elementos de trabajo.
  • Implementación mediante plantillas de Azure Resource Manager.
  • Consultas pregeneradas & personalizables del lenguaje de consulta de palabras clave (KQL) para agregar datos de Application Insights a los elementos de trabajo.
  • Plantillas de libro personalizables.

Creación y configuración de una plantilla de elemento de trabajo

  1. Para crear una plantilla de elemento de trabajo, vaya a su recurso de Application Insights y, a la izquierda, en Configurar, seleccione Elementos de trabajo; luego, en la parte superior, elija Create a new template (Crear nueva plantilla).

     Screenshot of the Work Items tab with create a new template selected.

    Si no existe ninguna plantilla actual, también puede crear una plantilla de elemento de trabajo desde la pestaña de detalles de la transacción completa. Seleccione un evento y, a la derecha, elija Crear un elemento de trabajo; luego, seleccione Start with a workbook template (Empezar con una plantilla de libro).

     Screenshot of end-to-end transaction details tab with create a work item, start with a workbook template selected.

  2. Después de seleccionar Create a new template (Crear nueva plantilla), puede elegir los sistemas de seguimiento, asignar un nombre al libro, crear un vínculo al sistema de seguimiento seleccionado y elegir una región para almacenar la plantilla (el valor predeterminado es la región en la que se encuentra el recurso de Application Insights). Los parámetros de dirección URL son la dirección URL predeterminada del repositorio, por ejemplo, https://github.com/myusername/reponame o https://mydevops.visualstudio.com/myproject.

     Screenshot of create a new work item workbook template.

    Puede establecer propiedades específicas de los elementos de trabajo directamente desde la propia plantilla. Esto incluye la persona asignada, la ruta de acceso de iteración, los proyectos, etc. en función del proveedor de control de versiones.

Crear un elemento de trabajo

Puede acceder a la nueva plantilla desde cualquier detalle de transacción completa al que pueda acceder desde las pestañas Rendimiento, Errores, Disponibilidad, u otras.

  1. Para crear un elemento de trabajo, vaya a Detalles de la transacción completa, seleccione un evento y, a continuación, elija Crear elemento de trabajo y la plantilla de elemento de trabajo.

     Screenshot of end to end transaction details tab with create work item selected.

  2. Se abrirá una nueva pestaña en el explorador que le lleva al sistema de seguimiento seleccionado. En Azure DevOps, puede crear un error o una tarea y, en GitHub, puede crear un problema en el repositorio. Se crea automáticamente un elemento de trabajo con la información contextual proporcionada por Application Insights.

     Screenshot of automatically created GitHub issue

     Screenshot of automatically create bug in Azure DevOps.

Edición de una plantilla

Para editar la plantilla, vaya a la pestaña Elementos de trabajo en Configurar y seleccione el icono de lápiz situado junto al libro que quiere actualizar.

 Screenshot of work item tab with the edit pencil icon selected.

Seleccione Editar edit icon en la parte superior para empezar a editar la plantilla. Las plantillas de elemento de trabajo se basan en libros de Azure Monitor. La información del elemento de trabajo se genera mediante el lenguaje de consulta de palabras clave. Puede modificar las consultas para agregar más contexto esencial a su equipo. Cuando haya terminado de editar, guarde el libro; para ello, seleccione el icono Guardar save icon en la barra de herramientas superior.

 Screenshot of the work item template workbook in edit mode.

Puede crear más de una configuración de elementos de trabajo y tener un libro personalizado adecuado para cada escenario. Los libros también pueden implementarse mediante Azure Resource Manager, lo que garantiza implementaciones estándar entre los entornos.

Integración de elementos de trabajo clásicos

  1. En la opción Configurar del recurso de Application Insights, seleccione Elementos de trabajo.

  2. Seleccione Cambiar al modo clásico, rellene los campos con su información y realice la autorización.

     Screenshot of how to configure classic work items.

  3. Para crear un elemento de trabajo, vaya a los detalles de la transacción completa, seleccione un evento y, a continuación, elija Crear elemento de trabajo (clásico) .

Migración a una nueva integración de elementos de trabajo

Para migrar, elimine la configuración de elemento de trabajo clásico y, a continuación, cree y configure una plantilla de elemento de trabajo para volver a crear la integración.

Para eliminar, vaya al recurso de Application Insights en Configurar, seleccione Elementos de trabajo y, a continuación, seleccione Cambiar al modo clásico y *Eliminar en la parte superior.

Pasos siguientes

Prueba de disponibilidad