Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.rootly.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

IBM watsonx.ai hosts foundation models in your IBM Cloud account, in a region you control, with enterprise auth and audit. Connect a watsonx project to Rootly and the same AI features that run on OpenAI or Anthropic — incident summaries, alert summaries, text editor, title generation — route through your watsonx project instead. Your incident data and AI prompts stay inside IBM Cloud’s regional boundary the entire time. The integration uses an IBM Cloud API key plus a regional inference endpoint. Rootly exchanges the API key for IAM bearer tokens automatically and refreshes them as needed, so the customer-side configuration is just two fields: region and key.

Pick Your Region

Six IBM Cloud regions available (Dallas, Frankfurt, London, Tokyo, Sydney, Toronto) so inference happens in the jurisdiction your compliance team approved.

Pick Your Model

Choose any foundation model your watsonx project has access to — Granite, Llama variants, and others — pulled live from your project at configuration time.

AI-Powered Summaries

Drives incident summarization, alert summarization, the in-app text editor, and incident title generation when WatsonX is the active provider.

Enterprise Auth

IBM Cloud API keys exchanged for short-lived IAM bearer tokens. Rootly handles the token refresh dance; you never paste a long-lived bearer.

​
Before You Begin

You’ll need access to both sides of the connection.
  • In IBM Cloud — permission to create an API key under your IBM Cloud account and a watsonx.ai project the API key has access to. Most enterprises require IAM access via a watsonx-specific role.
  • In Rootly — an admin role so you can reach Configuration → Integrations and complete the WatsonX setup.
If you’re evaluating IBM watsonx for the first time, IBM’s Quick start guide walks through provisioning a watsonx instance and creating your first project before you reach the credential step.

​
Generate Your IBM watsonx API Key

The vendor-side setup happens in IBM Cloud. Refer to IBM’s API key documentation for the latest UI specifics; the high-level flow is below.
1

Open IBM Cloud API Keys

Sign into IBM Cloud and navigate to Manage → Access (IAM) → API keys. Click Create.
2

Create The Key

Name the key something descriptive (rootly-watsonx-production works well). Choose an account-level or service-ID-scoped key based on your security policy. Click Create.
IBM Cloud shows the API key value once. Copy it now and store it in your secrets manager — you cannot retrieve it later, only revoke and reissue.
3

Confirm Project Access

Open the watsonx.ai project Rootly should use, go to Manage → Access control, and confirm the IBM Cloud identity tied to the API key has at least Editor access to the project (Viewer is insufficient for inference calls).
4

Note Your Region

Confirm which IBM Cloud region hosts your watsonx project. Rootly supports the six watsonx.ai regions — Dallas (us-south), Frankfurt (eu-de), London (eu-gb), Tokyo (jp-tok), Sydney (au-syd), and Toronto (ca-tor). The region you pick in Rootly must match the project’s region exactly.

​
Connect WatsonX to Rootly

With the API key in hand, the Rootly side is two fields and a save.
1

Open The WatsonX Settings

In Rootly, go to Configuration → Integrations and locate WatsonX. Click Setup.
2

Pick The Region

Select the IBM Cloud region from the Host dropdown:
  • us-south.ml.cloud.ibm.com — Dallas
  • ca-tor.ml.cloud.ibm.com — Toronto
Pick the region that matches your watsonx.ai project. Inference requests route to this regional endpoint; data residency follows.
3

Paste The API Key

Paste the IBM Cloud API key into the API Key field. The value is stored encrypted at rest; Rootly exchanges it for short-lived IAM bearer tokens on each request and refreshes them automatically.
4

Save And Verify

Click Save. Rootly tests the credentials against the regional endpoint immediately — a successful save confirms the API key authenticates against IAM and the watsonx project is reachable.

​
Configuration Reference

​
Host
enum
required
IBM Cloud region for inference. Must match the region of the watsonx project the API key has access to.Valid values: us-south.ml.cloud.ibm.com, eu-de.ml.cloud.ibm.com, eu-gb.ml.cloud.ibm.com, jp-tok.ml.cloud.ibm.com, au-syd.ml.cloud.ibm.com, ca-tor.ml.cloud.ibm.com.
​
API Key
string
required
IBM Cloud API key with at least Editor access to the watsonx.ai project. Stored encrypted at rest. Rotated by revoking the key in IBM Cloud and pasting a new one here.
​
Foundation Model
string
The watsonx model Rootly invokes for AI tasks. Rootly defaults to a Llama variant but exposes any foundation model your watsonx project lists. Configurable per AI feature; the model list updates from your project on each Rootly configuration load.

​
AI Features Powered by WatsonX

Once WatsonX is connected and enabled as the active AI provider, it drives the following Rootly features:

Incident Summaries

Auto-generated summaries of incident channels, timelines, and key events for retrospectives and stakeholder updates.

Alert Summaries

Condensed, plain-English versions of monitoring alert payloads so responders triage faster.

Text Editor

The in-app text editor’s AI actions (rewrite, expand, simplify, tone-shift) call watsonx instead of the default provider.

Incident Title Generation

Suggested incident titles based on the triggering alert and channel context.
Switching the active AI provider — between watsonx, OpenAI, Anthropic, and others — is a per-team configuration. WatsonX being connected doesn’t automatically route every team’s AI features through it. Contact Rootly support or your account team to activate WatsonX for specific teams or organization-wide.

​
Selecting a Foundation Model

Rootly pulls the list of available foundation models live from your watsonx project. Whatever models your IBM Cloud identity has access to — IBM Granite, Meta Llama variants, third-party models published in watsonx, custom-tuned models — appear in the selector when configuring AI features. Default model behavior:
  • Out of the box, Rootly invokes a recent instruction-tuned Llama variant suitable for summarization and short-form generation
  • To override, contact your Rootly account team — model selection is managed via a server-side configuration that maps each AI task type to a specific model ID
  • Model availability depends on your IBM Cloud region; not all foundation models are available in every region
Refer to IBM’s foundation models documentation for the current list of supported models and their regional availability.

​
Test the Integration

After saving the WatsonX settings, verify end-to-end inference works.
1

Trigger A Test AI Feature

Open any active incident and use the AI text editor (rewrite or summarize), or open the AI summary panel. If WatsonX is the active provider for your team, the request routes through your IBM Cloud project.
2

Confirm Inference Succeeds

The AI response should appear within a few seconds. If it doesn’t, see Troubleshooting below.
3

Check IBM Cloud Activity

Optional — open IBM Cloud’s Activity Tracker for your watsonx project to confirm the inference request arrived from Rootly and which foundation model it invoked. Useful for capacity planning and cost attribution.
A successful AI response in Rootly plus the corresponding inference event in IBM Cloud’s Activity Tracker confirms WatsonX is wired correctly. From here, broaden the WatsonX rollout to additional teams as needed.

​
Troubleshooting

The API key is invalid, expired, or doesn’t have access to the chosen region’s watsonx project. Confirm:
  • The key value was copied without surrounding whitespace
  • The IBM Cloud identity attached to the key has at least Editor access to the watsonx project in the selected region
  • The key hasn’t been revoked in IBM Cloud’s API keys panel
Most common causes:
  • The selected region’s watsonx endpoint is throttling — check IBM Cloud’s status page for region-specific incidents
  • The foundation model selected isn’t available in your region — switch to a model that lists your region in IBM’s availability matrix
  • Your IBM Cloud plan’s monthly tokens-per-minute quota is exhausted — review usage in IBM Cloud and consider upgrading
The API key authenticates but the project has no models accessible to that identity. Open the watsonx project in IBM Cloud and confirm at least one foundation model is associated with the project under Manage → Foundation models. Refresh the Rootly WatsonX settings page after granting access.
Provider routing is per-team and managed server-side. Connecting WatsonX makes it available; activating it for specific teams or org-wide requires a Rootly account team change. Reach out to support to flip the routing.
The API key authenticated, but the IBM Cloud identity lacks permission for the specific watsonx operation. In IBM Cloud IAM, confirm the identity has the watsonx.ai Service access policy plus project-level Editor access. IBM’s IAM separates platform-level and service-level permissions; both are required.
Revoke the existing key in IBM Cloud’s API keys panel, create a new one with the same scope, and paste the new value into Rootly’s WatsonX settings. The previous key continues to work in Rootly until you save the new value, then it’s immediately replaced.

​
Frequently Asked Questions

All three power the same AI features (incident summaries, alert summaries, text editor, title generation). WatsonX is the right choice when your security or compliance posture requires inference inside IBM Cloud’s regional boundary, or when you’ve already committed to IBM Cloud for other workloads. OpenAI and Anthropic are simpler to set up but route data through their own hosted endpoints.
One watsonx project per Rootly organization. To use multiple regions, pick the one your primary compliance requirements demand and use that project across your watsonx workloads.
Inference requests from Rootly to watsonx travel over TLS to the regional endpoint you chose. The prompt and response are processed by IBM Cloud’s watsonx service in that region; no data routes outside IBM Cloud during inference. Rootly stores the response back into the incident or alert record.
Yes, provided the model is published in your watsonx project and accessible to the IBM Cloud identity behind the API key. Contact your Rootly account team to set the custom model as the active model for specific AI tasks.
Inference cost is billed by IBM Cloud based on tokens consumed per foundation model. Rootly doesn’t add a markup. Review IBM Cloud’s watsonx.ai pricing for current per-model rates.

​
Next Steps

Anthropic

Alternate AI provider — Claude models hosted by Anthropic, no IBM Cloud account required.

OpenAI

Alternate AI provider — GPT models hosted by OpenAI, simpler setup but no regional control.

Azure OpenAI

Enterprise-hosted GPT models inside your Azure tenancy if you’re already on Microsoft Cloud.

User Permissions

Control which users and roles can configure and trigger AI features.