Instalowanie lub włączanie usługi Analytics

  • Artykuł

Azure DevOps Server 2022 r. | Azure DevOps Server 2020 r. | Azure DevOps Server 2019 r.

W przypadku wersji Azure DevOps Server 2020 i nowszych usługa Analytics jest ogólnie dostępna. Jest ona automatycznie włączona dla wszystkich nowych kolekcji projektów dodanych do serwera. W przypadku kolekcji projektów uaktualnionych z poprzedniej wersji może być konieczne ręczne jej włączenie. Możesz włączyć usługę Analytics dla każdej kolekcji projektów, dla której chcesz wygenerować raporty analizy.

Analiza jest dostępna w wersji zapoznawczej dla Azure DevOps Server 2019 r. W przypadku Azure DevOps Server 2019 r. należy zainstalować rozszerzenie Analytics z lokalnej platformy handlowej dla każdej kolekcji projektów, której chcesz użyć usługi Analytics. W przypadku Azure DevOps Server 2019.1 włączysz usługę Analytics dla każdej kolekcji projektów, której chcesz użyć usługi Analytics. Usługa Analytics obsługuje

Uwaga

Rozszerzenie usługi Analytics Marketplace i analiza nie są obsługiwane w przypadku wersji TFS 2018 lub starszych.

Analiza obsługuje dostęp do widżetów analizy dla wszystkich projektów zdefiniowanych w kolekcji projektów. Aby dowiedzieć się więcej, zobacz Co to jest analiza? i widżety oparte na analizie. Dane dostępne w usłudze Analytics są podsumowane w obszarze Dane dostępne w usłudze Analytics.

Wymagania wstępne

Dla Azure DevOps Server 2019.1:

W przypadku Azure DevOps Server 2019 r.:

Włączanie analizy

Jeśli przeprowadzono uaktualnienie do wersji Azure DevOps Server 2019.1, możesz włączyć usługę Analytics dla kolekcji projektów, wykonując następujące kroki. W przeciwnym razie w przypadku Azure DevOps Server 2019 zobacz Instalowanie analizy.

Uwaga

Analiza jest automatycznie włączona dla wszystkich nowo utworzonych kolekcji projektów.

  1. W przeglądarce internetowej wybierz (1) kolekcję projektów, (2) Ustawienia kolekcji lub ustawienia Administracja, a następnie (3) Analiza.

    Otwórz analizę kolekcji> Administracja ustawienia>

  2. Wybierz pozycję Włącz analizę.

    Włączanie analizy

    Po włączeniu zadania przejściowe analizy zaczynają wypełniać tabele danych analizy. Ten proces może zająć trochę czasu w zależności od rozmiaru kolekcji. Aby dowiedzieć się więcej o tabelach danych, zobacz Model danych analizy.

Wstrzymywanie lub wyłączanie analizy

Jeśli przeprowadzono uaktualnienie do wersji Azure DevOps Server 2019.1, możesz wstrzymać lub wyłączyć usługę Analytics dla kolekcji projektów, wykonując następujące kroki. W przeciwnym razie w przypadku Azure DevOps Server 2019 równoważne akcje to Wyłączenie lub odinstalowanie rozszerzenia Analiza.

Możesz wstrzymać lub wyłączyć usługę Analytics, która została wcześniej włączona.

  1. Na stronie Ustawienia analizy wybierz pozycję Wstrzymaj analizę lub Wyłącz analizę.

    Wstrzymywanie lub wyłączanie analizy

  2. Upewnij się, że chcesz wstrzymać lub wyłączyć usługę.

    Potwierdź wstrzymanie okna dialogowego.Potwierdź wyłączenie

Wznów analizę

W przypadku Azure DevOps Server 2019.1 możesz wznowić analizę po wstrzymaniu jej dla kolekcji projektów. Wznowienie usługi spowoduje ponowne włączenie zadań przejściowych, co spowoduje zaktualizowanie tabel danych i zaktualizowanie ich do bieżącej aktualizacji od czasu wstrzymania.

  1. Na stronie Ustawienia analizy wybierz pozycję Wznów analizę.

    Włączanie analizy

  2. Upewnij się, że chcesz wznowić usługę.

    Potwierdź wznawianie okna dialogowego.

    Po włączeniu zadania przejściowe analizy zaczynają wypełniać tabele danych analizy. Ten proces może zająć trochę czasu w zależności od rozmiaru kolekcji.

Co się stanie, jeśli wstrzymam lub wyłączę analizę?

Wstrzymując analizę lub wyłączając rozszerzenie Analytics (2019), wyłącza następujące funkcje:

Wstrzymując analizę zachowuje dane, ale uniemożliwia przejściowe zadania przed aktualizowaniem danych. Możesz wznowić usługę później, a dane zostaną zaktualizowane.

Wyłączenie usługi Analytics lub usunięcie rozszerzenia Analiza (2019) powoduje wyłączenie wszystkich zadań przejściowych analizy i usunięcie danych analizy przechowywanych w tabelach analizy. Wszystkie dane analizy, które przechwytują trendy historyczne, zostaną utracone. Nie usuwa żadnych innych danych przechowywanych w kolekcji. Nie można cofnąć tej akcji. Po usunięciu danych historycznych i popularnych danych nie można go przywrócić. Ponowne włączanie analizy nie spowoduje przywrócenia danych historycznych.

W przypadku wyłączenia lub usunięcia analizy są wykonywane następujące akcje:

  • Nie są uruchamiane żadne zadania przejściowe, a tabele analizy nie będą zawierać zaktualizowanych informacji.
  • Dane tabeli zostaną usunięte, a jeśli usługa Analytics zostanie ponownie włączona, wszystkie dane będą musiały zostać ponownie wypełniane od podstaw.

Uwaga

Wyłączenie usługi Analytics w Azure DevOps Server 2019.1 jest takie samo jak odinstalowywanie rozszerzenia Analytics dla Azure DevOps Server 2019 r.

Aby dowiedzieć się więcej o tabelach danych, zobacz Model danych analizy.

Instalowanie rozszerzenia analizy

Jeśli nie uaktualniono do wersji Azure DevOps Server 2019.1, możesz zainstalować rozszerzenie Analytics, aby uzyskać dostęp do widżetów i raportów analizy dla kolekcji projektów. Rozszerzenie Analytics jest dostarczane w instalatorze lokalnym. Zainstalowanie rozszerzenia umożliwia po prostu włączenie funkcji. Nie ma potrzeby ręcznego pobierania plików rozszerzeń do zainstalowania.

Porada

Rozszerzenie Analytics jest wyświetlane w lokalnej galerii dla Azure DevOps Server, aby nie było potrzeby pobierania jej z witryny Azure DevOps Marketplace.

  1. W przeglądarce internetowej wybierz (1) kolekcję projektów, (2) Administracja ustawienia, a następnie (3) Rozszerzenia.

    Otwórz kolekcję> Administracja ustawienia>Rozszerzenia

  2. Wybierz pozycję Przeglądaj rozszerzenia lokalne.

    Przeglądaj lokalną platformę handlową

    Uwaga

    Instalowanie rozszerzenia z lokalnej platformy handlowej jest identyczne z instalacją z hostowanej platformy handlowej. Jedyną różnicą jest to, że hostowana platforma handlowa wyświetla oceny rozszerzeń i komentarze użytkowników.

  3. Lokalna witryna Marketplace zostanie otwarta na nowej karcie przeglądarki. Wybierz kartę rozszerzenia Analiza.

    Karta rozszerzenia analizy

  4. Wybierz pozycję Pobierz bezpłatnie.

    Zrzut ekranu przedstawiający rozszerzenie Witryny Marketplace usługi Analytics i wybierz pozycję Pobierz bezpłatnie.

  5. Wybierz kolekcję projektów, a następnie wybierz pozycję Zainstaluj.

    Wybieranie kolekcji projektów

  6. Po zakończeniu instalacji zobaczysz obraz podobny do poniższego. Wybierz pozycję Kontynuuj do kolekcji, aby powrócić do portalu internetowego kolekcji.

    Zrzut ekranu przedstawiający zainstalowane rozszerzenie usługi Analytics Marketplace, Przejdź do kolekcji.

    Opcjonalnie, jeśli chcesz zainstalować rozszerzenie Analytics w innych kolekcjach projektów, wybierz przycisk Wstecz przeglądarki.

Wyłączanie lub odinstalowywanie rozszerzenia analizy

Jeśli zdecydujesz się wyłączyć rozszerzenie analizy, spowoduje to zatrzymanie uruchamiania wszystkich zadań. Dane analityczne nie będą zsynchronizowane, a skojarzone funkcje nie będą dostępne. Jednak żadne dane nie są usuwane. Odinstalowanie rozszerzenia Analytics powoduje usunięcie danych z tabel bazy danych usługi Analytics. Po ponownym zainstalowaniu rozszerzenia dane są ponownie wypełniane od podstaw.

  1. Otwórz menu rozszerzenia i wybierz pozycję Zarządzaj rozszerzeniami.

    Zrzut ekranu przedstawiający kartę Zarządzanie rozszerzeniami.

  2. Na karcie Zarządzanie otwórz menu skrótów rozszerzenia.

  3. Wybierz pozycję Wyłącz lub Odinstaluj zgodnie z potrzebami.

Przywracanie rozszerzenia Analizy w przypadku usunięcia z wdrożenia

Jeśli usuniesz rozszerzenie Analizy z wdrożenia, możesz zainstalować rozszerzenie z witryny Marketplace online, aby je przywrócić. Być może nie możesz użyć witryny Marketplace online ze względu na konfigurację serwera. Na przykład zapora może blokować niektóre połączenia wychodzące. Nawet jeśli tak jest, możesz przywrócić go do lokalnej platformy handlowej, wykonując następujące kroki.

  1. Otwórz ustawienia kolekcji zgodnie z instrukcjami podanymi w sekcji Instalowanie rozszerzenia analizy.

    Wybierz pozycję Rozszerzenia, a następnie przeglądaj rozszerzenia lokalne.

  2. Przewiń do dołu strony i wybierz pozycję Zarządzaj rozszerzeniami.

    Zarządzanie rozszerzeniami

  3. Wybierz pozycję Przekaż rozszerzenie , a następnie kliknij, aby przekazać. Przejdź do folderu zawierającego plik Microsoft.TeamFoundation.Extension.Analytics.vsix.

    Przekazywanie rozszerzenia

    Plik vsix można znaleźć w instalacji folderu warstwy aplikacji w następującej ścieżce.

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

    Przekazanie rozszerzenia spowoduje przywrócenie go do lokalnej platformy handlowej. W tym miejscu możesz zainstalować ją w kolekcji.

Jak określić, czy serwer jest odłączony?

Jeśli serwer jest odłączony od Internetu, musisz zainstalować usługę Analytics z lokalnej platformy handlowej.

Możesz określić, czy Azure DevOps Server jest w stanie rozłączenia. Sprawdź, czy ikona połączenia i nazwa serwera są wyświetlane u góry podczas przeglądania hostowanej platformy handlowej.

Określanie, czy serwer jest połączony, czy nie

Po przejściu do witryny Marketplace z serwera lokalnego błąd nie jest wyświetlany, jeśli nie masz połączenia. Po prostu przełącza się do kontekstu usługi w chmurze.

Znany problem

Jeśli używasz publicznego adresu URL do zainstalowania rozszerzenia, na przykład https://OnPrem.MyCompany.com, może zostać wyświetlony błąd wywołania zwrotnego, taki jak błąd TLS/SSL.

Aby rozwiązać ten problem, możesz zainstalować rozszerzenie z maszyny, która hostuje warstwę aplikacji, i wskazać adres URL komputera lokalnego, na przykład https://myMachineName.