Instalación o habilitación del servicio Analytics
Azure DevOps Server 2022 | Azure DevOps Server 2020 | Azure DevOps Server 2019
Para Azure DevOps Server 2020 y versiones posteriores, el servicio Analytics está disponible con carácter general y se habilita automáticamente para todas las colecciones de proyectos nuevas agregadas al servidor. En el caso de las colecciones de proyectos actualizadas desde una versión anterior, es posible que tenga que habilitarla manualmente. Habilite Analytics para cada colección de proyectos para la que desea generar informes de Analytics.
Analytics está en versión preliminar para Azure DevOps Server 2019. Para Azure DevOps Server 2019, instale la extensión Analytics desde el marketplace local para cada colección de proyectos que quiera usar Analytics. Para Azure DevOps Server 2019.1, habilite Analytics para cada colección de proyectos que quiera usar Analytics. Analytics admite
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 obtener más información, consulte ¿Qué es Analytics? y Widgets basados en Analytics. Los datos disponibles en Analytics se resumen en Datos disponibles en Analytics.
Requisitos previos
Para Azure DevOps Server 2019.1 y versiones posteriores:
- Tener instalado y configurado Azure DevOps Server.
- Tener una colección de proyectos.
- Permisos: para habilitar, pausar, deshabilitar o reanudar Analytics, sea miembro del grupo Administradores de la colección de proyectos con permisos editar información de nivel de colección.
Para Azure DevOps Server 2019:
- Tener instalado y configurado Azure DevOps Server.
- Tener una colección de proyectos.
- Permisos:
- Ser miembro del grupo Administradores de colecciones de proyectos con el permiso Editar información de nivel de colección. Si no tiene permisos, puede solicitar extensiones en su lugar.
- Para cargar una extensión, sea miembro del grupo Administradores de Azure DevOps Server con el permiso Editar información de nivel de instancia.
Habilitar análisis
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.
En un explorador web, seleccione (1) la colección de proyectos, (2) Configuración de recopilación o Configuración de administración y, a continuación, (3) Analytics.
Seleccione Habilitar análisis.
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 análisis.
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, para Azure DevOps Server 2019, las acciones equivalentes son deshabilitar o desinstalar la extensión analytics.
Solo puede pausar o deshabilitar análisis habilitados anteriormente.
En la página Configuración de Analytics , seleccione Pausar análisis o Deshabilitar análisis.
Confirme que desea pausar o deshabilitar el servicio.
Reanudación de Analytics
Para Azure DevOps Server 2019.1, puede reanudar Analytics después de pausarlo para una colección de proyectos. Reanudar el servicio vuelve a habilitar los trabajos de almacenamiento provisional, que actualizan las tablas de datos y las convierten en actuales, actualizando desde el momento en que se ha pausado.
En la página Configuración de Analytics , seleccione Reanudar análisis.
Confirme que desea reanudar el servicio.
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 pausa o deshabilito Analytics?
Al pausar o deshabilitar la extensión analytics (2019), se deshabilitan las siguientes características:
- Widgets de análisis
- Informes en contexto de análisis, como los informes de canalización y pruebas
- Integración de Power BI mediante vistas de Analytics
- Consultas de punto de conexión de OData
Pausar Analytics conserva los datos, pero impide que los trabajos de almacenamiento provisional actualicen los datos. Puede reanudar el servicio más adelante y, a continuación, actualizar los datos.
Al deshabilitar o quitar la extensión analytics (2019), desactiva todos los trabajos de almacenamiento provisional de Analytics y elimina los datos de Analytics almacenados en las tablas de Analytics. Todos los datos de Analytics que capturan tendencias históricas se pierden. 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 puede restaurar. Volver a habilitar Analytics no restaura los datos históricos.
Con Analytics deshabilitado o quitado, se producen las siguientes acciones:
- No se ejecutan trabajos de ensayo y la información de las tablas de Analytics no se actualiza.
- Los datos de tabla se eliminan y, si Analytics se vuelve a habilitar, todos los datos deben volver a rellenarse desde cero.
Nota:
Deshabilitar Analytics en Azure DevOps Server 2019.1 es el 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 análisis.
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 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 archivos de extensión manualmente para instalar.
Sugerencia
La extensión Analytics aparece en la galería local de Azure DevOps Server para que no sea necesario descargarla desde Marketplace de Azure DevOps.
En un explorador web, seleccione (1) la colección de proyectos, (2) Configuración de administrador y, a continuación, (3) Extensiones.
Seleccione Examinar extensiones locales.
Nota:
La instalación de la extensión desde marketplace local es idéntica a la instalación desde marketplace hospedado. La única diferencia es que marketplace hospedado muestra clasificaciones de extensiones y comentarios de usuario.
El Marketplace local se abre en una nueva pestaña del explorador. Seleccione la tarjeta de extensión analytics.
Seleccione Obtener gratis.
Seleccione la colección de proyectos y, a continuación, seleccione Instalar.
Tras la finalización de la instalación, se muestra una imagen similar a la siguiente. Seleccione Continuar a la recopilación para volver al portal web de la colección.
Opcionalmente, si desea instalar la extensión Analytics en otras colecciones de proyectos, seleccione el botón Atrás del explorador.
Deshabilitar o desinstalar la extensión de Analytics
Si decide deshabilitar la extensión analytics, impide que se ejecuten los trabajos. Los datos de análisis no están sincronizados y las características asociadas no está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 repoblan desde cero.
Abra el menú de extensiones y seleccione Administrar extensiones.
En la pestaña Administrar , abra el menú contextual de la extensión.
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 instalar la extensión desde el 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 el marketplace local mediante los pasos siguientes.
Abra Configuración de recopilación siguiendo las instrucciones proporcionadas en la sección Instalación de la extensión analytics.
Seleccione Extensiones y, a continuación , Examinar extensiones locales.
Desplácese hasta la parte inferior de la página y seleccione Administrar extensiones.
Seleccione Cargar extensión y, a continuación, haga clic en para cargar. Vaya a la carpeta que contiene el archivo Microsoft.TeamFoundation.Extension.Analytics.vsix.
El archivo .vsix se puede encontrar en la instalación de la carpeta de nivel de aplicación en la siguiente ruta de acceso.
C:\Program Files\Azure DevOps Server 2019\Tools\Deploy\TfsServicingFiles\Extensions\Microsoft.TeamFoundation.Extension.Analytics.vsix
La carga de la extensión la 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 servidor de Azure DevOps está en un estado desconectado. Compruebe si el icono conectado y el nombre del servidor aparecen en la parte superior al examinar el marketplace hospedado.
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 https://OnPrem.MyCompany.com
, podría obtener un error de devolución de llamada, como un error TLS/SSL.
Para resolver este problema, puede instalar la extensión desde un equipo que hospede el nivel de aplicación y apunte a la dirección URL del equipo local, por ejemplo https://myMachineName
.