Installer ou activer le service Analytics

  • Article

Azure DevOps Server 2022 | Azure DevOps Server 2020 | Azure DevOps Server 2019

Pour Azure DevOps Server 2020 et versions ultérieures, le service Analytics est en disponibilité générale. Il est automatiquement activé 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 Analytics pour chaque collection de projets pour laquelle vous souhaitez générer des rapports Analytics.

Analytics est disponible en préversion pour Azure DevOps Server 2019. Pour Azure DevOps Server 2019, vous installez l’extension Analytics à partir de votre place de marché locale pour chaque collection de projets que vous souhaitez utiliser Analytics. Pour Azure DevOps Server 2019.1, vous activez Analytics pour chaque collection de projets que vous souhaitez utiliser Analytics. Prise en charge d’Analytics

Notes

L’extension Analytics Marketplace et Analytics ne sont pas prises en charge pour TFS 2018 ou versions antérieures.

Analytics prend en charge l’accès aux widgets Analytics pour tous les projets définis dans la collection de projets. Pour en savoir plus, consultez Qu’est-ce que Analytics ? et Widgets basés sur Analytics. Les données disponibles dans Analytics sont résumées dans Données disponibles à partir de Analytics.

Prérequis

Pour Azure DevOps Server 2019.1 :

Pour Azure DevOps Server 2019 :

Activer Analytics

Si vous avez effectué une mise à niveau vers Azure DevOps Server 2019.1, vous pouvez activer Analytics pour une collection de projets en procédant comme suit. Sinon, pour Azure DevOps Server 2019, consultez Installer Analytics.

Notes

L’analytique est automatiquement activée pour toutes les collections de projets nouvellement créées.

  1. Dans un navigateur web, sélectionnez (1) la collection de projets, (2) Paramètres du regroupement ou paramètres de Administration, puis (3) Analytics.

    Ouvrir la collection> Administration paramètres>Analytics

  2. Sélectionnez Activer Analytics.

    Activer Analytics

    Une fois activés, les travaux intermédiaires Analytics commencent à remplir les tables de données Analytics. Ce processus peut prendre un certain temps en fonction de la taille de votre collection. Pour en savoir plus sur les tables de données, consultez Modèle de données Analytics.

Suspendre ou désactiver Analytics

Si vous avez effectué une mise à niveau vers Azure DevOps Server 2019.1, vous pouvez suspendre ou désactiver Analytics pour une collection de projets en procédant comme suit. Sinon, pour Azure DevOps Server 2019, les actions équivalentes sont Désactiver ou désinstaller l’extension Analytics.

Vous pouvez uniquement suspendre ou désactiver l’analytique qui a été activée précédemment.

  1. Dans la page Paramètres d’analyse , sélectionnez Suspendre l’analytique ou Désactiver l’analyse.

    Suspendre ou désactiver l’analytique

  2. Vérifiez que vous souhaitez suspendre ou désactiver le service.

    Boîte de dialogue Confirmer la pause.Confirmer la désactivation

Reprendre l’analyse

Pour Azure DevOps Server 2019.1, vous pouvez reprendre Analytics après l’avoir suspendu pour une collection de projets. La reprise du service réactivera les travaux intermédiaires, ce qui mettra à jour les tables de données et les rendra à jour et mises à jour depuis la mise en pause.

  1. Dans la page Paramètres d’analyse , sélectionnez Reprendre l’analyse.

    Activer Analytics

  2. Vérifiez que vous souhaitez reprendre le service.

    Boîte de dialogue Confirmer la reprise.

    Une fois activés, les travaux intermédiaires Analytics commencent à remplir les tables de données Analytics. 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 Analytics ?

La suspension de l’analytique ou la désactivation de l’extension Analytics (2019) désactive les fonctionnalités suivantes :

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 Analytics ou la suppression de l’extension Analytics (2019), désactive tous les travaux intermédiaires Analytics et supprime les données Analytics stockées dans les tables Analytics. Toutes les données Analytics qui capturent les tendances historiques sont perdues. Il 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 d’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 Analytics est réactivé, toutes les données devront être remplies à nouveau à partir de zéro.

Notes

La désactivation de Analytics dans Azure DevOps Server 2019.1 revient à désinstaller l’extension Analytics pour Azure DevOps Server 2019.

Pour en savoir plus sur les tables de données, consultez Modèle de données Analytics.

Installer l’extension Analytics

Si vous n’avez pas effectué la mise à niveau vers Azure DevOps Server 2019.1, vous pouvez installer l’extension Analytics pour accéder aux widgets et aux rapports Analytics pour votre collection de projets. L’extension Analytics est fournie dans le programme d’installation local. L’installation de l’extension active simplement la fonctionnalité. Il n’est pas nécessaire de télécharger manuellement les fichiers d’extension pour l’installer.

Conseil

L’extension Analytics apparaît dans la galerie locale pour Azure DevOps Server afin qu’il ne soit pas nécessaire de la télécharger à partir de la Place de marché Azure DevOps.

  1. Dans un navigateur web, sélectionnez (1) la collection de projets, (2) Administration paramètres, puis (3) Extensions.

    Ouvrir la collection> Administration paramètres>Extensions

  2. Sélectionnez Parcourir les extensions locales.

    Parcourir la Place de marché locale

    Notes

    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.

  3. La Place de marché locale s’ouvre dans un nouvel onglet de navigateur. Sélectionnez l’extension Analytics carte.

    Carte de l’extension Analytics

  4. Sélectionnez Get it free (Obtenir gratuitement).

    Capture d’écran de l’extension Analytics Marketplace, sélectionnez Obtenir gratuitement.

  5. Sélectionnez la collection de projets, puis sélectionnez Installer.

    Sélectionner la collection de projets

  6. Une fois l’installation terminée, vous verrez une image similaire à ce qui suit. Sélectionnez Continuer à la collection pour revenir au portail web de votre collection.

    Capture d’écran de l’extension De la Place de marché Analytics installée, Passez à la collecte.

    Si vous souhaitez installer l’extension Analytics sur d’autres collections de projets, sélectionnez le bouton Précédent du navigateur.

Désactiver ou désinstaller l’extension Analytics

Si vous choisissez de désactiver l’extension Analytics, l’exécution de tous les travaux sera arrêtée. Les données d’analyse ne sont pas synchronisées et les fonctionnalités associées ne sont pas disponibles. Toutefois, aucune donnée n’est supprimée. La désinstallation de l’extension Analytics supprime les données des tables de base de données Analytics. Lors de la réinstallation de l’extension, les données sont remplies à nouveau à partir de zéro.

  1. Ouvrez le menu extensions et sélectionnez Gérer les extensions.

    Capture d’écran de l’onglet Gérer les extensions.

  2. Sous l’onglet Gérer , ouvrez le menu contextuel de l’extension.

  3. Sélectionnez Désactiver ou désinstaller en fonction des besoins.

Restaurer l’extension Analytics si elle a été supprimée du déploiement

Si vous supprimez l’extension Analytics de votre déploiement, vous pouvez installer l’extension à partir de la Place de marché en ligne pour la restaurer. Vous ne pourrez 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.

  1. Ouvrez Paramètres de collection en suivant les instructions fournies dans la section Installer l’extension Analytics.

    Sélectionnez Extensions, puis Parcourir les extensions locales.

  2. Faites défiler jusqu’au bas de la page, puis sélectionnez Gérer les extensions.

    Gérer les extensions

  3. Sélectionnez Charger l’extension , puis cliquez pour charger. Accédez au dossier contenant le fichier Microsoft.TeamFoundation.Extension.Analytics.vsix.

    Charger l’extension

    Le fichier .vsix se trouve dans l’installation de votre 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 Analytics à partir de la Place de marché locale.

Vous pouvez déterminer si votre Azure DevOps Server 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.

Déterminer si votre serveur est connecté ou non

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.