Ustawienia dziennika

Ustawienia dzienników serwera dokonywane są za pomocą tego ekranu. Zawiera on następujące ustawienia:

Dziennik dostępów
Dziennik błędów
Dziennik stron
Poziom pliku log
Maks. wielkość pliku dziennika

To jest ważny ekran. Jeśli napotkasz problemy, tutaj ustawiasz poziom dziennika na „debug”, uruchamiasz ponownie demona CUPS i patrzysz do dziennika błędów określonego tutaj w celu znalezienia komunikatów, które pomogą zrozumieć błąd.

Okno konfigurujące Ustawienia dziennika serwera CUPS :

Dziennik dostępów

Nazwa pliku dziennika dostępów. Jeżeli nie zaczyna się od /, to przyjmuje się że jest podana względem ServerRoot.

Można również użyć nazwy specjalnej syslog aby wysyłać wynik do pliku lub usługi syslog.

Domyślnie ustawiana na /var/log/cups/access_log.

Plik jest formatowany zgodnie z tzw. „Common Log Format”. Dzięki temu możesz używać programów takich jak Webalyzer lub innego podobnego programu aby wygenerować raport na temat aktywności serwera CUPS.

Aby nazwa pliku dziennika zawierała nazwę serwera dodaj do niej %s. Przykład: /var/log/cups/access_log-%s.

kurt@transmeta:~ 
>tail /var/log/cups/access_log

127.0.0.1    - - [04/Aug/2001:20:11:39 +0100] "POST /printers/ HTTP/1.1" 200 109
127.0.0.1    - - [04/Aug/2001:20:11:39 +0100] "POST /admin/ HTTP/1.1" 401 0
127.0.0.1    - - [04/Aug/2001:20:11:39 +0100] "POST / HTTP/1.1" 200 210
127.0.0.1    - - [04/Aug/2001:20:11:39 +0100] "GET /ppd/DANKA_P450.ppd HTTP/1.1" 200 51021
127.0.0.1    - - [04/Aug/2001:20:11:39 +0100] "POST /jobs/ HTTP/1.1" 200 246
10.160.16.45 - - [04/Aug/2001:20:11:39 +0100] "GET /printers/DANKA_P450 HTTP/1.0" 200 0
127.0.0.1    - - [04/Aug/2001:20:11:39 +0100] "POST / HTTP/1.1" 200 80
127.0.0.1    - - [04/Aug/2001:20:11:39 +0100] "POST / HTTP/1.1" 200 139
10.160.16.45 - - [04/Aug/2001:20:11:40 +0100] "GET /cups.css HTTP/1.0" 200 198
127.0.0.1    - - [04/Aug/2001:20:11:40 +0100] "POST / HTTP/1.1" 200 139
10.160.16.45 - - [04/Aug/2001:20:11:39 +0100] "GET /printers/DANKA_P450 HTTP/1.0" 200 7319
10.160.16.45 - - [04/Aug/2001:20:11:40 +0100] "GET /images/title-logo.gif HTTP/1.0" 200 5729

Dla każdego momentu dostępu, widoczna jest pojedyncza linia zawierająca kolejno: adres IP klienta z którego dokonano dostępu, jego data i czas oraz metoda (POST lub GET), zażądany zasób, wersja protokołu HTTP używanego przez klienta, kod statusu ora liczbę przesłanych bajtów. Kod 200 oznacza sukces-OK kod 401 w powyższym przykładzie oznacza nieautoryzowany dostęp czyli jego odmowę. Format dzienników został omówiony w CUPS Software Administrator Manual (Podręcznik administratora).

Dziennik błędów

Nazwa pliku dziennika błędów. Jeżeli nie zaczyna się od /, to przyjmuje się że jest podana względem ServerRoot. Domyślnie ustawiona na /var/log/cups/error_log.

Można również użyć nazwy specjalnej syslog aby wysyłać wynik do pliku lub usługi syslog.

Wprowadź ścieżkę, np. /var/log/cups/error_log.

Fragment dziennika błędów ukazany poniżej ukazuje fragment logowania druku strony testowej przy ustawieniu zmiennej Poziom pliku log na „informacje ogólne”. Znaczenie zmiennej Poziom pliku log zostanie wytłumaczone później.

kurt@transmeta:~ 
> tail  /var/log/cups/error_log

I [04/Aug/2001:23:15:10 +0100] Job 213 queued on 'DANKA_P450' by 'root'
I [04/Aug/2001:23:15:10 +0100] Started filter /usr/lib/cups/filter/pstops (PID 18891) for job 213.
I [04/Aug/2001:23:15:10 +0100] Started backend /usr/lib/cups/backend/lpd (PID 18892) for job 213.

Dziennik stron

Nazwa pliku dziennika stron. Jeżeli nie zaczyna się od /, to przyjmuje się że jest podana względem ServerRoot. Domyślnie ustawiona na /var/log/cups/page_log

Można również użyć nazwy specjalnej syslog aby wysyłać wynik do pliku lub usługi syslog.

Wprowadź ścieżkę, np. /var/log/cups/page_log.

Plik dziennika stron w oddzielnych liniach umieszcza informacje o każdej pojedynczej stronie wydrukowanych zadań.

Oto przykład, jak wyglądają pozycje w tym pliku:

kurt@transmeta:~ 
> tail  /var/log/cups/page_log

GIMP_print_stp_HP kdetest 201 [03/Aug/2001:03:18:03 +0100] 4 1
GIMP_print_stp_HP kdetest 201 [03/Aug/2001:03:18:03 +0100] 5 1
GIMP_print_stp_HP kdetest 202 [03/Aug/2001:11:46:49 +0100] 1 1
GIMP_print_stp_HP kdetest 203 [03/Aug/2001:11:46:54 +0100] 1 1
DANKA_infotec_P450 kurt 204 [04/Aug/2001:03:29:00 +0100] 1 33
DANKA_infotec_P450 kurt 204 [04/Aug/2001:03:29:00 +0100] 2 33
DANKA_infotec_P450 kurt 204 [04/Aug/2001:03:29:00 +0100] 3 33
DANKA_infotec_P450 kurt 204 [04/Aug/2001:03:29:00 +0100] 4 33
DANKA_infotec_P450 root 205 [04/Aug/2001:19:12:34 +0100] 1 14
DANKA_infotec_P450 root 206 [04/Aug/2001:19:15:20 +0100] 1 1

W tym pliku znajdziesz informacje o nazwie drukarek (GIMP_print_stp_HP oraz DANKA_infotec_P450) używanych poprzez ten serwer, nazwach użytkowników (kdetest, kurt oraz root), numerach ID zadań („201” do „205”), czasie w którym zlecono zadanie, numerze strony wewnątrz zadania oraz ilości kopii danej strony. Na przykład zadanie o ID 204 miało 4 strony i wydrukowano ich 33 kopie, zadanie o ID 205 miało 14 kopii jednej strony .

Notatka

CUPS jest zależny (dla obliczeń ilości stron w zadaniu) od filtru „pstops”. Przyjżyj się diagramowi Kivio Flowchart pod kątem architektury filtrów CUPS aby dowiedzieć się w którym momencie procesu drukowania jest ten filtr wykorzystywany. Idąc dalej, pstops podczas liczenia zależy od DSC zgodnie z którym (DSC to Document Structuring Conventions, standard zdefiniowany przez Adobe) przesyłane są dane od kilenta. W większości przypadków taki system jest skuteczny.

Jednakże,system zliczania stron nie będzie działał dla zadań typu „raw” (gdyż z definicji, dla nich nie są wykorzystywane mechanizmy filtrowania CUPS i omijają one pstops.) Każde zadanie typu „raw” jest zliczane jako jednostronicowe (wraz z jego wielokrotnymi kopiami). Tak dzieje się dla wszystkich zadań przesyłanych z klientów Microsoft® Windows® poprzez program Samba do serwera CUPS , dzieje się tak gdyż te zadania docierają we właściwym dla drukarki formacie, ponieważ klienci używają oryginalnych sterowników drukarki.

Notatka

Nadal szukam chętnej osoby do napisania ładnego narzędzia do analizy dziennika stron CUPS. Powinno ono generować wynik podobny do raportów Webalizera. W ten sposób można by tworzyć przydatne statystyki do rozliczania zużycia drukarek, zależności obciążenia od pory dnia, dnia tygodnia, czy użytkownika, itp. Jacyś chętni?

Poziom pliku log

Określa liczbę komunikatów wypisywanych do dziennika błędów. Może przyjąć jedną z poniższych wartości:

debug2: Wypisuj wszystko.
debug: Wypisuj prawie wszystko.
info: Wypisuj wszystkie żądania i zmiany stanu.
warn: Wypisuj błędy i ostrzeżenia.
error: Wypisuj tylko błędy.
none: Nic nie wypisuj.

Jeżeli potrzebujesz rozwiązać problem (lub jeśli chcesz się dowiedzieć jak działa CUPS od środka), ustaw poziom pliku log na debug lub debug2. Wtedy plik error_log będzie o wiele bardziej szczegółowy (będą w nim zawarte nie tylko błędy, lecz również pozycje informacyjne).

W ten sposób możesz oglądać „na żywo” to co CUPS robi gdy dostaje zadanie do wydrukowania. W programie Konsole wpisz:

kurt@transmeta:~ 
>tail -f -n100 /var/log/cups/error_log

W ten sposób otrzymasz ostatnie 100 linii(-n 100) pliku log na ekranie, będzie on odświeżany w „czasie rzeczywistym” (-f), będziesz wiedział co się dzieje. Poniższy listing pokazuje co się dzieje podczas druku strony testowej. (fragmenty zostały wycięte aby oszczędzić miejsce... Wypróbuj to sam jeśli potrzebujesz więcej informacji):

 
I [04/Aug/2001:23:15:12 +0100] Job 214 queued on 'DANKA_P450' by 'root'
D [04/Aug/2001:23:15:12 +0100] StartJob(214, 08426fe0) 
D [04/Aug/2001:23:15:12 +0100] StartJob() id = 214, file = 0/1 
D [04/Aug/2001:23:15:12 +0100] job-sheets=none,none 
D [04/Aug/2001:23:15:12 +0100] banner_page = 0 
D [04/Aug/2001:23:15:12 +0100] StartJob: argv = "DANKA_P450","214","root","KDE Print Test",
[....]  
D [04/Aug/2001:23:15:12 +0100] StartJob: envp = "PATH=/usr/lib/cups/filter:/bin:/usr/bin", [....]  
D [04/Aug/2001:23:15:12 +0100] StartJob: statusfds = 5, 6 
D [04/Aug/2001:23:15:12 +0100] StartJob: filterfds[1] = 7, -1 
D [04/Aug/2001:23:15:12 +0100] StartJob: filter = "/usr/lib/cups/filter/pstops" 
D [04/Aug/2001:23:15:12 +0100] StartJob: filterfds[0] = 8, 9 
D [04/Aug/2001:23:15:12 +0100] start_process("/usr/lib/cups/filter/pstops", [....]  
I [04/Aug/2001:23:15:12 +0100] Started filter /usr/lib/cups/filter/pstops (PID 18991) for job 214.  
D [04/Aug/2001:23:15:12 +0100] StartJob: backend = "/usr/lib/cups/backend/lpd" 
D [04/Aug/2001:23:15:12 +0100] StartJob: filterfds[1] = -1, 7 
D [04/Aug/2001:23:15:12 +0100] start_process("/usr/lib/cups/backend/lpd", [....]  
I [04/Aug/2001:23:15:12 +0100] Started backend /usr/lib/cups/backend/lpd (PID 18992) for job 214.
D [04/Aug/2001:23:15:12 +0100] Page = 595x842; 15,16 to 580,833 [....]

Pozycje oznaczone literą „D” na początku to linie poziomu debug te oznaczone literą „I” to linie poziomu „info” .

Maks. wielkość pliku dziennika

Określa rozmiar plików dziennika, powyżej którego nastąpi podmiana pliku dziennika. Domyślnie 1048576 (1 Mb). Ustawienie na 0 powoduje wyłączenie podmiany dzienników.

Wprowadź wielkość pliku w bajtach, na przykład 1048576