GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — GitHub - telemetryflow/holmesgpt: SRE Agent - CNCF Sandbox Project

BranchesTags
Open more actions menu
 
 

Latest commit

 

History

1,535 Commits
1,535 Commits

Folders and files

NameName
Last commit message
Last commit date
.claude
.claude
 
 
.github
.github
 
 
bin/go-cve-rebuild
bin/go-cve-rebuild
 
 
docs
docs
 
 
examples
examples
 
 
experimental/ag-ui
experimental/ag-ui
 
 
helm
helm
 
 
holmes
holmes
 
 
holmes_operator
holmes_operator
 
 
images
images
 
 
loki
loki
 
 
scripts
scripts
 
 
specs
specs
 
 
tests
tests
 
 
.dockerignore
.dockerignore
 
 
.gitattributes
.gitattributes
 
 
.gitignore
.gitignore
 
 
.pre-commit-config.yaml
.pre-commit-config.yaml
 
 
ADOPTERS.md
ADOPTERS.md
 
 
AGENTS.md
AGENTS.md
 
 
CLAUDE.md
CLAUDE.md
 
 
CODE_OF_CONDUCT.md
CODE_OF_CONDUCT.md
 
 
CONTRIBUTING.md
CONTRIBUTING.md
 
 
Dockerfile
Dockerfile
 
 
Dockerfile.operator
Dockerfile.operator
 
 
FEATURES.md
FEATURES.md
 
 
GOVERNANCE.md
GOVERNANCE.md
 
 
LICENSE
LICENSE
 
 
MAINTAINERS.md
MAINTAINERS.md
 
 
Makefile
Makefile
 
 
README.md
README.md
 
 
SECURITY.md
SECURITY.md
 
 
build_with_arm.sh
build_with_arm.sh
 
 
config.example.yaml
config.example.yaml
 
 
conftest.py
conftest.py
 
 
datasource-catalog.json
datasource-catalog.json
 
 
docker-compose.yaml
docker-compose.yaml
 
 
holmes_cli.py
holmes_cli.py
 
 
mkdocs.yml
mkdocs.yml
 
 
poetry.lock
poetry.lock
 
 
pyproject.toml
pyproject.toml
 
 
run_benchmarks_local.py
run_benchmarks_local.py
 
 
server.py
server.py
 
 
tempo_cli.py
tempo_cli.py
 
 
tempo_cli_README.md
tempo_cli_README.md
 
 

Repository files navigation

HolmesGPT — The CNCF SRE Agent

Installation | Docs | Ask DeepWiki

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.

  • Deployment verification — Deploy a health check alongside your app to verify the new version is healthy
  • Scheduled health checks — Continuously monitor services and catch regressions automatically

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.

holmesgpt-architecture-diagram

HolmesGPT Investigation Demo

🔗 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 AKS Azure Kubernetes Service cluster and node health diagnostics
Atlassian Rovo Atlassian Rovo Jira issues and Confluence pages via Atlassian's hosted server (MCP)
ArgoCD ArgoCD Get status, history and manifests and more of apps, projects and clusters
AWS AWS RDS events, instances, slow query logs, and more (MCP)
Azure Azure Azure resources and diagnostics (MCP)
Azure SQL Azure SQL Database health, performance, connections, and slow queries
Confluence Confluence Private runbooks and documentation
Confluence MCP Confluence (MCP) Private runbooks and documentation (MCP)
Coralogix Coralogix Retrieve logs for any resource
Crossplane Crossplane Troubleshoot Crossplane providers, compositions, claims, and managed resources
Datadog Datadog Query logs, metrics, and traces
Docker Docker Get images, logs, events, history and more
Elasticsearch Elasticsearch / OpenSearch Query logs, cluster health, shard and index diagnostics
GCP GCP Google Cloud Platform resources (MCP)
GitHub GitHub Repositories, issues, and pull requests (MCP)
GitLab GitLab Projects, merge requests, issues, and CI/CD pipelines (MCP)
Jenkins Jenkins (MCP) Build status, pipeline logs, and job history (MCP)
Grafana Grafana Query and analyze dashboard configurations and panels
Helm Helm Release status, chart metadata, and values
Internet Internet Public runbooks, community docs, etc.
Kafka Kafka Fetch metadata, list consumers and topics or find lagging consumer groups
Kubernetes Kubernetes Pod logs, K8s events, and resource status (kubectl describe)
Kubernetes Remediation Kubernetes Remediation (MCP) Apply fixes like scaling, rollbacks, and resource edits (MCP)
Loki Loki Query logs for Kubernetes resources or any query
MariaDB MariaDB MariaDB database queries and diagnostics (MCP)
MongoDB MongoDB Query data, diagnose performance, inspect schemas, find slow operations
MongoDB Atlas MongoDB Atlas Cluster health, slow queries, and performance diagnostics
NewRelic NewRelic Investigate alerts, query tracing data
OpenShift OpenShift Projects, routes, builds, security context constraints, and deployment configs
Prefect Prefect (MCP) Workflow orchestration monitoring, flow runs, and worker health (MCP)
Prometheus Prometheus Investigate alerts, query metrics and generate PromQL queries
RabbitMQ RabbitMQ Partitions, memory/disk alerts, troubleshoot split-brain scenarios and more
Robusta Robusta Multi-cluster monitoring, historical change data, runbooks, PromQL graphs and more
ServiceNow ServiceNow Query tables and incident records
Sentry Sentry Error tracking, issues, and performance monitoring (MCP)
Slab Slab Team knowledge base and runbooks on demand
Splunk Log search and analysis (MCP)
SQL Databases SQL Databases PostgreSQL, MySQL, ClickHouse, MariaDB, SQL Server, SQLite
Tempo Tempo Fetch trace info, debug issues like high latency in application
VictoriaLogs VictoriaLogs Query logs from VictoriaLogs using LogsQL
VictoriaMetrics Query metrics from a Prometheus-compatible TSDB (vmsingle / vmcluster)
Zabbix Zabbix Monitor hosts, problems, events, triggers, and historical metrics

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

All Installation Methods

Read the installation documentation to learn how to install HolmesGPT.

Supported LLM Providers

All Integration 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:

  • Interactive mode for asking questions and follow-ups
  • Investigating Prometheus alerts
  • CI/CD troubleshooting

🔐 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:

  • Community Meetups

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. Ask DeepWiki

OpenSSF Best Practices OpenSSF Scorecard

About

SRE Agent - CNCF Sandbox Project

holmesgpt.dev/

Resources

Readme
License

Code of conduct

Code of conduct

Contributing

Contributing

Security policy

Security policy
Activity
Custom properties

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages

You are visitor 01402520 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.