Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
34 commits
Select commit Hold shift + click to select a range
c026e43
Update architecture and oss-vs-saas docs to reflect current commercia…
claude Feb 17, 2026
79ce066
Make HolmesGPT the primary focus of architecture and oss-vs-saas docs
claude Feb 17, 2026
3d914ed
Remove 'How It Works' section from architecture docs
claude Feb 17, 2026
06b69af
Move Robusta Classic footnote to architecture, trim Agent bullets, re…
claude Feb 17, 2026
78f922e
Update architecture diagram and align docs with new diagram
claude Feb 17, 2026
9ad548e
Remove cluster-specific wording from Platform section
claude Feb 17, 2026
9800b5f
Replace notification routing with HolmesGPT Slack/Teams bot mention
claude Feb 17, 2026
5a1476d
Reframe Platform description as SRE agent control center
claude Feb 17, 2026
7e9727f
Remove pro features link from Platform section
claude Feb 17, 2026
c8d88a0
Remove usage FAQ and revamp index page messaging
claude Feb 17, 2026
28d2c6d
Remove outdated FAQ entries about DataDog, NewRelic, and monitoring r…
claude Feb 17, 2026
5c2408f
Consolidate sidebar sections into Other Features
claude Feb 17, 2026
f05854e
Reorganize sidebar: HTTP APIs section, move Connect Metrics & CRDs
claude Feb 17, 2026
9d3e276
Remove stale Robusta Pro Features link, add Robusta Classic section
claude Feb 17, 2026
1acdbc2
Link data sources to holmesgpt.dev, update signup link and Classic wo…
claude Feb 17, 2026
bd25af2
Simplify main-features page and clean up getting-started prerequisites
claude Feb 17, 2026
388770d
Simplify getting-started, link to holmesgpt.dev with robusta-helm-cha…
claude Feb 17, 2026
daa4457
Clean up docs: trim getting-started, fix sidebar, update README, remo…
claude Feb 17, 2026
c9d3e83
Fix GitHub link to HolmesGPT repo, fix Other Features sidebar flattening
claude Feb 17, 2026
f3dfb0e
Fix Other Features sidebar: remove hidden toctrees from parent pages
claude Feb 17, 2026
e678dba
Fix architecture pages to appear in sidebar TOC hierarchy
claude Feb 17, 2026
c3525d0
Clean up README header and move nav links under What Can Robusta Do
claude Feb 17, 2026
4da0ac2
Add toctree to configuration/index.rst and trim oss-vs-saas text
claude Feb 17, 2026
1ce142e
Revert suppress_warnings to original value
claude Feb 17, 2026
71d5bc9
Fix RST heading underline length for cluster_name section
claude Feb 17, 2026
95e7df4
Fix Other Features sidebar nesting for Send Alerts to Robusta
claude Feb 17, 2026
fd08b54
Move toctree before section headings in configuration/index
claude Feb 17, 2026
5d6079c
Add toctrees for sidebar children and fix missing pages
claude Feb 17, 2026
bac2b26
Move LaunchDarkly under Track Config Changes to match master
claude Feb 17, 2026
e6dcbaf
Flatten Overview section: remove double Overview in sidebar
claude Feb 17, 2026
cde7191
Update OSS description: CLI and HTTP API, no web UI
claude Feb 17, 2026
1963af9
Update oss-vs-saas: remove pro link, CNCF sandbox, simplify classic
claude Feb 17, 2026
7416b8c
Rename AI Analysis section to SRE Agent
claude Feb 17, 2026
9084f97
Point Get Started button to signup page
claude Feb 17, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 11 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,19 +1,21 @@
<div id="top"></div>

<div align="center">
<h1 align="center">Robusta - Better Prometheus Notifications for Kubernetes</h1>
<h2 align="center">Better grouping, enrichment, and remediation of your existing alerts</h2>
<p align="center">
<a href="#%EF%B8%8F-how-it-works"><strong>How it Works</strong></a> |
<a href="#-installing-robusta"><strong>Installation</strong></a> |
<a href="https://docs.robusta.dev/master/configuration/index.html"><strong>Integrations ↗</strong></a> |
<a href="https://docs.robusta.dev/master/index.html"><strong>Docs ↗</strong></a> |
<a href="https://bit.ly/robusta-slack"><strong>Slack Community ↗</strong></a>
</p>
<h1 align="center">Robusta Classic - Prometheus Alert Enrichment for Kubernetes</h1>
</div>

> **Note:** This repository contains **Robusta Classic** — the rule-based alert enrichment engine. For AI-powered root cause analysis, see [HolmesGPT](https://github.com/robusta-dev/holmesgpt). Both can be installed together as part of the [Robusta platform](https://platform.robusta.dev/signup).

## What Can Robusta Do?

<p align="center">
<a href="#%EF%B8%8F-how-it-works"><strong>How it Works</strong></a> |
<a href="#-installing-robusta"><strong>Installation</strong></a> |
<a href="https://docs.robusta.dev/master/configuration/index.html"><strong>Integrations ↗</strong></a> |
<a href="https://docs.robusta.dev/master/index.html"><strong>Docs ↗</strong></a> |
<a href="https://bit.ly/robusta-slack"><strong>Slack Community ↗</strong></a>
</p>

Compatible with kube-prometheus-stack, Prometheus Operator, and more.

Robusta integrates with Prometheus by webhook and adds features like:
Expand Down
14 changes: 0 additions & 14 deletions docs/community-tutorials.rst

This file was deleted.

68 changes: 34 additions & 34 deletions docs/conf.py
Original file line number Diff line number Diff line change
Expand Up @@ -109,7 +109,7 @@
"tutorials/routing-silencing.html": "/master/notification-routing/routing-silencing.html",
"configuration/configuring-sinks.html": "/master/notification-routing/configuring-sinks.html",
"how-it-works/privacy-and-security.html": "/master/setup-robusta/privacy-and-security.html",
"how-it-works/index.html": "/master/playbook-reference/what-are-playbooks.html",
# "how-it-works/index.html": "/master/playbook-reference/what-are-playbooks.html", # removed: now a real page
"playbook-reference/examples.html": "/master/playbook-reference/builtin-alert-enrichment.html",
"playbook-reference/prometheus-examples/index.html": "/master/playbook-reference/builtin-alert-enrichment.html",
"tutorials/playbook-track-changes.html": "/master/playbook-reference/kubernetes-examples/kubernetes-change-notifications.html",
Expand All @@ -133,35 +133,35 @@
"configuration/ai-analysis.html": "/master/configuration/holmesgpt/main-features.html",
"configuration/holmesgpt/index.html": "/master/configuration/holmesgpt/main-features.html",
# AI Analysis pages redirects to holmesgpt.dev (docs have moved there)
"configuration/holmesgpt/builtin_toolsets.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/",
"configuration/holmesgpt/permissions.html": "https://holmesgpt.dev/data-sources/permissions/",
"configuration/holmesgpt/custom_toolsets.html": "https://holmesgpt.dev/data-sources/custom-toolsets/",
"configuration/holmesgpt/remote_mcp_servers.html": "https://holmesgpt.dev/data-sources/remote-mcp-servers/",
"configuration/holmesgpt/builtin_toolsets.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/?tab=robusta-helm-chart",
"configuration/holmesgpt/permissions.html": "https://holmesgpt.dev/data-sources/permissions/?tab=robusta-helm-chart",
"configuration/holmesgpt/custom_toolsets.html": "https://holmesgpt.dev/data-sources/custom-toolsets/?tab=robusta-helm-chart",
"configuration/holmesgpt/remote_mcp_servers.html": "https://holmesgpt.dev/data-sources/remote-mcp-servers/?tab=robusta-helm-chart",
# Individual toolset page redirects
"configuration/holmesgpt/toolsets/argocd.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/argocd/",
"configuration/holmesgpt/toolsets/aws.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/aws/",
"configuration/holmesgpt/toolsets/confluence.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/confluence/",
"configuration/holmesgpt/toolsets/coralogix_logs.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/coralogix-logs/",
"configuration/holmesgpt/toolsets/datadog_logs.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/datadog/",
"configuration/holmesgpt/toolsets/datetime.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/datetime/",
"configuration/holmesgpt/toolsets/docker.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/docker/",
"configuration/holmesgpt/toolsets/grafanaloki.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/grafanaloki/",
"configuration/holmesgpt/toolsets/grafanatempo.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/grafanatempo/",
"configuration/holmesgpt/toolsets/helm.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/helm/",
"configuration/holmesgpt/toolsets/internet.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/internet/",
"configuration/holmesgpt/toolsets/kafka.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/kafka/",
"configuration/holmesgpt/toolsets/kubernetes.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/kubernetes/",
"configuration/holmesgpt/toolsets/newrelic.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/newrelic/",
"configuration/holmesgpt/toolsets/notion.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/notion/",
"configuration/holmesgpt/toolsets/opensearch_logs.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/opensearch-logs/",
"configuration/holmesgpt/toolsets/opensearch_status.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/opensearch-status/",
"configuration/holmesgpt/toolsets/prometheus.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/prometheus/",
"configuration/holmesgpt/toolsets/rabbitmq.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/rabbitmq/",
"configuration/holmesgpt/toolsets/robusta.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/robusta/",
"configuration/holmesgpt/toolsets/slab.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/slab/",
"configuration/holmesgpt/toolsets/argocd.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/argocd/?tab=robusta-helm-chart",
"configuration/holmesgpt/toolsets/aws.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/aws/?tab=robusta-helm-chart",
"configuration/holmesgpt/toolsets/confluence.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/confluence/?tab=robusta-helm-chart",
"configuration/holmesgpt/toolsets/coralogix_logs.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/coralogix-logs/?tab=robusta-helm-chart",
"configuration/holmesgpt/toolsets/datadog_logs.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/datadog/?tab=robusta-helm-chart",
"configuration/holmesgpt/toolsets/datetime.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/datetime/?tab=robusta-helm-chart",
"configuration/holmesgpt/toolsets/docker.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/docker/?tab=robusta-helm-chart",
"configuration/holmesgpt/toolsets/grafanaloki.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/grafanaloki/?tab=robusta-helm-chart",
"configuration/holmesgpt/toolsets/grafanatempo.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/grafanatempo/?tab=robusta-helm-chart",
"configuration/holmesgpt/toolsets/helm.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/helm/?tab=robusta-helm-chart",
"configuration/holmesgpt/toolsets/internet.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/internet/?tab=robusta-helm-chart",
"configuration/holmesgpt/toolsets/kafka.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/kafka/?tab=robusta-helm-chart",
"configuration/holmesgpt/toolsets/kubernetes.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/kubernetes/?tab=robusta-helm-chart",
"configuration/holmesgpt/toolsets/newrelic.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/newrelic/?tab=robusta-helm-chart",
"configuration/holmesgpt/toolsets/notion.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/notion/?tab=robusta-helm-chart",
"configuration/holmesgpt/toolsets/opensearch_logs.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/opensearch-logs/?tab=robusta-helm-chart",
"configuration/holmesgpt/toolsets/opensearch_status.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/opensearch-status/?tab=robusta-helm-chart",
"configuration/holmesgpt/toolsets/prometheus.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/prometheus/?tab=robusta-helm-chart",
"configuration/holmesgpt/toolsets/rabbitmq.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/rabbitmq/?tab=robusta-helm-chart",
"configuration/holmesgpt/toolsets/robusta.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/robusta/?tab=robusta-helm-chart",
"configuration/holmesgpt/toolsets/slab.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/slab/?tab=robusta-helm-chart",
"coverage.html": "/master/how-it-works/coverage.html",
"tutorials/python-profiling.html": "/master/playbook-reference/actions/python-troubleshooting.html#python-profiler",
"tutorials/more-tutorials.html": "/master/community-tutorials.html",
"tutorials/more-tutorials.html": "/master/help.html",
"common-errors.html": "/master/help.html#common-errors",
"user-guide/defining-playbooks.html": "/master/playbook-reference/defining-playbooks/index.html",
"user-guide/global-config.html": "/master/setup-robusta/additional-settings.html#global-config",
Expand Down Expand Up @@ -201,10 +201,10 @@
"developer-guide/actions/triggers-and-events.html": "/master/playbook-reference/actions/develop-actions/triggers-and-events.html",
"developer-guide/actions/utility-functions.html": "/master/playbook-reference/actions/develop-actions/utility-functions.html",
"developer-guide/actions/documenting-actions.html": "/master/playbook-reference/actions/develop-actions/documenting-actions.html",
"developer-guide/platform/index.html": "/master/contributing.html",
"developer-guide/platform/dev-setup.html": "/master/contributing.html",
"developer-guide/platform/coding-conventions.html": "/master/contributing.html",
"developer-guide/platform/docs-contributions.html": "/master/docs-contributions.html#improving-these-docs",
"developer-guide/platform/index.html": "/master/help.html",
"developer-guide/platform/dev-setup.html": "/master/help.html",
"developer-guide/platform/coding-conventions.html": "/master/help.html",
"developer-guide/platform/docs-contributions.html": "/master/help.html",
"developer-guide/platform/sinks-guide.html": "/master/configuration/sinks/sinks-development.html",
"user-guide/robusta-cli.html": "/master/setup-robusta/installation/index.html",
"advanced/index.html": "/master/setup-robusta/installation/index.html",
Expand Down Expand Up @@ -293,8 +293,8 @@
"icon": {
"repo": "fontawesome/brands/github",
},
"repo_url": "https://github.com/robusta-dev/robusta",
"repo_name": "Robusta",
"repo_url": "https://github.com/robusta-dev/holmesGPT",
"repo_name": "HolmesGPT",
"repo_type": "github",
"edit_uri": "tree/master/docs",
"palette": [
Expand Down Expand Up @@ -330,7 +330,7 @@
"social": [
{
"icon": "fontawesome/brands/github",
"link": "https://github.com/robusta-dev/robusta",
"link": "https://github.com/robusta-dev/holmesGPT",
},
{
"icon": "fontawesome/brands/slack",
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -48,7 +48,7 @@ Apply the following Secret in the GMP namespace (default ``gmp-public``). Replac
repeat_interval: 4h

Ensure alerts include ``cluster_name``
*************************************
**************************************

Use an ``OperatorConfig`` to add external labels to both collection and rule evaluation so every alert contains the required ``cluster_name`` label.

Expand Down
74 changes: 14 additions & 60 deletions docs/configuration/exporting/robusta-pro-features.rst
Original file line number Diff line number Diff line change
@@ -1,78 +1,32 @@
Overview
========
HTTP APIs
=========

.. note::
These features are available with the Robusta SaaS platform and self-hosted commercial plans. They are not available in the open-source version.
These APIs are available with the Robusta SaaS platform and self-hosted commercial plans. They are not available in the open-source version.

Robusta Pro adds a web UI, additional integrations, and enterprise APIs to the open-source engine. Available as SaaS (we handle hosting) or self-hosted on-premise.
The Robusta Platform exposes REST APIs for programmatic access to alerts, investigations, and platform data.

AI Analysis
-----------

Automatically investigate and resolve issues with AI-powered analysis.

:doc:`AI Analysis (HolmesGPT) <../holmesgpt/main-features>`
Automatically analyze Kubernetes alerts, logs, and metrics. Get potential root causes and remediation suggestions.
Holmes Chat API
---------------

:doc:`Holmes Chat API <../holmesgpt/holmes-chat-api>`
Programmatically send questions to Holmes AI for root cause analysis via REST API.

Custom Alert Ingestion
-----------------------

Send alerts to Robusta from any monitoring system using HTTP webhooks.

:doc:`Custom Webhooks <custom-webhooks>`
Send alerts from any system that supports HTTP webhooks, including custom monitoring solutions.

:doc:`New Relic Integration <../alertmanager-integration/newrelic>`
Forward alerts from New Relic to Robusta via webhooks.

:doc:`LaunchDarkly Integration <../alertmanager-integration/launchdarkly>`
Forward feature flag changes from LaunchDarkly to Robusta via webhooks.

:doc:`SolarWinds Integration <../alertmanager-integration/solarwinds>`
Configure SolarWinds to send alert webhooks directly to Robusta.
Send questions to HolmesGPT for on-demand root cause analysis via REST.

:doc:`Nagios Integration <../alertmanager-integration/nagios>`
Forward alerts from Nagios to Robusta for enrichment and automation.

Data Export and Reporting APIs
-------------------------------

Export alert history and generate reports using Robusta's REST APIs.

**Robusta API Reference**
Comprehensive APIs for exporting alert history, generating reports, and sending custom alerts programmatically.

Features include:
Data Export and Reporting
-------------------------

* :doc:`Alert Export API <alert-export-api>`: Export historical alert data with filtering by time range, alert name, and account
* :doc:`Alert Reporting API <alert-statistics-api>`: Get aggregated statistics and counts for different alert types
* :doc:`Send Alerts API <send-alerts-api>`: Send alerts programmatically from external systems or via integrations
* :doc:`Send Alerts API <send-alerts-api>`: Send alerts programmatically from external systems
* :doc:`Configuration Changes API <configuration-changes-api>`: Track configuration changes in your environment
* :doc:`Namespace Resources API <namespace-resources-api>`: Query namespace-level resource information
* :doc:`RBAC Configuration API <rbac-api>`: Programmatically manage role-based access control configurations
* :doc:`Prometheus Query API <prometheus-query-api>`: Run PromQL queries against Prometheus in your connected clusters

Additional Pro Features
-----------------------

Additional capabilities in Robusta Pro:

* **Web UI**: Manage alerts, playbooks, and configuration through a browser interface
* **Alert Templates**: Create Prometheus alerts without writing PromQL
* **Historical Data**: Query alert history and trends
* **Enterprise Support**: Production support and SLA options

For more details on the differences between open-source and SaaS, see :doc:`Open Source vs SaaS <../../how-it-works/oss-vs-saas>`.

Getting Started
---------------

To access these features:

1. **Robusta SaaS**: `Sign up for free <https://platform.robusta.dev/signup>`_ to get started with the full platform
2. **Self-hosted Commercial**: Contact support@robusta.dev for enterprise plans with self-hosted UI
3. **API Access**: Generate API keys in the Robusta platform under **Settings** → **API Keys**
To access these APIs:

For detailed API documentation and examples, see the individual API references listed above.
1. `Sign up <https://platform.robusta.dev/signup>`_ for Robusta SaaS or contact support@robusta.dev for self-hosted plans
2. Generate API keys in the Robusta Platform under **Settings** → **API Keys**
Loading
Loading