日 志 服 务 器
康 林（2011-1-28）
一、日志服务器的架构：
日志服务器由三部分组成：
a) 应用程序日志库
作用：输出日志。
依赖库：ACE
b) 客户端日志DAEMON
作用：收集同一台服务器上所有应用程序的日志，并转发到指定的日志服务器上。
组件：
配置服务管理器（windows下ACE_wrappers/netsvcs/servers/ace_netsvcs.exe, linux下ACE_wrappers/netsvcs/servers/main）
配置服务管理器配置文件（svc.conf）
日志服务库（netsvcs）
依赖库：
ACE、netsvcs、pthread
注意，在linux下配置文件中配置 ACE、netsvcs库时，请使用绝对路径
c) 日志服务器
作用：存储各应用程序生成的日志。以便以后查询。
组件：
配置服务管理器（windows下ACE_wrappers/netsvcs/servers/ace_netsvcs.exe, linux下ACE_wrappers/netsvcs/servers/main）
配置服务管理器配置文件（svc.conf）
日志服务库（netsvcs）
依赖库：
ACE、netsvcs、pthread
注意，在linux下配置文件中配置 ACE、netsvcs库时，请使用绝对路径
二、使用：
1) 服务器的配置：
在日志服务器上，配置服务管理器的配置文件，加入日志策略服务和日志服务。
a) 日志策略服务：
dynamic Logger Service_Object * ACE:_make_ACE_Logging_Strategy() " -f STDERR|VERBOSE"
“”中的为参数，可以设置日志的输出位置，详细程序等策略。参数如下：
/**
* Parse arguments provided in svc.conf file.
* @arg '-f' Pass in the flags (such as OSTREAM, STDERR, LOGGER, VERBOSE,
* SILENT, VERBOSE_LITE) used to control logging.
* @arg '-i' The interval (in seconds) at which the logfile size is sampled
* (default is 0, i.e., do not sample by default).
* @arg '-k' Set the logging key.
* @arg '-m' Maximum logfile size in Kbytes.
* @arg '-n' Set the program name for the %n format specifier.
* @arg '-N' The maximum number of logfiles that we want created.
* @arg '-o' Specifies that we want the no standard logfiles ordering
* (fastest processing in handle_timeout()). Default is not to
* order logfiles.
* @arg '-p' Pass in the process-wide priorities to either enable (e.g.,
* DEBUG, INFO, WARNING, NOTICE, ERROR, CRITICAL, ALERT,
* EMERGENCY) or to disable (e.g., ~DEBUG, ~INFO, ~WARNING,
* ~NOTICE, ~ERROR, ~CRITICAL, ~ALERT, ~EMERGENCY).
* @arg '-s' Ensure that the OSTREAM flag is set and log to the @a filename.
* @arg '-t' Pass in the thread-wide priorities to either enable (e.g.,
* DEBUG, INFO, WARNING, NOTICE, ERROR, CRITICAL, ALERT,
* EMERGENCY) or to disable (e.g., ~DEBUG, ~INFO, ~WARNING,
* ~NOTICE, ~ERROR, ~CRITICAL, ~ALERT, ~EMERGENCY).
* @arg '-w' Cause the logfile to be wiped out, both on startup and on
* reconfiguration.
*/
b) 日志服务：
dynamic Thr_Server_Logging_Service Service_Object * netsvcs:_make_ACE_Thr_Server_Logging_Acceptor() active "-p 20020"
“”中为日志服务的参数：
-p ：日志服务器的监听端口号
2) 客户端日志DAEMON
在应用服务器上配置服务管理器（ismg_daemon）的配置文件，加入客户端日志
DAEMON服务。
dynamic Client_Logging_Service Service_Object * netsvcs:_make_ACE_Client_Logging_Acceptor() active "-p 20020 –h 10.10.1.69"
“”中为客户端日志DAEMON参数：
-p :日志服务器的端口
-h:日志服务器的IP地址
-l:本机IP
-k: 设置 the logging key.即本地的监听IP和端口
（默认：
# if !defined (ACE_DEFAULT_LOGGER_KEY)
# if (ACE_HAS_STREAM_LOG_MSG_IPC == 1)
# define ACE_DEFAULT_LOGGER_KEY ACE_TEXT ("/tmp/server_daemon")
# else
# define ACE_DEFAULT_LOGGER_KEY ACE_TEXT ("localhost:20012")
# endif /* ACE_HAS_STREAM_LOG_MSG_IPC==1 */
# endif /* ACE_DEFAULT_LOGGER_KEY */
）
3) 应用程序输出日志：
你可以直接使用ACE日志宏进行日志输出，详见《ACE日志库使用》。
一般我们在开发中常使用三种级别的日志输出（调试级别、错误级别、信息级别），所以我定义了三个宏：
LOG_DEBUG(X, …)
LOG_ERROR(X, …)
LOG_INFO(X, …)
如果你不是使用配置服务管理器，为了能使用你的程序可以按指定的策略进行输出。为此定义了一个初始化宏。
LOG_INIT(argn, argv)
你可以按前面策略服务所讲的参数进行设置。如果你要自定日志输出策略，你必须在程序启动时调用这个宏进行日志策略初始化。默认的日志输出是直接输出到stderr。
三、日志输出格式约定
a) 信息级别：
各元互素分隔符用 : 分隔，第一个元素为此信息名字
MONITOR:clients:0:close:0:srv_handler:0:recvPackage:0:error:0:heart:0:sends:0:packages:0:resend:0:responsion:0:error:0:buffer:0
b) 错误级别：
请输出错误返回码，和错误内容，第一个元素为此模块名字
c) 调试级别：
输出调试内容，第一个元素为此模块名字
