De Analytics-service installeren of inschakelen

  • Artikel

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

Voor Azure DevOps Server 2020 en latere versies is de Analytics-service algemeen beschikbaar. Deze functie wordt automatisch ingeschakeld voor alle nieuwe projectverzamelingen die aan uw server zijn toegevoegd. Voor projectverzamelingen die zijn bijgewerkt vanaf een eerdere versie, moet u deze mogelijk handmatig inschakelen. U schakelt Analyse in voor elke projectverzameling waarvoor u Analytics-rapporten wilt genereren.

Analytics is in preview voor Azure DevOps Server 2019. Voor Azure DevOps Server 2019 installeert u de Analytics-extensie vanuit uw lokale marketplace voor elke projectverzameling die u Analytics wilt gebruiken. Voor Azure DevOps Server 2019.1 schakelt u Analyse in voor elke projectverzameling die u Analytics wilt gebruiken. Analyse ondersteunt

Notitie

De Analytics Marketplace-extensie en Analytics worden niet ondersteund voor TFS 2018 of eerdere versies.

Analytics biedt ondersteuning voor toegang tot Analytics-widgets voor alle projecten die zijn gedefinieerd in de projectverzameling. Zie Wat is Analyse? en Widgets op basis van Analyse voor meer informatie. Gegevens die beschikbaar zijn in Analytics worden samengevat in Gegevens die beschikbaar zijn vanuit Analytics.

Vereisten

Voor Azure DevOps Server 2019.1:

Voor Azure DevOps Server 2019:

Analyse inschakelen

Als u een upgrade hebt uitgevoerd naar Azure DevOps Server 2019.1, kunt u Analyse inschakelen voor een projectverzameling met de volgende stappen. Zie Analytics installeren voor Azure DevOps Server 2019.

Notitie

Analyse wordt automatisch ingeschakeld voor alle nieuw gemaakte projectverzamelingen.

  1. Selecteer in een webbrowser (1) de projectverzameling, (2) Verzamelingsinstellingen of Beheer-instellingen en vervolgens (3) Analyse.

    Verzameling openen> Beheer instellingen>Analytics

  2. Selecteer Analyse inschakelen.

    Analyse inschakelen

    Zodra deze optie is ingeschakeld, beginnen de analytics-gegevenstabellen te worden gevuld met faseringstaken van Analytics. Dit proces kan enige tijd duren, afhankelijk van de grootte van uw verzameling. Zie Gegevensmodel analyseren voor meer informatie over de gegevenstabellen.

Analyse onderbreken of uitschakelen

Als u een upgrade hebt uitgevoerd naar Azure DevOps Server 2019.1, kunt u Analytics voor een projectverzameling onderbreken of uitschakelen door de volgende stappen uit te voeren. Anders zijn de vergelijkbare acties voor Azure DevOps Server 2019 het uitschakelen of verwijderen van de Analytics-extensie.

U kunt analyse alleen onderbreken of uitschakelen die eerder is ingeschakeld.

  1. Selecteer op de pagina Analyse-instellingende optie Analyse onderbreken of Analyse uitschakelen.

    Analyse onderbreken of uitschakelen

  2. Bevestig dat u de service wilt onderbreken of uitschakelen.

    Dialoogvenster Onderbreken bevestigen.Uitschakelen bevestigen

Analyse hervatten

Voor Azure DevOps Server 2019.1 kunt u De analyse hervatten nadat u deze hebt onderbroken voor een projectverzameling. Als u de service hervat, worden faseringstaken opnieuw ingeschakeld, waardoor de gegevenstabellen worden bijgewerkt en bijgewerkt sinds het tijdstip waarop deze is onderbroken.

  1. Selecteer op de pagina Analyse-instellingende optie Analyse hervatten.

    Analyse inschakelen

  2. Bevestig dat u de service wilt hervatten.

    Dialoogvenster Hervatten bevestigen.

    Zodra deze optie is ingeschakeld, beginnen de analytics-gegevenstabellen te worden gevuld met faseringstaken van Analytics. Dit proces kan enige tijd duren, afhankelijk van de grootte van uw verzameling.

Wat gebeurt er als ik Analytics onderbreek of uitschakel?

Als u De analyse onderbroken of de Analytics-extensie (2019) uitschakelt, worden de volgende functies uitgeschakeld:

Als u Analytics onderbroken, blijven uw gegevens behouden, maar wordt het bijwerken van uw gegevens door faseringstaken gestopt. U kunt de service later hervatten, waarna uw gegevens worden bijgewerkt.

Als u Analytics uitschakelt of de Analytics-extensie (2019) verwijdert, worden alle Faseringstaken van Analytics uitgeschakeld en worden de Analytics-gegevens verwijderd die zijn opgeslagen in de Analytics-tabellen. Alle analysegegevens die historische trends vastleggen, gaan verloren. Er worden geen andere gegevens verwijderd die in uw verzameling zijn opgeslagen. U kunt deze actie niet ongedaan maken. Zodra historische gegevens en trending gegevens zijn verwijderd, kunt u deze niet meer herstellen. Als u Analytics opnieuw inschakelt, worden de historische gegevens niet hersteld.

Als Analytics is uitgeschakeld of verwijderd, worden de volgende acties uitgevoerd:

  • Er worden geen faseringstaken uitgevoerd en de Analytics-tabellen bevatten geen bijgewerkte informatie.
  • Tabelgegevens worden verwijderd en als Analytics opnieuw wordt ingeschakeld, moeten alle gegevens opnieuw worden ingevuld.

Notitie

Het uitschakelen van Analytics in Azure DevOps Server 2019.1 is hetzelfde als het verwijderen van de Analytics-extensie voor Azure DevOps Server 2019.

Zie Gegevensmodel analyseren voor meer informatie over de gegevenstabellen.

De Analytics-extensie installeren

Als u geen upgrade hebt uitgevoerd naar Azure DevOps Server 2019.1, kunt u de Analytics-extensie installeren om toegang te krijgen tot Analytics-widgets en -rapporten voor uw projectverzameling. De Analytics-extensie wordt geleverd in het on-premises installatieprogramma. Als u de extensie installeert, wordt de functionaliteit gewoon ingeschakeld. Het is niet nodig om extensiebestanden handmatig te downloaden om te installeren.

Tip

De Analytics-extensie wordt weergegeven in de lokale galerie voor Azure DevOps Server, zodat u deze niet hoeft te downloaden van de Azure DevOps Marketplace.

  1. Selecteer in een webbrowser (1) de projectverzameling, (2) Beheer instellingen en vervolgens (3) Extensies.

    Verzameling openen> Beheer instellingen>Extensies

  2. Selecteer Bladeren door lokale extensies.

    Bladeren door lokale marketplace

    Notitie

    Het installeren van de extensie vanuit de lokale marketplace is identiek aan het installeren vanuit de gehoste marketplace. Het enige verschil is dat de gehoste marketplace extensiebeoordelingen en gebruikersopmerkingen weergeeft.

  3. De lokale Marketplace wordt geopend in een nieuw browsertabblad. Selecteer de kaart Analytics-extensie.

    Analyse-extensiekaart

  4. Selecteer Gratis downloaden.

    Schermopname van de Analytics Marketplace-extensie, selecteer Gratis downloaden.

  5. Selecteer de projectverzameling en selecteer vervolgens Installeren.

    Selecteer de projectverzameling

  6. Na voltooiing van de installatie ziet u een installatiekopieën die er ongeveer als volgt uitzien. Selecteer Doorgaan naar verzameling om terug te keren naar de webportal voor uw verzameling.

    Schermopname van de Analytics Marketplace-extensie geïnstalleerd, Ga naar verzameling.

    Als u de Analytics-extensie op andere projectverzamelingen wilt installeren, selecteert u desgewenst de knop Terug in de browser.

De Analytics-extensie uitschakelen of verwijderen

Als u ervoor kiest om de Analytics-extensie uit te schakelen, worden alle taken niet meer uitgevoerd. Analysegegevens zijn niet gesynchroniseerd en de bijbehorende functies zijn niet beschikbaar. Er worden echter geen gegevens verwijderd. Als u de Analytics-extensie verwijdert, worden de gegevens uit de Analytics-databasetabellen verwijderd. Bij het opnieuw installeren van de extensie worden de gegevens helemaal opnieuw ingevuld.

  1. Open het menu extensies en selecteer Extensies beheren.

    Schermopname van het tabblad Extensies beheren.

  2. Open op het tabblad Beheren het snelmenu voor de extensie.

  3. Selecteer Uitschakelen of Verwijderen indien vereist.

De Analytics-extensie herstellen als deze uit de implementatie is verwijderd

Als u de Analytics-extensie uit uw implementatie verwijdert, kunt u de extensie installeren vanuit de onlinemarktplaats om deze te herstellen. Mogelijk kunt u de onlinemarktplaats niet gebruiken vanwege de installatie van uw server. Uw firewall kan bijvoorbeeld bepaalde uitgaande verbindingen blokkeren. Zelfs als dat het geval is, kunt u deze herstellen naar de lokale marketplace met behulp van de volgende stappen.

  1. Open Verzamelingsinstellingen volgens de instructies in de sectie De Analytics-extensie installeren.

    Selecteer Extensies en vervolgens Door lokale extensies bladeren.

  2. Schuif naar de onderkant van de pagina en selecteer Extensies beheren.

    Extensies beheren

  3. Selecteer Extensie uploaden en selecteer vervolgens klik om te uploaden. Blader naar de map met het bestand Microsoft.TeamFoundation.Extension.Analytics.vsix.

    Extensie uploaden

    Het .vsix-bestand vindt u in de mapinstallatie van de toepassingslaag in het volgende pad.

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

    Als u de extensie uploadt, wordt deze hersteld naar de lokale marketplace. Van daaruit kunt u deze installeren in een verzameling.

Hoe kan ik bepalen of de verbinding met de server is verbroken?

Als de verbinding van uw server met internet is verbroken, moet u Analytics installeren vanuit de lokale marketplace.

U kunt bepalen of uw Azure DevOps Server de status Verbroken heeft. Controleer of het verbonden pictogram en de servernaam bovenaan worden weergegeven wanneer u door de gehoste marketplace bladert.

Bepalen of uw server is verbonden of niet

Wanneer u vanaf uw on-premises server naar Marketplace navigeert, wordt er geen fout weergegeven als u geen verbinding hebt. Er wordt gewoon overgeschakeld naar de cloudservicecontext.

Bekend probleem

Als u bijvoorbeeld https://OnPrem.MyCompany.comeen openbare URL gebruikt om de extensie te installeren, krijgt u mogelijk een callback-fout, zoals een TLS/SSL-fout.

U kunt dit probleem oplossen door de extensie te installeren vanaf een computer die als host fungeert voor de toepassingslaag en naar de URL van de lokale computer te verwijzen, bijvoorbeeld https://myMachineName.