Identyfikator korelacji programu SharePoint w komunikatach o błędach: czym jest i jak z niego korzystać
Dotyczy
SharePoint Server 2016 Program Microsoft Office SharePoint Online na platformie Microsoft 365

Jeśli jesteś użytkownikiem, który ma problemy z publiczną witryną internetową lub ankietą, pocztą e-mail lub inną aplikacją, zadzwoń do firmy, która jest właścicielem witryny internetowej, i poproś o pomoc.   Informacje kontaktowe witryny internetowej lub ankiety możesz zazwyczaj znaleźć u dołu strony albo w sekcjach O nas lub Kontakt w menu nawigacji.

Jeśli jesteś użytkownikiem w firmie i otrzymujesz błędy, skontaktuj się z osobą zarządzającą wewnętrzną witryną internetową Twojej firmy.   Tego typu problemy często może rozwiązać tylko webmaster (administrator SharePoint) lub ktoś z Twojej firmy.

Jeśli jesteś administratorem SharePoint, webmasterem lub menedżerem witryny,    a użytkownicy zadają pytania dotyczące identyfikatorów korelacji, ten artykuł może Ci pomóc.

Czym jest, a czym nie jest identyfikator korelacji

Identyfikator korelacji nie jest numerem błędu ani kodem. Po prostu jest to identyfikator GUID (unikatowy identyfikator globalny), który jest generowany automatycznie dla każdego żądania otrzymanego przez serwer SharePoint. Jest on unikatowy dla każdego żądania, a nie dla każdego błędu. Jednak w przypadku wystąpienia błędu komunikat o błędzie zawiera identyfikator korelacji, który był ważny dla żądania w danym momencie.

Identyfikator korelacji ma ułatwić administratorowi SharePoint prześledzenie, co działo się w momencie wystąpienia błędu. Jest on przydatny tylko jako interaktywne narzędzie, które pomaga administratorowi znaleźć błąd. Administracja używa identyfikatora korelacji jako „łączy do stron nadrzędnych” do ponownego śledzenia żądań lub procesów w SharePointUsłudze zunifikowanego rejestrowania (ULS) w celu znalezienia tego, co prowadzi do i powoduje problem. Jeśli SharePoint otrzyma błąd, którego nie może zidentyfikować podczas pracy nad tym zadaniem, publikuje komunikat „Wystąpił nieoczekiwany błąd” i zawiera identyfikator korelacji. Identyfikator korelacji może pomóc ustalić, co się stało, ale nie identyfikuje tego, co się stało.

Diagram przedstawiający sposób przypisywania identyfikatora korelacji

Pomyślne żądania są oznaczane identyfikatorem korelacji, podobnie jak nieudane. Identyfikator jest unikatowy i różny dla każdego nowego żądania oraz trwa tylko przez czas trwania żądania. To nie jest jak błąd systemu Windows, który daje numer 80xxxxxx, identyfikujący dokładny problem. Poszukiwanie określonego identyfikatora korelacji w Internecie nie pomaga, ponieważ każdy z nich jest inny i unikatowy dla danego serwera oraz w danym momencie.

W przypadku, gdy identyfikator korelacji jest przydatny, należy prześledzić proces. SharePoint tworzy dziennik (ULS) wszystkiego, co robi podczas przetwarzania żądań, a identyfikator korelacji jest w zasadzie wątkiem, który łączy wszystkie kroki razem. Ponieważ SharePoint wykonuje tysiące żądań w tym samym czasie, identyfikator korelacji może być używany do filtrowania tylko kroków, które SharePoint robił dla danego żądania.

Dla administratora, identyfikator korelacji może być używany do śledzenia błędów, jak również problemów z wydajnością i innych problemów. Używając identyfikatorów korelacji dla żądań, które wykazują problematyczne zachowanie, mogą zbadać je głębiej.  Jeśli nie występuje żaden błąd i nie jest generowany żaden komunikat o błędzie, pulpit nawigacyjny dewelopera może zostać użyty do wyświetlenia identyfikatora korelacji wygenerowanego przez procesy. 

Jeśli jesteś użytkownikiem końcowym, prawdopodobnie nie będziesz mieć dostępu do dzienników, które zawierają informacji, w których identyfikator korelacji może być przydatny. W takim przypadku możesz zatrzymać się tutaj i zadzwonić do działu pomocy technicznej lub administratora. Wyjaśnij swój problem i współpracuj z nimi w celu zdiagnozowania problemu. Podaj im identyfikator korelacji widoczny w komunikacie o błędzie, który może być potrzebny.

Jako specjalista IT lub administrator, aby dowiedzieć się, co się stało, musisz znaleźć dzienniki ULS dla czasu wystąpienia zdarzenia i wyszukać w nich identyfikator korelacji. Może być konieczne przejrzenie kilku interfejsów internetowych, aby znaleźć ten, który ma szukany identyfikator korelacji. Identyfikator korelacji nie rozwiąże błędu, ale może pomóc w prześledzeniu żądania w celu sprawdzenia, co poszło nie tak. Możesz uzyskać pewne szczegółowe informacje na temat tego, co wydarzyło się tuż przed wygenerowaniem błędu, jakie komunikaty o błędach zostały wyświetlone lub jakie zdarzenia zostały wyzwolone z powodu tego błędu (jeśli w ogóle). Możesz użyć narzędzia takiego jak ULSViewer w celu ułatwienia przeglądania tych danych i odfiltrowania żądań, których nie musisz widzieć. Aby uzyskać więcej pomysłów i porad, zobacz wpis w blogu Rejestrowanie i rozwiązywanie problemów w programie SharePoint za pomocą narzędzia ULSViewer.

Oto typowy scenariusz używany przez administratora podczas korzystania z identyfikatora korelacji:

  • Użytkownik otrzymuje błąd otwarcia pliku w programie Excel, co daje administratorowi identyfikator korelacji i datę/godzinę zdarzenia:

  • Znajdź katalog dziennika i szukaną datę, a następnie otwórz ten plik w programie Excel:

  • Znajdź szukany identyfikator korelacji. Możesz również filtrować według poziomu zdarzeń, aby zorientować się, co się dzieje:

  • Jeśli nie możesz znaleźć identyfikatora korelacji, spróbuj użyć innego serwera internetowego, który był w użyciu w momencie zgłoszenia problemu.

Oto kilka innych zasobów administratora, które pomogą w debugowaniu błędów SharePoint. Oprócz tych linków spróbuj wyszukiwać w Internecie, ponieważ istnieje wiele witryn i społeczności innych firm oferujących pomoc techniczną oraz narzędzia do pracy z SharePoint. Ponieważ SharePoint jest platformą, istnieje społeczność tysięcy deweloperów, specjalistów IT i użytkowników tworzących narzędzia, aplikacje oraz dokumentację, aby pomagać sobie nawzajem.

Potrzebujesz dalszej pomocy?

Chcesz uzyskać więcej opcji?

Poznaj korzyści z subskrypcji, przeglądaj kursy szkoleniowe, dowiedz się, jak zabezpieczyć urządzenie i nie tylko.