日志系统之ACE日志服务.doc

日志系统之ACE日志服务 2007-8-22 目 录 1 基本使用 2 1.1 日志输出宏 2 1.2 日志的等级 2 1.3 格式化指令 3 1.4 例1-日志的简单示例 4 2 日志的输出过滤 5 2.1 输出过滤原理 5 2.2 编译时刻设定 6 2.3 运行时刻设定 8 3 日志的输出重定向 9 3.1输出重定向的涉及函数 9 3.2例2-输出重定向的综合示例 10 4 使用Logging Strategy进行运行时配置 11 4.1 配置选项 11 4.2 例3-运行配置示例 12 ACE日志服务是ACE库的一个功能模块，具有线程安全、灵活、分级显示等特点，可以面向程序调试、运行、测试、和维护等全生命周期，可以选择将信息输出到屏幕、文件、系统日志（如Windows下的Event log）、甚至是远程服务器。除此之外，ACE日志系统支持回调函数以及运行时刻动态配置（Runtime Configuration ）。 1 基本使用 1.1 日志输出宏 ACE日志的使用主要通过宏ACE_XXX((severity, formatting-args))进行日志输出。其中severity为日志等级(见1.2小节)，formatting-args是要输出的内容，类似printf()函数的可变参数，其中也可以包含以’%’开头的格式化指令(见1.3小节)。 注意日志输出宏包括两层圆括号，外层括号是为了宏展开时指定宏的参数，内层的括号则为了宏展开成函数后指定函数参数。日志输出宏包括： ACE_ERROR((level, string, ...)) ACE_DEBUG((level, string, ...)) ACE_TRACE(string) ACE_ASSERT(test) ACE_HEX_DUMP((level, buffer, size [,text])) ACE_RETURN(value) ACE_ERROR_RETURN((level, string, ...), value) ACE_ERROR_INIT( value, flags ) ACE_ERROR_BREAK((level, string, ...)) 1.2 日志的等级 Severity Level Meaning LM_TRACE Messages indicating function-calling sequence LM_DEBUG Debugging information LM_INFO Messages that contain information normally of use only when debugging a program LM_NOTICE Conditions that are not error conditions but that may require special handling LM_WARNING Warning messages LM_ERROR Error messages LM_CRITICAL Critical conditions, such as hard device errors LM_ALERT A condition that should be corrected immediately, such as a corrupted system database LM_EMERGENCY A panic condition, normally broadcast to all users 1.3 格式化指令 Code Argument Type Displays A ACE_timer_t Floating-point number; long decimal number if platform doesnt support floating point a — Aborts the program after displaying output c char Single character C char* Character string (narrow characters) i,d int Decimal number I — Indents output according to the nesting depth, obtained from ACE_Trace::get_nesting_indent() e,E,f,F,g,G double Double-precision floating-point number l — Line number where logging macro appears M — Text for