日志
####


Basic logging
==============

* uWSGI 中最基本的日志记录的形式是将请求、错误和信息消息写到标准输出 / 标准错误。这是默认配置中使用的方式。
* 日志重定向的最基本的形式是 --logto / --logto2 / --daemonize 选项，它们允许你重定向日志到文件中。


Basic logging to files
----------------------

要将日志写到文件中，而不是标准输出 / 标准错误，则使用 --logto ，或者同时守护 uWSGI， --daemonize::

    ./uwsgi -s :3031 -w simple_app --daemonize /tmp/mylog.log

    ./uwsgi -s :3031 -w simple_app --logto /tmp/mylog.log

    # logto2 only opens the log file after privileges have been dropped to the specified uid/gid.
    ./uwsgi -s :3031 -w simple_app --uid 1001 --gid 1002 --logto2 /tmp/mylog.log


Basic logging (connected UDP mode)
-----------------------------------

启用连接 UDP 模式，则传递 UDP 服务器的地址到 --daemonize/--logto 选项::

    ./uwsgi -s :3031 -w simple_app --daemonize 192.168.0.100:1717
    ./uwsgi -s :3031 -w simple_app --logto 192.168.0.100:1717

需要一个 UDP 服务器，它将管理你的 UDP 消息::

    $ nc -u -p 1717 -s 192.168.0.100 -l
    or
    $ ./uwsgi --udp 192.168.0.100:1717



可插拔记录器
============

* 要设置一个可插拔记录器，则使用 ``--logger`` 或者 ``--req-logger`` 选项。 
* ``--logger`` 将为每条消息设置一个记录器，而 ``--req-logger`` 将会为请求信息消息设置一个记录器。


语法::

    --logger <plugin>[:options]
    --logger "<name> <plugin>[:options]" # The quotes are only required on the command line -- config files don't use them


示例::

    # 写日志到文件中 
    req-logger = file:/tmp/reqlog
    logger = file:/tmp/errlog

    # 写日志到 socket
    uwsgi --socket :3031 --logger socket:192.168.173.19:5050

    # 写日志到 syslog
    uwsgi --socket :3031 --logger syslog:uwsgi1234

    # Redis 记录器 
    --logger redislog[:<host>,<command>,<prefix>]
    --logger redislog:/tmp/redis.sock,rpush foo,example.com


    # MongoDB 记录器 
    --logger mongodblog[:<host>,<collection>,<node>]
    --logger mongodblog:127.0.0.1:9090,foo.bar





格式化--logformat
=================


offsetof::

    %(uri) -> REQUEST_URI
    %(method) -> REQUEST_METHOD
    %(user) -> REMOTE_USER
    %(addr) -> REMOTE_ADDR
    %(host) -> HTTP_HOST
    %(proto) -> SERVER_PROTOCOL
    %(uagent) -> HTTP_USER_AGENT (自 1.4.5 起)
    %(referer) -> HTTP_REFERER (自 1.4.5 起)

函数::

    %(status) -> HTTP 响应状态码
    %(micros) -> 响应时间，以微秒为单位
    %(msecs) -> 响应时间，以毫秒为单位
    %(time) -> 请求开始的时间戳
    %(ctime) -> 请求开始的 ctime
    %(epoch) -> Unix 格式的当前时间
    %(size) -> 响应体大小 + 响应头大小 (自 1.4.5 起)
    %(ltime) -> 人类可读 (Apache 风格) 的请求时间 (自 1.4.5 起)
    %(hsize) -> 响应头大小 (自 1.4.5 起)
    %(rsize) -> 响应体大小 (自 1.4.5 起)
    %(cl) -> 请求内容体大小 (自 1.4.5 起)
    %(pid) -> 处理请求的 worker 的 pid (自 1.4.6 起)
    %(wid) -> 处理请求的 worker 的 id (自 1.4.6 起)
    %(switches) -> 异步切换数 (自 1.4.6 起)
    %(vars) -> 请求中的 CGI 变量数 (自 1.4.6 起)
    %(headers) -> 已生成的响应头数 (自 1.4.6 起)
    %(core) -> 运行请求的核心 (自 1.4.6 起)
    %(vsz) -> 地址空间 / 虚拟内存使用 (单位为字节) (自 1.4.6 起)
    %(rss) -> RSS 内存使用 (单位为字节) (自 1.4.6 起)
    %(vszM) -> 地址空间 / 虚拟内存使用 (单位为 MB) (自 1.4.6 起)
    %(rssM) -> RSS 内存使用 (单位为 MB) (自 1.4.6 起)
    %(pktsize) -> 内部的请求 uwsgi 包大小 (自 1.4.6 起)
    %(modifier1) -> 请求的 modifier1 (自 1.4.6 起)
    %(modifier2) -> 请求的 modifier2 (自 1.4.6 起)
    %(metric.XXX) -> 访问 XXX 度量值 (见 度量（Metrics）子系统)
    %(rerr) -> 请求的读错误数 (自 1.9.21 起)
    %(werr) -> 请求的写错误数 (自 1.9.21 起)
    %(ioerr) -> 请求的读写错误数 (自 1.9.21 起)
    %(tmsecs) -> 请求开始时间戳，自纪元起，单位为毫秒 (自 1.9.21 起)
    %(tmicros) -> 请求开始时间戳，自纪元起，单位为微秒 (自 1.9.21 起)
    %(var.XXX) -> 请求变量 XXX 的内容 (例如 var.PATH_INFO，自 1.9.21 起可用)