2 * Copyright (C) 1996-2014 The Squid Software Foundation and contributors
4 * Squid software is distributed under GPLv2+ license and includes
5 * contributions from numerous individuals and organizations.
6 * Please see the COPYING and CONTRIBUTORS files for details.
9 #ifndef SQUID_HTTPACCESSLOGENTRY_H
10 #define SQUID_HTTPACCESSLOGENTRY_H
12 #include "anyp/PortCfg.h"
13 #include "base/RefCount.h"
14 #include "comm/Connection.h"
15 #include "HierarchyLogEntry.h"
16 #include "http/ProtocolVersion.h"
17 #include "http/RequestMethod.h"
18 #include "HttpHeader.h"
19 #include "icp_opcode.h"
20 #include "ip/Address.h"
22 #include "MessageSizes.h"
25 #include "adaptation/icap/Elements.h"
28 #include "ssl/gadgets.h"
36 class AccessLogEntry
: public RefCountable
40 typedef RefCount
<AccessLogEntry
> Pointer
;
42 AccessLogEntry() : url(NULL
), tcpClient(), reply(NULL
), request(NULL
),
43 adapted_request(NULL
) {}
46 /// Fetch the client IP log string into the given buffer.
47 /// Knows about several alternate locations of the IP
48 /// including indirect forwarded-for IP if configured to log that
49 void getLogClientIp(char *buf
, size_t bufsz
) const;
53 /// TCP/IP level details about the client connection
54 Comm::ConnectionPointer tcpClient
;
55 // TCP/IP level details about the server or peer connection
56 // are stored in hier.tcpServer
58 /** \brief This subclass holds log info for HTTP protocol
59 * \todo Inner class declarations should be moved outside
60 * \todo details of HTTP held in the parent class need moving into here.
66 HttpDetails() : method(Http::METHOD_NONE
), code(0), content_type(NULL
),
72 HttpRequestMethod method
;
74 const char *content_type
;
75 AnyP::ProtocolVersion version
;
76 bool timedout
; ///< terminated due to a lifetime or I/O timeout
77 bool aborted
; ///< other abnormal termination (e.g., I/O error)
79 /// compute suffix for the status access.log field
80 const char *statusSfx() const {
81 return timedout
? "_TIMEDOUT" : (aborted
? "_ABORTED" : "");
84 /// counters for the original request received from client
85 // TODO calculate header and payload better (by parser)
86 // XXX payload encoding overheads not calculated at all yet.
87 MessageSizes clientRequestSz
;
89 /// counters for the response sent to client
90 // TODO calculate header and payload better (by parser)
91 // XXX payload encoding overheads not calculated at all yet.
92 MessageSizes clientReplySz
;
96 /** \brief This subclass holds log info for ICP protocol
97 * \todo Inner class declarations should be moved outside
103 IcpDetails() : opcode(ICP_INVALID
) {}
108 /** \brief This subclass holds log info for HTCP protocol
109 * \todo Inner class declarations should be moved outside
114 HtcpDetails() : opcode(NULL
) {};
120 /// logging information specific to the SSL protocol
126 const char *user
; ///< emailAddress from the SSL client certificate
127 int bumpMode
; ///< whether and how the request was SslBumped
131 /** \brief This subclass holds log info for Squid internal stats
132 * \todo Inner class declarations should be moved outside
133 * \todo some details relevant to particular protocols need shuffling to other sub-classes
134 * \todo this object field need renaming to 'squid' or something.
140 CacheDetails() : caddr(),
152 memset(&start_time
, 0, sizeof(start_time
));
153 memset(&trTime
, 0, sizeof(start_time
));
160 struct timeval start_time
; ///< The time the master transaction started
161 struct timeval trTime
; ///< The response time
167 Ssl::X509_Pointer sslClientCert
; ///< cert received from the client
169 AnyP::PortCfgPointer port
;
173 /** \brief This subclass holds log info for various headers in raw format
174 * \todo shuffle this to the relevant protocol section.
180 Headers() : request(NULL
),
181 adapted_request(NULL
),
184 char *request
; //< virgin HTTP request headers
186 char *adapted_request
; //< HTTP request headers after adaptation and redirection
192 /** \brief This subclass holds general adaptation log info.
193 * \todo Inner class declarations should be moved outside.
195 class AdaptationDetails
199 AdaptationDetails(): last_meta(NULL
) {}
201 /// image of the last ICAP response header or eCAP meta received
206 // Why is this a sub-class and not a set of real "private:" fields?
207 // TODO: shuffle this to the relevant ICP/HTCP protocol section
212 Private() : method_str(NULL
) {}
214 const char *method_str
;
216 HierarchyLogEntry hier
;
218 HttpRequest
*request
; //< virgin HTTP request
219 HttpRequest
*adapted_request
; //< HTTP request after adaptation and redirection
221 /// key:value pairs set by squid.conf note directive and
222 /// key=value pairs returned from URL rewrite/redirect helper
223 NotePairs::Pointer notes
;
226 /** \brief This subclass holds log info for ICAP part of request
227 * \todo Inner class declarations should be moved outside
232 IcapLogEntry() : reqMethod(Adaptation::methodNone
), bytesSent(0), bytesRead(0),
233 bodyBytesRead(-1), request(NULL
), reply(NULL
),
234 outcome(Adaptation::Icap::xoUnknown
), resStatus(Http::scNone
)
236 memset(&trTime
, 0, sizeof(trTime
));
237 memset(&ioTime
, 0, sizeof(ioTime
));
238 memset(&processingTime
, 0, sizeof(processingTime
));
241 Ip::Address hostAddr
; ///< ICAP server IP address
242 String serviceName
; ///< ICAP service name
243 String reqUri
; ///< ICAP Request-URI
244 Adaptation::Icap::ICAP::Method reqMethod
; ///< ICAP request method
245 int64_t bytesSent
; ///< number of bytes sent to ICAP server so far
246 int64_t bytesRead
; ///< number of bytes read from ICAP server so far
248 * number of ICAP body bytes read from ICAP server or -1 for no encapsulated
249 * message data in ICAP reply (eg 204 responses)
251 int64_t bodyBytesRead
;
252 HttpRequest
* request
; ///< ICAP request
253 HttpReply
* reply
; ///< ICAP reply
255 Adaptation::Icap::XactOutcome outcome
; ///< final transaction status
256 /** \brief Transaction response time.
257 * The timer starts when the ICAP transaction
258 * is created and stops when the result of the transaction is logged
260 struct timeval trTime
;
261 /** \brief Transaction I/O time.
262 * The timer starts when the first ICAP request
263 * byte is scheduled for sending and stops when the lastbyte of the
264 * ICAP response is received.
266 struct timeval ioTime
;
267 Http::StatusCode resStatus
; ///< ICAP response status code
268 struct timeval processingTime
; ///< total ICAP processing time
277 /* Should be in 'AccessLog.h' as the driver */
278 void accessLogLogTo(CustomLog
* log
, AccessLogEntry::Pointer
&al
, ACLChecklist
* checklist
= NULL
);
279 void accessLogLog(AccessLogEntry::Pointer
&, ACLChecklist
* checklist
);
280 void accessLogRotate(void);
281 void accessLogClose(void);
282 void accessLogInit(void);
283 const char *accessLogTime(time_t);
285 #endif /* SQUID_HTTPACCESSLOGENTRY_H */