Monitor stanu zdrowia

Enterprise Server zawiera kompleksowy system monitorowania kondycji, który pozwala administratorom szybko określić i przeanalizować stan, czyli „kondycję” (health) Enterprise Server. Monitor kondycji jest dostępny z poziomu sekcji Admin w interfejsie przeglądarkowym Workspace (strona Server Health) albo jako samodzielne narzędzie wykonywalne dołączone do instalacji Enterprise Server na komputerze-hoscie (narzędzie Server Health Monitor).

Funkcja kondycji zapewnia wizualne podsumowanie stanu konfiguracji i usług Enterprise Server, informacje o zasobach systemowych maszyny hosta, a także dostęp do raportów stanu i plików dziennika. Daje to natychmiastowy wgląd w status Enterprise Server, co pozwala administratorom z wyprzedzeniem wykrywać i rozwiązywać problemy, które mogą wpływać na użytkowników Workspace.

Każde podejście do monitorowania kondycji i statusu Enterprise Server ma własną, odrębną zaletę:

• Server Health page – jako część interfejsu przeglądarkowego Workspace Enterprise Server, strona Server Health jest dostępna dla administratorów w sieci lokalnej, co zapewnia wygodę zdalnego dostępu.
• Server Health Monitor tool – samodzielny plik wykonywalny Health Monitor (avhealth.exe) jest dostępny niezależnie od stanu Enterprise Server, a zatem dostarczy kluczowych danych i informacji w mało prawdopodobnym przypadku, gdy Enterprise Server nie działa w pełni poprawnie.

Strona Server Health

W interfejsie przeglądarkowym Workspace wybierz Admin – Health w menu głównym, aby przejść do strony raportowania Server Health, która wskaże ogólny status instalacji Enterprise Server według znacznika czasu widocznego w górnej sekcji Status strony (Updated at: <timestamp>).

Strona Server Health zapewnia natychmiastowy podgląd statusu Enterprise Server oraz jego infrastruktury wspierającej.

Oprócz szybkiego wizualnego podsumowania kondycji serwera strona udostępnia także następujące funkcje:

• Możliwość wygenerowania raportu stanu do wysłania do działu wsparcia Altium (a ostatecznie do deweloperów Altium). Aby to zrobić, kliknij część Generate tekstu Generate status report for support team w obszarze Status strony – wymagane raporty zostaną wygenerowane i zebrane w jednym archiwum Zip (vault_status_report_<Date>.zip), a następnie pobrane do domyślnego folderu pobierania przeglądarki.

• Możliwość pobrania wszystkich plików logów – zawierających wpisy Error i Warning ze wszystkich dostępnych plików logów serwera, które zwykle znajdują się w folderze \ProgramData\Altium\Altium365Data\logs. Aby to zrobić, kliknij łącze Download all logs w sekcji Logs strony. Pliki zostaną zebrane w jedno archiwum Zip (AllLogs.zip) i pobrane do domyślnego folderu pobierania przeglądarki.

• Użyj łącza Clear logs (znajdującego się na dole sekcji Logs strony), aby zarchiwizować, a następnie usunąć wszystkie istniejące pliki logów. Archiwum (logs_<Date>.zip) zostanie zapisane w folderze \ProgramData\Altium\Altium365Data\logs.archive.

• Informacje na stronie Server Health są okresowo aktualizowane (zgodnie ze znacznikiem czasu Status), ale aktualizację można też wymusić na żądanie. Aby ręcznie odświeżyć status serwera, kliknij łącze refresh status w obszarze Status strony. Kondycja serwera i systemu zostanie sprawdzona, a strona odświeżona zgodnie z bieżącym stanem. Data i godzina odzwierciedlają ostatni moment sprawdzenia kondycji serwera.

  Kliknij łącze odświeżania, aby zaktualizować informacje o kondycji Enterprise Server.

  Zwróć uwagę, że po instalacji Enterprise Server pierwsze sprawdzenie kondycji serwera następuje około 5 minut po wejściu na stronę Health . Możesz wykonać ręczne odświeżenie, aby przeprowadzić kontrolę wcześniej. Kolejne automatyczne sprawdzanie odbywa się co 4 godziny.

Błędy i ostrzeżenia

Jako wyróżnione podsumowanie statusu Enterprise Server, strona Server Health prezentuje wyraźne ikony ostrzeżeń/błędów oraz powiązane opisy dla wpisów statusu budzących zastrzeżenia. Typowe alerty obejmują zaległe kopie zapasowe danych, zbliżające się wygaśnięcie licencji, aktywne konto użytkownika admin/admin lub wykryte wpisy błędów w pliku logu:

• OK  – wykryte metryki mieszczą się w akceptowalnym zakresie lub spełniają warunek.
• Warning  – Enterprise Server i jego infrastruktura wspierająca działają poprawnie, ale zalecana jest zmiana, aby rozwiązać potencjalny lub przyszły problem.
• Error  – część Enterprise Server lub jego infrastruktury wspierającej nie działa lub nie jest poprawnie skonfigurowana i wymaga natychmiastowej uwagi.

Korygowanie typowych problemów

O ile problemy z wydajnością i systemem najczęściej rozwiązuje się poprzez zwiększenie dostępnych zasobów i poprawę infrastruktury komputera-hosta Enterprise Server, o tyle problemy w sekcji Environment and configuration strony Server Health można zazwyczaj usunąć, korzystając z funkcji i narzędzi dostępnych dla administratorów Workspace:

• Admin password – utwórz jedno lub więcej dedykowanych kont administratora na stronie Users, jeśli jeszcze tego nie zrobiono, oraz zmień hasło (a najlepiej także nazwę użytkownika) domyślnego konta admin.

• Log level – w razie potrzeby zmień poziom logowania Enterprise Server, edytując wpis LogLevel= w sekcji General pliku LocalVault.ini, znajdującego się w folderze instalacyjnym Enterprise Server na komputerze-hoscie. Dozwolone poziomy to Info (domyślny) oraz Warn. Przy tej drugiej opcji ogólne informacje o stanie (wywołania API, uruchamianie i zatrzymywanie usług itp.) nie będą uwzględniane w plikach logów – błędy są zawsze rejestrowane.

• Licenses – błąd dotyczący zbliżającego się wygaśnięcia licencji Enterprise Server usuwa się na stronie Licenses w interfejsie przeglądarkowym (Admin – Licenses). Licencję, która już wygasła, można naprawić, uzyskując dostęp do interfejsu przeglądarkowego na komputerze-hoście Enterprise Server.

• Backups – kopię zapasową Workspace backup można wykonać za pomocą narzędzia avbackup.exe, dostępnego w folderze Tools\BackupTool w ramach instalacji Enterprise Server na komputerze-hoscie.

Raporty i logi

Wydajność zarówno Enterprise Server, jak i komputera-hosta jest testowana i podsumowywana (w sekcjach Performance i System), a logi raportów są udostępniane do generowania i pobierania:

• Logs – logi Enterprise Server są pobierane jako archiwum zip do domyślnej lokalizacji pobierania przeglądarki (Download all logs). Obejmują one logi tekstowe dla wszystkich usług hostowanych przez Enterprise Server, przy czym plik logu każdej usługi zawiera zdarzenia zależne od czasu (oraz błędy) od momentu instalacji Enterprise Server lub od wyczyszczenia logów (Clear logs).
• Reports – raport stanu Enterprise Server jest pobierany jako archiwum zip do domyślnej lokalizacji pobierania przeglądarki (wywoływany łączem Generate w górnej sekcji Status strony). Raportuje on stan kondycji i konfigurację wszystkich kluczowych elementów Enterprise Server. Raporty, przeznaczone jako kluczowe informacje dla zespołów wsparcia Altium, zawierają także informacje o stanie i wydajności infrastruktury wspierającej na komputerze-hoście.

Narzędzie Health Monitor

Instalacja Enterprise Server zawiera kompleksowe narzędzie On-Prem Enterprise Server Health Monitor, które pozwala administratorom szybko określić i przeanalizować stan, czyli „kondycję” (health) Enterprise Server na poziomie lokalnym. Dostarczane jako samodzielna, niezależna aplikacja wraz z instalacją Enterprise Server, Health Monitor zapewnia wizualne podsumowanie stanu maszyny hosta oraz konfiguracji i usług Enterprise Server. Interfejs zawiera również podpowiedzi kontekstowe, a także informacje i ścieżki do ważnych lokalizacji i plików logów.

Health Monitor prezentuje informacje o statusie Enterprise Server w prostym GUI i ogólnie obejmuje następujące krytyczne obszary:

• Enterprise Server Environment – stan sprzętu komputera-hosta, taki jak dyski twarde, pamięć, CPU oraz adekwatność jego wydajności.
• Enterprise Server Backend – stan wspierającej bazy danych, magazynu plików i repozytorium Enterprise Server.
• Enterprise Server Services – stan zestawu usług Enterprise Server, hostowanych jako pule aplikacji IIS (IIS Application Pools), takich jak usługi Identity, Authorization, License Manager oraz Network Installation.

Dostęp do narzędzia

W domyślnej instalacji Enterprise Server narzędzie Health Monitor można znaleźć w folderze \Program Files (x86)\Altium\Altium365\Tools\HealthMonitor jako plik wykonywalny avhealth.exe. Zwróć uwagę, że folder zawiera także uproszczone narzędzie wiersza poleceń: avConsoleHealth.exe.

Po uruchomieniu narzędzia GUI Health Monitor (avhealth.exe) program natychmiast odpytuje Enterprise Server i systemy hostujące, aby wypełnić główny ekran Health Monitor Dashboard – wybrany (domyślnie) w górnych zakładkach. Kliknij przycisk Refresh (), aby ponownie uruchomić proces i zaktualizować ekran.

GUI Health Monitor Dashboard zapewnia natychmiastowy podgląd statusu Enterprise Server i jego infrastruktury wspierającej, a także łącza do dodatkowych informacji.

Błędy i ostrzeżenia

Status każdego elementu na pulpicie (Dashboard) jest wskazywany komunikatem i powiązaną ikoną:

• OK  – wykryte metryki mieszczą się w akceptowalnym zakresie lub spełniają warunek.
• Warning  – Enterprise Server i jego infrastruktura wspierająca działają poprawnie, ale zalecana jest zmiana, aby rozwiązać potencjalny lub przyszły problem.
• Error  – część Enterprise Server lub jego infrastruktury wspierającej nie działa poprawnie i wymaga natychmiastowej uwagi.

Najedź kursorem na status elementu, aby uzyskać więcej informacji. Dla błędu lub ostrzeżenia widocznego na pulpicie (Dashboard) dalsze szczegóły są (w większości przypadków) dostępne po kliknięciu wpisu statusu dla danego elementu.

Najedź na wpis statusu, aby uzyskać bardziej szczegółowe informacje.

Łącza kontekstowe

Wiele warunków Error/Warning wykrywanych przez Health Monitor oferuje łącza mające pomóc w rozwiązaniu sytuacji. Są one zawarte w szczegółowych informacjach elementu, dostępnych po kliknięciu jego wpisu statusu.

    
Gdy występują typowe problemy ze zdarzeniami, powiązane informacje dostarczają dodatkowych szczegółów i łączy pomagających rozwiązać dany problem.

W powyższym przykładzie ekranu po lewej stronie Health Monitor wykrył, że nie wykonano kopii zapasowej Enterprise Server. Powiązane informacje zawierają łącze do dokumentacji, która pomoże rozwiązać tę sytuację.

Przykładowy ekran po prawej stronie (powyżej) wskazuje, że nadal istnieją domyślne dane logowania do Enterprise Server (admin/admin), co stanowi istotne ryzyko bezpieczeństwa. Łącze Fix It w powiązanych informacjach zapewnia bezpośredni dostęp do strony logowania Enterprise Server przez interfejs przeglądarki, gdzie można skorygować profile użytkowników Administratora.

Log Browser

Ekran Log Browser w Health Monitor, dostępny z poziomu karty Log Browser, prezentuje wpisy Error i Warning ze wszystkich dostępnych plików logów Enterprise Server – zwykle znajdujących się w folderze C:\ProgramData\Altium\Altium365Data\logs. Aby wyświetlić plik logu zawierający dany wpis zdarzenia, wybierz powiązane łącze Open file  lub po prostu kliknij dwukrotnie sam wpis.

Zbiorcze wpisy zdarzeń na liście są pogrupowane według daty i obejmują wszystkie dostępne zdarzenia Error/Warning ze wszystkich plików logów. Aby znaleźć konkretne zdarzenia, wybierz przedział czasu z menu rozwijanego Show logs i/lub użyj dynamicznego pola filtra (), aby wyszukać słowa kluczowe w kolumnach Subsystem i Message.

Interfejs Log Browser umożliwia zawężenie wyników do interesujących zdarzeń przy użyciu wybieranego przedziału czasu oraz filtrowania po słowach kluczowych.

Wybierz przycisk , aby usunąć zgromadzone wpisy logów z listy Log Browser – spowoduje to zarchiwizowanie, a następnie usunięcie wszystkich istniejących plików logów.

Status Report

Ekran Status Report w Health Monitor, dostępny z poziomu karty Status Report, służy do tworzenia i wyświetlania plików raportów stanu Enterprise Server. Wygenerowane raporty zestawiają wszystkie informacje debugowania zdarzeń w jednym archiwum Zip (*.zip), które w razie potrzeby można przesłać do Altium Developers.

Aby utworzyć raport, wybierz odpowiedni przedział czasu zdarzeń z menu rozwijanego Include Logs, wprowadź swoje dane kontaktowe i wybierz umowę udostępniania, a następnie rozpocznij proces przyciskiem .

Użyj ekranu Status Report, aby generować zbiorcze pliki raportów logów do celów debugowania.