From: eldy <> Date: Thu, 18 Sep 2003 13:54:25 +0000 (+0000) Subject: Update documentation X-Git-Tag: AWSTATS_5_9_BETA~32 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=e734e4c6a13fc62332c0056ce42cbee8d5e437c2;p=thirdparty%2FAWStats.git Update documentation --- diff --git a/docs/awstats_glossary.html b/docs/awstats_glossary.html index 1bfabd2f..393ca834 100644 --- a/docs/awstats_glossary.html +++ b/docs/awstats_glossary.html @@ -41,7 +41,6 @@ The period shown by AWStats reports is by default the current month.
However if you use AWStats as a CGI you can click on the "year" link to have a report for all the year. In a such report, period is full year, so Unique Visitors are number of hosts that have made at least 1 hit on 1 page of your web site during those year.
-
Visits:
@@ -50,7 +49,6 @@ Think "session" here, say a unique IP accesses a page, and then requests three o between any of the requests, all of the "pages" are included in the visit, therefore you should expect multiple pages per visit and multiple visits per unique visitor (assuming that some of the unique IPs are logged with more than an hour between requests)
-
Pages:
@@ -58,19 +56,16 @@ The number of "pages" logged. Only files that don't match an entry in the NotPag parameter (and match an entry of OnlyFiles config parameter if used) are counted as "Pages". Usually pages are reserved for HTML files or CGI files, not images nor other files requested as a result of loading a "Page" (like js,css... files).
-
Hits:
Any files requested from the server (including files that are "Pages") except those that match the SkipFiles config parameter.
-
Bandwidth:
Total number of bytes downloaded.
-
Entry Page:
@@ -78,7 +73,6 @@ First page viewed by a visitor during its visit.
Note: When a visit started at end of month to end at beginning of next month, you might have an Entry page for the month report and no Exit pages.
That's why Entry pages can be different than Exit pages.
-
Exit Page:
@@ -86,7 +80,6 @@ Last page viewed by a visitor during its visit.
Note: When a visit started at end of month to end at beginning of next month, you might have an Entry page for the month report and no Exit pages.
That's why Entry pages can be different than Exit pages.
-
Session Duration:
@@ -95,13 +88,11 @@ Some Visits durations are 'unknown' because they can't always be calculated. Thi - Visit was not finished when 'update' occured.
- Visit started the last hour (after 23:00) of the last day of a month (A technical reason prevents AWStats from calculating duration of such sessions).
-
Grabber:
A browser that is used primarily for copying locally an entire site. These include for example "teleport", "webcapture", "webcopier"...
-
Add To Favourites:
@@ -113,58 +104,53 @@ x = Number of hits made by IE browsers for "/anydir/favicon.ico" with no 404 err y = Number of hits made by IE browsers for "/favicon.ico" (with or without 404 error)
r = Ratio of hits made by IE browsers compared to hits made by all browsers (r <= 1)

-
+ HTTP Status Codes:
- -HTTP -status codes are returned by web servers to indicate the status of a request. -The status code is a 3-digit code indicating the particular response. The -first digit of this code identifies the class of the status code. The remaining -2 digits correspond to the specific condition within the response class. -The following table outlines all status codes defined for the HTTP/1.1 -draft specification outlined in IETF -rfc 2068.  +HTTP status codes are returned by web servers to indicate the status of a request. +Codes 200 and 304 are used to tell the browser the page can be viewed. +All other codes generates hits and traffic 'not seen' by the visitor. For example a return +code 301 or 302 will tell the browser to ask another page. The browser will do another hit +and should finaly receive the page with a return code 200 and 304. +All codes that are 'unseen' traffic are isolated by AWStats in the HTTP Status report chart, +enabled by the directives ShowHTTPErrorsStats. +in config file. You can also change value for 'not error' hits (set by default to 200 and 304 +with the ValidHTTPcodes directive. +The following table outlines all status codes defined for the HTTP/1.1 draft specification +outlined in IETF rfc 2068.
+They are 3-digit codes where the first digit of this code identifies the class of the status +code and the remaining 2 digits correspond to the specific condition within the response class. They are classified in 5 categories:
- +
- + -
+ 1xx class - Informational
Informational status codes are provisional responses from the web server... they give the client a heads-up on what the server is doing. Informational codes do not indicate an error condition.  - +
- - - + - - - + @@ -174,241 +160,187 @@ the client asks to switch from HTTP/1.0 to HTTP/1.1 
This class of status code indicates that the client's request was received, understood, and successful.  -
100100 -Continue +100100 Continue
The continue status code tells the browser to continue sending a request to the server. 
101101 -Switching Protocols +101101 Switching Protocols
The server sends this response when the client asks to switch from HTTP/1.0 to HTTP/1.1 
+
- - - + + - - - + + - - - + + - - - + + - - - + + - - - + + - - - + +
200200 -Successful200200 Successful
201201 -Created201201 Created
202202 -Accepted202202 Accepted
203203 -Non-Authorative Information203203 Non-Authorative Information
204204 -No Content204204 No Content
205205 -Reset Content205205 Reset Content
206206 -Partial Content +206206 Partial Content
The partial content success code is issued when the server fulfills a partial GET request. This happens when the client is downloading a multi-part document or part of a larger file. 
-

3xx class - Redirection + +3xx class - Redirection
This code tells the client that the browser should be redirected to another URL in order to complete the request. This is not an error condition.  - +
- - - + + - - - + + - - - + + - - - + + - - - + + - - - + + +
300300 -Multiple Choices300300 Multiple Choices
301301 -Moved Permanently301301 Moved Permanently
302302 -Moved Temporarily302302 Moved Temporarily
303303 -See Other303303 See Other
304304 -Not Modified304304 Not Modified
305305 -Use Proxy305305 Use Proxy
-

4xx class - Client Error + +4xx class - Client Error
This status code indicates that the client has sent bad data or a malformed request to the server. Client errors are generally issued by the webserver when a client tries to gain access to a protected area using a bad username and password.  - +
- - - + + - - - + + - - - + + - - - + + - - - + + - - - + + - - - + + - - - + + - - - + + - - - + + - - - + + - - - + + - - - + + - - - + + - - - + + - - - + + +
400400 -Bad Request400400 Bad Request
401401 -Unauthorized401401 Unauthorized
402402 -Payment Required402402 Payment Required
403403 -Forbidden403403 Forbidden
404404 -Not Found404404 Not Found
405400 -Method Not Allowed405400 Method Not Allowed
406400 -Not Acceptable406400 Not Acceptable
407400 -Proxy Authentication Required407400 Proxy Authentication Required
408400 -Request Timeout408400 Request Timeout
409409 -Conflict409409 Conflict
410410 -Gone410410 Gone
411411 -Length Required411411 Length Required
412412 -Precondition Failed412412 Precondition Failed
413413 -Request Entity Too Long413413 Request Entity Too Long
414414 -Request-URI Too Long414414 Request-URI Too Long
415415 -Unsupported Media Type415415 Unsupported Media Type
- -

5xx class - Server Error + + +5xx class - Server Error
This status code indicates that the client's request couldn't be succesfully processed due to some internal error in the web server. These error codes may indicate something is seriously wrong with the web server.  - +
- - - + - - - + - - - + - - - + - - - + - - - + +
500500 -Internal Server Error +500500 Internal Server Error
An internal server error has caused the server to abort your request. This is an error condition that may also indicate a misconfiguration with the web server. However, the most common @@ -417,10 +349,8 @@ syntax errors. 
501501 -Not Implemented +501501 Not Implemented
This code is generated by a webserver when the client requests a service that is not implemented on the server. Typically, not implemented codes are returned when a client attempts to @@ -429,92 +359,254 @@ file). 
502502 -Bad Gateway +502502 Bad Gateway
The server, when acting as a proxy, issues this response when it receives a bad response from an upstream or support server. 
503503 -Service Unavailable +503503 Service Unavailable
The web server is too busy processing current requests to listen to a new client. This error represents a serious problem with the webserver (normally solved with a reboot). 
504504 -Gateway Timeout +504504 Gateway Timeout
Gateway timeouts are normally issued by proxy servers when an upstream or support server doesn't respond to a request in a timely fashion. 
505505 -HTTP Version Not Supported +505505 HTTP Version Not Supported
The server issues this status code when a client tries to talk using an HTTP protocol that the server doesn't support or is configured to ignore.

+ +
SMTP Status Codes:
-SMTP -status codes are returned by mail servers to indicate the status of a sending/receiving mail. +SMTP status codes are returned by mail servers to indicate the status of a sending/receiving mail. The status code depends on mail server and preprocessor used to analyze log file.
-This is value reported for Postfix mail server when mail log file is preprocessing -with maillogconvert:
+All codes that are failure codes are isolated by AWStats in the SMTP Status report chart, +enabled by the directives ShowSMTPErrorsStats in AWStats +config file. You can decide which codes are successfull mail transfer that should not appear +in this chart with the ValidSMTPCodes directive.
+Here are values reported for most mail servers (This should also be values when mail log file +is preprocessing with maillogconvert.pl).
+SMTP Errors are classified in 3 categories:
+ - + +
+ + + + +4xx class - Temporary Errors +
+Those codes are temporary error message. They are used to tell client sender that +an error occured but he can try to solve it but trying again, so in most cases, clients that +receive such codes will keep the mail in their queue and will try again later.
+ + +
-xxx class - Errors -
  + + +2xx/3xx class - Success +
+They are SMTP protocols successfull answers + - +
- - - + + - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
450450 -User Unknown -
The mail server has receive an email for an unknown user -so mail was rejected. 		200200 Non standard success response +
Non standard success response
554554 -Relay denied -
The SMTP server was used to send a mail from a user/ip/domain x -to a user/ip/domain y with a path x to y that is not allowed 		211211 System status, or system help reply +
System status, or system help reply
214214 Help message +
Help message
220220 Service ready +
Service ready
221221 Service closing transmission channel +
Service closing transmission channel
250250 Requested mail action taken and completed +
Your ISP mail server have successfully executes a command and the DNS is reporting a positive delivery.
251251 User not local: will forward to +
Your message to a specified email address is not local to the mail server, but it will accept and forward the message to a different recipient email address.
252252 Recipient cannot be verified +
Recipient cannot be verified but mail server accepts the message and attempts delivery
354354 Start mail input and end with . +
Indicates mail server is ready to accept the message or instruct your mail client to send the message body after the mail server have received the message headers.
- -
+ + + + + + + + + + + + + + + + + + + +
421421 Service not available, closing transmission channel +
This may be a reply to any command if the service knows it must shut down.
450450 Requested mail action not taken: mailbox busy or access denied +
Your ISP mail server indicates that an email address does not exist or the mailbox is busy. It could be the network connection went down while sending, or it could also happen if the remote mail server does not want to accept mail from you for some reason i.e. (IP address, From address, Recipient, etc.)
451451 Requested mail action aborted: error in processing +
Your ISP mail server indicates that the mailing has been interrupted, usually due to overloading from too many messages or transient failure is one in which the message sent is valid, but some temporary event prevents the successful sending of the message. Sending in the future may be successful.
452452 Requested mail action not taken: insufficient system storage +
Your ISP mail server indicates, probable overloading from too many messages and sending in the future may be successful.
453453 Too many messages +
Some mail servers have the option to reduce the number of concurrent connection and also the number of messages sent per connection. If you have a lot of messages queued up it could go over the max number of messages per connection. To see if this is the case you can try submitting only a few messages to that domain at a time and then keep increasing the number until you find the maximum number accepted by the server.
+ + +5xx class - Permanent Errors +
+This are permant error codes. Mail transfer is definitly a failure. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
500500 Syntax error, command unrecognized or command line too long +
501501 Syntax error in parameters or arguments +
502502 Command not implemented +
503503 Server encountered bad sequence of commands +
504504 Command parameter not implemented +
521521 does not accept mail or closing transmission channel +
You must be pop-authenticated before you can use this SMTP server and you must use your mail address for the Sender/From field.
530530 Access denied +
A sendmailism ?
550550 Requested mail action not taken (Relaying not allowed, Unknown recipient user, ...) +
Sending an email to recipients outside of your domain are not allowed or your mail server does not know that you have access to use it for relaying messages and authentication is required. Or to prevent the sending of SPAM some mail servers will not allow (relay) send mail to any e-mail using another company’s network and computer resources.
551551 User not local: please try or Invalid Address: Relay request denied +
552552 Requested mail action aborted: exceeded storage allocation +
ISP mail server indicates, probable overloading from too many messages.
553553 Requested mail action not taken: mailbox name not allowed +
Some mail servers have the option to reduce the number of concurrent connection and also the number of messages sent per connection. If you have a lot of messages queued up (being sent) for a domain, it could go over the maximum number of messages per connection and/or some change to the message and/or destination must be made for successful delivery.
554554 Requested mail action rejected: access denied +
557557 Too many duplicate messages +
Resource temporarily unavailable Indicates (probable) that there is some kind of anti-spam system on the mail server.
+ + + +