Solve alerts faster with an AI Agent

How it Works | Quick Start | YouTube Demo

Respond to alerts faster, using AI to automatically:

Fetch logs, traces, and metrics
Determine if issues are application or infrastructure related
Find upstream root-causes

Using HolmesGPT, you can transform your existing alerts from this 👇

To this 👇

How it Works

HolmesGPT connects AI models with live observability data and organizational knowledge. It uses an agentic loop to analyze data from multiple sources and identify possible root causes.

📈 Data Sources

The following data sources ("toolsets") are built-in. Add your own.

Data Source	Status	Description
Kubernetes	✅	Pod logs, K8s events, and resource status (kubectl describe)
Grafana	✅	Logs (Loki) and traces (Tempo)
Helm	✅	Release status, chart metadata, and values
ArgoCD	✅	Application sync status
AWS RDS	✅	Logs and events
Prometheus	✅	Currently supports investigating alerts; coming soon: automatically write PromQL and show related graphs
Internet	✅	Public runbooks
Confluence	✅	Private runbooks and documentation
OpenSearch	🟡 Beta	Query logs and investigate issues with OpenSearch itself (using self-health diagnostics)
NewRelic	🟡 Beta	Investigate alerts, query tracing data
Coralogix	🟡 Beta	Logs
GitHub	🟡 Beta	Remediate alerts by opening pull requests with fixes

How to configure datasources with Robusta SaaS (docs for CLI coming soon)

Request access to beta features

🔐 Data Privacy

By design, HolmesGPT has read-only access and respects RBAC permissions. It is safe to run in production environments.

We do not train HolmesGPT on your data. Data sent to Robusta SaaS is private to your account.

For extra privacy, bring an API key for your own AI model.

🚀 Bi-Directional Integrations With Your Tools

Robusta can investigate alerts - or just answer questions - from the following sources:

Integration	Status	Notes
Slack	🟡 Beta	Demo. Tag HolmesGPT bot in any Slack message
Prometheus/AlertManager	✅	Robusta SaaS or HolmesGPT CLI
PagerDuty	✅	HolmesGPT CLI only
OpsGenie	✅	HolmesGPT CLI only
Jira	✅	HolmesGPT CLI only

See it in Action

Quick Start - Installing HolmesGPT

HolmesGPT can be installed two ways:

Robusta SaaS (recommended) for the full HolmesGPT experience (Kubernetes required)
Desktop CLI or K9s plugin - no Kubernetes required, supports one-off investigations

For advanced use cases, you can import HolmesGPT as a Python library and use it from your own code. Before doing so, we recommend install HolmesGPT SaaS or CLI (see above) to learn your way around.

Using HolmesGPT

In the Robusta SaaS: Go to platform.robusta.dev and use Holmes from your browser
With HolmesGPT CLI: setup an LLM API key and ask Holmes a question 👇

holmes ask "what pods are unhealthy and why?"

You can also provide files as context:

holmes ask "summarize the key points in this document" -f ./mydocument.txt

You can also load the prompt from a file using the --prompt-file option:

holmes ask --prompt-file ~/long-prompt.txt

Enter interactive mode to ask follow-up questions:
```bash
holmes ask "what pods are unhealthy and why?" --interactive
# or
holmes ask "what pods are unhealthy and why?" -i

Also supported:

HolmesGPT CLI: investigate Prometheus alerts

Pull alerts from AlertManager and investigate them with HolmesGPT:

holmes investigate alertmanager --alertmanager-url http://localhost:9093
# if on Mac OS and using the Holmes Docker image👇
#  holmes investigate alertmanager --alertmanager-url http://docker.for.mac.localhost:9093

To investigate alerts in your browser, sign up for a free trial of Robusta SaaS.

Optional: port-forward to AlertManager before running the command mentioned above (if running Prometheus inside Kubernetes)

kubectl port-forward alertmanager-robusta-kube-prometheus-st-alertmanager-0 9093:9093 &

HolmesGPT CLI: investigate PagerDuty and OpsGenie alerts

holmes investigate opsgenie --opsgenie-api-key <OPSGENIE_API_KEY>
holmes investigate pagerduty --pagerduty-api-key <PAGERDUTY_API_KEY>
# to write the analysis back to the incident as a comment
holmes investigate pagerduty --pagerduty-api-key <PAGERDUTY_API_KEY> --update

For more details, run holmes investigate <source> --help

Customizing HolmesGPT

HolmesGPT can investigate many issues out of the box, with no customization or training. Optionally, you can extend Holmes to improve results:

Custom Data Sources: Add data sources (toolsets) to improve investigations

If using Robusta SaaS: See Robusta's docs
If using the CLI: Use -t flag with custom toolset files or add to ~/.holmes/config.yaml

Custom Runbooks: Give HolmesGPT instructions for known alerts:

If using Robusta SaaS: Use the Robusta UI to add runbooks
If using the CLI: Use -r flag with custom runbook files or add to ~/.holmes/config.yaml

You can save common settings and API Keys in a config file to avoid passing them from the CLI each time:

Reading settings from a config file

You can save common settings and API keys in config file for re-use. Place the config file in ~/.holmes/config.yaml` or pass it using the --config

You can view an example config file with all available settings here.

License

Distributed under the MIT License. See LICENSE.txt for more information.

Support

If you have any questions, feel free to message us on robustacommunity.slack.com

How to Contribute

Install HolmesGPT from source with Poetry. See Installation for details.

For help, contact us on Slack

License

lightme16/holmesgpt

ErrorLooks like something went wrong!

About

Resources

License

Code of conduct

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Error
Looks like something went wrong!

Packages