Installieren oder Aktivieren des Analytics-Diensts

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. Sie wird automatisch für alle neuen Projektsammlungen aktiviert, die Ihrem Server hinzugefügt werden. 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 generieren möchten.

Analytics befindet sich für Azure DevOps Server 2019 in der Vorschauphase. Für Azure DevOps Server 2019 installieren Sie die Analytics-Erweiterung aus 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. Analytics unterstützt

Hinweis

Die Analytics Marketplace-Erweiterung und Analytics 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:

Aktivieren von Analytics

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 für Azure DevOps Server 2019 weitere Informationen unter Installieren von Analysen.

Hinweis

Analytics wird automatisch für alle neu erstellten Projektsammlungen aktiviert.

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

    Öffnen der Sammlung> Admin Einstellungen>Analytics

  2. Wählen Sie Analyse aktivieren aus.

    Aktivieren von Analytics

    Nach der Aktivierung beginnen Analytics-Stagingaufträge mit dem Auffüllen der Analytics-Datentabellen. Dieser Vorgang kann je nach Größe Ihrer Sammlung einige Zeit in Anspruch nehmen. Weitere Informationen zu den Datentabellen finden Sie unter Analysedatenmodell.

Anhalten oder Deaktivieren von Analytics

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 anhalten oder deaktivieren. Andernfalls sind für Azure DevOps Server 2019 die entsprechenden Aktionen das Deaktivieren oder Deinstallieren der Analytics-Erweiterung.

Sie können Analytics nur anhalten oder deaktivieren, die zuvor aktiviert wurde.

  1. Wählen Sie auf der Seite Analytics-Einstellungendie 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 es für eine Projektsammlung angehalten haben. Durch die Fortsetzung des Diensts werden Stagingaufträge wieder aktiviert. Dadurch werden die Datentabellen aktualisiert und aktualisiert, seit er angehalten wurde.

  1. Wählen Sie auf der Seite Analytics-Einstellungen die Option Analyse fortsetzen aus.

    Aktivieren von Analytics

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

    Dialogfeld

    Nach der Aktivierung beginnen Analytics-Stagingaufträge mit dem Auffüllen der Analytics-Datentabellen. Dieser Vorgang kann je nach Größe Ihrer Sammlung einige Zeit in Anspruch nehmen.

Was geschieht, wenn ich Analytics anhält oder deaktiviere?

Wenn Sie Analytics anhalten oder die Analytics-Erweiterung (2019) deaktivieren, 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 Analytics-Erweiterung (2019) werden alle Analytics-Stagingaufträge deaktiviert und die in den Analytics-Tabellen gespeicherten Analytics-Daten gelöscht. Alle Analysedaten, die historische Trends erfassen, sind verloren. Andere daten, die in Ihrer Sammlung gespeichert sind, 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 das erneute Aktivieren 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 wieder aktiviert wird, müssen alle Daten von Grund auf neu aufgefüllt werden.

Hinweis

Das Deaktivieren von Analytics in Azure DevOps Server 2019.1 entspricht der Deinstallation der Analytics-Erweiterung 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 im lokalen Installationsprogramm bereitgestellt. 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 muss.

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

    Öffnen der Sammlung> Admin Einstellungen>Erweiterungen

  2. Wählen Sie Lokale Erweiterungen durchsuchen aus.

    Durchsuchen des lokalen Marketplace

    Hinweis

    Die Installation der Erweiterung aus dem lokalen Marketplace ist identisch mit der Installation aus dem gehosteten Marketplace. Der einzige Unterschied besteht darin, dass der gehostete Marketplace Erweiterungsbewertungen und Benutzerkommentare anzeigt.

  3. Der lokale Marketplace wird in einer neuen Browserregisterkarte geöffnet. Wählen Sie die Karte Analyseerweiterung aus.

    Karte der Analyseerweiterung

  4. Wählen Sie Kostenlos erhalten aus.

    Screenshot der Analytics Marketplace-Erweiterung, Wählen Sie Kostenlos herunterladen aus.

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

    Auswählen der Projektsammlung

  6. Nach Abschluss der Installation wird ein Image ähnlich dem folgenden angezeigt. Wählen Sie Zur Sammlung fortfahren aus, um zum Webportal für Ihre Sammlung zurückzukehren.

    Screenshot der installierten Analytics Marketplace-Erweiterung, Fahren Sie mit der Sammlung fort.

    Wenn Sie die Analytics-Erweiterung in anderen Projektsammlungen installieren möchten, wählen Sie optional die Schaltfläche Zurück im Browser aus.

Deaktivieren oder Deinstallieren der Analytics-Erweiterung

Wenn Sie die Analytics-Erweiterung deaktivieren, werden alle Aufträge nicht ausgeführt. Analysedaten sind nicht synchron, und die zugehörigen Features sind nicht verfügbar. Es werden jedoch keine Daten gelöscht. Beim 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 Erweiterungsmenü, 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 Analytics-Erweiterung, 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. Beispielsweise kann Ihre Firewall einige ausgehende Verbindungen blockieren. Selbst wenn dies der Fall ist, können Sie es mit den folgenden Schritten im lokalen Marketplace wiederherstellen.

  1. Öffnen Sie die Sammlungseinstellungen gemäß den Anweisungen im Abschnitt Installieren der Analytics-Erweiterung.

    Wählen Sie Erweiterungen und dann Lokale Erweiterungen durchsuchen aus.

  2. Scrollen Sie zum unteren Rand der Seite, und wählen Sie Erweiterungen verwalten aus.

    Verwalten von Erweiterungen

  3. Wählen Sie Erweiterung hochladen aus, und klicken Sie dann, um hochzuladen. Navigieren Sie zu dem Ordner, der die Datei Microsoft.TeamFoundation.Extension.Analytics.vsix enthält.

    Upload-Erweiterung

    Die VSIX-Datei finden Sie in Der Installation des Ordners auf Anwendungsebene 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 dem lokalen Marketplace wiederhergestellt. Von dort aus können Sie es in einer Sammlung installieren.

Wie kann ich feststellen, ob der Server getrennt ist?

Wenn Ihr Server vom Internet getrennt ist, müssen Sie Analytics aus dem lokalen Marketplace installieren.

Sie können feststellen, ob sich Ihr Azure DevOps Server in einem getrennten Zustand befindet. Überprüfen Sie beim Durchsuchen des gehosteten Marketplace, ob das verbundene Symbol und der Servername oben angezeigt werden.

Ermitteln, ob Ihr Server verbunden ist oder nicht

Wenn Sie von Ihrem lokalen Server zum Marketplace navigieren, wird kein Fehler angezeigt, wenn Sie nicht verbunden sind. Es wechselt einfach zum Clouddienstkontext.

Bekanntes Problem

Wenn Sie zum Installieren der Erweiterung beispielsweise eine öffentliche URL verwenden, https://OnPrem.MyCompany.comerhalten 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, der die Anwendungsebene hostet und auf die lokale Computer-URL verweisen, z. B https://myMachineName. .