Changeset 280 for etherws/trunk/README.rst

Timestamp:

06/25/15 14:27:54 (9 years ago)

Author:

atzm

Message:

• logging support

File:

• etherws/trunk/README.rst (modified) (2 diffs)

etherws/trunk/README.rst

@@ -128 +128 @@
 Advanced Usage
 ==============
+
+Proxy
+-----
+You can create WebSocket tunnels via HTTP proxy.  Proxy server's address and
+port number are specified by generic environment variables: e.g. *$http_proxy*
+
+See https://docs.python.org/library/urllib.html for more information about
+environment variables for the proxy.
+
+Logging
+-------
+etherws uses standard logging library.  You can customize the logger using the
+*fileConfig* described in https://docs.python.org/library/logging.config.html
+
+To run *etherws sw* with the custom logger::
+
+  # etherws sw --logconf /path/to/logging.ini
+
+etherws uses a logger stream named "etherws".  And internally Tornado uses
+some logger streams described in http://www.tornadoweb.org/en/stable/log.html
+
+Note: etherws does not write debug logs even if you simply configure loglevel
+DEBUG, to avoid performance degradation.  To write debug logs, you can
+specify *--debug* option.
 
 Remote Control
@@ -203 +227 @@
 =======
 1.3
+  - logging support
   - http proxy support on client connection
   - fix listport bug on tornado 4.0.x