X-Git-Url: http://git.indexdata.com/?a=blobdiff_plain;f=doc%2Flog.xml;h=adf27abf37f143522a488eb61da912d4b8bc6817;hb=c1d953eee6c00432493bc364da6284704ccd9cc2;hp=1c3cf5ccd76bb7a29241b099a9e3e0912b43fa83;hpb=637a685d61a9ff0e3f398a59da426979815c4d68;p=metaproxy-moved-to-github.git diff --git a/doc/log.xml b/doc/log.xml index 1c3cf5c..adf27ab 100644 --- a/doc/log.xml +++ b/doc/log.xml @@ -1,16 +1,20 @@ - - - %common; + + %idcommon; ]> - + + Metaproxy + Index Data + + log 3mp - Metaproxy Module - + Metaproxy Module + log @@ -35,7 +39,7 @@ filename - Specifies a name of file that log messages is written to. + Specifies a name of log file. @@ -48,74 +52,239 @@ for disabled. The following category attributes are supported: + + access + + + One line log messages inspired by Apache access log entries. + This is a brief message stating the request and response. + This is enabled by default. All other categories are disabled by + default. See the section ACCESS LOG. + + + + user-access + + + One line log messages similar to access but + with the authenticated user on each log line. + + + + request-apdu + + + Z39.50 Request APDU. + + + + response-apdu + + + Z39.50 Response APDU. + + + + apdu + + + Z39.50 APDU (request and response) + + + + request-session + + + Request session. + + + + response-session + + + Response session. + + + + session + + + Session (request and response) + + + + init-options + + + Z39.50 Init Request options + + + + + + + + + + + + + The access log + + The access is is strictly one line per entry and aims for + easy mangling with tools such as awk, grep, perl etc. + Many values may be omitted in the packages in which case a single + dash is printed instead. This is to ensure that all values have + well-defined position. + + + The basic format and order is - access - - - One line log messages inspired by Apache access log entries. - This is a brief message stating the request and response. - This is enabled by default. All other categories are disabled by - default. + time (position 1) + + Full time of event - request-apdu - - - Z39.50 Request APDU. + + Custom message (position 2) + + The string as given in element message. - response-apdu - + + IP (position 3) + + IP address of origin (peer) + - Z39.50 Response APDU. + If category user-acesss is used the + user is written on position 3 and the IP is written on position 4. - apdu - - - Z39.50 APDU (request and response) + + session (position 4) + + Session ID. Can be used to identify a particular Z39.50 session. + For HTTP this session ID only tracks the HTTP socket (kept alive). + NOT to be confused the the HTTP cookie mechanism. - request-session - - - Request session. + + elapsed (position 5) + + Elapsed time . + The elapsed time is the time between the point in time + where a package was received form the client and the + point where a response was received from the next filter + in chain (backend eventually). - response-session - - - Response session. + protocol (position 6) + + Protocol type which is one of Z3950 or + HTTP_Request or + HTTP_Response. - session - + + + + + For packages of with protocol marker Z3950 + the the access log line is followed by the APDU type + information + depending on the type. The APDU type is on position 7. + + + + initRequest + + Z39.50 Initialize Request with the information + username, vhost, + implementation ID, implementation name, implementation version. + + + + + initResponse + + Z39.50 Initialize Response with the information: + status (OK or FAIL), implementatino ID, implementation name, + implementation version. + + + + + searchRequest + + Z39.50 Search Request with the information: + database(s), result set ID, record syntax, query. + - Session (request and response) + Multiple databases are separated by + a plus-sign (+). The query itself is + multiple tokens. For this reason it is placed as the last + information on this log entry. - init-options - + + searchResponse + + Z39.50 Search Response with the information: + status (OK or FAIL), hit count, number of records returned, + next result set position. + + + + + presentRequest + + Z39.50 Present Request with the information: + result Set ID, start position, number of records requested, + record syntax, record composition. + + + + + presentResponse + + Z39.50 Present Response with the information: + status (OK, DIAG, ERROR), number of records returned, + next result set position. + + + + + scanRequest + + Z39.50 Scan Request with the information: + database(s), number of terms requested, preferred position in + response, step size, start point. + - Z39.50 Init Request options + start point is a multi token value in PQF notation. - - - + + scanResponse + + Z39.50 Scan Response with the information: + status (OK, ERROR), number of entries returned, position of term, + step size. + + EXAMPLES