Kiro 读取并分析本地 IDEA 项目运行日志的完整方案

Kiro 读取并分析本地 IDEA 项目运行日志的完整方案一、场景说明本地用 IntelliJ IDEA 运行项目时报错信息和日志默认只输出在 IDEA 的 Run/Debug 控制台中。要让 Kiro 具备读取和分析这些日志的能力核心思路是让日志有一个 Kiro 能访问到的落地点。二、方案总览方案原理配置成本适用场景日志输出到文件 Kiro 直接读日志写入文件Kiro 读取文件内容一行配置日常开发首选复制粘贴到聊天框手动复制 IDEA 控制台内容零临时排查、少量日志Steering 文件规范化固化日志路径和分析流程创建一个 md 文件团队统一规范Hook 一键触发分析点击按钮自动读取分析创建一个 Hook频繁排错注博客https://blog.csdn.net/badao_liumang_qizhi三、方案一日志输出到文件推荐3.1 Spring Boot 项目配置最简方式——在application.yml中加一行logging:file:name:logs/app.log项目启动后日志会同时输出到 IDEA 控制台和logs/app.log文件。指定日志级别和格式logging:file:name:logs/app.logmax-size:50MBmax-history:7level:root:INFOcom.yourpackage:DEBUGpattern:file:%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n3.2 Logback 配置方式更细粒度控制在src/main/resources/logback-spring.xml中?xml version1.0 encodingUTF-8?configuration!-- 控制台输出 --appendernameCONSOLEclassch.qos.logback.core.ConsoleAppenderencoderpattern%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n/pattern/encoder/appender!-- 文件输出 --appendernameFILEclassch.qos.logback.core.rolling.RollingFileAppenderfilelogs/app.log/filerollingPolicyclassch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicyfileNamePatternlogs/app.%d{yyyy-MM-dd}.%i.log/fileNamePatternmaxFileSize50MB/maxFileSizemaxHistory7/maxHistory/rollingPolicyencoderpattern%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n/pattern/encoder/appender!-- ERROR 单独输出到一个文件方便快速定位 --appendernameERROR_FILEclassch.qos.logback.core.rolling.RollingFileAppenderfilelogs/error.log/filefilterclassch.qos.logback.classic.filter.LevelFilterlevelERROR/levelonMatchACCEPT/onMatchonMismatchDENY/onMismatch/filterrollingPolicyclassch.qos.logback.core.rolling.TimeBasedRollingPolicyfileNamePatternlogs/error.%d{yyyy-MM-dd}.log/fileNamePatternmaxHistory30/maxHistory/rollingPolicyencoderpattern%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n/pattern/encoder/appenderrootlevelINFOappender-refrefCONSOLE/appender-refrefFILE/appender-refrefERROR_FILE//root/configuration3.3 Log4j2 配置方式?xml version1.0 encodingUTF-8?ConfigurationstatusWARNAppendersConsolenameConsoletargetSYSTEM_OUTPatternLayoutpattern%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n//ConsoleRollingFilenameFilefileNamelogs/app.logfilePatternlogs/app-%d{yyyy-MM-dd}-%i.logPatternLayoutpattern%d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %-5level %logger{50} - %msg%n/PoliciesSizeBasedTriggeringPolicysize50MB/TimeBasedTriggeringPolicy//PoliciesDefaultRolloverStrategymax7//RollingFile/AppendersLoggersRootlevelinfoAppenderRefrefConsole/AppenderRefrefFile//Root/Loggers/Configuration3.4 配置后的使用方式项目启动后对 Kiro 说帮我看下 logs/app.log 最近的报错 读取 logs/error.log 分析下最近的异常 看下 logs/app.log 中最后 100 行关于 NullPointerException 的信息Kiro 会直接读取文件内容进行分析。四、方案二复制粘贴零配置直接在 IDEA 控制台中选中报错的日志内容通常从 ERROR 行到堆栈结束CtrlC复制粘贴到 Kiro 聊天框中说帮我分析下这段错误日志优点零配置随时可用缺点手动操作日志量大时不方便五、方案三Steering 文件固化日志分析流程在.kiro/steering/目录下创建一个日志分析规范文件--- inclusion: manual --- # 日志分析规范 ## 日志文件位置 - 全量日志: logs/app.log - 错误日志: logs/error.log ## 分析流程 1. 读取日志文件最后 200 行 2. 查找 ERROR 级别日志和异常堆栈 3. 重点关注 Caused by 行通常是根因 4. 定位到项目包名下的代码行如 at com.yourpackage 5. 读取对应源码文件分析问题 6. 给出修复建议和代码示例 ## 日志关键字优先级 - ERROR - 错误级别 - Exception / Error - 异常类名 - Caused by - 根因链 - at com.yourpackage - 你自己的代码非框架层 ## 忽略的日志 - Spring 启动日志INFO级别的 Bean 注册信息 - Hibernate/MyBatis 的 DEBUG SQL除非在排查 SQL 问题使用方式在聊天框中输入#log-analysis引入此上下文然后说帮我分析日志。六、方案四Hook 一键触发日志分析创建一个手动触发的 Hook点击按钮即可让 Kiro 自动读取分析日志。Hook 配置文件.kiro/hooks/analyze-app-log.json{name:分析应用日志,version:1.0.0,description:手动触发后读取应用日志文件分析最近的ERROR日志和异常堆栈,when:{type:userTriggered},then:{type:askAgent,prompt:请读取 logs/app.log 文件的最后 200 行内容找出其中的 ERROR 级别日志和异常堆栈信息分析错误原因定位到项目源码并给出具体的修复建议。如果文件不存在提示用户在 application.yml 中添加 logging.file.name 配置。}}使用方式在 Kiro 左侧的Agent Hooks面板中找到分析应用日志点击触发即可。七、进阶自动监控日志文件变化如果希望日志文件出现 ERROR 时 Kiro 自动感知可以配合fileEdited事件{name:日志错误监控,version:1.0.0,description:当日志文件发生变化时检查是否有新的ERROR级别日志,when:{type:fileEdited,patterns:[logs/error.log]},then:{type:askAgent,prompt:日志文件发生变化请读取 logs/error.log 最后 50 行如果有新的异常分析原因并给出修复建议。}}注意这种方式需要logs/error.log在 Kiro 的工作区内且文件变化能被检测到。八、.gitignore 配置日志文件不应提交到 Git确保.gitignore中有# 应用日志 logs/ *.log九、不同项目类型的日志文件配置Node.js 项目// 使用 winstonconstwinstonrequire(winston);constloggerwinston.createLogger({transports:[newwinston.transports.Console(),newwinston.transports.File({filename:logs/app.log}),newwinston.transports.File({filename:logs/error.log,level:error})]});Python 项目importlogging logging.basicConfig(levellogging.INFO,format%(asctime)s [%(threadName)s] %(levelname)-5s %(name)s - %(message)s,handlers[logging.StreamHandler(),logging.FileHandler(logs/app.log),])Go 项目import(logosio)funcinitLogger(){logFile,_:os.OpenFile(logs/app.log,os.O_CREATE|os.O_WRONLY|os.O_APPEND,0666)multiWriter:io.MultiWriter(os.Stdout,logFile)log.SetOutput(multiWriter)}十、最佳实践总结日志一定要落文件——只有落到文件Kiro 才能自主读取分析不需要你手动复制粘贴。ERROR 单独一个文件——logs/error.log只记录 ERROR 级别文件小、定位快。日志格式要包含关键信息——时间、线程、级别、类名、消息缺一不可2026-07-22 10:30:15.123 [http-nio-8080-exec-1] ERROR c.y.service.UserService - 用户查询失败Steering 文件固化规范——团队统一日志路径和分析流程新人也能快速上手。结合接口测试使用——调接口报错时Kiro 可以同时看接口返回 日志文件上下游问题一目了然。