Monitorowanie dzienników portalu pomaga w identyfikacji i lokalizacji błędów oraz w rozwiązywaniu problemów występujących w portalu. Aplikacja ArcGIS Portal Directory umożliwia przeglądanie, przeszukiwanie, konfigurowanie i usuwanie dzienników portalu. Aplikacja ArcGIS Portal Directory agreguje komunikaty dziennika w postaci tabeli, którą można przeglądać i modyfikować.
Sekcje zawarte w tym temacie pomocy opisują dzienniki portalu, a także podają sposoby rozwiązywania problemów przy ich użyciu.
- Przechwytywanie, przeszukiwanie i wyświetlanie zdarzeń
- Zrozumienie dzienników
- Używanie filtrów zdarzeń w zapytaniach w celu zawężenia wyników wyszukiwania
- Usuwanie dzienników
Przechwytywanie, przeszukiwanie i wyświetlanie zdarzeń
Gdy w portalu wystąpi zdarzenie, jest ono przechwytywane i zapisywane w dziennikach. Aby wyświetlić komunikaty odnoszące się do zdarzenia, należy przeszukać dzienniki. Aby przeszukać i wyświetlić bieżące komunikaty w portalu, wykonaj poniższe czynności:
- Otwórz aplikację ArcGIS Portal Directory i zaloguj się jako administrator. Zwykle dostępny jest następujący adres URL: https://webadaptorhost.domain.com/webadaptorname/portaladmin.
- Kliknij pozycje Dzienniki > Zapytanie.
- Pozostaw niezmienione wszystkie ustawienia domyślne i kliknij pozycję Zapytanie.
Niektóre komunikaty są zwracane wraz z dodatkowymi informacjami. Na przykład, jeśli użytkownik wprowadził błędne hasło zbyt wiele razy i z tego powodu jego konto zostało zablokowane, pojawi się następujący komunikat:
W powyższym scenariuszu użytkownik john_cho próbował się zalogować, ale wprowadził błędne hasło. Po pięciu próbach zadziałały zasady blokowania konta i konto tego użytkownika zostało zablokowane. Może to też wskazywać na próbę uzyskania dostępu do portalu przez złośliwego użytkownika.
Wszystkie zdarzenia powodują zapisanie powyższych informacji, takich jak typ poziomu dziennika, czas wystąpienia zdarzenia, komponent źródłowy, który zapisał dane zdarzenie, komputer, na którym wystąpiło zdarzenie, użytkownik powiązany ze zdarzeniem, kod dziennika i identyfikator procesu. Wszystkie te informacje ułatwiają rozwiązywanie występujących w portalu problemów w sposób bardziej efektywny. Szczegółowe wyjaśnienie tych informacji podano w sekcji Zrozumienie dzienników.
Funkcjonowanie dzienników w trakcie instalacji i po jej zakończeniu
Podczas instalacji lub aktualizacji portalu poziom dziennika portalu jest ustawiony na Pełne informacje. Oznacza to, że w trakcie procesu instalacji lub aktualizacji zapisywane są bardzo szczegółowe komunikaty.
Jeśli w trakcie tego procesu wystąpi błąd i chcesz przejrzeć dzienniki w celu łatwiejszego rozwiązania problemu, sprawdź, czy możesz uzyskać dostęp do aplikacji ArcGIS Portal Directory. Jeśli tak, przeszukaj dzienniki i przejrzyj komunikaty. W przeciwnym razie należy zapoznać się z komunikatami dziennika na dysku. Aby uzyskać dostęp do dzienników na dysku, przejdź do katalogu dzienników i otwórz najnowszy plik dziennika (na przykład C:\arcgisportal\logs\<machine name>\portal\portal-20150101.095803-8596-0.0.log). W razie potrzeby można udostępnić te informacje zespołowi pomocy technicznej Esri.
Po zakończeniu procesu instalacji lub aktualizacji poziom dziennika portalu zostanie domyślnie ustawiony na Ostrzeżenie. Oznacza to, że zapisywane są tylko problemy o poziomie szczegółowości od średniego do poważnego. Jeśli użytkownik portalu zgłasza problem, można zmienić poziom dziennika tak, by zapisywane były bardziej szczegółowe komunikaty dla określonego problemu. Aby dowiedzieć się jak zmienić poziom dziennika, zapoznaj się z tematem Określanie ustawień dziennika portalu.
Gdy masz wrażenie, że wystąpił problem
Jeśli wydaje się, że w portalu pojawił się błąd, albo użytkownik zgłasza problem, wywołaj ponownie to zdarzenie, przechwyć je w dziennikach, przeszukaj dzienniki w celu uzyskania informacji o danym zdarzeniu, a następnie wykorzystaj je do rozwiązania problemu, którego źródłem było to zdarzenie.
Jeśli zachodzi podejrzenie wystąpienia błędu lub błąd został już zarejestrowany, postępuj zgodnie z informacjami na poniższym drzewie decyzyjnym, aby przechwycić zdarzenie za pomocą dzienników:
- Spróbuj wywołać ponownie ten problem:
- Jeśli problem da się ponownie wywołać, przeszukaj dzienniki i przejrzyj informacje zawarte w komunikatach odnoszących się do tego problemu.
- Jeśli żadne informacje nie są dostępne, zwiększ poziom rejestrowania. Jeszcze raz spróbuj wywołać ten problem, przeszukaj dzienniki i przejrzyj komunikaty.
- Jeśli komunikaty dziennika zawierają informacje, zapoznaj się z nimi, aby ułatwić sobie rozwiązanie problemu.
- Jeśli nie można ponownie wywołać problemu, zanotuj okoliczności jego pojawienia się, co może być przydatne w razie ponownego jego wystąpienia.
- Jeśli problem da się ponownie wywołać, przeszukaj dzienniki i przejrzyj informacje zawarte w komunikatach odnoszących się do tego problemu.
Wskazówka:
Jeśli problem ma związek z publikowaniem, zalecamy też przejrzenie dzienników serwera ArcGIS Server. W dziennikach serwera mogą znajdować się dodatkowe informacje przydatne przy rozwiązywaniu problemu związanego z publikowaniem.
Poniżej podano przykładowe sposoby przechwytywania zdarzeń, przeszukiwania i identyfikowania ich za pomocą dzienników.
- Użytkownik nie może dodać załącznika do usługi obiektowej
- Użytkownik podaje nieprawidłową nazwę użytkownika lub hasło
- Element został przeniesiony z jednego folderu do innego
Użytkownik nie może dodać załącznika do usługi obiektowej
Na przykład użytkownik zgłasza, że nie może dodać załącznika do usługi obiektowej. Próbował on kilkukrotnie wykonać tę czynność, ale plik nie został przesłany.
- Otwórz aplikację ArcGIS Portal Directory i zaloguj się jako administrator. Zwykle dostępny jest następujący adres URL: https://webadaptorhost.domain.com/webadaptorname/portaladmin.
- Kliknij pozycje Dzienniki > Ustawienia > Edytuj.
- Ustaw poziom dziennika równy INFORMACJE i kliknij przycisk Aktualizuj. Teraz portal zapisuje komunikaty poziomu Informacje.
- Poproś użytkownika o ponowne wywołanie tego problemu. Poproś go o zanotowanie czynności podejmowanych w celu jego wywołania, a także informacji o tym, ile zajęło to czasu.
- W aplikacji ArcGIS Portal Directory kliknij pozycje Dzienniki > Zapytanie.
- Podaj wartości czasu uzyskane od użytkownika. Format jest następujący: yyyy-mm-ddThh:mm:ss. Nas przykład czas początkowy to 2015-05-10T14:05:00, a czas końcowy to 2015-05-10T14:03:00.
- Sformułuj zapytanie powodujące zwracanie komunikatów na poziomie dziennika INFORMACJE.
- W polu Użytkownicy podaj nazwę użytkownika członka. Na przykład jcho dla użytkownika John Cho.
- Kliknij przycisk Zapytanie.
- Przejrzyj pole Komunikat pod kątem wszelkich komunikatów odnoszących się do problemu.
Wyświetlony został następujący komunikat:
Failed to add attachment. File size limit of 20 MB exceeded for feature service '/gis/rest/services/Hosted/parks3k_19/FeatureServer/0/1/addAttachment'.
Mówi on, że użytkownik próbował przesłać plik przekraczający limit rozmiaru. Poradź użytkownikowi zmniejszenie rozmiaru pliku do wartości poniżej 20 MB.
Użytkownik podaje nieprawidłową nazwę użytkownika lub hasło
Ten typ zdarzenia jest zapisywany na domyślnym poziomie OSTRZEŻENIE. W celu przechwytywania zdarzeń tego typu należy ustawić dla poziomu dziennika wartość ostrzeżenie lub niższą, na przykład:
- Otwórz aplikację ArcGIS Portal Directory i zaloguj się jako administrator. Zwykle dostępny jest następujący adres URL: https://webadaptorhost.domain.com/webadaptorname/portaladmin.
- Kliknij pozycje Dzienniki > Ustawienia > Edytuj.
- Upewnij się, że ustawiony jest poziom OSTRZEŻENIE lub niższy. W przeciwnym razie ustaw poziom dziennika równy OSTRZEŻENIE (lub niższy) i kliknij przycisk Aktualizuj.
- Jeśli jest taka potrzeba, otwórz aplikację ArcGIS Portal Directory i kliknij pozycje Dzienniki > Zapytanie.
- Sformułuj zapytanie powodujące zwracanie komunikatów na poziomie dziennika OSTRZEŻENIE. Zignoruj wszystkie pozostałe pola, ponieważ zapytanie to zwraca komunikaty na poziomie ostrzeżenia dla wszystkich użytkowników.
- Przejrzyj pole Komunikat pod kątem wszelkich komunikatów odnoszących się do problemu.
Wyświetlony został następujący komunikat:
Sign in error: Invalid username or password specified for 'asmith'.
Mówi on, że użytkownik asmith (Ashley Smith) podał nieprawidłową nazwę użytkownika lub hasło przy próbie zalogowania się do portalu. Monitoruj takie zdarzenia, aby zapobiec próbom nieuprawnionego dostępu.
Element został przeniesiony z jednego folderu do innego
W celu przechwytywania zdarzeń tego typu należy podnieść poziom dziennika do wartości INFORMACJE, na przykład:
- Otwórz aplikację ArcGIS Portal Directory i zaloguj się jako administrator. Zwykle dostępny jest następujący adres URL: https://webadaptorhost.domain.com/webadaptorname/portaladmin.
- Kliknij pozycje Dzienniki > Ustawienia > Edytuj.
- Ustaw poziom dziennika równy INFORMACJE i kliknij przycisk Aktualizuj. Teraz portal zapisuje komunikaty poziomu Informacje i rejestruje zdarzenia związane z przenoszeniem elementów z jednego folderu do innego.
- Jeśli jest taka potrzeba, otwórz aplikację ArcGIS Portal Directory i kliknij pozycje Dzienniki > Zapytanie.
- Sformułuj zapytanie powodujące zwracanie komunikatów na poziomie dziennika INFORMACJE. Zignoruj wszystkie pozostałe pola, ponieważ od momentu ustawienia tego poziomu zwraca ono komunikaty na poziomie informacje dla wszystkich użytkowników.
- Przejrzyj pole Komunikat pod kątem wszelkich komunikatów odnoszących się do problemu.
Wyświetlony został następujący komunikat:
Item moved from folder 'jcho/(Home)' to folder 'jcho/(Home)/Utilities'. Item ID is 'b7557bd2691b4e74bc4ce3e373402cc6'.
Mówi on, że użytkownik jcho (John Cho) przeniósł element (o identyfikatorze b7557bd2691b4e74bc4ce3e373402cc6) z folderu macierzystego (Home) do podkatalogu w tym folderze o nazwie Utilities.
Zrozumienie dzienników
Wszystkie zdarzenia powodują zapisanie określonych informacji, takich jak typ poziomu dziennika, czas wystąpienia zdarzenia, komponent źródłowy, który zapisał dane zdarzenie, komputer, na którym wystąpiło zdarzenie, użytkownik powiązany ze zdarzeniem, kod dziennika i identyfikator procesu. Wszystkie te informacje ułatwiają rozwiązywanie występujących w portalu problemów w sposób bardziej efektywny. W poniższych sekcjach informacje te zostały szczegółowo opisane.
Typ dziennika
Zapisywane zdarzenia mogą się różnić pod względem poziomu szczegółowości, od poziomu Poważne, który wskazuje na problem wymagający natychmiastowej interwencji, do poziomu Pełne informacje, który jest szczegółowym komunikatem o charakterze informacyjnym, generowanym regularnie w trakcie korzystania z portalu.
Poniżej wyszczególniono typy poziomu dziennika:
| Poziom | Opis | Przykładowy komunikat |
|---|---|---|
Poważne | Poważne problemy wymagające natychmiastowej interwencji. Poziom ten obejmuje jedynie komunikaty o poważnym znaczeniu. | The 'System/GPServer/PublishingTools' service is stopped or ArcGIS Server is not started. Verify these components are started and try again. |
Ostrzeżenie | Średnie problemy wymagające interwencji. Poziom ten obejmuje także komunikaty o poważnym znaczeniu. | Organization updated: HTTP access disabled. The portal can only be accessed through HTTPS. |
Informacje | Często pojawiające się komunikaty administracyjne portalu, w tym komunikaty dotyczące aktualizowanych ustawień instytucji. Poziom ten obejmuje także komunikaty o poważnym znaczeniu i ostrzeżenia. | User 'asmith' signed in to the portal. |
Wysoka | Komunikaty pojawiające się często w trakcie korzystania z portalu, takie jak nazwy operacji lub otrzymane żądania. Poziom ten obejmuje komunikaty o poważnym znaczeniu, ostrzeżenia i informacje. | Account settings updated. |
Pełne informacje | Komunikaty dostarczające bardziej szczegółowych informacji na temat sposobu wykonywania operacji i przetwarzania żądań przez portal. Poziom ten obejmuje komunikaty o poważnym znaczeniu, ostrzeżenia, informacje i komunikaty szczegółowe. | Setting log level to VERBOSE before creating new site. |
Debugowanie | Bardzo szczegółowe komunikaty, przeznaczone dla programistów i pracowników pomocy technicznej pragnących w trakcie rozwiązywania problemów dogłębnie zrozumieć stan portalu. Nie należy wykorzystywać tego poziomu w środowisku produkcyjnym, ponieważ może to spowodować zmniejszenie wydajności. W sytuacjach niezwiązanych z rozwiązywaniem problemów, zamiast niego należy używać poziomu Ostrzeżenie. | Failed to update index for item '44b37137e1f64de2bec832ab82043b86'. |
Wyłączone | Zapisywanie zdarzeń jest wyłączone. Zdarzenia nie są rejestrowane w portalu. | Brak |
Informacja
To jest komunikat powiązany z zarejestrowanym zdarzeniem. Komunikaty różnią się pod względem poziomu szczegółowości w zależności od typu poziomu dziennika.
Czas
Czas wystąpienia zarejestrowanego zdarzenia. Zdarzenia są uporządkowane chronologicznie, jako pierwsze wyświetlane jest zdarzenie najnowsze. Format czasu jest następujący: yyyy-mm-ddThh:mm:ss. Można ustawić wyświetlanie tylko określonego przedziału czasowego podczas przeszukiwania dzienników.
Źródła
Źródło rejestrowanych zdarzeń jest generowane na podstawie komponentów oprogramowania: udostępnianych, administracyjnych lub pochodzących z portalu. Zdarzenia mające związek z publikowaniem i użytkownikami zostają przydzielone do kategorii Udostępnianie. Zdarzenia mające związek z bezpieczeństwem i indeksowaniem zostają przydzielone do kategorii Administrator portalu. Zdarzenia mające związek z instalacją oprogramowania zostają przydzielone do kategorii Portal. W razie konieczności można ustawić wyświetlanie tylko określonego źródła podczas przeszukiwania dzienników.
Komputer
Komputer portalu, na którym wystąpił błąd.
Użytkownik
Nazwa użytkownika, który przesłał żądanie, w wyniku którego został wygenerowany komunikat dziennika. Właściwość ta pozwala śledzić aktywność poszczególnych użytkowników przy włączonych zabezpieczeniach.
Kod
Kod dziennika powiązany z komunikatem. Kody są podzielone na kilka kategorii o określonym zakresie wartości i określonym znaczeniu. Można ustawić wyświetlanie kodów tylko o określonej wartości albo o wartościach z określonego przedziału podczas przeszukiwania dzienników.
| Kategoria | Zakres | Zawartość komunikatu |
|---|---|---|
Publikacja | 200000–201999 | Publikowanie i usuwanie hostowanych usług. |
Zarządzanie zasobami | 202000–203999 | Dodawanie, usuwanie, aktualizacja i przenoszenie elementów. Zmiana właściciela elementu. Udostępnianie elementów wszystkim osobom, instytucji lub grupom. |
Bezpieczeństwo | 204000–205999 | Logowanie się na wbudowane lub korporacyjne konto. Generowanie i konfiguracja tokena portalu. Blokowanie i odblokowywanie rejestracji kont. Blokowanie i odblokowywanie dostępu do aplikacji ArcGIS Portal Directory. Importowanie lub eksportowanie certyfikatu zabezpieczeń. Tworzenie, usuwanie i blokowanie użytkowników. Zmiana uprawnień roli użytkownika. Tworzenie i usuwanie ról niestandardowych. Blokowanie i odblokowywanie protokołu HTTPS oraz anonimowego dostępu. Aktualizacja magazynu tożsamości. |
Zarządzanie instytucją | 206000–207999 | Dostosowywanie strony głównej instytucji. Konfiguracja galerii, map bazowych, jednostek wyświetlania, usług narzędziowych i sfederowanych serwerów. Tworzenie i usuwanie grup. Dodawanie użytkowników do grupy oraz usuwanie użytkowników z grupy. Zapraszanie użytkowników do grupy lub akceptacja zaproszenia do grupy. Konfiguracja licencji aplikacji ArcGIS Pro. Konfiguracja aplikacji ArcGIS Web Adaptor. Modyfikacja lokalizacji katalogu zasobów portalu. Konfiguracja serwerów forward proxy i zwrotnych serwerów proxy. Przekroczenie liczby nazwanych użytkowników autoryzowanych w portalu. Edycja ustawień dziennika i usuwanie dzienników. |
Instalacja i aktualizacja | 208000–209999 | Instalacja i aktualizacja oprogramowania, tworzenie witryny portalu i autoryzacja oprogramowania. |
Indeks wyszukiwania | 210000–211999 | Generowanie indeksu wyszukiwania elementu portalu. |
Ogólne | 212000–219999 | Ponowne uruchomienie portalu. Konfiguracja portalu o wysokiej dostępności. Pozostałe ogólne komunikaty generowane w trakcie zwyczajnego korzystania z portalu. |
Proces
Identyfikator procesu komputera, który spowodował zarejestrowanie zdarzenia w dzienniku.
Używanie filtrów zdarzeń w zapytaniach w celu zawężenia wyników wyszukiwania
W celu zawężenia listy zdarzeń i wyświetlania bardziej odpowiednich komunikatów, można formułować zapytania w oparciu o czas, poziom dziennika, określony kod dziennika lub zakres kodów, określonego użytkownika lub listę użytkowników oraz komponent źródłowy portalu. W zapytaniu można zawrzeć dowolną kombinację tych filtrów.
Aby uzyskać dostęp do tych filtrów, zaloguj się do aplikacji ArcGIS Portal Directory i kliknij pozycje Start > Dzienniki > Zapytanie.
Poziom dziennika
Zdarzenia mogą się różnić pod względem poziomu szczegółowości, od poziomu Poważne, który wskazuje na problem wymagający natychmiastowej interwencji, do poziomu Pełne informacje, który jest szczegółowym komunikatem o charakterze informacyjnym, generowanym regularnie w trakcie korzystania z portalu. Wybierz żądany poziom z listy rozwijanej Poziom dziennika. Szczegółowe opisy wszystkich poziomów można znaleźć w sekcji Typ dziennika powyżej.
Źródła
Źródło rejestrowanych zdarzeń jest generowane na podstawie komponentów oprogramowania: udostępnianych, administracyjnych lub pochodzących z portalu. Na przykład:
- Zdarzenia mające związek z publikowaniem i użytkownikami zostają przydzielone do kategorii Udostępnianie.
- Zdarzenia mające związek z bezpieczeństwem i indeksowaniem zostają przydzielone do kategorii Administrator portalu.
- Zdarzenia mające związek z instalacją oprogramowania zostają przydzielone do kategorii Portal.
Domyślnie przeszukiwane są wszystkie źródła (opcja Wszystkie z listy rozwijanej). Aby filtrować zdarzenia w oparciu o określone źródło, wybierz żądane źródło z listy rozwijanej Źródło.
Czas
Aby wybrać tylko takie zdarzenia, które nastąpiły w określonym przedziale czasu, podaj odpowiednie wartości czasu w polach Czas początkowy i Czas końcowy (w formacie yyyy-mm-ddThh:mm:ss). Czas początkowy dotyczy zdarzenia najnowszego, a czas końcowy dotyczy zdarzenia najstarszego. Na przykład:
- Aby zdefiniować przedział czasu o długości piętnastu minut, ustaw czas początkowy równy 2015-05-01T13:15:00, a czas końcowy równy 2015-05-01T13:00:00.
- Aby zdefiniować przedział czasu o długości jednej godziny, ustaw czas początkowy równy 2015-05-01T14:00:00, a czas końcowy równy 2015-05-01T13:00:00.
- Aby zdefiniować przedział czasu o długości jednego dnia, ustaw czas początkowy równy 2015-05-02T12:00:00, a czas końcowy równy 2015-05-01T12:00:00.
- Aby przeszukiwać wszystkie dzienniki, pozostaw pola czasu puste.
Jeśli czas początkowy został określony, a czas końcowy nie został określony, zwrócone zostaną wszystkie zapisy dziennika zarejestrowane do czasu określonego jako czas początkowy. Odwrotnie, jeśli czas początkowy nie został określony, a czas końcowy został określony, zwrócone zostaną wszystkie zapisy dziennika zarejestrowane począwszy od czasu określonego jako czas końcowy.
Kody dziennika
Każdy komunikat jest powiązany z kodem dziennika. Kody są podzielone na kilka kategorii, jak opisano powyżej. Istnieje możliwość filtrowania w oparciu o określony kod lub zakres kodów, na przykład:
- Aby filtrować w oparciu o pojedynczy kod, podaj wartość kodu (na przykład: 204028).
- Aby filtrować w oparciu o określone kody, oddziel kody za pomocą przecinka (,) (na przykład: 204028, 212015, 219114).
- Aby filtrować w oparciu o zakres kodów, jak np. wszystkie kody w kategorii bezpieczeństwo, podaj wartości początkową i końcową kodu oddzielone kreską (-) (na przykład: 204000–205999).
- Aby filtrować w oparciu o zakres kodów i kody indywidualne, podaj wartości początkową i końcową kodu oddzielone kreską oraz indywidualne wartości kodu oddzielone przecinkami (na przykład: 204000–205999, 212015, 219114).
Użytkownicy
Aby filtrować zdarzenia dotyczące określonego użytkownika, podaj żądaną nazwę użytkownika w polu Użytkownicy, na przykład:
- Aby filtrować pod kątem jednego określonego użytkownika, podaj nazwę użytkownika (na przykład: jcho dla użytkownika o nazwie John Cho).
- Aby filtrować pod kątem kilku użytkowników, oddziel nazwy użytkowników przecinkami (,) (na przykład: jcho, asmith dla użytkowników o nazwie John Cho i Ashley Smith).
Notatka:
Użycie symbolu wieloznacznego (*) nie jest obsługiwane.
Liczba komunikatów
Liczba komunikatów wyświetlanych podczas wykonywania zapytania. Komunikaty są wyświetlane na jednej stronie internetowej. Niekiedy trzeba przewinąć stronę w dół, aby wyświetlić wszystkie komunikaty.
Usuwanie dzienników
Aby usunąć dzienniki, kliknij pozycje Strona główna > Dzienniki > Wyczyść > Wyczyść dzienniki. Spowoduje to usunięcie wszystkich komunikatów dziennika na komputerze udostępniającym portal. Podczas debugowania określonej sytuacji będącej przyczyną błędu w portalu, usunięcie dzienników może pomóc w wyizolowaniu problemu. Dzięki takiemu postępowaniu zostaną usunięte zapisy dotyczące wszystkich pozostałych zdarzeń, co pozwoli skoncentrować się na debugowaniu tego jednego problemu.