devops-troubleshooter — Claude Code subagent: setup and use
This subagent investigates logs, deployment failures, and monitoring issues. Use it to trace an incident and work out a fix.
npx claude-code-templates@latest --agent devops-infrastructure/devops-troubleshooterWhat devops-troubleshooter does
The subagent examines logs, metrics, and traces, tests possible explanations, and helps identify why an incident occurred. It covers container and network debugging, suggests commands to investigate problems, and can help plan a rollback or a temporary fix. Its response can also include monitoring queries and follow-up actions.
It has access to Read, Write, Edit, Bash, and Grep, so it can inspect and edit files, search a project, and run commands. ELK, Datadog, and kubectl appear among its focus areas. This is an incident-response subagent, not a monitoring service; monitoring setup is part of the troubleshooting work it can suggest.
What it helps with
- trace an incident using logs and metrics
- investigate a container issue with
kubectl - plan a rollback after a failed deployment
- draft monitoring queries for an incident
- write follow-up actions after an outage
Example prompts for the agent
- Investigate this incident using its logs and metrics, test possible causes, and report the likely root cause.
- Help debug this container issue: suggest
kubectlcommands and checks. - Plan a deployment rollback and outline ways to detect a repeat of the issue.
How to install devops-troubleshooter
1claude-code-templates
npx claude-code-templates@latest --agent devops-infrastructure/devops-troubleshooter2Manually: put the files in place
.claude/agents/devops-troubleshooter.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/devops-troubleshooter.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/devops-troubleshooter.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about devops-troubleshooter
How do I install devops-troubleshooter in Claude Code?
Run npx claude-code-templates@latest --agent devops-infrastructure/devops-troubleshooter. The agent file is placed at .claude/agents/devops-troubleshooter.md.
What does devops-troubleshooter do?
It helps investigate incidents by examining logs and metrics, testing possible causes, and suggesting debugging, remediation, and monitoring steps.
Which tools can the subagent use?
It has access to Read, Write, Edit, Bash, and Grep. Its listed focus areas include ELK, Datadog, and kubectl.