Rocket.Chat

opensre onboard
# or
opensre integrations setup rocketchat

# Token mode
ROCKETCHAT_SERVER_URL=https://chat.example.com
ROCKETCHAT_AUTH_TOKEN=<personal-access-token>
ROCKETCHAT_USER_ID=<user-id>
ROCKETCHAT_DEFAULT_CHANNEL=#incidents

# Webhook mode (either mode alone is enough; both may be set)
ROCKETCHAT_WEBHOOK_URL=https://chat.example.com/hooks/<id>/<token>

docker network create rc-net

docker run -d --name rc-mongo --network rc-net --platform linux/amd64 \
  mongo:7.0 --replSet rs0 --bind_ip_all
i=0
until docker exec rc-mongo mongosh --quiet --eval "db.runCommand('ping')" > /dev/null 2>&1; do
  i=$((i + 1))
  [ "$i" -ge 30 ] && { echo "ERROR: MongoDB never became ready" >&2; exit 1; }
  sleep 2
done
docker exec rc-mongo mongosh --eval "rs.initiate()"

docker run -d --name rc-dev --network rc-net --platform linux/amd64 -p 127.0.0.1:3201:3000 \
  -e 'MONGO_URL=mongodb://rc-mongo:27017/rocketchat?replicaSet=rs0' \
  -e 'MONGO_OPLOG_URL=mongodb://rc-mongo:27017/local?replicaSet=rs0' \
  -e 'ROOT_URL=http://localhost:3201' \
  -e 'ADMIN_USERNAME=verifyadmin' \
  -e 'ADMIN_PASS=verify-admin-pass' \
  -e 'ADMIN_EMAIL=verifyadmin@example.com' \
  -e 'OVERWRITE_SETTING_Show_Setup_Wizard=completed' \
  -e 'OVERWRITE_SETTING_Accounts_TwoFactorAuthentication_Enabled=false' \
  rocket.chat:8.5.1

i=0
until curl -sf -o /dev/null http://localhost:3201/api/info; do
  i=$((i + 1))
  [ "$i" -ge 40 ] && { echo "ERROR: Rocket.Chat never became ready" >&2; exit 1; }
  sleep 10
done

RC_LOGIN=$(printf 'user=verifyadmin&password=verify-admin-pass' | curl -s -X POST http://localhost:3201/api/v1/login --data-binary @-)
RC_AUTH_TOKEN=$(echo "$RC_LOGIN" | python3 -c "import json,sys;print(json.load(sys.stdin)['data']['authToken'])")
RC_USER_ID=$(echo "$RC_LOGIN" | python3 -c "import json,sys;print(json.load(sys.stdin)['data']['userId'])")
unset RC_LOGIN

RC_PAT=$(printf 'tokenName=opensre-verify' | curl -s -X POST http://localhost:3201/api/v1/users.generatePersonalAccessToken \
  -H "X-Auth-Token: $RC_AUTH_TOKEN" -H "X-User-Id: $RC_USER_ID" --data-binary @- \
  | python3 -c "import json,sys;print(json.load(sys.stdin)['token'])")

export ROCKETCHAT_SERVER_URL="http://localhost:3201"
export ROCKETCHAT_AUTH_TOKEN="$RC_PAT"
export ROCKETCHAT_USER_ID="$RC_USER_ID"
export ROCKETCHAT_DEFAULT_CHANNEL="#general"
unset RC_PAT RC_AUTH_TOKEN RC_USER_ID

opensre integrations verify rocketchat

SERVICE    │ SOURCE    │ STATUS   │ DETAIL
rocketchat │ local env │ ✓ passed │ Connected to Rocket.Chat as @verifyadmin.

sleep 30 &
opensre watchdog --pid $! --max-runtime 2s --once --provider rocketchat --chat-id "#general"

🚨 OpenSRE Watchdog Alarm
host       dev-machine.local
pid        44352  (sleep)
cmd        sleep 30
threshold  max_runtime  limit=2s  observed=2s
runtime    2s
started    2026-08-21T09:54:35.439729Z

docker rm -f rc-dev rc-mongo && docker network rm rc-net
unset ROCKETCHAT_SERVER_URL ROCKETCHAT_AUTH_TOKEN
unset ROCKETCHAT_USER_ID ROCKETCHAT_DEFAULT_CHANNEL

{
  "name": "rocketchat_send_message",
  "arguments": {
    "channel": "#incidents",
    "message": "DB CPU is back below 70%; keeping the incident open for 10 minutes."
  }
}

/background on
/background notify set rocketchat          # or: email,rocketchat
/investigate datadog

/watch <pid> --max-cpu 80 --provider rocketchat --chat-id "#alerts"

opensre watchdog --pid <pid> --max-cpu 80 --provider rocketchat --chat-id "#alerts"

opensre hermes watch --provider rocketchat --chat-id "#incidents"

opensre cron add --kind daily_summary --cron "0 9 * * 1-5" \
  --tz America/Sao_Paulo --provider rocketchat --chat-id "#ops"

opensre integrations verify rocketchat

opensre investigate --input tests/e2e/kubernetes/fixtures/datadog_k8s_alert.json