Merge branch 'master' into feature/helm-dns-config

Author: andrewgkew

docs/conf.py

@@ -71,7 +71,11 @@
     "developer-guide/actions/findings-api.html": "/master/playbook-reference/actions/develop-actions/findings-api.html",
     "tutorials/my-first-custom-action.html": "/master/playbook-reference/actions/develop-actions/index.html",
     "user-guide/self-hosting.html": "/master/how-it-works/oss-vs-saas.html",
-    "getting-started/installation.html": "/master/setup-robusta/installation/all-in-one-installation.html",
+    "getting-started/installation.html": "/master/setup-robusta/installation/index.html",
+    "setup-robusta/installation/all-in-one-installation.html": "/master/setup-robusta/installation/index.html",
+    "setup-robusta/installation/standalone-installation.html": "/master/setup-robusta/installation/index.html",
+    "setup-robusta/installation/dev-setup.html": "/master/help.html",
+    "setup-robusta/supported-clusters.html": "/master/setup-robusta/installation/index.html",
     "tutorials/java-troubleshooting.html": "/master/tutorials/application-troubleshooting-java.html",
     "catalog/sinks/index.html": "/master/configuration/sinks/index.html",
     "tutorials/prometheus-enrichment.html": "/master/tutorials/alert-custom-enrichment.html",
@@ -97,7 +101,8 @@
     "configuration/defining-playbooks/playbook-basics.html": "/master/playbook-reference/index.html",
     "configuration/defining-playbooks/trigger-action-binding.html": "/master/playbook-reference/index.html#matching-actions-to-triggers",
     "playbook-reference/defining-playbooks/trigger-action-binding.html": "/master/playbook-reference/index.html#matching-actions-to-triggers",
-    "configuration/additional-settings.html": "/master/setup-robusta/additional-settings.html",
+    "configuration/additional-settings.html": "/master/setup-robusta/installation/index.html",
+    "setup-robusta/additional-settings.html": "/master/setup-robusta/installation/index.html",
     "developer-guide/writing-playbooks.html": "/master/playbook-reference/defining-playbooks/index.html",
     "user-guide/slack.html": "/master/configuration/sinks/slack.html",
     "user-guide/elasticsearch.html": "/master/playbook-reference/triggers/elasticsearch.html",
@@ -130,8 +135,11 @@
     "tutorials/alert-custom-prometheus.html": "/master/configuration/alertmanager-integration/alert-custom-prometheus.html",
     "catalog/triggers/prometheus.html": "/master/configuration/alertmanager-integration/index.html",
     "playbook-reference/prometheus-examples/alert-remediation.html": "/master/playbook-reference/automatic-remediation-examples/index.html",
-    "configuration/ai-analysis.html": "/master/configuration/holmesgpt/main-features.html",
-    "configuration/holmesgpt/index.html": "/master/configuration/holmesgpt/main-features.html",
+    "configuration/ai-analysis.html": "https://robusta.dev/",
+    "configuration/holmesgpt/index.html": "https://robusta.dev/",
+    "configuration/holmesgpt/main-features.html": "https://robusta.dev/",
+    "configuration/holmesgpt/getting-started.html": "https://robusta.dev/",
+    "configuration/holmesgpt/holmesgpt-docs.html": "https://robusta.dev/",
     # AI Analysis pages redirects to holmesgpt.dev (docs have moved there)
     "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",
@@ -164,12 +172,12 @@
     "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",
+    "user-guide/global-config.html": "/master/setup-robusta/installation/index.html",
     "user-guide/configuration-secrets.html": "master/setup-robusta/configuration-secrets.html",
     "user-guide/additional-playbooks.html": "/master/playbook-reference/defining-playbooks/external-playbook-repositories.html",
     "user-guide/embedded-prometheus.html": "/master/configuration/alertmanager-integration/embedded-prometheus.html#enabling-the-embedded-prometheus",
     "user-guide/node-selector.html": "/master/setup-robusta/node-selector.html",
-    "user-guide/interactivity.html": "/master/setup-robusta/additional-settings.html#two-way-interactivity",
+    "user-guide/interactivity.html": "/master/setup-robusta/installation/index.html",
     "user-guide/flow-control.html": "/master/playbook-reference/index.html#using-filters-to-restrict-triggers",
     "catalog/triggers/index.html": "/master/playbook-reference/triggers/index.html",
     "catalog/triggers/kubernetes.html": "/master/playbook-reference/triggers/kubernetes.html",
@@ -216,7 +224,7 @@
     "playbook-reference/overview.html": "/master/playbook-reference/index.html",
     "playbook-reference/defining-playbooks/playbook-basics.html": "/master/playbook-reference/index.html",
     "how-it-works/alert-builtin-enrichment.html": "/master/playbook-reference/builtin-alert-enrichment.html",
-    "setup-robusta/installation/extend-prometheus-installation.html": "/master/setup-robusta/installation/standalone-installation.html",
+    "setup-robusta/installation/extend-prometheus-installation.html": "/master/setup-robusta/installation/index.html",
     "playbook-reference/defining-playbooks/index.html": "/master/playbook-reference/index.html",
     "configuration/alertmanager-integration/alert-custom-prometheus.html": "/master/configuration/alertmanager-integration/embedded-prometheus.html#creating-custom-prometheus-alerts",
     "configuration/alertmanager-integration/index.html": "/master/configuration/index.html",

docs/configuration/alertmanager-integration/_testing_integration.rst

@@ -56,4 +56,4 @@ If everything is setup properly, this alert will reach Robusta. It will show up
 
     Robusta enriches alerts with Kubernetes and log data using Prometheus labels for mapping.
     Standard label names are used by default. If your setup differs, you can
-    `customize this mapping </setup-robusta/additional-settings.html#alert-label-mapping>`_ to fit your environment.
+    `customize this mapping </configuration/alertmanager-integration/customize-labels-priorities.html>`_ to fit your environment.

docs/configuration/exporting/robusta-pro-features.rst

@@ -19,9 +19,7 @@ Data Export and Reporting
 * :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
 * :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
 
 Getting Started
 ---------------

docs/configuration/exporting/send-alerts-api.rst

@@ -1,24 +1,12 @@
 Send Alerts API
 ===============
 
-Why Send Your Alerts to Robusta?
----------------------------------
-
-Benefits include:
-
-* Persistent alert history on a filterable timeline
-* Centralized view of alerts from all your monitoring systems (multiple Prometheus instances, cloud services, custom tools)
-* AI investigation of alerts
-* Correlations between alerts and Kubernetes deploys
-* and more!
-
-.. image:: /images/robusta-ui-timeline.png
-   :alt: Prometheus Alert History
+Send alerts to Robusta to have HolmesGPT automatically run an AI-powered root cause analysis on each one. HolmesGPT investigates the alert against your live cluster state, logs, metrics, and connected data sources, then attaches its findings to help accelerate triage.
 
 Integration Methods
 -------------------
 
-There are two main ways to send alerts to Robusta:
+There are two main ways to send alerts to Robusta for HolmesGPT to investigate:
 
 1. **Pre-built Integrations**: Use our existing integrations for AlertManager, Nagios, SolarWinds, and other monitoring systems. See :doc:`Send Alerts <../index>`.
 
@@ -27,9 +15,6 @@ There are two main ways to send alerts to Robusta:
 Send Alerts API
 ---------------
 
-.. note::
-    This API is available with the Robusta SaaS platform and self-hosted commercial plans. It is not available in the open-source version.
-
 Use this endpoint to send alert data to Robusta. You can send up to 1000 alerts in a single request.
 
 .. _send-alerts-api:
@@ -261,7 +246,7 @@ Troubleshooting
 
         **Alerts arriving but missing Kubernetes context?**
 
-        Check :doc:`Alert Label Mapping </setup-robusta/additional-settings>` to customize how Prometheus labels map to Kubernetes resources.
+        Check :doc:`Customize Labels and Priorities </configuration/alertmanager-integration/customize-labels-priorities>` to customize how Prometheus labels map to Kubernetes resources.
 
 Testing Your Integration
 ------------------------

docs/configuration/holmesgpt/getting-started.rst

@@ -185,5 +185,5 @@ Next Steps
 ----------
 
 - Configure :doc:`alert routing </notification-routing/index>`
-- Set up :doc:`AI-powered insights </configuration/holmesgpt/getting-started>`
+- `Set up AI-powered insights <https://platform.robusta.dev/signup>`_
 - Learn about :doc:`common configuration options <metric-providers>`

docs/configuration/holmesgpt/holmesgpt-docs.rst

@@ -27,7 +27,7 @@ Each sink consists of a sink class and a config class. Optionally, helpers are u
 
 To implement a new sink you must:
 
-1. :ref:`Build Robusta from source <Build from Source>`
+1. Clone the `Robusta repo <https://github.com/robusta-dev/robusta>`_ and follow the README to build from source
 2. Add a new Python module inside `src/robusta/core/sinks <https://github.com/robusta-dev/robusta/tree/master/src/robusta/core/sinks>`_ containing your sink’s source code
 3. Implement a sink config class
 4. Implement a sink class

docs/configuration/holmesgpt/main-features.rst

@@ -20,14 +20,14 @@ Quick Start
 
 **Option 1: Automatic Setup (Recommended)**
 
-When installing Robusta, run ``robusta gen-config`` and follow the prompts. This automatically configures Slack using our `official
+Sign up for a `free Robusta account <https://platform.robusta.dev/signup>`_ and connect Slack during the signup wizard. This automatically configures Slack using our `official
 Slack app <https://slack.com/apps/A0214S5PHB4-robusta?tab=more_info>`_.
 
 Note: Robusta can only write messages and doesn't require read permissions.
 
 **Option 2: Manual Configuration**
 
-Generate a Slack API key by running ``robusta integrations slack``, then add to your ``generated_values.yaml``:
+Generate a Slack API key on your own (see :ref:`Creating Custom Slack Apps` below), then add it to your ``generated_values.yaml``:
 
 .. code-block:: yaml