Aplikacja 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 aplikacji 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 aplikacji 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ą również zapisywane zdarzenia mające miejsce w kontenerach Docker na komputerze użytkownika. Aby wyświetlić dzienniki specyficzne dla kontenera, zapoznaj się z poniższym tematem Wyświetlanie dzienników kontenera Docker.
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.
W aplikacji ArcGIS Notebook Server Administrator Directory można określić najwyższy poziom szczegółowości tworzonych dzienników. Na przykład, jeśli został skonfigurowany poziom Szczegółowe, witryna serwera będzie zapisywać komunikaty na poziomach szczegółowości Poważne, Ostrzeżenie, Informacja i Szczegółowe.
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 Manager
Począwszy od wersji 10.8, 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.
- Parametry filtrów zapytań znajdują się w górnej części strony. Parametry te umożliwiają ograniczanie lub rozszerzanie wyszukiwania.
- Poziom dziennika — minimalny poziom dziennika, którego mogą dotyczyć zapytania (patrz wyż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 sześciu 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.
- 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.
- 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.
- 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 .
- 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 zostanie skonfigurowany poziom na przykład FINE, w witrynie nie będą przechowywane dzienniki na poziomach VERBOSE i 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 aplikacji ArcGIS Notebook Server.
Wyświetlanie dzienników kontenera Docker w aplikacji ArcGIS Notebook Server Manager
W aplikacji ArcGIS Notebook Server Manager można wyświetlić dzienniki specyficzne dla kontenerów Docker danej witryny.
- Zaloguj się do aplikacji ArcGIS Notebook Server Manager portalu jako administrator. Adres URL ma format https://webadaptorhost.domain.com/webadaptorname/home/notebook/manager.html.
- Przejdź na kartę Kontenery.
- Kliknij przycisk Wyświetl dzienniki, aby wyświetlić dzienniki kontenera wybranego komputera.
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 terminal 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.