Apache NiFi中RouteOnAttribute未匹配时触发GUI公告的配置方法
可实现的配置方案
整体逻辑和原流程完全兼容,仅在未匹配分支的FlowFile被丢弃前增加Bulletin触发环节,不改动原有路由规则的运行行为。
操作步骤
- 先修改RouteOnAttribute的关系配置:打开处理器的关系设置页,找到未匹配对应的出站关系(默认命名为
unmatched),取消原本勾选的「自动终止」选项,给这个关系留好出线接口 - 从未匹配关系连线接入原生
LogAttribute处理器,配置对应的日志规则:- 日志级别设为
WARN - 用NiFi表达式语言自定义日志内容,带上必要的上下文信息,示例写法:
检测到未匹配路由规则的FlowFile,UUID: ${uuid},关键属性值: ${your-custom-attr}
- 日志级别设为
- 调整
LogAttribute的Bulletin触发阈值:打开处理器的配置页,找到「Bulletin Level」选项,把默认的ERROR值改成WARN。改完之后,这个处理器输出的WARN级日志会直接推送到GUI上对应的Bulletin Indicator,点标记就能看到具体的未匹配提示 - 把
LogAttribute的所有出站关系设为自动终止,整个链路的运行效果和之前直接把未匹配分支自动终止的状态完全一致,不会造成FlowFile积压
适配Java自研逻辑的简化实现
因为项目底层是Java开发,完全可以省掉引入LogAttribute的额外步骤:
- 取消RouteOnAttribute未匹配关系的自动终止配置,把这条线连到自己写的自定义终止处理器上
- 在自定义处理器的
onTrigger方法里,拿到未匹配的FlowFile后,调用内置的logger以WARN级别输出带上下文的未匹配提示,再把当前处理的FlowFile从会话里直接移除,不需要走出站关系流转 - 把这个自定义处理器的「Bulletin Level」设为
WARN,就能直接在自研处理器对应的GUI位置弹出Bulletin提示标记
关键注意点
- 别把Bulletin Level设成
INFO,不然正常运行的常规日志会刷得提示标记满天飞,针对未匹配这类异常分支的提示,设成WARN的阈值刚好,只有符合异常场景的消息才会触发提示 - 原生RouteOnAttribute的内部路由日志默认是DEBUG级别,根本达不到Bulletin的触发阈值,没法靠直接改RouteOnAttribute的配置实现需求,必须在未匹配分支的链路里加能输出对应级别日志的环节
内容的提问来源于stack exchange,提问作者mikec
相关产品推荐
相关产品推荐

