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