Logowanie zdarzeń zadań

Logowanie zdarzeń zadań to zapisywanie przebiegu każdego kroku zadania SQL Server Agent wraz z jego wynikiem.

Jak SQL Server Agent zapisuje przebieg zadania

Logowanie zdarzeń zadań w SQL Server Agent polega na rejestrowaniu informacji o uruchomieniu zadania, kolejnych krokach oraz rezultacie ich wykonania. Zadanie może składać się z wielu kroków, a każdy krok ma własny numer, nazwę, typ działania, polecenie lub odwołanie do pakietu oraz warunek określający dalszy przebieg. Historia pozwala sprawdzić, czy krok zakończył się powodzeniem, błędem albo innym statusem przewidzianym przez konfigurację zadania.

SQL Server Agent przechowuje podstawową historię zadań w bazie systemowej msdb. Najważniejsze informacje o wykonaniach znajdują się w widoku systemowym msdb.dbo.sysjobhistory. Rekord może dotyczyć całego zadania albo pojedynczego kroku. Wpis z wartością step_id równą zero opisuje podsumowanie wykonania zadania, natomiast wpisy z numerem większym od zera odnoszą się do konkretnych kroków. Dzięki temu można odróżnić błąd pojedynczego polecenia od końcowego statusu całego zadania.

Informacje dostępne w historii wykonania

Wiersze widoku sysjobhistory zawierają między innymi identyfikator zadania, numer kroku, kod wyniku, datę rozpoczęcia, czas trwania oraz komunikat zwrócony przez SQL Server Agent. Kod run_status określa rezultat wykonania. W praktyce podczas analizy sprawdza się również pola run_date, run_time i run_duration, ponieważ są one zapisywane w formacie liczbowym, a nie jako pojedyncza wartość typu data i czas. Do powiązania wpisu z nazwą zadania służy job_id, który można połączyć z tabelą msdb.dbo.sysjobs.

Definicję kroków przechowuje tabela msdb.dbo.sysjobsteps. Zawiera ona między innymi nazwę kroku, numer sekwencyjny, podsystem wykonujący działanie, treść polecenia, bazę danych kontekstu oraz akcję podejmowaną po sukcesie lub błędzie. Zestawienie sysjobhistory z sysjobsteps umożliwia sprawdzenie, co miało zostać wykonane, a następnie porównanie tego z rzeczywistym wynikiem. Sam komunikat historii nie zawsze wskazuje pełną przyczynę problemu, dlatego istotne jest analizowanie zarówno konfiguracji kroku, jak i jego logu wyjściowego.

Różnica między historią zadania a szczegółowym logiem

Historia zadania zawiera przede wszystkim metadane wykonania i komunikat statusu. Nie jest automatycznie pełnym dziennikiem każdej instrukcji wykonanej przez polecenie Transact-SQL ani całej zawartości wyjścia programu uruchamianego przez SQL Server Agent. Jeżeli potrzebne są szczegółowe komunikaty, krok zadania można skonfigurować z zapisem wyjścia do pliku albo do tabeli. Takie ustawienie należy oceniać razem z uprawnieniami konta usługi SQL Server Agent, ścieżką docelową i okresem przechowywania danych.

W przypadku kroków typu Transact-SQL komunikat błędu może pochodzić z aparatu bazy danych, procedury składowanej albo instrukcji uruchamianej w ramach kroku. W przypadku innych podsystemów SQL Server Agent rezultat zależy od konkretnego mechanizmu, na przykład PowerShell, CmdExec, SSIS lub replikacji. Dlatego podczas interpretacji wpisu trzeba najpierw ustalić typ kroku zapisany w sysjobsteps. Ten sam kod zakończenia nie zawsze oznacza identyczną przyczynę w różnych podsystemach.

Do odczytu historii można użyć procedury systemowej msdb.dbo.sp_help_jobhistory, filtrując wyniki według identyfikatora zadania, nazwy zadania albo zakresu czasu. Przydatne jest także sprawdzenie właściwości zadania w SQL Server Management Studio, jednak interfejs prezentuje dane już sformatowane i może ukrywać część szczegółów. W analizie powtarzających się awarii warto porównać kilka kolejnych wykonań: pozwala to odróżnić jednorazowy błąd od regularnego problemu z harmonogramem, zależnością między krokami, timeoutem lub dostępnością zasobu.

Wykorzystanie logów przy sprawdzaniu komputera

Przy diagnostyce komputera, na którym zainstalowano SQL Server lub SQL Server Management Studio, logowanie zdarzeń zadań pomaga ustalić, czy problem dotyczy samego silnika bazy danych, usługi SQL Server Agent, konfiguracji zadania, uprawnień systemowych albo dostępu do plików. Analizuje się kolejność kroków, czas ich trwania, kody wyników i treść komunikatów. Należy również sprawdzić, czy usługa SQL Server Agent działa, czy zadanie jest włączone oraz czy harmonogram faktycznie wywołuje oczekiwane uruchomienie.

Warszawskie Pogotowie Komputerowe zajmuje się profesjonalną naprawą laptopów, komputerów PC i ich podzespołów. W przypadku problemów z aplikacją wykorzystującą SQL Server Agent diagnostyka może obejmować stan systemu, działanie usług, błędy dysku, pamięci masowej i komunikację między komponentami zainstalowanymi na komputerze. Sam wpis w historii zadania nie powinien być traktowany jako kompletna diagnoza: przed naprawą trzeba ustalić, jaki krok się nie powiódł, jakie polecenie wykonywał oraz czy błąd można odtworzyć.