Skip to content

Update Send Alerts API documentation to focus on HolmesGPT#2068

Merged
aantn merged 3 commits intomasterfrom
claude/update-alerts-api-docs-FZk99
May 4, 2026
Merged

Update Send Alerts API documentation to focus on HolmesGPT#2068
aantn merged 3 commits intomasterfrom
claude/update-alerts-api-docs-FZk99

Conversation

@aantn
Copy link
Copy Markdown
Collaborator

@aantn aantn commented May 4, 2026

Summary

Updated the Send Alerts API documentation to refocus the messaging around HolmesGPT's AI-powered root cause analysis capabilities rather than general alert management benefits.

Key Changes

  • Replaced the "Why Send Your Alerts to Robusta?" section with a concise description of HolmesGPT's automatic AI-powered root cause analysis functionality
  • Removed the benefits list and timeline screenshot that emphasized alert history and centralized monitoring
  • Updated the "Integration Methods" intro text to clarify that alerts are sent for Holmes to investigate
  • Removed the note about API availability being limited to SaaS and commercial plans

Notable Details

The documentation now emphasizes the core value proposition of automated AI investigation and triage, positioning HolmesGPT as the primary benefit of sending alerts to Robusta rather than focusing on alert aggregation and history features.

https://claude.ai/code/session_012jM54fvj27H8feByzcED2a

claude added 2 commits May 4, 2026 12:05
Reframe the page so it leads with Holmes investigating sent alerts, and
drop the generic benefits list and timeline screenshot.
The exporting docs section is already commercial-only, so the inline
banner doesn't add information.
@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 4, 2026

Docker image ready for 712c5e7 (built in 2m 40s)

⚠️ Warning: does not support ARM (ARM images are built on release only - not on every PR)

Use this tag to pull the image for testing.

📋 Copy commands

⚠️ Temporary images are deleted after 30 days. Copy to a permanent registry before using them:

gcloud auth configure-docker us-central1-docker.pkg.dev
docker pull us-central1-docker.pkg.dev/robusta-development/temporary-builds/robusta-runner:712c5e7
docker tag us-central1-docker.pkg.dev/robusta-development/temporary-builds/robusta-runner:712c5e7 me-west1-docker.pkg.dev/robusta-development/development/robusta-runner-dev:712c5e7
docker push me-west1-docker.pkg.dev/robusta-development/development/robusta-runner-dev:712c5e7

Patch Helm values in one line:

helm upgrade --install robusta robusta/robusta \
  --reuse-values \
  --set runner.image=me-west1-docker.pkg.dev/robusta-development/development/robusta-runner-dev:712c5e7

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 4, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: abba9642-089c-446f-b9e6-cfe157de6908

📥 Commits

Reviewing files that changed from the base of the PR and between 9c8f6c0 and a2d70ae.

📒 Files selected for processing (1)
  • docs/configuration/exporting/send-alerts-api.rst
✅ Files skipped from review due to trivial changes (1)
  • docs/configuration/exporting/send-alerts-api.rst

Walkthrough

Rewords the Send Alerts API documentation: removes the "Why Send Your Alerts to Robusta?" section and its image, opens the page directly with the "Integration Methods" heading and a statement that alerts can be sent to Robusta for HolmesGPT AI-powered root cause analysis, and drops the edition-availability note from the API section.

Changes

Send Alerts API Documentation

Layer / File(s) Summary
Integration Methods Intro / HolmesGPT
docs/configuration/exporting/send-alerts-api.rst (lines 4–9)
Rewrites the opening to state there are two main ways to send alerts and explicitly notes HolmesGPT can investigate alerts (cluster state, logs/metrics/data sources) and attach findings.
Structure / Heading Order
docs/configuration/exporting/send-alerts-api.rst (lines 6–12)
Removes the preceding "Why Send Your Alerts to Robusta?" section so the "Integration Methods" heading is the page entry point.
Send Alerts API: Availability Note Removed
docs/configuration/exporting/send-alerts-api.rst (lines 15–18)
Deletes the note that previously restricted API availability to Robusta SaaS and self-hosted commercial plans; proceeds directly to endpoint description.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

  • Docs reorganize clean #1902: Edits the same docs/configuration/exporting/send-alerts-api.rst file (earlier change added the page; this PR modifies wording and availability note).

Suggested reviewers

  • arikalon1
  • pavangudiwada
  • moshemorad
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title directly reflects the main change: updating Send Alerts API documentation to focus on HolmesGPT, which aligns with the content changes and PR objectives.
Description check ✅ Passed The description provides a clear and detailed account of the changes made to the documentation, including the specific sections modified and the rationale for refocusing on HolmesGPT's AI capabilities.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch claude/update-alerts-api-docs-FZk99

Review rate limit: 3/5 reviews remaining, refill in 21 minutes and 41 seconds.

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick comments (2)
docs/configuration/exporting/send-alerts-api.rst (2)

4-10: ⚡ Quick win

Make HolmesGPT/Holmes naming consistent.

The intro mixes “HolmesGPT” (Line 4) with “Holmes” (Line 9). Please pick one term and use it consistently across both sentences/bullets to avoid confusion and keep branding uniform.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/configuration/exporting/send-alerts-api.rst` around lines 4 - 10, The
intro uses two different product names ("HolmesGPT" and "Holmes"); pick one
canonical term (e.g., "HolmesGPT") and update the text so both sentences and any
following bullets consistently use that chosen name; specifically replace the
other occurrence of "Holmes" with the chosen canonical name in the paragraph
that currently reads "Holmes investigates the alert..." and any nearby headings
or occurrences in this section to ensure uniform branding.

4-4: ⚡ Quick win

Consider softening the “skip manual triage” phrasing.

Line 4 says HolmesGPT “then attaches its findings so you can skip the manual triage step.” If there are cases where manual review is still needed, this wording could over-promise. Consider reframing to “reduce” or “accelerate” triage rather than guaranteeing it’s fully skipped.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/configuration/exporting/send-alerts-api.rst` at line 4, Update the
sentence that currently reads "then attaches its findings so you can skip the
manual triage step" to soften the guarantee; replace that phrase with wording
such as "then attaches its findings to help reduce or accelerate manual triage"
(or similar phrasing like "help reduce the need for manual triage" / "help
accelerate triage") so the docs avoid over-promising; locate the exact string
"skip the manual triage step" in the doc and make the substitution.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In `@docs/configuration/exporting/send-alerts-api.rst`:
- Around line 4-10: The intro uses two different product names ("HolmesGPT" and
"Holmes"); pick one canonical term (e.g., "HolmesGPT") and update the text so
both sentences and any following bullets consistently use that chosen name;
specifically replace the other occurrence of "Holmes" with the chosen canonical
name in the paragraph that currently reads "Holmes investigates the alert..."
and any nearby headings or occurrences in this section to ensure uniform
branding.
- Line 4: Update the sentence that currently reads "then attaches its findings
so you can skip the manual triage step" to soften the guarantee; replace that
phrase with wording such as "then attaches its findings to help reduce or
accelerate manual triage" (or similar phrasing like "help reduce the need for
manual triage" / "help accelerate triage") so the docs avoid over-promising;
locate the exact string "skip the manual triage step" in the doc and make the
substitution.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 0263c646-400e-422d-8e7c-00d9894f0a84

📥 Commits

Reviewing files that changed from the base of the PR and between adcc345 and 9c8f6c0.

📒 Files selected for processing (1)
  • docs/configuration/exporting/send-alerts-api.rst

…laim

Address CodeRabbit nitpicks: standardize on "HolmesGPT" instead of
mixing it with "Holmes", and reframe "skip the manual triage step" as
"accelerate triage" to avoid over-promising.
@aantn aantn enabled auto-merge (squash) May 4, 2026 12:48
@aantn aantn merged commit cd99816 into master May 4, 2026
7 checks passed
@aantn aantn deleted the claude/update-alerts-api-docs-FZk99 branch May 4, 2026 12:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants