// 蓝鲸作业平台日志查询专家。当需要：(1) 编写 KQL 查询语句查询作业执行日志，(2) 排查任务执行失败问题，(3) 分析 GSE/CMDB 调用问题，(4) 查看任务完整链路日志时使用。提供 KQL 语法指导和常用查询模板。
经 APIGW 调用蓝鲸作业平台（BK-Job）开放接口，支持检索定时任务与最近定时执行的状态/日志、执行方案搜索与带参启动、按实例 ID 查询任务状态与执行日志。列举类查询默认先最近 20 条；大列表在本地用 jq 或短脚本过滤后再摘要。含 plan-execute 操作确认门禁（G1–G4）、对用户输出规范与可选业务记忆 memory/businesses。技能包以含 SKILL.md 的目录为根，可部署在 Cursor、CodeBuddy、OpenClaw 等任意技能加载路径下，脚本与文档路径均相对该根目录。当用户提及作业平台、蓝鲸作业、定时任务、cron、执行方案、job_plan、job_instance、APIGW 调用作业接口、执行作业方案时使用。
蓝鲸监控 APM 调用链分析专家。通过蓝鲸监控平台的 bkmonitor-tracing MCP 服务中的 search_spans 工具，查询和分析 APM Span 数据。当需要：(1) 通过 trace_id/request_id 查询完整调用链，(2) 定位调用链中的 Error Span 和耗时异常 Span，(3) 分析微服务间的调用关系和错误传播路径，(4) 结合 APM 数据辅助排查作业平台任务执行异常时使用。
蓝鲸作业平台任务耗时分布分析专家。当用户需要：(1) 分析任务各阶段耗时分布，(2) 定位任务执行中的性能瓶颈，(3) 了解任务执行链路和各阶段涉及的中间件，(4) 生成任务耗时分布统计报告时使用。基于六阶段模型，通过 request_id 查询完整链路日志进行分析。
| name | kql-query-guide |
| description | 蓝鲸作业平台日志查询专家。当需要：(1) 编写 KQL 查询语句查询作业执行日志，(2) 排查任务执行失败问题，(3) 分析 GSE/CMDB 调用问题，(4) 查看任务完整链路日志时使用。提供 KQL 语法指导和常用查询模板。 |
| license | Apache-2.0 |
帮助用户正确编写 KQL (Kibana Query Language) 查询语句，用于蓝鲸作业平台的日志查询。
使用正确的 KQL 语法和字段名，结合业务场景选择合适的查询条件。
# 1. 查询任务完整链路日志
request_id: "{request_id}"
# 2. 查询任务错误日志
request_id: "{request_id}" AND level: ERROR
# 3. 查询 GSE 调用日志
request_id: "{request_id}" AND path: "*gse.log*"
# 4. 查询 CMDB 调用日志
request_id: "{request_id}" AND path: "*cmdb.log*"
# 生成基础查询语句
python3 scripts/generate_kql.py --request-id "b02df4aec7bd263a9b4f727eb605fad9"
# 生成错误日志查询
python3 scripts/generate_kql.py --request-id "b02df4aec7bd263a9b4f727eb605fad9" --level ERROR
# 生成 GSE 调用日志查询
python3 scripts/generate_kql.py --request-id "b02df4aec7bd263a9b4f727eb605fad9" --service gse
# 生成 CMDB 调用日志查询
python3 scripts/generate_kql.py --request-id "b02df4aec7bd263a9b4f727eb605fad9" --service cmdb
字段名: "值"
常用字段：
request_id - 请求 ID（任务执行的唯一标识）level - 日志级别（ERROR, WARN, INFO, DEBUG）path - 日志文件路径message - 日志消息内容logger - 日志记录器名称使用 AND 连接多个条件：
条件1 AND 条件2 AND 条件3
使用 * 进行模糊匹配：
path: "*cmdb.log"
message: "*timeout*"
步骤：
查询语句：
request_id: "{request_id}" AND level: ERROR
适用情况：
查询语句：
request_id: "{request_id}" AND path: "*gse.log*"
适用情况：
查询语句：
request_id: "{request_id}" AND path: "*cmdb.log*"
适用情况：
查询语句：
request_id: "{request_id}"
| 服务名 | GSE 日志路径 | CMDB 日志路径 |
|---|---|---|
| job-execute | /data/logs/job-execute/gse.log | /data/logs/job-execute/cmdb.log |
| job-manage | - | /data/logs/job-manage/cmdb.log |
| job-backup | - | /data/logs/job-backup/cmdb.log |
| job-crontab | - | /data/logs/job-crontab/cmdb.log |
| job-file-gateway | /data/logs/job-file-gateway/gse.log | - |
| job-logsvr | - | - |
详细说明：查看 bk-job-log-paths.md
1d - 最近 1 天（默认）
1h - 最近 1 小时
15m - 最近 15 分钟
7d - 最近 7 天（最大）
10 - 默认值
50 - 推荐用于详细分析
100 - 最大值（避免返回过多数据）
false - 降序（默认，最新日志在前）
true - 升序（最早日志在前，适合查看任务启动阶段）
level: ERROR 定位问题timeRangesize 参数避免返回过多日志asc: trueAND 组合多个条件缩小范围⚠️ 重要提醒：
request_id 的值必须用双引号包裹AND、ERROR）需要注意大小写path 字段需要完整的日志文件路径request_id 的情况下查询所有日志查看更多查询示例：examples/common-queries.md
searchLogsByCondition - 执行日志查询searchRequestIdByStepInstanceId - 通过步骤实例 ID 查询 request_id