Available since CLI v7.8.0.
checkly rca command lets you trigger and retrieve AI-powered root cause analyses (RCA) for error groups directly from the terminal. An RCA examines an error group and returns a classification, root cause explanation, user impact assessment, and suggested code fixes when available.
Prerequisites
Prerequisites
Before using
checkly rca, ensure you have:- Checkly CLI installed
- Valid Checkly account authentication (run
npx checkly loginif needed) - A Checkly plan that includes root cause analysis
- Rocky AI enabled for the account, to run new analyses with
checkly rca run. An account Owner turns on Enable Rocky AI in the Rocky AI settings.
Usage
Terminal
Subcommands
checkly rca run
Trigger a new root cause analysis for a check or test session error group. The analysis runs asynchronously — use --watch to wait for the result in your terminal.
Usage:
Terminal
*Pass either
--error-group or --test-session-error-group.
Run Options
The check error group ID to trigger the analysis for. You can find error group IDs in the output of
checkly checks get when viewing a check with errors.Usage:Terminal
Available since CLI v8.0.0.
checkly test-sessions get.Usage:Terminal
Available in CLI v8.5.0+.
Terminal
Wait for the analysis to complete and display the full result. Without this flag, the command returns immediately with the RCA ID and a pending status.Only works with
--output detail.Usage:Terminal
Set the output format. Use
json for programmatic access or md for markdown.Usage:Terminal
Run Examples
Terminal
checkly rca get
Retrieve an existing root cause analysis by its ID. If the analysis is still generating, use --watch to wait for completion.
Usage:
Terminal
Options:
Get Options
Wait for the analysis to complete if it is still generating. Without this flag, the command returns the current status immediately.Only works with
--output detail.Usage:Terminal
Set the output format. Use
json for programmatic access or md for markdown.Usage:Terminal
Get Examples
Terminal
RCA Output
A completed root cause analysis includes:- Classification — the category of the error
- Root cause — explanation of what caused the error
- User impact — how the error affects end users
- Code fix — suggested fix when available
- Evidence — supporting artifacts from the analysis
- Reference links — relevant external resources
Related Commands
checkly checks- List, inspect, and analyze checks (includes error groups)checkly test-sessions- Inspect recorded test sessions and test session error groups