码迷,mamicode.com
首页 > 其他好文 > 详细

DPDK中Log的使用方法

时间:2015-04-19 19:34:14      阅读:237      评论:0      收藏:0      [点我收藏+]

标签:dpdk log 使用 分析 syslo

本文谢绝转载,如有需要,请以链接的方式引用。


注:本文中的代码为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的文件指针。

DPDK中Log的使用方法

标签:dpdk log 使用 分析 syslo

原文地址:http://blog.csdn.net/kabar_strider/article/details/45131257

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!