Rocket.Chat

This page documents a legacy sink in Robusta classic

For new setups, we recommend HolmesGPT instead.

HolmesGPT triages your alerts instead of just forwarding them. Sinks are deterministic: they send every notification, unchanged, to a fixed destination, leaving you to read and prioritize each one yourself.

HolmesGPT instead uses AI to investigate each alert, surface the likely root cause, and escalate only what needs attention — so you get fewer, more actionable notifications. Set this up with Alerts Triage for alerts, or Triggered Workflows for custom events.

Robusta can report issues and events in your Kubernetes cluster to Rocket.Chat.

Prerequisites

Before you begin setting up the Rocket.Chat sink, ensure you have the following information ready:

  • Server URL

  • Personal Access Token

  • User ID

  • Channel name

Rocket.Chat Server Setup

First, you need to set up a Rocket.Chat server. If you haven't done this yet, you can find detailed information on deploying on-prem servers at the following URL: Rocket.Chat Installation Guide.

Or if you prefer using RocketChat's cloud SaaS platform, you can follow the instructions at this URL: Rocket.Chat Cloud Setup.

Generating Personal Access Token and User ID

Follow these steps to generate the required Personal Access Token and User ID:

  1. Log in to your Rocket.Chat server using your valid username and password.

  2. Click on your avatar and select My Account from the menu.

  3. Navigate to Profile > Personal Access Tokens.

  4. Check the Ignore Two Factor Authentication option if enabled.

  5. Fill in the Add new Personal Access Token text field and click the Add button.

  6. Copy the provided Personal Access Token and User ID for later use.

Configuring the Rocket.Chat sink

Add this to your generated_values.yaml

 sinksConfig:
 # Rocket.Chat integration params
- rocketchat_sink:
      name: main_rocketchat_sink
      user_id: <User ID>
      channel: <Rocket.Chat channel>
      token: <Personal Access Token>
      server_url: <Server URL>

Save the file and run

 helm upgrade robusta robusta/robusta --values=generated_values.yaml