home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / sarg1221.zip / sarg.conf < prev    next >
Text File  |  2002-10-08  |  9KB  |  388 lines
  1. # sarg.conf
  2. #
  3. # TAG:  language 
  4. #    Available languages:
  5. #        Bulgarian_windows1251
  6. #        Czech
  7. #        Dutch
  8. #        English
  9. #        French
  10. #        German
  11. #        Hungarian
  12. #        Indonesian
  13. #        Italian
  14. #        Japanese
  15. #        Latvian
  16. #        Polish
  17. #        Portuguese
  18. #        Romanian
  19. #        Russian
  20. #        Russian_koi8
  21. #        Russian_windows1251
  22. #        Serbian
  23. #        Spanish
  24. #        Turkish
  25. #
  26. #language English
  27.  
  28. # TAG:  access_log file
  29. #       Where is the access.log file
  30. #       sarg -l file
  31. #
  32. #access_log /usr/local/squid/logs/access.log
  33.  
  34. # TAG:    title
  35. #     Especify the title for html page.
  36. #
  37. #title "Squid User Access Reports"
  38.  
  39. # TAG:    font_face
  40. #     Especify the font for html page.
  41. #
  42. #font_face Arial
  43.  
  44. # TAG:    header_color
  45. #     Especify the header color
  46. #
  47. #header_color darkblue
  48.  
  49. # TAG:    header_bgcolor
  50. #     Especify the header bgcolor
  51. #
  52. #header_bgcolor blanchedalmond
  53.  
  54. # TAG:    font_size
  55. # TAG:    font_size
  56. #     Especify the font size
  57. #
  58. #header_font_size -1
  59.  
  60. # TAG:    background_color
  61. # TAG:    background_color
  62. #    Html page background color
  63. #
  64. #background_color white
  65.  
  66. # TAG:    text_color
  67. #    Html page text color
  68. #
  69. #text_color black
  70.  
  71. # TAG:    text_bgcolor
  72. #    Html page text background color
  73. #
  74. #text_bgcolor beige
  75.  
  76. # TAG:    title_color
  77. #    Html page title color
  78. #
  79. #title_color green
  80.  
  81. # TAG:    logo_image
  82. #    Html page logo.
  83. #
  84. #logo_image none
  85.  
  86. # TAG:    logo_text
  87. #    Html page logo text.
  88. #
  89. #logo_text ""
  90.  
  91. # TAG:    logo_text_color
  92. #    Html page logo texti color.
  93. #
  94. #logo_text_color black
  95.  
  96. # TAG:    logo_image_size
  97. #    Html page logo image size. 
  98. #       width height
  99. #
  100. #image_size 80 45
  101.  
  102. # TAG:    background_image
  103. #    Html page background image
  104. #
  105. #background_image none
  106.  
  107. # TAG:  password
  108. #       User password file used by authentication
  109. #       If you put here, reports will be generated only for users in.
  110. #
  111. #password none
  112.  
  113. # TAG:  temporary_dir
  114. #       Temporary directory name
  115. #       sarg -w dir
  116. #
  117. #temporary_dir /tmp
  118.  
  119. # TAG:  output_dir
  120. #       Where is the reports will ne stored.
  121. #       sarg -o dir
  122. #
  123. #output_dir /usr/local/etc/httpd/htdocs/squid-reports
  124. #output_dir /home/httpd/html/squid-reports # RedHat version
  125.  
  126. # TAG:  output_email
  127. #       Email address to send the reports
  128. #       sarg -e email
  129. #
  130. #output_email none
  131.  
  132. # TAG:  resolve_ip yes/no
  133. #       Convert ip address to dns name
  134. #       sarg -n
  135. #resolve_ip no
  136.  
  137. # TAG:  user_ip yes/no
  138. #       Use Ip Address instead userid (reports)
  139. #       sarg -p
  140. #user_ip no
  141.  
  142. # TAG:  topuser_sort_field field normal/reverse
  143. #       Sort field for the Topuser Report.
  144. #       Allowed fields: USER CONNECT BYTES TIME
  145. #
  146. #topuser_sort_field BYTES reverse
  147.  
  148. # TAG:  user_sort_field field normal/reverse
  149. #       Sort field for the User Report.
  150. #       Allowed fields: SITE CONNECT BYTES TIME
  151. #
  152. #user_sort_field BYTES reverse
  153.  
  154. # TAG:  exclude_users file
  155. #       users within the file will be excluded from reports.
  156. #       you can use indexonly to have only index.html file.
  157. #
  158. #exclude_users none
  159.  
  160. # TAG:  exclude_hosts file
  161. #       Hosts, domains or subnets will be excluded from reports.
  162. #
  163. #       Eg.: 192.168.10.10 - exclude ip address only
  164. #            192.168.10.0  - exclude full C class
  165. #            s1.acme.foo   - exclude hostname only
  166. #            acme.foo      - exclude full domain name
  167. #
  168. #exclude_hosts none
  169.  
  170. # TAG:  useragent_log file
  171. #       Put here where is useragent.log to nable useragent report.
  172. #
  173. #useragent_log none
  174.  
  175. # TAG:  date_format
  176. #       Date format in reports: e (Europe=dd/mm/yy), u (USA=mm/dd/yy), w (Weekly=yy.ww)
  177. #date_format u
  178.  
  179. # TAG:  per_user_limit file MB
  180. #       Save userid on file if download exceed n MB.
  181. #       
  182. #       This option can be used to disable user access if user exceed a download limit.
  183. #per_user_limit none
  184.  
  185. # TAG: lastlog n
  186. #      How many reports files must be keept in reports directory.
  187. #      The oldest report file will be automatically removed.
  188. #      0 - no limit.
  189. #
  190. #lastlog 0
  191.  
  192. # TAG: remove_temp_files yes
  193. #      Remove temporary files: geral, usuarios, top, periodo from root report directory.
  194. #
  195. #remove_temp_files yes
  196.  
  197. # TAG: index yes|no|only
  198. #      Generate the main index.html.
  199. #      only - generate only the main index.html
  200. #
  201. #index yes
  202.  
  203. # TAG: overwrite_report yes|no
  204. #      yes - if report date already exist then will be overwrited.
  205. #       no - if report date already exist then will be renamed to filename.n, filename.n+1
  206. #
  207. #overwrite_report no
  208.  
  209. # TAG: records_without_userid ignore|ip|everybody
  210. #      What can I do with records without user id (no authentication) in access.log file ?
  211. #
  212. #      ignore - This record will be ignored.
  213. #          ip - Use ip address instead. (default)
  214. #   everybody - Use "everybody" instead.
  215. #
  216. #records_without_userid ip
  217.  
  218. # TAG: use_comma no|yes
  219. #      Use comma instead point in reports.
  220. #      Eg.: use_comma yes => 23,450,110
  221. #           use_comma no  => 23.450.110
  222. #
  223. #use_comma no
  224.  
  225. # TAG: mail_utility mail|mailx
  226. #      Mail command to use to send reports via SMTP
  227. #
  228. #mail_utility mailx
  229.  
  230. # TAG: topsites_num n
  231. #      How many sites in topsites report.
  232. #
  233. #topsites_num 100
  234.  
  235. # TAG: topsites_sort_order CONNECT|BYTES A|D
  236. #      Sort for topsites report, where A=Ascendent, D=Descendent
  237. #
  238. #topsites_sort_order CONNECT D
  239.  
  240. # TAG: exclude_codes file
  241. #      Ignore records with these codes. Eg.: NONE/400
  242. #
  243. #exclude_codes /usr/local/sarg/exclude_codes
  244.  
  245. # TAG: replace_index string
  246. #      Replace "index.html" in the main index file with this string
  247. #      If null "index.html" is used 
  248. #
  249. #replace_index <?php echo str_replace(".", "_", $REMOTE_ADDR); echo ".html"; ?>
  250.  
  251. # TAG: max_elapsed milliseconds
  252. #      If elapsed time is recorded in log is greater than max_elapsed use 0 for elapsed time.
  253. #      Use 0 for no checking 
  254. #
  255. #max_elapsed 0
  256. # 8 Hours
  257. max_elapsed 28800000
  258.  
  259. # TAG: report_type type
  260. #      What kind of reports to generate.
  261. #      topsites        - shows the site, connect and bytes
  262. #      sites_users    - shows which users were accessing a site
  263. #      users_sites    - shows sites accessed by the user
  264. #      date_time    - shows the amount of bytes used by day and hour
  265. #      denied        - show all denied sites with full URL
  266. #      auth_failures    - show autentication failures
  267. #
  268. #      Eg.: report_type topsites denied 
  269. #
  270. #report_type topsites users_sites sites_users date_time denied auth_failures site_user_time_date
  271.  
  272. # TAG: usertab filename
  273. #      You can change the "userid" or the "ip address" to be a real user name on the rpeorts.
  274. #      Table syntax:
  275. #         userid name   or   ip address name
  276. #      Eg:
  277. #        SirIsaac Isaac Newton
  278. #        vinci Leonardo da Vinci
  279. #        192.168.10.1 Karol Wojtyla
  280. #      
  281. #      Each line must be terminated with '\n'
  282. #
  283. #usertab none
  284.  
  285. # TAG: long_url yes|no
  286. #      If yes, the full url is showed in report.
  287. #      If no, only the site will be showed
  288. #
  289. #      YES option generate very big sort files and reports.
  290. #
  291. #long_url no
  292.  
  293. # TAG: date_time_by bytes|elap
  294. #      Date/Time reports will use bytes or elapsed time?
  295. #
  296. #date_time_by bytes
  297.  
  298. # TAG: charset name
  299. #      ISO 8859 is a full series of 10 standardized multilingual single-byte coded (8bit)
  300. #      graphic character sets for writing in alphabetic languages
  301. #      You can use the following charsets:
  302. #        Latin1         - West European
  303. #        Latin2         - East European 
  304. #        Latin3         - South European 
  305. #        Latin4         - North European 
  306. #        Cyrillic 
  307. #        Arabic 
  308. #        Greek 
  309. #        Hebrew 
  310. #        Latin5         - Turkish 
  311. #        Latin6
  312. #        Windows-1251
  313. #        Koi8-r
  314. #        Cyrillic-866
  315. #
  316. #charset Latin1
  317.  
  318. # TAG: user_invalid_char "&/"
  319. #      Records that contain invalid characters in userid will be ignored by Sarg.
  320. #
  321. #user_invalid_char "&/"
  322.  
  323. # TAG: privacy yes|no
  324. #      privacy_string "***.***.***.***"
  325. #      privacy_string_color blue
  326. #      In some countries the sysadm cannot see the visited sites by a restrictive law.
  327. #      Using privacy yes the visited url will be changes by privacy_string and the link
  328. #      will be removed from reports.
  329. #
  330. #privacy no
  331. #privacy_string "***.***.***.***"
  332. #privacy_string_color blue
  333.  
  334. # TAG: include_users "user1:user2:...:usern"
  335. #      Reports will be generated only for listed users.
  336. #
  337. #include_users none
  338.  
  339. # TAG: exclude_string "string1:string2:...:stringn"
  340. #      Records from access.log file that contain one of listed strings will be ignored.
  341. #
  342. #exclude_string none
  343.  
  344. # TAG: show_successful_message yes|no
  345. #      Show "Successful report generated on dir" at end of process.
  346. #
  347. #show_successful_message yes
  348.  
  349. # TAG: topuser_fields
  350. #      Which fields must be in Topuser report.
  351. #
  352. #topuser_fields NUM DATE_TIME USERID CONNECT BYTES %BYTES IN-CACHE-OUT USED_TIME MILISEC %TIME TOTAL AVERAGE
  353.  
  354. # TAG: topuser_num n
  355. #      How many users in topsites report. 0 = no limit
  356. #
  357. #topuser_num 0
  358.  
  359. # TAG: datafile file
  360. #      Save the report results in a file to populate some database
  361. #
  362. #datafile none
  363.  
  364. # TAG: datafile_delimiter ";"
  365. #      ascii character to use as a field separator in datafile
  366. #
  367. #datafile_delimiter ";"
  368.  
  369. # TAG: datafile_fields all
  370. #      Which data fields must be in datafile
  371. #      user;date;time;url;connect;bytes;in_cache;out_cache;elapsed
  372. #
  373. #datafile_fields user;date;time;url;connect;bytes;in_cache;out_cache;elapsed
  374.  
  375. # TAG: weekdays
  376. #      The weekdays to take account ( Sunday->0, Saturday->6 )
  377. # Example:
  378. #weekdays 1-3,5
  379. # Default:
  380. #weekdays 0-6
  381.  
  382. # TAG: hours
  383. #      The hours to take account
  384. # Example:
  385. #hours 7-12,14,16,18-20
  386. # Default:
  387. #hours 0-23
  388.