القائمة
蓝鲸作业平台日志查询专家。当需要：(1) 编写 KQL 查询语句查询作业执行日志，(2) 排查任务执行失败问题，(3) 分析 GSE/CMDB 调用问题，(4) 查看任务完整链路日志时使用。提供 KQL 语法指导和常用查询模板。
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/TencentBlueKing/bk-job --skill kql-query-guideيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
عرض SKILL.md
经 APIGW 调用蓝鲸作业平台（BK-Job）开放接口：查搜定时任务、作业模板、执行方案与作业执行历史、实例状态日志，创建执行方案、新建与启停定时任务，到指定机器快速执行脚本，分发文件到目标机器（仅服务器/本地文件），查主机拓扑与执行账号。含写操作确认门禁、先选业务范围、先查主机与账号等规范。当用户提及作业平台、业务、业务集、蓝鲸作业、定时任务、cron、执行方案、作业模板、job_plan、job_instance、执行历史、快速执行脚本、fast_execute_script、文件分发、fast_transfer_file、主机、搜索主机、执行账号、bk_scope、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استنادا إلى تصنيف SOC المهني
