Serverlogningsindstilling

Serverlogningsindstillingen gøres på denne skærm. Den inkluderer:

Dette er en vigtig skærm for dig. Skulle du nogensinde løbe ind i problemer: er her stedet at sætte Logniveauet til “debug”, genstarte CUPS-dæmonen og så kigge i fejl-logfilen defineret her for indgange der kunne give dig indblik i besværet.


Dialogen til at indstille CUPS-serveren: Server-logning
Adgangs-logfil

Dette er hvor adgange til serveren bliver logget. Hvis dette ikke begynder med et ledende /, så antages det at være relativ til serverroden.

Du kan også bruge det specielle navn syslog til at sende uddata til syslogfilen eller dæmonen.

Indtast en sti, for eksempel /var/log/cups/acces_log.

Formatet for denne fil gemmes i det såkaldte “Almindelige logformat”. På denne måde kan du bruge programmer såsom Webalyzer eller vilkårlige andre netadgangs-rapportværktøjer til at generere rapporter om CUPS serveraktiviteter.

For at inkludere servernavnet i filnavnet brug et %s i navnet. Eksempel: /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

Du ser en linje for hver enkelt adgang, der viser IP-adressen for adgangsklienten, dato og tid for adgang, adgangsmetode (POST eller GET), den forespurgte ressource, HTTP-versionen brugt af klienten, statuskode og antal overførte byte. Statuskode 200 betyder succes-O.k. 401 i ovenstående eksempel var en uautoriseret adgang som blev afslået. For en detaljeret forklaring af logformatet gå til the CUPS Software Administrator Manual.

Fejl-logfil

Hvis denne ikke starter med et ledende /, så antages den at være relativ til server-root. Standardopsætning er /var/log/cups/error_log.

Du kan også bruge det specielle navn syslog til at sende uddata til syslogfilen eller dæmonen.

Indtast stien, for eksempel /var/log/cups/error_log.

Fejllog-uddraget viser dig den del der er logget for udskrift af testsiden med standardopsætning af Logniveau til “info”. For en forklaring af Logniveau-opsætning se yderligere nedenfor.

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.
Side-logfil

Hvis denne ikke starter med et ledende / så antages det at være relativt til server-root. Standarden er /var/log/cups/page_log

Du kan også bruge det specielle navn syslog til at sende uddata til syslogfilen eller dæmonen.

Indtast stien, for eksempel /var/log/cups/page_log.

Side-logfilen har en linje for hver enkelt side for hvert job udskrevet.

Her er hvordan nogle indgange ser ud:

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

I dette uddrag af filen finder du information om navnene på printerne (GIMP_print_stp_HP and DANKA_infotec_P450) brugt gennem denne server, brugernavnene (kdetest, kurt og root), job-ID'er (“201” til “205”), tidspunkt for udskrift, sidenummer indenfor jobbet og antal kopier for siderne. For eksempel job-ID 204 havde 4 sider og 33 kopier blev udskrevet, job-ID 205 havde 14 kopier af blot 1 side) .

Bemærk

CUPS er afhængig (for sin beregning af antallet af sider i et job) af at sende PostScript® gennem “pstops”-filteret. Se Kivio Flowchart om CUPS-filterarkitekturen for en idé om hvor dette filter passer ind i hele udskriftsprocessen). Derudover afhænger pstops for tællingen af en DSC tilpasset (DSC betyder Document Structuring Conventions, en standard defineret af Adobe) til at blive sendt af klienten. I de fleste tilfælde virker dette.

Denne sidekontering virker imidlertid ikke for nogen “raw” printerkøer (da disse pr definition, ikke bruger nogen filtrering på CUPS-værten og går uden om pstops.) Hvert job der går gennem en “raw” kø tælles som et 1-side-job (muligvis med flere kopier). Dette er især sandt for alle job sendt fra Microsoft® Windows® klienter via Samba til CUPS-serveren, da disse job allerede ankommer i det rigtige format for printeren, fordi klienterne bruger den oprindelige printerdriver.

Bemærk

Jeg leder stadig efter nogen der vil skrive et godt CUPS sidelog-analyseværktøj. Det skulle generere en rapport med grafisk uddata ligesom Webalizer's adgangslog-rapporter. På denne måde kunne du have gode statistikker til brug for kontering om brugen af printere, belastningsafhængigt af tiden på dagen eller ugen, brugere osv. Er der nogen der har lyst?

Logniveau

Denne indstilling kontrollerer antallet af breve der logges til fejl-logfilen. Det kan være en af følgende:

debug2

Log alt.

debug

Log næsten alt.

info

Log alle forespørgsler og tilstandsændringer.

advar

Log fejl og advarsler.

fejl

Log kun fejl.

ingen

Log ingenting.

Hvis du har behov for at løse problemer (eller hvis du ønsker at studere de indre funktioner af CUPS), så sæt logniveauet til debug eller debug2. Så vil error_log have en masse flere indgange (ikke blot fejl, men også informationsindgange).

Du kan bruge dette til at se “levende” hvad CUPS gør når du sender et udskriftsjob. Skriv i en Konsole:

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

Dette vil give dig de sidste 100 linjer (-n 100) af filen på skærmen og en “realtids”-opdatering (-f) af hvad der sker. Følgende listning viser udskriften af en testside (nogle stykker er blevet skåret ud af pladsgrunde... Prøv det selv hvis du har brug for mere info):

 
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 [....]  

Linjerne mærket “D” i begyndelsen er fejlretningsniveau-indgange, dem der er mærket “I” er der på “info”-niveauet.

Maks logfil-størrelse

Kontrollerer den maksimale størrelse af hver logfil før de roteres. Standard er på 1048576 (1 Mb). Sæt dette til 0 for at deaktivere logrotation.

Indtast en størrelse i byte, for eksempel 1048576