قالب پرونده گزارش دسترسی (ACCESS LOG FILE FORMAT)

پرونده access_log هر منبع HTTP را که توسط یک مرورگر وب یا کلاینت مورد دسترسی قرار گرفته است، فهرست می‌کند. هر خط در یک نسخه توسعه‌یافته از قالبی موسوم به «قالب گزارش مشترک» (Common Log Format) است که توسط بسیاری از سرورهای وب و ابزارهای گزارش‌گیری وب استفاده می‌شود:

    host group user date-time "method resource version" status bytes
      ipp-operation ipp-status

برای مثال:

10.0.1.2 - - [01/Dec/2005:21:50:28 +0000] "POST / HTTP/1.1" 200 317
  CUPS-Get-Printers successful-ok-ignored-or-substituted-attributes
localhost - - [01/Dec/2005:21:50:32 +0000] "GET /admin HTTP/1.1"
  200 0 - -
localhost - - [01/Dec/2005:21:50:32 +0000] "POST / HTTP/1.1"
  200 157 CUPS-Get-Printers
  successful-ok-ignored-or-substituted-attributes
localhost - - [01/Dec/2005:21:50:32 +0000] "POST / HTTP/1.1"
  200 1411 CUPS-Get-Devices -
localhost - - [01/Dec/2005:21:50:32 +0000] "GET /admin HTTP/1.1"
  200 6667 - -

فیلد host به‌طور معمول تنها یک نشانی IP خواهد بود، مگر اینکه دستورالعمل HostNameLookups را در پرونده cupsd.conf فعال کرده باشید یا نشانی IP مربوط به رایانه محلی شما باشد.

فیلد group همواره شامل "-" است.

فیلد user نام کاربری احرازهویت‌شده کاربر درخواست‌دهنده است. اگر هیچ نام کاربری و گذرواژه‌ای برای درخواست ارائه نشده باشد، این فیلد شامل "-" خواهد بود.

فیلد date-time تاریخ و زمان درخواست به وقت محلی است و در قالب "[DD/MON/YYYY:HH:MM:SS +ZZZZ]" قرار دارد.

فیلد method متد HTTP استفاده‌شده است: "GET"، "HEAD"، "OPTIONS"، "POST" یا "PUT". درخواست‌های "GET" برای دریافت پرونده‌ها از سرور، چه برای رابط کاربری وب و چه برای دریافت پرونده‌های پیکربندی و لاگ، استفاده می‌شوند. درخواست‌های "HEAD" برای دریافت اطلاعات درباره یک منبع پیش از "GET" به کار می‌روند. درخواست‌های "OPTIONS" برای ارتقای اتصالات به رمزنگاری TLS استفاده می‌شوند. درخواست‌های "POST" برای فرم‌های رابط وب و درخواست‌های IPP به کار می‌روند. درخواست‌های "PUT" برای بارگذاری پرونده‌های پیکربندی استفاده می‌شوند.

فیلد resource نام پرونده منبع درخواست‌شده است.

فیلد version نسخه مشخصات HTTP استفاده‌شده توسط کلاینت است. برای کلاینت‌های CUPS این مقدار همواره "HTTP/1.1" خواهد بود.

فیلد status شامل وضعیت نتیجه HTTP درخواست است، به شرح زیر:

فیلد bytes شامل تعداد بایت‌های موجود در درخواست است. برای درخواست‌های POST، فیلد bytes شامل تعداد بایت‌های داده غیر IPP است که از کلاینت دریافت می‌شود.

فیلد ipp-operation برای درخواست‌های غیر IPP شامل "-" و برای درخواست‌های POST حاوی یک درخواست IPP، شامل نام عملیات IPP است.

فیلد ipp-status برای درخواست‌های غیر IPP شامل "-" و برای درخواست‌های POST حاوی یک پاسخ IPP، شامل نام کد وضعیت IPP است.

قالب پرونده گزارش خطا (ERROR LOG FILE FORMAT)

پرونده error_log پیام‌های ارائه‌شده از زمان‌بند را فهرست می‌کند - خطاها، هشدارها و غیره. دستورالعمل LogLevel در پرونده cupsd.conf(5) کنترل می‌کند چه پیام‌هایی ثبت شوند:

level date-time message

برای مثال:

I [20/May/1999:19:18:28 +0000] [Job 1] Queued on 'DeskJet' by 'mike'.
D [20/May/1999:19:18:28 +0000] [Job 1] argv[0]="DeskJet"
D [20/May/1999:19:18:28 +0000] [Job 1] argv[1]="1"
D [20/May/1999:19:18:28 +0000] [Job 1] argv[2]="mike"
D [20/May/1999:19:18:28 +0000] [Job 1] argv[3]="myjob"
D [20/May/1999:19:18:28 +0000] [Job 1] argv[4]="1"
D [20/May/1999:19:18:28 +0000] [Job 1] argv[5]="media=
  na_letter_8.5x11in sides=one-sided"
D [20/May/1999:19:18:28 +0000] [Job 1] argv[6]="/var/spool/cups/
  d000001-001"
I [20/May/1999:19:21:02 +0000] [Job 2] Queued on 'DeskJet' by 'mike'.
I [20/May/1999:19:22:24 +0000] [Job 2] Canceled by 'mike'.

فیلد level نوع پیام را مشخص می‌کند:

A

پیام هشدار فوری (LogLevel alert)

C

پیام خطای بحرانی (LogLevel crit)

D

پیام اشکال‌زدایی (LogLevel debug)

d

پیام اشکال‌زدایی تفصیلی (LogLevel debug2)

E

پیام خطای عادی (LogLevel error)

I

پیام اطلاعاتی (LogLevel info)

N

پیام اعلان (LogLevel notice)

W

پیام هشدار (LogLevel warn)

X

پیام خطای اضطراری (LogLevel emerg)

فیلد date-time شامل تاریخ و زمان پیام است. قالب این فیلد با فیلد date-time در پرونده access_log یکسان است.

فیلد message شامل یک پیام متنی با قالب آزاد است. پیام‌های حاصل از فیلترهای کار دارای پیشوند "[Job NNN]" هستند که در آن "NNN" شناسه کار است.

قالب پرونده گزارش برگه (PAGE LOG FILE FORMAT)

پرونده page_log تعداد کل صفحات (برگه‌ها) را که چاپ شده‌اند فهرست می‌کند. به‌طور پیش‌فرض، هر خط شامل اطلاعات زیر است:

    printer user job-id date-time total num-sheets job-billing
      job-originating-host-name job-name media sides

برای مثال ورودی یک کار دو صفحه‌ای به نام "myjob" ممکن است بدین صورت باشد:

DeskJet root 1 [20/May/1999:19:21:06 +0000] total 2 acme-123
  localhost myjob na_letter_8.5x11in one-sided

از دستورالعمل PageLogFormat در پرونده cupsd.conf(5) می‌توان برای تغییر این اطلاعات استفاده کرد.

فیلد printer شامل نام چاپگری است که صفحه را چاپ کرده است. اگر کاری را به یک رده چاپگر ارسال کنید، این فیلد حاوی نام چاپگری خواهد بود که کار به آن تخصیص یافته است.

فیلد user شامل نام کاربری است (صفت requesting-user-name در IPP) که این پرونده را برای چاپ ارسال کرده است.

فیلد job-id شامل شماره کار صفحه‌ای است که چاپ می‌شود.

فیلد date-time شامل تاریخ و زمان شروع چاپ صفحه است. قالب این فیلد دقیقاً مشابه فیلد date-time در پرونده access_log است.

فیلد num-sheets تعداد کل صفحات (برگه‌ها) را که برای این کار چاپ شده‌اند، ارائه می‌دهد.

فیلد job-billing شامل رونوشتی از صفت‌های job-billing یا job-account-id ارائه‌شده در درخواست‌های Create-Job یا Print-Job پروتکل IPP است، یا در صورتی که هیچ‌کدام ارائه نشده باشند، شامل "-" خواهد بود.

فیلد job-originating-host-name شامل نام میزبان یا نشانی IP کلاینتی است که کار را ارسال کرده است.

فیلد job-name شامل رونوشتی از صفت job-name ارائه‌شده در درخواست‌های Create-Job یا Print-Job پروتکل IPP است، یا در صورتی که هیچ‌کدام ارائه نشده باشند، شامل "-" خواهد بود.

فیلد media شامل رونوشتی از صفت media یا media-col/media-size ارائه‌شده در درخواست‌های Create-Job یا Print-Job پروتکل IPP است، یا در صورتی که ارائه نشده باشد، شامل "-" خواهد بود.

فیلد sides شامل رونوشتی از صفت sides ارائه‌شده در درخواست‌های Create-Job یا Print-Job پروتکل IPP است، یا در صورتی که ارائه نشده باشد، شامل "-" خواهد بود.