Skip to main content
subagent

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.

Install into Claude Code · claude-code-templates All methods and platforms ↓
npx claude-code-templates@latest --agent devops-infrastructure/devops-troubleshooter
Open on GitHub

What 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 kubectl commands 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-troubleshooter

2Manually: put the files in place

.claude/agents/devops-troubleshooter.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

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.

Similar subagents

All subagents for DevOps and infrastructure →
devops-incident-responder VoltAgent Community Assists with active production incidents, root-cause investigations, and blameless postmortems. Built for teams handling live service outages. 206installs devops-oncall official Awesome Copilot Community A GitHub Copilot plugin with prompts, commands, and an agent for incident triage and Azure diagnostics. Helpful for on-call engineers managing cloud infrastructure. ★ 40,418repo stars DevOps Expert official github A subagent that guides projects through the DevOps Infinity Loop — from planning to monitoring — and automates every phase. ★ 40,418repo stars security-auditor VoltAgent Community Audits security controls, vulnerabilities, risks, and compliance gaps across systems, infrastructure, and processes. Use it when you need documented findings. 10,718installs error-detective VoltAgent Community A Claude subagent that digs into failures: correlates errors across services, traces cascades and suggests how to prevent them. 7,557installs devops-engineer VoltAgent Community This subagent reviews infrastructure and helps with CI/CD, containers, and deployment workflows. Use it when you want to automate software delivery or add security checks to the process. 7,392installs deployment-engineer VoltAgent Community Designs and tunes CI/CD pipelines, automates rollback triggers, and sets up canary or blue-green releases. Helpful when manual deployment steps slow down your team. 6,079installs security-engineer VoltAgent Community Automates DevSecOps workflows, CIS benchmark checks, and vulnerability scanning. Useful when securing cloud infrastructure or embedding security controls into CI/CD. 3,243installs

From the same set205

The whole set →

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor