Walkthrough

Get started with HolmesGPT by running your first investigation.

Prerequisites

Before starting, ensure you have:

• ✅ HolmesGPT CLI installed - See CLI Installation Guide
• ✅ AI provider API key configured - See AI Provider Setup

Run Your First Investigation

holmes ask "tell me something surprising about my environment"

Holmes will automatically discover your connected data sources — Kubernetes, Prometheus, Datadog, Elasticsearch, AWS, GCP, databases, and more — and report back on what it finds.

What You Just Experienced

HolmesGPT automatically:

• ✅ Gathered context - Retrieved relevant data from your observability stack
• ✅ Identified the root cause - Pinpointed the underlying issue
• ✅ Provided actionable solutions - Specific steps to fix the problem
• ✅ Saved investigation time - No manual troubleshooting steps required

Next Steps

• Recommended Setup - Connect metrics, logs, and cloud providers to unlock deeper investigations
• Troubleshooting guide - Common issues and solutions
• Join our Slack - Get help from the community
• Request features on GitHub - Suggest improvements or report bugs