Installieren oder Aktivieren des Analysediensts
Azure DevOps Server 2022 | Azure DevOps Server 2020 | Azure DevOps Server 2019
Für Azure DevOps Server 2020 und höhere Versionen ist der Analysedienst allgemein verfügbar und automatisch für alle neuen Projektsammlungen aktiviert, die Ihrem Server hinzugefügt wurden. Für Projektsammlungen, die von einer früheren Version aktualisiert wurden, müssen Sie sie möglicherweise manuell aktivieren. Sie aktivieren Analytics für jede Projektsammlung, für die Sie Analyseberichte erstellen möchten.
Analytics befindet sich in der Vorschau für Azure DevOps Server 2019. Für Azure DevOps Server 2019 installieren Sie die Analyseerweiterung von Ihrem lokalen Marketplace für jede Projektsammlung, die Sie analytics verwenden möchten. Für Azure DevOps Server 2019.1 aktivieren Sie Analytics für jede Projektsammlung, die Sie verwenden möchten. Analyse unterstützt
Hinweis
Die Analytics Marketplace-Erweiterung und -Analyse werden für TFS 2018 oder frühere Versionen nicht unterstützt .
Analytics unterstützt den Zugriff auf Analytics-Widgets für alle Projekte, die in der Projektsammlung definiert sind. Weitere Informationen finden Sie unter Was ist Analytics? und Widgets basierend auf Analytics. Daten, die in Analytics verfügbar sind, werden in Daten zusammengefasst, die in Analytics verfügbar sind.
Voraussetzungen
Für Azure DevOps Server 2019.1 und höher:
- Lassen Sie Azure DevOps Server installiert und konfiguriert.
- Verfügen Sie über eine Projektsammlung.
- Berechtigungen: Um Analysen zu aktivieren, anzuhalten, zu deaktivieren oder fortzusetzen, gehören Sie der Gruppe "Projektsammlungsadministratoren" mit Berechtigungen zum Bearbeiten von Informationsberechtigungen auf Sammlungsebene an.
Für Azure DevOps Server 2019:
- Lassen Sie Azure DevOps Server installiert und konfiguriert.
- Verfügen Sie über eine Projektsammlung.
- Berechtigungen:
- Mitglied der Gruppe "Projektsammlungsadministratoren " mit der Berechtigung "Informationen auf Sammlungsebene bearbeiten". Wenn Sie nicht über Berechtigungen verfügen, können Sie stattdessen Erweiterungen anfordern.
- Um eine Erweiterung hochzuladen, müssen Sie Mitglied der Azure DevOps Server-Administratorgruppe mit der Berechtigung "Informationen auf Instanzebene bearbeiten" sein.
Analytik aktivieren
Wenn Sie ein Upgrade auf Azure DevOps Server 2019.1 durchgeführt haben, können Sie Analytics für eine Projektsammlung mit den folgenden Schritten aktivieren. Andernfalls finden Sie informationen zu Azure DevOps Server 2019 unter Install Analytics.
Hinweis
Analysen werden automatisch für alle neu erstellten Projektsammlungen aktiviert.
Wählen Sie in einem Webbrowser (1) die Projektsammlung, (2) Sammlungseinstellungen oder Administratoreinstellungen und dann (3) Analytics aus.
Wählen Sie "Analyse aktivieren" aus.
Nach der Aktivierung beginnen Analytics-Stagingaufträge mit dem Auffüllen der Analysedatentabellen. Dieser Vorgang kann je nach Größe der Sammlung einige Zeit in Anspruch nehmen. Weitere Informationen zu den Datentabellen finden Sie unter Analysedatenmodell.
Anhalten oder Deaktivieren von Analysen
Wenn Sie ein Upgrade auf Azure DevOps Server 2019.1 durchgeführt haben, können Sie Die Analyse für eine Projektsammlung mit den folgenden Schritten anhalten oder deaktivieren. Andernfalls gelten für Azure DevOps Server 2019 die entsprechenden Aktionen zum Deaktivieren oder Deinstallieren der Analytics-Erweiterung.
Sie können zuvor aktivierte Analysen nur anhalten oder deaktivieren.
Wählen Sie auf der Seite "Analyseeinstellungen " die Option "Analyse anhalten " oder "Analyse deaktivieren" aus.
Vergewissern Sie sich, dass Sie den Dienst anhalten oder deaktivieren möchten.
Resume Analytics
Für Azure DevOps Server 2019.1 können Sie Analytics fortsetzen, nachdem Sie sie für eine Projektsammlung angehalten haben. Durch das Fortsetzen des Diensts werden Stagingaufträge wieder aktiviert, mit denen die Datentabellen aktualisiert und aktualisiert werden, seit der Zeit, zu der sie angehalten wurden.
Wählen Sie auf der Seite "Analyseeinstellungen " die Option "Analyse fortsetzen" aus.
Vergewissern Sie sich, dass Sie den Dienst fortsetzen möchten.
Nach der Aktivierung beginnen Analytics-Stagingaufträge mit dem Auffüllen der Analysedatentabellen. Dieser Vorgang kann je nach Größe der Sammlung einige Zeit in Anspruch nehmen.
Was geschieht, wenn ich Analytics angehalten oder deaktiviere?
Wenn Sie die Analyseerweiterung (2019) anhalten oder deaktivieren, werden die folgenden Features deaktiviert:
- Analyse-Widgets
- Analyse von Kontextberichten wie Pipeline- und Testberichten
- Power BI-Integration mit Analyseansichten
- OData-Endpunktabfragen
Das Anhalten von Analytics behält Ihre Daten bei, verhindert jedoch, dass Stagingaufträge Ihre Daten aktualisieren. Sie können den Dienst später und dann ihre Datenaktualisierungen fortsetzen.
Wenn Sie die Analytics-Erweiterung (2019) deaktivieren oder entfernen, werden alle Analytics-Stagingaufträge deaktiviert und die Analytics-Daten gelöscht, die in den Analytics-Tabellen gespeichert sind. Alle Analysedaten, die historische Trends erfassen, sind verloren. Andere in Ihrer Sammlung gespeicherte Daten werden nicht gelöscht. Dieser Vorgang kann nicht rückgängig gemacht werden. Nachdem Verlaufsdaten und Trenddaten gelöscht wurden, können Sie sie nicht mehr wiederherstellen. Durch erneutes Aktivieren von Analytics werden die historischen Daten nicht wiederhergestellt.
Wenn Analytics deaktiviert oder entfernt wurde, werden die folgenden Aktionen ausgeführt:
- Es werden keine Stagingaufträge ausgeführt, und die Analysetabelleninformationen werden nicht aktualisiert.
- Tabellendaten werden gelöscht, und wenn Analytics erneut aktiviert ist, müssen alle Daten von Grund auf neu aufgefüllt werden.
Hinweis
Das Deaktivieren von Analysen in Azure DevOps Server 2019.1 entspricht der Deinstallation der Analyseerweiterung für Azure DevOps Server 2019.
Weitere Informationen zu den Datentabellen finden Sie unter Analysedatenmodell.
Installieren der Analytics-Erweiterung
Wenn Sie kein Upgrade auf Azure DevOps Server 2019.1 durchgeführt haben, können Sie die Analytics-Erweiterung installieren, um Zugriff auf Analytics-Widgets und -Berichte für Ihre Projektsammlung zu erhalten. Die Analytics-Erweiterung wird innerhalb des lokalen Installationsprogramms ausgeliefert. Durch die Installation der Erweiterung wird einfach die Funktionalität aktiviert. Es ist nicht erforderlich, Erweiterungsdateien manuell herunterzuladen, um sie zu installieren.
Tipp
Die Analyseerweiterung wird im lokalen Katalog für Azure DevOps Server angezeigt, sodass sie nicht aus dem Azure DevOps Marketplace heruntergeladen werden müssen.
Wählen Sie in einem Webbrowser (1) die Projektsammlung, (2) Administratoreinstellungen und dann (3) Erweiterungen aus.
Wählen Sie "Lokale Erweiterungen durchsuchen" aus.
Hinweis
Die Installation der Erweiterung vom lokalen Marketplace ist identisch mit der Installation vom gehosteten Marketplace. Der einzige Unterschied besteht darin, dass der gehostete Marketplace Erweiterungsbewertungen und Benutzerkommentare anzeigt.
Der lokale Marketplace wird auf einer neuen Browserregisterkarte geöffnet. Wählen Sie die Analyseerweiterungskarte aus.
Wählen Sie Kostenlos erhalten aus.
Wählen Sie die Projektsammlung und dann "Installieren" aus.
Nach Abschluss der Installation wird ein Bild ähnlich der folgenden Anzeige angezeigt. Wählen Sie "Weiter zur Sammlung " aus, um zum Webportal für Ihre Sammlung zurückzukehren.
Wenn Sie die Analyseerweiterung optional in anderen Projektsammlungen installieren möchten, wählen Sie die Schaltfläche "Browser zurück" aus.
Deaktivieren oder Deinstallieren der Analyseerweiterung
Wenn Sie die Analyseerweiterung deaktivieren, werden alle Aufträge nicht mehr ausgeführt. Analysedaten sind nicht synchron, und die zugehörigen Features sind nicht verfügbar. Es werden jedoch keine Daten gelöscht. Durch das Deinstallieren der Analytics-Erweiterung werden die Daten aus den Analytics-Datenbanktabellen gelöscht. Nach der Neuinstallation der Erweiterung werden die Daten von Grund auf neu aufgefüllt.
Öffnen Sie das Menü "Erweiterungen", und wählen Sie "Erweiterungen verwalten" aus.
Öffnen Sie auf der Registerkarte "Verwalten " das Kontextmenü für die Erweiterung.
Wählen Sie nach Bedarf "Deaktivieren" oder "Deinstallieren" aus.
Wiederherstellen der Analyseerweiterung, wenn sie aus der Bereitstellung entfernt wurde
Wenn Sie die Analytics-Erweiterung aus Ihrer Bereitstellung entfernen, können Sie die Erweiterung aus dem Online-Marketplace installieren, um sie wiederherzustellen. Möglicherweise können Sie den Online-Marketplace aufgrund Ihrer Servereinrichtung nicht verwenden. Ihre Firewall kann z. B. einige ausgehende Verbindungen blockieren. Selbst wenn dies der Fall ist, können Sie sie mithilfe der folgenden Schritte auf dem lokalen Marketplace wiederherstellen.
Open Collection settings following the instructions in the section Install the Analytics extension.
Wählen Sie Erweiterungen aus, und durchsuchen Sie dann lokale Erweiterungen.
Scrollen Sie nach unten auf der Seite, und wählen Sie "Erweiterungen verwalten" aus.
Wählen Sie "Erweiterung hochladen" aus, und klicken Sie dann auf "Hochladen". Navigieren Sie zu dem Ordner, der die Datei "Microsoft.TeamFoundation.Extension.Analytics.vsix" enthält.
Die VSIX-Datei befindet sich in Der Installation des Ordners "application-tier" im folgenden Pfad.
C:\Program Files\Azure DevOps Server 2019\Tools\Deploy\TfsServicingFiles\Extensions\Microsoft.TeamFoundation.Extension.Analytics.vsixDurch das Hochladen der Erweiterung wird sie auf den lokalen Marketplace wiederhergestellt. Von dort aus können Sie es in einer Sammlung installieren.
Wie kann ermittelt werden, ob der Server getrennt ist?
Wenn Ihr Server vom Internet getrennt ist, müssen Sie Analytics vom lokalen Marketplace installieren.
Sie können feststellen, ob sich Ihr Azure DevOps Server in einem getrennten Zustand befindet. Überprüfen Sie, ob das verbundene Symbol und der Servername beim Durchsuchen des gehosteten Marketplace oben angezeigt werden.
Wenn Sie vom lokalen Server zum Marketplace navigieren, wird kein Fehler angezeigt, wenn Sie nicht verbunden sind. Sie wechselt einfach zum Clouddienstkontext.
Bekanntes Problem
Wenn Sie eine öffentliche URL verwenden, um die Erweiterung zu installieren, https://OnPrem.MyCompany.comz. B. erhalten Sie möglicherweise einen Rückruffehler, z. B. einen TLS/SSL-Fehler.
Um dieses Problem zu beheben, können Sie die Erweiterung von einem Computer installieren, auf dem die Anwendungsebene gehostet wird, und auf die URL des lokalen Computers verweisen, z https://myMachineName. B. .