cloudbees

name	cloudbees
id	cloudbees
description	CloudBees CI integration for investigating builds, deployments, pipeline stages, and test results during RCA
category	cicd
connection_check	{"method":"is_connected_function","module":"chat.backend.agent.tools.cloudbees_rca_tool","function":"is_cloudbees_connected"}
tools	["cloudbees_rca"]
index	CI/CD -- investigate CloudBees CI builds, deployments, pipeline stages, logs, test results
rca_priority	4
allowed-tools	cloudbees_rca
metadata	{"author":"aurora","version":"2.0"}

CloudBees CI Integration

Overview

CloudBees CI integration for investigating builds and deployments during Root Cause Analysis. CloudBees CI uses the same APIs as Jenkins: Core REST API, Pipeline REST API (wfapi), and Blue Ocean REST API.

Instructions

Tool: cloudbees_rca

Unified CloudBees CI investigation tool for Root Cause Analysis.

Actions:

• recent_deployments -- Query stored deployment events; optional service filter and time_window_hours
• build_detail -- Core API: SCM revision, changeSets, build causes, parameters. Requires job_path + build_number
• pipeline_stages -- wfapi: stage-level breakdown with status and timing. Requires job_path + build_number
• stage_log -- wfapi: per-stage log output for a specific node_id. Requires job_path + build_number + node_id
• build_logs -- Core API: console output, truncated to ~1MB. Requires job_path + build_number
• test_results -- Core API: test report with failure details. Requires job_path + build_number
• blue_ocean_run -- Blue Ocean API: run data with changeSet and commit info. Requires pipeline_name + run_number
• blue_ocean_steps -- Blue Ocean API: step-level detail for a pipeline node. Requires pipeline_name + run_number

Required params vary by action: job_path + build_number for Core/wfapi, pipeline_name + run_number for Blue Ocean. service is optional for recent_deployments.

RCA Investigation Flow

Recent deployments are a leading indicator of root cause. Always check if a deployment occurred shortly before the alert fired.

1. cloudbees_rca(action='recent_deployments', service='SERVICE') -- Check for recent deploys
2. cloudbees_rca(action='build_detail', job_path='JOB', build_number=N) -- Build details + commits