Freigeben über


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. Es ist 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:

Für Azure DevOps Server 2019:

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.

  1. Wählen Sie in einem Webbrowser (1) die Projektsammlung, (2) Sammlungseinstellungen oder Administratoreinstellungen und dann (3) Analytics aus.

    Analyse der Einstellungen des Sammlungsadministrators>>öffnen

  2. Wählen Sie "Analyse aktivieren" aus.

    Analytik aktivieren

    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 analysen, die zuvor aktiviert wurden, nur anhalten oder deaktivieren.

  1. Wählen Sie auf der Seite "Analyseeinstellungen " die Option "Analyse anhalten " oder "Analyse deaktivieren" aus.

    Anhalten oder Deaktivieren von Analysen

  2. Vergewissern Sie sich, dass Sie den Dienst anhalten oder deaktivieren möchten.

    Dialogfeld Deaktivieren bestätigen

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, wodurch die Datentabellen aktualisiert und aktualisiert werden, seit der Zeit, an der sie angehalten wurden.

  1. Wählen Sie auf der Seite "Analyseeinstellungen " die Option "Analyse fortsetzen" aus.

    Analytik aktivieren

  2. Vergewissern Sie sich, dass Sie den Dienst fortsetzen möchten.

    Dialogfeld

    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?

Durch Anhalten von Analytics oder Deaktivieren der Analytics-Erweiterung (2019) werden die folgenden Features deaktiviert:

Das Anhalten von Analytics behält Ihre Daten bei, verhindert jedoch, dass Stagingaufträge Ihre Daten aktualisieren. Sie können den Dienst später fortsetzen, und Ihre Daten werden dann aktualisiert.

Durch Deaktivieren von Analytics oder Entfernen der Analyseerweiterung (2019) werden alle Analytics-Stagingaufträge deaktiviert und die in den Analytics-Tabellen gespeicherten Analysedaten gelöscht. 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 die erneute Aktivierung von Analytics werden die Verlaufsdaten nicht wiederhergestellt.

Wenn Analytics deaktiviert oder entfernt wurde, werden die folgenden Aktionen ausgeführt:

  • Es werden keine Stagingaufträge ausgeführt, und die Analytics-Tabellen enthalten keine aktualisierten Informationen.
  • 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.

  1. Wählen Sie in einem Webbrowser (1) die Projektsammlung, (2) Administratoreinstellungen und dann (3) Erweiterungen aus.

    Erweiterungen für Einstellungen des>Sammlungsadministrators>öffnen

  2. Wählen Sie "Lokale Erweiterungen durchsuchen" aus.

    Durchsuchen des lokalen Marketplace

    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.

  3. Der lokale Marketplace wird auf einer neuen Browserregisterkarte geöffnet. Wählen Sie die Analyseerweiterungskarte aus.

    Analyseerweiterungskarte

  4. Wählen Sie Kostenlos erhalten aus.

    Screenshot der Analytics Marketplace-Erweiterung, Wählen Sie

  5. Wählen Sie die Projektsammlung und dann "Installieren" aus.

    Auswählen der Projektsammlung

  6. Nach Abschluss der Installation sehen Sie ein Bild ähnlich dem folgenden. Wählen Sie "Weiter zur Sammlung " aus, um zum Webportal für Ihre Sammlung zurückzukehren.

    Screenshot der installierten Analytics Marketplace-Erweiterung, Weiter zur Sammlung.

    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 werden nicht synchronisiert, 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.

  1. Öffnen Sie das Menü "Erweiterungen", und wählen Sie "Erweiterungen verwalten" aus.

    Screenshot der Registerkarte

  2. Öffnen Sie auf der Registerkarte "Verwalten " das Kontextmenü für die Erweiterung.

  3. 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.

  1. Open Collection settings following the instructions in the section Install the Analytics extension.

    Wählen Sie Erweiterungen aus, und durchsuchen Sie dann lokale Erweiterungen.

  2. Scrollen Sie nach unten auf der Seite, und wählen Sie "Erweiterungen verwalten" aus.

    Verwalten von Erweiterungen

  3. 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.

    Upload-Erweiterung

    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.vsix

    Durch 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.

Ermitteln, ob ihr Server verbunden ist oder nicht

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 beispielsweise eine öffentliche URL zum Installieren der Erweiterung https://OnPrem.MyCompany.comverwenden, 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. .