Open-source AI agent for investigating production incidents and finding root causes. Works with any stack — Kubernetes, VMs, cloud providers, databases, and SaaS platforms. We are a Cloud Native Computing Foundation sandbox project. Originally created by Robusta.Dev, with major contributions from Microsoft.
New: Operator Mode — Find Problems 24/7 in the Background
Most AI agents are great at troubleshooting problems, but still need a human to notice something is wrong and trigger an investigation. Operator mode fixes that — HolmesGPT runs in the background 24/7, spots problems before your customers notice, and messages you in Slack with the fix. Connect the GitHub integration and it can even open PRs to fix what it finds.
While the operator itself runs in Kubernetes, health checks can query any data source Holmes is connected to — VMs, cloud services, databases, SaaS platforms, and more.
Features
- Petabyte-scale data: Server-side filtering, JSON tree traversal, and tool output transformers keep large payloads out of context windows
- Memory-safe execution: Per-tool memory limits, streaming large results to disk, and automatic output budgeting prevent OOM kills when querying large observability datasets
- Deep integrations: Prometheus, Grafana, Datadog, Kubernetes, and many more—plus any REST API
- Bidirectional alert integrations: Fetch alerts from AlertManager, PagerDuty, OpsGenie, or Jira—and write findings back
- Any LLM provider: OpenAI, Anthropic, Azure, Bedrock, Gemini, and more
- No Kubernetes required: Works with any infrastructure — VMs, bare metal, cloud services, or containers
How it Works
HolmesGPT uses an agentic loop to query live observability data from multiple sources and identify root causes.
🔗 Data Sources
HolmesGPT integrates with popular observability and cloud platforms. The following data sources ("toolsets") are built-in. Add your own.
| Data Source | Notes |
|---|
| AKS | Azure Kubernetes Service cluster and node health diagnostics |
| Atlassian Rovo | Jira issues and Confluence pages via Atlassian's hosted server (MCP) |
| ArgoCD | Get status, history and manifests and more of apps, projects and clusters |
| AWS | Any AWS API via the hosted AWS MCP Server: RDS, EC2, CloudWatch, CloudTrail, Cost Explorer and more (MCP) |
| Azure | Azure resources and diagnostics (MCP) |
| Confluence | Private runbooks and documentation |
| Confluence (MCP) | Private runbooks and documentation (MCP) |
| Coralogix | Retrieve logs for any resource |
| Crossplane | Troubleshoot Crossplane providers, compositions, claims, and managed resources |
| |
See the full list of built-in toolsets for additional integrations including Cilium, KubeVela, Notion, and more.
🚀 End-to-End Automation
HolmesGPT can fetch alerts/tickets to investigate from external systems, then write the analysis back to the source or Slack.
| Integration | Status | Notes |
|---|
| Slack | ✅ | Demo. Available via Robusta |
| Microsoft Teams | ✅ | Available via Robusta |
| Prometheus/AlertManager | ✅ | Robusta or HolmesGPT CLI |
| PagerDuty | ✅ | HolmesGPT CLI only |
| OpsGenie | ✅ | HolmesGPT CLI only |
| Jira | ✅ | HolmesGPT CLI only |
| GitHub | ✅ | HolmesGPT CLI only |
Installation
Read the installation documentation to learn how to install HolmesGPT.
Supported LLM Providers
Read the LLM Providers documentation to learn how to set up your LLM API key.
Using HolmesGPT
See the walkthrough documentation for usage guides, including:
🔐 Data Privacy
By design, HolmesGPT has read-only access and respects RBAC permissions. It is safe to run in production environments.
License
Distributed under the Apache 2.0 License. See LICENSE for more information.
Community
Join our community to discuss the HolmesGPT roadmap and share feedback:
Support
If you have any questions, feel free to message us on HolmesGPT Slack Channel
How to Contribute
Please read our CONTRIBUTING.md for guidelines and instructions.
For help, contact us on Slack or ask DeepWiki AI your questions.
Please make sure to follow the CNCF code of conduct - details here.
