القائمة
蓝鲸作业平台日志查询专家。当需要：(1) 编写 KQL 查询语句查询作业执行日志，(2) 排查任务执行失败问题，(3) 分析 GSE/CMDB 调用问题，(4) 查看任务完整链路日志时使用。提供 KQL 语法指导和常用查询模板。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
经 APIGW 调用蓝鲸作业平台（BK-Job）开放接口，支持检索定时任务与最近定时执行的状态/日志、作业模板搜索与详情查询、执行方案搜索/创建/带参启动、定时任务新建与启停、按实例 ID 查询任务状态与执行日志。列举类查询默认先最近 20 条；大列表在本地用 jq 或短脚本过滤后再摘要。含 plan-execute/plan-create/cron-save 操作确认门禁（G1–G4 及创建后启用询问）、对用户输出规范与可选业务记忆 memory/businesses。技能包以含 SKILL.md 的目录为根，可部署在 Cursor、CodeBuddy、OpenClaw 等任意技能加载路径下，脚本与文档路径均相对该根目录。当用户提及作业平台、蓝鲸作业、定时任务、cron、执行方案、作业模板、job_template、job_plan、job_instance、APIGW 调用作业接口、执行作业方案、创建执行方案、保存定时任务时使用。不适用于：作业平台 Web 界面/前端交互操作、非 APIGW（如直连微服务或其它接入方式）调用、以及作业平台之外的蓝鲸产品（CMDB、监控、节点管理等）。
蓝鲸监控 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