用途:对已在运行的 DataStage 作业(计划或生产作业)的失败运行做深入排查,借助 de-mcp 服务器提供的 MCP 工具定位根因。输入为作业名或 UUID、可选 run ID、项目 ID。
主要能力与用法:
- 解析作业 ID:用 list_jobs(project_id=<PROJECT_ID>) 按 job_name 匹配 job_id。
- 收集上下文:无 run_id 时用 list_job_runs(project_id, job_ids, selection_strategy="latest", limit=20) 找最近失败运行;注意 job_runs 为列表的列表,状态用原始大小写,duration 为 null 表示进行中、0 表示零秒完成。再用 get_job_run_details(project_id, job_id, run_id) 获取 errors、stage_metrics、link_metrics、flow_limits、job_parameters、总读写行数等。job_parameters 为权威来源,$ 开头为环境变量。
- 需要时用 retrieve_datastage_flow_code 查看流程结构(flow 名为作业名去掉 .DataStage job 后缀),用 list_connections 与 inspect_project_asset 检查连接,用 list_data_assets、inspect_project_asset、read_data_preview 核对 schema。
- 对比最近成功运行与失败运行的参数与阶段指标。
- 用 get_job_run_logs 取日志,先 grep="##[EF]",必要时放宽;按错误码前缀(CDICO、IIS-DSEE-TBLD/TFOR/TFCC/TFPM/TFRS、IIS-DSTAGE-RUN、NDS-DSEE 等)判断组件。
- 陌生错误码可参考 di-agent-knowledge-engine-datastage 技能、datastage_property_lookup 工具及 IBM 文档。
输出:给出错误、失败阶段、原因、证据与缺口;结论不明确时明确说明,不猜测,不提供修复方案。诊断后可检查告警定义与已触发告警,并按用户意愿创建、确认或解决告警。
限制:无 MCP 工具可主动测试连接可达性,需用户在 UI 手动验证;部分字段可能为空或不可靠。