Oprogramowanie ArcGIS Notebook Server zapisuje wszystkie zdarzenia mające miejsce w witrynie, a także wszelkie błędy powiązane z tymi zdarzeniami, posługując się dziennikami. Te dzienniki są dostępne dla administratorów witryny.
Dzienniki są ważnym narzędziem monitorowania i rozwiązywania problemów występujących w witrynie oprogramowania ArcGIS Notebook Server. Informacje zawarte w dziennikach mogą pomóc w identyfikacji problemów i dostarczają kontekstu niezbędnego do rozwiązania problemów i usunięcia błędów. Dzienniki służą także jako system zapisu zdarzeń mających miejsce w witrynie.
Na przykład w dziennikach zapisywane są następujące typy zdarzeń:
- Zdarzenia instalacji i aktualizacji, takie jak autoryzacja oprogramowania i utworzenie witryny
- Otwieranie i zamykanie notatników ArcGIS Notebooks
- Zadania czyszczenia wykonywane przez witrynę
- Zdarzenia zarządzania witryną wykonywane przez administratorów, w tym: dodawanie i usuwanie środowisk wykonawczych notatnika, tworzenie katalogów serwera lub konfiguracja ustawień zabezpieczeń.
- Zdarzenia odnoszące się do zabezpieczeń, takie jak logowanie się w witrynie lub importowanie i eksportowanie certyfikatów SSL.
Niektóre zdarzenia nie są zapisywane w dziennikach oprogramowania ArcGIS Notebook Server. Do takich zdarzeń należy federowanie witryny z portalem. Zdarzenia mające miejsce wewnątrz notatników ArcGIS Notebooks — dodawanie zasobów, uruchamianie komórek itp. — nie są zapisywane. Nie są też zapisywane zdarzenia mające miejsce w kontenerach Docker na komputerze użytkownika. Aby wyświetlić dzienniki charakterystyczne dla kontenera, zapoznaj się z sekcją „Wyświetlanie dzienników kontenerów Docker za pomocą wiersza polecenia platformy Docker” poniżej.
Dostępne poziomy dziennika
Każdy dziennik zawiera w sobie określony poziom szczegółowości dziennika, którym może być jeden z następujących, podanych w kolejności od najmniej szczegółowego do najbardziej szczegółowego:
- Poważne — poważne problemy, które wymagają natychmiastowej interwencji.
- Ostrzeżenie — średniej wagi problemy, które wymagają interwencji.
- Informacja — często pojawiające się komunikaty administracyjne witryny serwera notatników, w tym komunikaty dotyczące utworzenia i uruchomienia usługi.
- Szczegółowe — komunikaty pojawiające się często w trakcie korzystania z serwera, takie jak nazwy operacji odebranych żądań.
- Pełne informacje — komunikaty dostarczające bardziej szczegółowych informacji na temat sposobu wykonywania operacji przez serwer.
- Debugowanie — bardzo szczegółowe komunikaty, przeznaczone dla programistów i pracowników pomocy technicznej chcących w trakcie rozwiązywania problemów dogłębnie zrozumieć stan serwera. Niezalecane do używania w systemach produkcyjnych ze względu na dużą liczbę tworzonych dzienników.
Kody dziennika
Zakresy kodów dziennika są powiązane z określonymi typami komunikatów. Poniższa tabela opisuje zakresy kodów dziennika i ich typ zasobów.
| Zakres kodów dziennika | Zawartość komunikatu |
|---|---|
1000-4999 | Podstawowa struktura ArcGIS Notebook Server |
5000-6999 | Docker SDK i związane z kontenerami |
7000-7200 | Notatniki |
7200-7299 | Narzędzi internetowe notatników |
7300-7399 | Migawka notatnika |
7400-7499 | Fragmenty kodu notatnika |
Wykonywanie zapytań dotyczących dzienników w aplikacji ArcGIS Notebook Server Manager
Aplikacja ArcGIS Notebook Server Manager zawiera stronę Dzienniki. Na tej stronie można tworzyć zapytania dotyczące wszystkich dzienników witryny ArcGIS Notebook Server.
- Zaloguj się do portalu ArcGIS Enterprise jako administrator i otwórz aplikację ArcGIS Notebook Server Manager.
- Otwórz stronę Dzienniki.
- Kliknij przycisk Filtry, aby dostosować filtry w celu doprecyzowania wyszukiwania.
- Kody dziennika — jeden lub większa liczba kodów dziennika przypisanych do komunikatu dziennika. Jeśli pole pozostanie puste, wyświetlane będą wszystkie kody dziennika .
- Użytkownicy — nazwa jednego lub większej liczby użytkowników (rozdzielone przecinkami), których dzienników ma dotyczyć zapytanie. Niektóre komunikaty dziennika są powiązane z działaniem konkretnego użytkownika.
- Identyfikatory żądań — rozdzielana przecinkami lista identyfikatorów żądań serwerów, których dzienników ma dotyczyć zapytanie. Niektóre komunikaty dziennika są powiązane z konkretnym żądaniem.
- Poziom dziennika — minimalny poziom dziennika, którego mogą dotyczyć zapytania (patrz sekcja powyżej). Zwracane są wyłącznie rekordy o podanym lub wyższym poziomie dziennika. Poziom domyślny to WARNING.
- Czas w dzienniku — przedział czasu, z którego pochodzą rekordy wyszukiwane w dziennikach. Zapytanie można ograniczyć do ostatnich 15 minut, ostatniej godziny, ostatnich 6 lub 24 godzin, ostatniego tygodnia lub ostatnich 30 dni. Można też wyświetlić wszystkie dzienniki od momentu utworzenia witryny.
Wskazówka:
Do tworzenia zapytań dotyczących dzienników należy używać aplikacji Administrator Directory, jeśli w zapytaniu ma być określony czas zakończenia inny niż bieżąca data, na przykład w zapytaniu dotyczącym dzienników wygenerowanych trzy i dwa dni temu.
- Komputer — ograniczenie zapytania do dzienników pochodzących z jednego z komputerów ArcGIS Notebook Server lub wyświetlenie dzienników ze wszystkich komputerów.
- Kliknij przycisk Szukaj , aby uruchomić zapytanie. Wszystkie dzienniki zgodne z parametrami zapytania zostaną wyświetlone w tabeli wynikowej.
Zmienianie ustawień dziennika w aplikacji Manager
Za pomocą aplikacji ArcGIS Notebook Server Manager można również zmieniać ustawienia dziennika w witrynie.
- Zaloguj się do portalu ArcGIS Enterprise jako administrator i otwórz aplikację ArcGIS Notebook Server Manager.
- Otwórz stronę Ustawienia i kliknij opcję Dzienniki.
- Możliwa jest zmiana następujących ustawień:
- Katalog dzienników — położenie katalogu dzienników na dysku. Jeśli w witrynie jest wiele komputerów, należy pamiętać, aby określić ścieżkę jako udział UNC.
- Poziom dziennika — najbardziej szczegółowy poziom rejestrowania komunikatów zapisywanych w witrynie. Jeśli na przykład zostanie skonfigurowany poziom FINE, witryna serwera będzie rejestrować komunikaty w dzienniku na poziomach szczegółowości SEVERE, WARNING, INFO oraz FINE i nie będzie przechowywać dzienników na poziomach VERBOSE lub DEBUG.
- Liczba dni przechowywania dzienników — liczba dni, po upływie których komunikaty w dzienniku będą usuwane. Należy wziąć pod uwagę ilość pamięci dostępnej w katalogu dzienników na dysku, a także wybrane ustawienie Poziom dziennika i poziom aktywności w witrynie. Jeśli na przykład poziom rejestrowania zostanie zmieniony na bardziej szczegółowy, może być konieczne zmniejszenie liczby dni przechowywania dzienników.
- Kliknij przycisk Zapisz, aby zatwierdzić zmiany.
Tworzenie zapytań dotyczących dzienników serwera w aplikacji Administrator Directory
Aplikacja ArcGIS Notebook Server Administrator Directory umożliwia przeszukiwanie, przeglądanie, konfigurowanie i usuwanie dzienników serwera.
Aby uzyskać dostęp do tych dzienników, wykonaj następujące czynności:
- Zaloguj się w aplikacji Administrator Directory. Adres URL ma format https://notebookserver.domain.com:11443/arcgis/admin lub https://notebookserver.domain.com/<webadaptorname>/admin.
- Kliknij kolejno opcje Dzienniki > Zapytanie, aby przeszukiwać i przeglądać bieżące dzienniki. Użyj elementów sterujących filtru na stronie pozwalających zawęzić zdarzenia według określonych kryteriów, takich jak okres lub poziom dziennika.
- Kliknij kolejno opcje Dzienniki > Ustawienia, aby zarządzać ustawieniami dziennika, takimi jak domyślny poziom dziennika (jak określono powyżej), okres przechowywania dzienników na dysku i lokalizacja, w której dzienniki są zapisywane.
- Kliknij opcję Wyczyść dzienniki, aby usunąć wszystkie pliki dziennika z witryny oprogramowania ArcGIS Notebook Server.
Wyświetlanie dzienników kontenera Docker w wierszu poleceń Docker
Używając interfejsu wiersza poleceń Docker, możesz wyświetlić dzienniki specyficzne dla kontenerów Docker Twojej witryny w następujący sposób.
- Zaloguj się w aplikacji Administrator Directory. Adres URL ma format https://notebookserver.domain.com:11443/arcgis/admin lub https://notebookserver.domain.com/<webadaptorname>/admin.
- Przejdź do obszaru System > Kontenery. Wyszukaj kontener, którego dzienniki chcesz wyświetlić i kliknij jego identyfikator.
- Otwórz widok JSON strony z informacjami o kontenerze, dodając fragment ?f=pjson do jej adresu URL, tak by adres URL miał następujący format https://notebookserver.arcgis.com/<webadaptorname>/admin/system/containers/<container>?f=pjson.
- Znajdź pozycję containerId kontenera i zanotuj jej wartość.
- Otwórz wiersz polecenia jako użytkownik z uprawnieniami Docker.
- Uruchom polecenie docker logs <containerId>, używając zanotowanej wartości. Zostaną zwrócone dzienniki Docker specyficzne dla tego kontenera.