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 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 de Marketplace de Analytics y Analytics no se admiten para TFS 2018 ni 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:

  • Debe haber instalado y configurado el Azure DevOps Server. Para más información, consulte Instalación y configuración Azure DevOps local.
  • Debe haber agregado al menos una colección de proyectos. Para agregar colecciones de proyectos, vea Administrar colecciones de proyectos.
  • Para instalar una extensión, debe ser miembro del grupo de administradores de recopilación de Project con permisos Editar información de nivel de colección Si no tiene permisos, puede solicitar extensiones en su lugar.
  • Para cargar una extensión, debe ser miembro del grupo administradores de Azure DevOps Server con permisos editar información de nivel de instancia.

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, 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 después (3) Analytics.

    Open Collection>Admin settings>Analytics

  2. Seleccione Habilitar Analytics.

    Enable Analytics

    Una vez habilitados, 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 análisis o Deshabilitar Analytics.

    Pause or Disable Analytics

  2. Confirme que desea pausar o deshabilitar el servicio.

    Confirm Pause dialog.Confirm Disable

Reanudar análisis

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 detuvo.

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

    Enable Analytics

  2. Confirme que desea reanudar el servicio.

    Confirm Resume dialog.

    Una vez habilitados, 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 pausa o deshabilite Analytics?

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

La pausa de Analytics conserva los datos, pero 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 de tendencia, no se pueden restaurar. Al volver a habilitar Analytics, no se restaurarán los datos históricos.

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

  • No se ejecutan trabajos de ensayo 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 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 administrador y, a continuación, (3) Extensiones.

    Open Collection>Admin settings>Extensions

  2. Seleccione Examinar extensiones locales.

    Browse local marketplace

    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 marketplace hospedado muestra las clasificaciones de extensión y los comentarios del usuario.

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

    Analytics extension card

  4. Seleccione Obtener gratis.

    Screenshot of Analytics Marketplace extension, Select Get it free.

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

    Select the project collection

  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.

    Screenshot of Analytics Marketplace extension installed, Proceed to collection.

    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.

    Screenshot of Manage extensions tab.

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

    Screenshot of context menu for an extension, Disable or uninstall an extension menu options.

  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.

    Manage extensions

  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 extension

    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.

Determining if your server is connected or not

Al navegar 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.