Instalación o habilitación del servicio Analytics

Azure DevOps Server 2020 | Azure DevOps Server 2019

Para Azure DevOps Server 2020, el servicio Analytics está disponible con carácter general. Se habilita automáticamente para todas las nuevas colecciones de proyectos agregadas al servidor. En el caso de las colecciones de proyectos actualizadas desde una versión anterior, es posible que deba habilitarla manualmente. Puede habilitar Analytics para cada colección de proyectos para la que quiera generar informes de Analytics.

Analytics se encuentra actualmente en versión preliminar. Se puede usar de forma gratuita mientras permanece en versión preliminar. Para Azure DevOps Server 2019, instale la extensión Analytics desde el marketplace local. Para Azure DevOps Server 2019.1, habilite Analytics. Instale o habilite Analytics para cada colección de proyectos para la que quiera generar informes de Analytics.

Nota:

La extensión analytics de Marketplace y Analytics no se admiten para TFS 2018 o versiones anteriores.

Analytics admite el acceso a widgets de Analytics para todos los proyectos definidos en la colección de proyectos. Para más información, consulte ¿Qué es Analytics? y Widgets basados en Analytics.

Requisitos previos

Para Azure DevOps Server 2019.1:

Para Azure DevOps Server 2019:

Habilitación de Analytics

Si ha actualizado a Azure DevOps Server 2019.1, puede habilitar Analytics para una colección de proyectos con los pasos siguientes. De lo contrario, para Azure DevOps Server 2019, consulte Instalación de Analytics.

Nota:

Analytics se habilita automáticamente para todas las colecciones de proyectos recién creadas.

  1. En un explorador web, seleccione (1) la colección de proyectos, (2) Collection Configuración o Admin settings(Configuración de administración) y, a continuación, (3) Analytics.

    Abrir la configuración  de administración de > recopilación Analytics

  2. Seleccione Habilitar Analytics.

    Habilitación de Analytics

    Una vez habilitado, los trabajos de almacenamiento provisional de Analytics comienzan a rellenar las tablas de datos de Analytics. Este proceso puede tardar algún tiempo en función del tamaño de la colección. Para más información sobre las tablas de datos, consulte Modelo de datos de Analytics.

Pausar o deshabilitar Analytics

Si ha actualizado a Azure DevOps Server 2019.1, puede pausar o deshabilitar Analytics para una colección de proyectos con los pasos siguientes. De lo contrario, Azure DevOps Server 2019, las acciones equivalentes son deshabilitar o desinstalar la extensión de Analytics.

Solo puede pausar o deshabilitar Analytics que se ha habilitado previamente.

  1. En la página Configuración de Analytics, seleccione Pausar Analytics o Deshabilitar Analytics.

    Pausar o deshabilitar Analytics

  2. Confirme que desea pausar o deshabilitar el servicio.

    Cuadro de diálogo Confirmar pausa.Confirmación de la deshabilitación

Resume Analytics

Para Azure DevOps Server 2019.1, puede reanudar Analytics después de haberla pausado para una colección de proyectos. La reanudación del servicio volverá a habilitar los trabajos de almacenamiento provisional, lo que actualizará las tablas de datos y las actualizará desde el momento en que se pausaron.

  1. En la página Configuración de Analytics, seleccione Reanudar Análisis.

    Habilitación de Analytics

  2. Confirme que desea reanudar el servicio.

    Cuadro de diálogo Confirmar reanudación.

    Una vez habilitado, los trabajos de almacenamiento provisional de Analytics comienzan a rellenar las tablas de datos de Analytics. Este proceso puede tardar algún tiempo en función del tamaño de la colección.

¿Qué ocurre si deteno o deshabilite Analytics?

Al pausar Analytics o deshabilitar la extensión analytics (2019), se deshabilitan las siguientes características:

Al pausar Analytics se conservan los datos, pero se impide que los trabajos de almacenamiento provisional actualicen los datos. Puede reanudar el servicio más adelante y los datos se actualizarán.

Al deshabilitar Analytics o quitar la extensión analytics (2019), se desactivan todos los trabajos de almacenamiento provisional de Analytics y se eliminan los datos de Analytics almacenados en las tablas de Analytics. Se pierden todos los datos de Analytics que capturan tendencias históricas. No elimina ningún otro dato almacenado en la colección. No es posible deshacer esta acción. Una vez eliminados los datos históricos y los datos actuales, no se pueden restaurar. Volver a habilitar Analytics no restaurará los datos históricos.

Con Analytics deshabilitado o quitado, se producen las siguientes acciones:

  • No se ejecutan trabajos de almacenamiento provisional y las tablas de Analytics no tendrán información actualizada.
  • Se eliminan los datos de tabla y, si Se vuelve a habilitar Analytics, todos los datos tendrán que volver a llenarse desde cero.

Nota:

Deshabilitar Analytics en Azure DevOps Server 2019.1 es lo mismo que desinstalar la extensión analytics para Azure DevOps Server 2019.

Para más información sobre las tablas de datos, consulte Modelo de datos de Analytics.

Instalación de la extensión de Analytics

Si no ha actualizado a Azure DevOps Server 2019.1, puede instalar la extensión analytics para obtener acceso a los widgets e informes de Analytics para la colección de proyectos. La extensión analytics se incluye en el instalador local. La instalación de la extensión simplemente habilita la funcionalidad. No es necesario descargar manualmente los archivos de extensión para instalarlos.

Sugerencia

La extensión Analytics aparece en la galería local de Azure DevOps Server para que no sea necesario descargarla desde Azure DevOps Marketplace.

  1. En un explorador web, seleccione (1) la colección de proyectos, (2) Configuraciónde administración y, a continuación, (3) Extensiones.

    Abrir extensiones de  configuración de administrador de > recopilación

  2. Seleccione Examinar extensiones locales.

    Examinar Marketplace local

    Nota:

    La instalación de la extensión desde marketplace local es idéntica a la instalación desde el marketplace hospedado. La única diferencia es que el marketplace hospedado muestra las clasificaciones de extensión y los comentarios del usuario.

  3. El Marketplace local se abre en una nueva pestaña del explorador. Seleccione la tarjeta de extensión Analytics.

    Tarjeta de extensión de Analytics

  4. Seleccione Obtener gratis.

    Captura de pantalla de la extensión de Marketplace de Analytics, seleccione Obtenerla gratis.

  5. Seleccione la colección de proyectos y, a continuación, seleccione Instalar.

    Selección de la colección de proyectos

  6. Tras la finalización de la instalación, verá una imagen similar a la siguiente. Seleccione Continuar a la recopilación para volver al portal web de la colección.

    Captura de pantalla de la extensión de Marketplace de Analytics instalada, Continuar con la recopilación.

    Opcionalmente, si desea instalar la extensión Analytics en otras colecciones de proyectos, seleccione el botón Atrás del explorador.

Deshabilitación o desinstalación de la extensión de Analytics

Si decide deshabilitar la extensión analytics, impedirá que se ejecuten los trabajos. Los datos de análisis estarán sin sincronizar y las características asociadas no estarán disponibles. Sin embargo, no se elimina ningún dato. Al desinstalar la extensión analytics, se eliminan los datos de las tablas de base de datos de Analytics. Tras volver a instalar la extensión, los datos se vuelven a llenar desde cero.

  1. Abra el menú extensiones y seleccione Administrar extensiones.

    Captura de pantalla de la pestaña Administrar extensiones.

  2. En la pestaña Administrar, abra el menú contextual de la extensión.

    Captura de pantalla del menú contextual de una extensión, Deshabilitar o desinstalar opciones de menú de extensión.

  3. Seleccione Deshabilitar o Desinstalar según sea necesario.

Restauración de la extensión de Analytics si se quita de la implementación

Si quita la extensión analytics de la implementación, puede instalarla desde Marketplace en línea para restaurarla. Es posible que no pueda usar Marketplace en línea debido a la configuración del servidor. Por ejemplo, el firewall podría bloquear algunas conexiones salientes. Incluso si ese es el caso, puede restaurarlo en marketplace local mediante los pasos siguientes.

  1. Abra Configuración de recopilación siguiendo las instrucciones proporcionadas en la sección Instalación de la extensión de Analytics.

    Seleccione Extensiones y,a continuación, Examinar extensiones locales.

  2. Desplácese hasta la parte inferior de la página y seleccione Administrar extensiones.

    Administración de extensiones

  3. Seleccione Upload extensión y, a continuación, haga clic para cargar. Vaya a la carpeta que contiene el archivo Microsoft.TeamFoundation.Extension.Analytics.vsix.

    Upload extensión

    El archivo .vsix se puede encontrar en la instalación de la carpeta del nivel de aplicación en la ruta de acceso siguiente.

    C:\Program Files\Azure DevOps Server 2019\Tools\Deploy\TfsServicingFiles\Extensions\Microsoft.TeamFoundation.Extension.Analytics.vsix

    Al cargar la extensión, se restaura en marketplace local. Desde allí, puede instalarlo en una colección.

¿Cómo determinar si el servidor está desconectado?

Si el servidor está desconectado de Internet, debe instalar Analytics desde Marketplace local.

Puede determinar si el Azure DevOps Server está en estado desconectado. Compruebe si el icono conectado y el nombre del servidor aparecen en la parte superior al examinar marketplace hospedado.

Determinar si el servidor está conectado o no

Cuando se navega a Marketplace desde el servidor local, no se muestra un error si no está conectado. Simplemente cambia al contexto del servicio en la nube.

Problema conocido

Si usa una dirección URL pública para instalar la extensión, por ejemplo , puede obtener un error de devolución de llamada, como un https://OnPrem.MyCompany.com error TLS/SSL.

Para resolver este problema, puede instalar la extensión desde un equipo que hospeda el nivel de aplicación y apuntar a la dirección URL del equipo local, por https://myMachineName ejemplo.