[master] e726134 Sync with reality
Federico G. Schwindt
fgsch at lodoss.net
Fri Jan 16 16:08:24 CET 2015
Author: Federico G. Schwindt <fgsch at lodoss.net>
Date: Fri Jan 16 15:06:20 2015 +0000
Sync with reality
This updates the last oustanding document to 4.0
diff --git a/doc/sphinx/users-guide/operation-logging.rst b/doc/sphinx/users-guide/operation-logging.rst
index 22b9e4c..d3e715c 100644
@@ -20,13 +20,13 @@ is logging. `varnishlog` gives you the raw logs, everything that is
written to the logs. There are other clients that can access the logs as well, we'll show you
-In the terminal window you started Varnish now type ``varnishlog`` and
+In the terminal window you started Varnish now type ``varnishlog -g raw``
+and press enter.
You'll see lines like these scrolling slowly by.::
- 0 CLI - Rd ping
- 0 CLI - Wr 200 PONG 1273698726 1.0
+ 0 CLI - Rd ping
+ 0 CLI - Wr 200 19 PONG 1273698726 1.0
These is the Varnish master process checking up on the caching process
to see that everything is OK.
@@ -37,25 +37,24 @@ app.
You'll see lines like these.::
- 11 SessionOpen c 127.0.0.1 58912 0.0.0.0:8080
- 11 ReqStart c 127.0.0.1 58912 595005213
- 11 RxRequest c GET
- 11 RxURL c /
- 11 RxProtocol c HTTP/1.1
- 11 RxHeader c Host: localhost:8080
- 11 RxHeader c Connection: keep-alive
+ 11 SessOpen c 127.0.0.1 58912 :8080 0.0.0.0 8080 1273698726.933590 14
+ 11 ReqStart c 127.0.0.1 58912
+ 11 ReqMethod c GET
+ 11 ReqURL c /
+ 11 ReqProtocol c HTTP/1.1
+ 11 ReqHeader c Host: localhost:8080
+ 11 ReqHeader c Connection: keep-alive
The first column is an arbitrary number, it identifies the
-session. Lines with the same number are coming from the same session
-and are being handled by the same thread. The second column is the
-*tag* of the log message. All log entries are tagged with a tag
-indicating what sort of activity is being logged. Tags starting with
-'Rx' indicate Varnish is receiving data and 'Tx' indicates sending data.
+transaction. Lines with the same number are coming from the same
+transaction. The second column is the *tag* of the log message. All
+log entries are tagged with a tag indicating what sort of activity is
-The third column tell us whether this is is data coming or going to
-the client ('c') or to/from the backend ('b'). The forth column is the
-data being logged.
+The third column tell us whether this is is data coming from or going
+to the client ('c'), or the backend ('b'). The forth column is the data
Now, you can filter quite a bit with `varnishlog`. The basic options we think you
want to know are:
@@ -67,9 +66,11 @@ want to know are:
Same as '-b' but for client side traffic.
- Only list transactions where the tag matches a regular expression. If
- it matches you will get the whole transaction.
+ Group transactions by request.
+ Only list transactions matching this query.
.. XXX:Maybe a couple of sample commands here? benc
More information about the varnish-commit