Installer ou activer le service Analytique
Azure DevOps Server 2022 | Azure DevOps Server 2020 | Azure DevOps Server 2019
Pour Azure DevOps Server 2020 et versions ultérieures, le service Analytique est généralement disponible. Elle est automatiquement activée pour toutes les nouvelles collections de projets ajoutées à votre serveur. Pour les collections de projets mises à niveau à partir d’une version précédente, vous devrez peut-être l’activer manuellement. Vous activez Analytique pour chaque collection de projets pour laquelle vous souhaitez générer des rapports Analytique.
Analytique est disponible en préversion pour Azure DevOps Server 2019. Pour Azure DevOps Server 2019, vous installez l’extension Analytique à partir de votre place de marché locale pour chaque collection de projets que vous souhaitez utiliser Analytique. Pour Azure DevOps Server 2019.1, vous activez Analytique pour chaque collection de projets que vous souhaitez utiliser Analytique. Analytique prend en charge
Remarque
L’extension de la Place de marché Analytique et les Analytique ne sont pas prises en charge pour TFS 2018 ou versions antérieures.
Analytique prend en charge l’accès aux widgets Analytique pour tous les projets définis dans la collection de projets. Pour plus d’informations, consultez Qu’est-ce que Analytique ? et les widgets basés sur Analytique. Les données disponibles dans Analytique sont résumées dans Les données disponibles à partir de Analytique.
Prérequis
Pour Azure DevOps Server 2019.1 :
- Vous devez avoir installé et configuré votre serveur Azure DevOps. Pour plus d’informations, consultez Installer et configurer Azure DevOps localement.
- Vous devez avoir ajouté au moins une collection de projets. Pour ajouter des collections de projets, consultez Gérer les collections de projets.
- Pour activer, suspendre, désactiver ou reprendre Analytique, vous devez être membre du groupe Administrateurs de regroupement de projets avec des autorisations d’informations au niveau du regroupement.
Pour Azure DevOps Server 2019 :
- Vous devez avoir installé et configuré votre serveur Azure DevOps. Pour plus d’informations, consultez Installer et configurer Azure DevOps localement.
- Vous devez avoir ajouté au moins une collection de projets. Pour ajouter des collections de projets, consultez Gérer les collections de projets.
- Pour installer une extension, vous devez être membre du groupe Administrateurs de regroupements de projets avec des autorisations d’informations au niveau de la collection Modifier si vous n’avez pas d’autorisations, vous pouvez demander des extensions à la place.
- Pour charger une extension, vous devez être membre du groupe Administrateurs du serveur Azure DevOps avec des autorisations d’informations au niveau de l’instance.
Activer l’analyse
Si vous avez effectué une mise à niveau vers Azure DevOps Server 2019.1, vous pouvez activer Analytique pour une collection de projets en procédant comme suit. Sinon, pour Azure DevOps Server 2019, consultez Installer Analytique.
Remarque
Analytique est automatiquement activé pour toutes les collections de projets nouvellement créées.
Dans un navigateur web, sélectionnez (1) la collection de projets, (2) Paramètres de collection ou Paramètres d’administration, puis (3) Analytique.
Sélectionnez Activer Analytique.
Une fois activé, Analytique travaux intermédiaires commencent à remplir les tables de données Analytique. Ce processus peut prendre un certain temps en fonction de la taille de votre collection. Pour plus d’informations sur les tables de données, consultez Analytique modèle de données.
Suspendre ou désactiver Analytique
Si vous avez effectué une mise à niveau vers Azure DevOps Server 2019.1, vous pouvez suspendre ou désactiver Analytique pour une collection de projets en procédant comme suit. Sinon, pour Azure DevOps Server 2019, les actions équivalentes sont de désactiver ou de désinstaller l’extension Analytique.
Vous pouvez uniquement suspendre ou désactiver Analytique qui a été activé précédemment.
Dans la page des paramètres de Analytique , sélectionnez Suspendre Analytique ou désactiver Analytique.
Vérifiez que vous souhaitez suspendre ou désactiver le service.
Reprendre Analytique
Pour Azure DevOps Server 2019.1, vous pouvez reprendre Analytique une fois que vous l’avez suspendu pour une collection de projets. La reprise du service active à nouveau les travaux intermédiaires, qui mettent à jour les tables de données et les rendent actuelles, mises à jour depuis le moment où elles ont été suspendues.
Dans la page des paramètres de Analytique , sélectionnez Reprendre Analytique.
Vérifiez que vous souhaitez reprendre le service.
Une fois activé, Analytique travaux intermédiaires commencent à remplir les tables de données Analytique. Ce processus peut prendre un certain temps en fonction de la taille de votre collection.
Que se passe-t-il si je suspends ou désactive Analytique ?
La suspension de Analytique ou la désactivation de l’extension Analytique (2019), désactive les fonctionnalités suivantes :
- widgets Analytique
- Analytique rapports dans le contexte, tels que les rapports de pipeline et de test
- Intégration de Power BI à l’aide de vues Analytique
- Requêtes de point de terminaison OData
La mise en pause de l’analytique conserve vos données, mais arrête les travaux intermédiaires de mise à jour de vos données. Vous pouvez reprendre le service ultérieurement et vos données seront ensuite mises à jour.
La désactivation de Analytique ou la suppression de l’extension de Analytique (2019), désactive tous les travaux intermédiaires Analytique et supprime les données Analytique stockées dans les tables Analytique. Toutes les données Analytics qui capturent les tendances historiques sont perdues. Elle ne supprime aucune autre donnée stockée dans votre collection. Vous ne pouvez pas annuler cette action. Une fois les données historiques et les données de tendance supprimées, vous ne pouvez pas les restaurer. La réactivation de Analytics ne restaure pas les données historiques.
Une fois Analytics désactivé ou supprimé, les actions suivantes se produisent :
- Aucun travail intermédiaire n’est exécuté et les tables Analytics n’auront pas d’informations mises à jour.
- Les données de table sont supprimées et, si Analytique est réactivée, toutes les données doivent être reremplies à partir de zéro.
Remarque
La désactivation de Analytique dans Azure DevOps Server 2019.1 est identique à la désinstallation de l’extension Analytique pour Azure DevOps Server 2019.
Pour plus d’informations sur les tables de données, consultez Analytique modèle de données.
Installer l’extension Analytique
Si vous n’avez pas effectué de mise à niveau vers Azure DevOps Server 2019.1, vous pouvez installer l’extension Analytique pour accéder à Analytique widgets et rapports pour votre collection de projets. L’extension Analytique est fournie dans le programme d’installation local. L’installation de l’extension active simplement les fonctionnalités. Il n’est pas nécessaire de télécharger manuellement les fichiers d’extension pour l’installation.
Conseil
L’extension Analytique apparaît dans la galerie locale pour Azure DevOps Server afin qu’il n’y ait pas besoin de la télécharger à partir de la Place de marché Azure DevOps.
Dans un navigateur web, sélectionnez (1) la collection de projets, (2) Paramètres d’administration, puis (3) Extensions.
Sélectionnez Parcourir les extensions locales.
Remarque
L’installation de l’extension à partir de la Place de marché locale est identique à l’installation à partir de la Place de marché hébergée. La seule différence est que la Place de marché hébergée affiche les évaluations d’extension et les commentaires des utilisateurs.
La Place de marché locale s’ouvre dans un nouvel onglet de navigateur. Sélectionnez la carte d’extension Analytique.
Sélectionnez Get it free (Obtenir gratuitement).
Sélectionnez la collection de projets, puis sélectionnez Installer.
Une fois l’installation terminée, vous verrez une image similaire à ce qui suit. Sélectionnez Continuer vers la collection pour revenir au portail web de votre collection.
Si vous souhaitez installer l’extension Analytique sur d’autres collections de projets, sélectionnez le bouton Précédent du navigateur.
Désactiver ou désinstaller l’extension Analytique
Si vous choisissez de désactiver l’extension Analytique, elle empêche l’exécution des travaux. Analytique données ne seront pas synchronisées et les fonctionnalités associées ne seront pas disponibles. Toutefois, aucune donnée n’est supprimée. La désinstallation de l’extension Analytique supprime les données des tables de base de données Analytique. Lors de la réinstallation de l’extension, les données sont reremplies à partir de zéro.
Ouvrez le menu Extensions et sélectionnez Gérer les extensions.
Dans l’onglet Gérer , ouvrez le menu contextuel de l’extension.
Sélectionnez Désactiver ou désinstaller en fonction des besoins.
Restaurer l’extension Analytique si elle est supprimée du déploiement
Si vous supprimez l’extension Analytique de votre déploiement, vous pouvez installer l’extension à partir de la Place de marché en ligne pour la restaurer. Vous ne pouvez peut-être pas utiliser la Place de marché en ligne en raison de la configuration de votre serveur. Par exemple, votre pare-feu peut bloquer certaines connexions sortantes. Même si c’est le cas, vous pouvez le restaurer sur la Place de marché locale en procédant comme suit.
Ouvrez les paramètres de collection en suivant les instructions fournies dans la section Installer l’extension Analytique.
Sélectionnez Extensions, puis parcourez les extensions locales.
Faites défiler jusqu’au bas de la page, puis sélectionnez Gérer les extensions.
Sélectionnez Charger l’extension , puis cliquez sur Charger. Accédez au dossier contenant le fichier Microsoft.TeamFoundation.Extension.Analytique.vsix.
Le fichier .vsix se trouve dans l’installation du dossier de la couche Application dans le chemin d’accès suivant.
C:\Program Files\Azure DevOps Server 2019\Tools\Deploy\TfsServicingFiles\Extensions\Microsoft.TeamFoundation.Extension.Analytics.vsix
Le chargement de l’extension la restaure sur la Place de marché locale. À partir de là, vous pouvez l’installer dans une collection.
Comment déterminer si votre serveur est déconnecté ?
Si votre serveur est déconnecté d’Internet, vous devez installer Analytique à partir de la Place de marché locale.
Vous pouvez déterminer si votre serveur Azure DevOps est dans un état déconnecté. Vérifiez si l’icône connectée et le nom du serveur apparaissent en haut lors de la navigation sur la Place de marché hébergée.
Lorsque vous accédez à la Place de marché à partir de votre serveur local, une erreur ne s’affiche pas si vous n’êtes pas connecté. Il bascule simplement vers le contexte du service cloud.
Problème connu
Si vous utilisez une URL publique pour installer l’extension, par exemple https://OnPrem.MyCompany.com
, vous pouvez obtenir une erreur de rappel, telle qu’une erreur TLS/SSL.
Pour résoudre ce problème, vous pouvez installer l’extension à partir d’un ordinateur qui héberge la couche Application et pointer vers l’URL de l’ordinateur local, par exemple https://myMachineName
.