Jenkins Log Parser Plugin使用说明

原创
2015/03/04 16:22
阅读数 2.6W
官方wiki:https://wiki.jenkins-ci.org/display/JENKINS/Log+Parser+Plugin

插件概要信息:
解析控制台输出,高亮显示error/warning/info行。

描述:
log-parser插件解析Jenkins构建生成的控制台日志。
解析控制台日志提供了如下功能:
  • 高亮感兴趣的日志(error,warning,info)行
  • 将日志切分成块
  • 在日志和它的区块中显示errors/warnings/infomations行的总数的概要
  • 链接errors/warnings/infomations概要到全量日志的上下文,使得更容易找到感兴趣的日志行
  • 在构建页面显示errors/warnings概要
解析日志例子:

构建级别的概要:
在构建页面显示errors/warnings概要


解析过的日志:
下面是一个构建的解析日志的例子,可以通过点击构建页面左侧边栏的“ Parsed Console Output”链接访问。


报表的左侧可以展开用来浏览 errors/warning/info行,这些行链接到右侧的全量日志,很容易找到。
点击某个错误会把你带到它在右侧的完整日志的地方。


 
配置
全局级别可以配置多个解析规则。

全局配置

解析规则选项
出现在全局Jenkins配置的是 "Console Output Parsing"节点的逻辑名称(项目、描述等)和解析规则文件的配置对。
之后,当一个Job配置日志解析时,可以为Job从中选择一个实现了解析规则的配置项。

对于每个解析规则选项,指定:
解析规则名称:逻辑名称,将作为一个选项显示在job级配置中。
解析规则文件:在这个选项中实现解析规则的文件。(更多信息,参见"Parsing rules files" )

解析规则文件
文件的每行指定一个级别(ok/error/warn/info/start)和一个用“/”限定的正则式来查找以标记匹配级别的行。
  • ok/error/warn
    用于识别问题行。
  • info
    在报告中这些行被高亮为蓝色。他们用来创建一系列到报告的链接用于快速访问特定的区域。
  • start
    info行一样,在报告中这些行也被高亮为蓝色,并且显示为一系列快速访问链接. 此外,他们被用来分组在那个区域发现的一系列errors和warnings。 

例如,在解析规则文件中,如下行意味着包含"ERROR"单词的行被标记为一个error行:
error /ERROR/ 
  • 不区分大小写匹配
    匹配符号支持Java正则表达式嵌入标记表达式。为了To perform a case-insensitive match, use (?i) notation.
    例子: 为了匹配以不区分大小写的单词‘error’开头的行,请使用:
    error /(?i)^error / 
  • 如果一行匹配多个规则,第一个规则被应用。
    所以对于如下系列规则 :
    ok /^javadoc:/
    error /Error/ 

    并且如下行存在与构建日志中:

    javadoc: Error : could not find something 

    这行将被认为是"ok",并且不会作为error被高亮,因为 ^javadoc:模式首先被匹配。

  • 以“#”开头的行、空行将被忽略

解析规则文件案例如下:
ok /not really/

# match line starting with 'error ', case-insensitive
error /(?i)^error /

# list of warnings here...
warning /[Ww]arning/
warning /WARNING/

# create a quick access link to lines in the report containing 'INFO'
info /INFO/

# each line containing 'BUILD' represents the start of a section for grouping errors and warnings found after the line.
# also creates a quick access link.
start /BUILD/ 


Job配置
  1. 点击菜单:Jenkins -> job name -> Configure
  2. 定位到Post-build Actions区域
  3. 选取"Console output (build log) parsing" 选择框
  4. "Mark build Unstable on Warning" 选项: 勾选后解析出warnings将标记构建为'Unstable'状态
  5. "Mark build Failed on Error" 选项: 勾选后解析出errors将标记构建为'Failed'状态
  6. "Select Parsing Rules" : 选择用来在Job构建中解析日志的规则
  7. (注意:这个列表从全局配置中获取)


展开阅读全文
打赏
1
5 收藏
分享
加载中
donghui2020博主
使用中遇到问题:中文乱码
2015/03/19 16:02
回复
举报
更多评论
打赏
1 评论
5 收藏
1
分享
返回顶部
顶部