Praca z dziennikami instytucji—Portal for ArcGIS | Dokumentacja oprogramowania ArcGIS Enterprise

Monitorowanie dzienników pomaga w identyfikacji i lokalizacji błędów oraz w rozwiązywaniu problemów występujących w instytucji. Aplikacja ArcGIS Portal Administrator Directory umożliwia przeglądanie, przeszukiwanie, konfigurowanie i usuwanie dzienników instytucji. Aplikacja Portal Administrator Directory agreguje komunikaty dziennika w postaci tabeli, którą można przeglądać i modyfikować.

Dostęp do zarejestrowanych zdarzeń dotyczących każdego komponentu w instytucji można uzyskać z poziomu aplikacji Portal Administrator Directory. Aplikacja ArcGIS Server Manager wciąż może być potrzebna w celu określania ustawień dziennika serwera, usuwania dzienników serwera i użycia wszystkich opcji filtrowania.

Sekcje zawarte w tym temacie opisują dzienniki, a także podają sposoby rozwiązywania problemów przy ich użyciu.

Przechwytywanie, przeszukiwanie i wyświetlanie zdarzeń

Gdy w instytucji 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, wykonaj poniższe czynności:

Otwórz aplikację Portal Administrator Directory i zaloguj się jako administrator. Zwykle dostępny jest następujący adres URL: https://webadaptorhost.example.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:

Strona komunikatów dziennika w aplikacji ArcGIS Portal Administrator Directory

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 instytucji 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, identyfikator procesu oraz identyfikator żądania. Wszystkie te informacje ułatwiają rozwiązywanie występujących w instytucji problemów w sposób bardziej efektywny. Szczegółowe wyjaśnienie tych informacji podano w sekcji Zrozumienie dzienników.

Gdy masz wrażenie, że wystąpił problem

Jeśli wydaje się, że w instytucji 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.
  1. 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.
  2. 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.

Wskazówka:

Jeśli podejrzewa się, że problem dotyczy wielu komponentów, podczas przeszukiwania dzienników zaleca się wybór serwerów sfederowanych. Dzienniki serwera oraz dzienniki magazynu danych ArcGIS Data Store mogą udostępnić dodatkowe informacje ułatwiające rozwiązywanie problemów.

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

W tym przykładzie 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. Aby zarejestrować tego typu zdarzenie, poziom dziennika portalu musi być najpierw ustawiony na INFORMACJE.

Gdy portal rejestruje komunikaty na poziomie INFORMACJE, wykonaj następujące czynności:

Poproś użytkownika o ponowne wywołanie problemu i zapisanie czynności oraz czasu potrzebnego do ponownego wywołania problemu.
Otwórz aplikację Portal Administrator Directory i zaloguj się jako administrator. Zwykle dostępny jest następujący adres URL: https://webadaptorhost.example.com/webadaptorname/portaladmin.
Kliknij pozycje Dzienniki > Zapytanie.
1. 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.
2. Sformułuj zapytanie powodujące zwracanie komunikatów na poziomie dziennika INFORMACJE.
3. W polu Użytkownicy podaj nazwę użytkownika członka. Na przykład jcho dla użytkownika John Cho.
4. Kliknij przycisk Zapytanie.
Przejrzyj pole Komunikat pod kątem wszelkich komunikatów odnoszących się do problemu.

Wyświetlony zostanie 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

Aby zarejestrować tego typu zdarzenie, poziom dziennika portalu musi być najpierw ustawiony na OSTRZEŻENIE lub niższy.

Gdy portal rejestruje komunikaty na poziomie OSTRZEŻENIE, wykonaj następujące czynności:

Otwórz aplikację Portal Administrator Directory i zaloguj się jako administrator. Zwykle dostępny jest następujący adres URL: https://webadaptorhost.example.com/webadaptorname/portaladmin.
Kliknij pozycje Dzienniki > Zapytanie.
Sprawdź, czy poziom dziennika jest ustawiony na 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 zostanie komunikat.

Mówi on, że użytkownik asmith (Ashley Smith) podał nieprawidłową nazwę użytkownika lub hasło przy próbie zalogowania się do instytucji. Monitoruj takie zdarzenia, aby zapobiec próbom nieuprawnionego dostępu.

Element został przeniesiony z jednego folderu do innego

Aby zarejestrować tego typu zdarzenie, poziom dziennika portalu musi być najpierw ustawiony na INFORMACJE.

Gdy portal rejestruje komunikaty na poziomie INFORMACJE, wykonaj następujące czynności:

Otwórz aplikację Portal Administrator Directory i zaloguj się jako administrator. Zwykle dostępny jest następujący adres URL: https://webadaptorhost.example.com/webadaptorname/portaladmin.
Kliknij pozycje Dzienniki > Zapytanie.
Sprawdź, czy poziom dziennika jest ustawiony na INFORMACJE. Zignoruj wszystkie pozostałe pola, ponieważ od momentu ustawienia tego poziomu zwraca ono komunikaty na poziomie informacje dla wszystkich użytkowników.
Kliknij przycisk Zapytanie.
Przejrzyj pole Komunikat pod kątem wszelkich komunikatów odnoszących się do problemu.

Wyświetlony zostanie 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.

Instytucja jest ustawiona tylko do odczytu

Aby zarejestrować to, co dzieje się we wszystkich komponentach po ustawieniu trybu tylko do odczytu dla instytucji, poziom dziennika dla komponentów musi być najpierw ustawiony na INFORMACJE lub niższy. Więcej informacji zawierają tematy Określanie ustawień dziennika portalu i Określanie ustawień dziennika serwera.

Gdy komponenty rejestrują komunikaty na poziomie INFORMACJE lub niższym, a instytucja jest ustawiona na tryb tylko do odczytu, wykonaj następujące czynności:

Otwórz aplikację Portal Administrator Directory i zaloguj się jako administrator. Zwykle dostępny jest następujący adres URL: https://webadaptorhost.example.com/webadaptorname/portaladmin.
Kliknij pozycje Dzienniki > Zapytanie.
Sprawdź, czy poziom dziennika jest ustawiony na INFORMACJE, a następnie kliknij Zapytanie.
Zlokalizuj komunikat dziennika wskazujący, że instytucja została ustawiona na tryb tylko do odczytu, a następnie zanotuj identyfikator żądania tego komunikatu.
Successfully set the organization to read-only mode
Kliknij Zapytanie, aby powrócić do komunikatów dziennika zapytań.
Wprowadź identyfikator żądania zanotowany na etapie 4 w polu Identyfikatory żądań.
Wybierz Wszystkie w polu Serwery sfederowane.
Kliknij Zapytanie i przejrzyj dzienniki wszystkich komponentów związanych z ustawieniem trybu tylko do odczytu dla instytucji.

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 poziom dziennika, komponent źródłowy, czas, określony kod dziennika lub zakres kodów, określonego użytkownika lub listę użytkowników oraz identyfikator żądania. W zapytaniu można zawrzeć dowolną kombinację tych filtrów.

Aby wykonać zapytanie dotyczące wszystkich komunikatów dziennika w instytucji, można wybrać serwery sfederowane. Czas i identyfikator żądania umożliwiają filtrowanie komunikatów dziennika w różnych komponentach, a reszta umożliwia filtrowanie tylko dzienników portalu. Aby skorzystać z większej liczby opcji filtrowania logów serwera, można użyć aplikacji ArcGIS Server Manager.

Aby uzyskać dostęp do tych filtrów, zaloguj się do aplikacji Portal Administrator 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.

Źródła

Źródła rejestrowanych zdarzeń są 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 portalu 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 (format to 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 15 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.

Po wybraniu odpowiedniej opcji filtrowane będą także zdarzenia zarejestrowane na serwerach sfederowanych.

Kody dziennika

Każdy komunikat jest powiązany z kodem dziennika. Kody są podzielone na kilka kategorii. Istnieje możliwość filtrowania dzienników portalu 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 portalu 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.

Identyfikatory żądań

Niepowtarzalny ciąg znakowy identyfikatora dołączany do każdego wykonanego żądania, który jest przechowywany przez cały cykl życia żądania w systemie. Wybierz jeden lub wszystkie serwery sfederowane w przypadku filtrowania według identyfikatora żądania, aby operacja obejmowała wiele komponentów.

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.

Serwery sfederowane

Aby rozwiązywać problemy lub uzyskiwać wgląd w operacje obejmujące wiele komponentów oprogramowania ArcGIS Enterprise, uwzględnij w zapytaniu dzienniki serwera, wybierając jeden lub wszystkie serwery sfederowane. W zapytaniach dotyczących dzienników serwera hostującego uwzględniane będą również dzienniki aplikacji ArcGIS Data Store.

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.

Aby usunąć dzienniki serwera, użyj aplikacji ArcGIS Server Manager.

Opinia na ten temat?