Jenkins Log Parser Plugin使用说明

官方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. (注意：这个列表从全局配置中获取)

(adsbygoogle = window.adsbygoogle || []).push({});