本文谢绝转载,如有需要,请以链接的方式引用。
注:本文中的代码为git库中的dpdk-2.0.0-rc1,对应Linux平台。
1 log简介
dpdk中通过log系统记录相关的日志信息,每一条日志除日志内容外,还有两个附加信息,log级别和log类型。开发人员可根据级别和类型对日志信息进行过滤,只记录
必要的日志。
1.1 log级别
根据日志信息的优先级高低,dpdk将日志信息分为8个级别,其中RTE_LOG_DEBUG的值为8,这是日志的最高级别,也就是说记录的日志信息最多;相应的,RTE_LOG_EMERG为日志的最低级别,只记录严重的错误信息。dpdk在运行时只有一个log级别,代码中每一条日志都有其固定的log级别,只有代码的log级别小于等于当前系统的log级别时
,才有可能记录该条日志(还要参考log类型)。
log级别的相关宏在“./lib/librte_eal/common/include/rte_log.h”中定义:
91 /* Can‘t use 0, as it gives compiler warnings */
92 #define RTE_LOG_EMERG 1U /**< System is unusable. */
93 #define RTE_LOG_ALERT 2U /**< Action must be taken immediately. */
94 #define RTE_LOG_CRIT 3U /**< Critical conditions. */
95 #define RTE_LOG_ERR 4U /**< Error conditions. */
96 #define RTE_LOG_WARNING 5U /**< Warning conditions. */
97 #define RTE_LOG_NOTICE 6U /**< Normal but significant condition. */
98 #define RTE_LOG_INFO 7U /**< Informational. */
99 #define RTE_LOG_DEBUG 8U /**< Debug-level messages. */
1.2 log类型
与常见的log系统不同(如Linux的syslog),dpdk还根据日志所属的不同模块,将日志分为不同的log类型。每种log类型通过一个bit来表示,这与log级别不同,dpdk在运行时可以配置多个log类型(保存为bitmap)。代码中每一条日志都有其固定的log类型,当该log类型相应的bit置1时,才有可能记录该条日志(还要参考log级别)。
dpdk除了默认的log类型外,还留给用户8个可由用户自定义的log类型,用户可利用这8个自定义的log类型,将转发程序中的日志进行更详细的分类。
log类型的相关宏在“./liblibrte_eal/common/include/rte_log.h”中定义:
63 /* SDK log type */
64 #define RTE_LOGTYPE_EAL 0x00000001 /**< Log related to eal. */
65 #define RTE_LOGTYPE_MALLOC 0x00000002 /**< Log related to malloc. */
66 #define RTE_LOGTYPE_RING 0x00000004 /**< Log related to ring. */
67 #define RTE_LOGTYPE_MEMPOOL 0x00000008 /**< Log related to mempool. */
68 #define RTE_LOGTYPE_TIMER 0x00000010 /**< Log related to timers. */
69 #define RTE_LOGTYPE_PMD 0x00000020 /**< Log related to poll mode driver. */
70 #define RTE_LOGTYPE_HASH 0x00000040 /**< Log related to hash table. */
71 #define RTE_LOGTYPE_LPM 0x00000080 /**< Log related to LPM. */
72 #define RTE_LOGTYPE_KNI 0x00000100 /**< Log related to KNI. */
73 #define RTE_LOGTYPE_ACL 0x00000200 /**< Log related to ACL. */
74 #define RTE_LOGTYPE_POWER 0x00000400 /**< Log related to power. */
75 #define RTE_LOGTYPE_METER 0x00000800 /**< Log related to QoS meter. */
76 #define RTE_LOGTYPE_SCHED 0x00001000 /**< Log related to QoS port scheduler. */
77 #define RTE_LOGTYPE_PORT 0x00002000 /**< Log related to port. */
78 #define RTE_LOGTYPE_TABLE 0x00004000 /**< Log related to table. */
79 #define RTE_LOGTYPE_PIPELINE 0x00008000 /**< Log related to pipeline. */
80
81 /* these log types can be used in an application */
82 #define RTE_LOGTYPE_USER1 0x01000000 /**< User-defined log type 1. */
83 #define RTE_LOGTYPE_USER2 0x02000000 /**< User-defined log type 2. */
84 #define RTE_LOGTYPE_USER3 0x04000000 /**< User-defined log type 3. */
85 #define RTE_LOGTYPE_USER4 0x08000000 /**< User-defined log type 4. */
86 #define RTE_LOGTYPE_USER5 0x10000000 /**< User-defined log type 5. */
87 #define RTE_LOGTYPE_USER6 0x20000000 /**< User-defined log type 6. */
88 #define RTE_LOGTYPE_USER7 0x40000000 /**< User-defined log type 7. */
89 #define RTE_LOGTYPE_USER8 0x80000000 /**< User-defined log type 8. */
1.3 支持syslog
syslog是Linux系统中功能比较完善的log工具,Linux系统中的服务基本都使用syslog记录自己的日志信息。其所记录的日志一般在/var/log目录中。dpdk的log系统除了按照自己的方式处理日志之外,还会根据命令行的选项将日志写入syslog.conf配置的日志文件中(syslog相关信息可参考man手册)。
2 命令行中与log有关的配置项
2.1 配置能记录日志的最高级别
通过eal的命令行选项"--log-level"指定,最大值为8,对应RTE_LOG_DEBUG,此时记录的日志内容最多;最小值为1,对应RTE_LOG_EMERG。
2.2 配置syslog的facility
通过eal的命令行选项"--syslog"设置写入syslog的默认日志类型,此参数对应openlog()的第三个参数。
3.在代码中使用log
3.1 标记所有要记录的log类型
eal的命令行中没有添加配置log类型的命令行选项,猜测其可能有2个原因:1) 输出哪种类型的log,转发程序关心dpdk中哪个模块的log,开发人员在写转发程序时已经确定,这不像log级别那样根据运行环境的不同而变化(调试时需要较多的日志);2)通过命令行配置bitmap这样的资源,不是那么容易,如果直接配置bitmap,其选值不够直观(无法在命令行选项中使用代码中定义的宏),如果通过重复使用同一个命令行选项来配置bitmap中的每一位,又有些繁琐。
在转发程序的代码中,通过调用rte_set_log_type()函数来设置log类型的bitmap。函数的定义查看lib/librte_eal/common/include/rte_log.h。
3.2 使用log函数
log系统提供的标准log函数(宏)为RTE_LOG(l, t, ...),其中第一个参数l为此条log的级别(参考1.1),第二个参数t为此条log的类型(参考1.2)。但在dpdk的模块中,一般会将此函数进行封装,将t设置为固定值。
4. 查看log内容
默认情况下,符合优先级和类型要求的日志会通过自定义的文件操作函数,将日志:
1) 通过mempool记录历史日志信息
2) 输出到标准输出(stdout)
3) 通过syslog()将日志记录到syslog.conf中对应的文件中
用户也可以在转发程序中通过调用rte_openlog_stream()设置记录日志的文件描述符,这种情况下,记录日志的方式由用户的代码决定。
5. 深入分析
DPDK对程序内部的日志区分了级别和类型,这比syslog的记录更加精细,后者在程序内部只能区分不同级别(反复调用openlog()/closelog()也可实现区分日志类型,但是代码的执行十分繁琐)。
如果DPDK的使用者对日志系统的要求不高,DPDK就会按照默认的方式来保存日志,此时会将日志输出到stdout,我认为如果记录日志较频繁,这将会影响程序的性能。
但DPDK的日志系统的另一个好处就是,使用者可以自定义记录日志的方式,通过fopencookie()打开一个自己定义的文件操作函数的文件指针,调用rte_openlog_stream()函数将其设置为记录log的文件指针。