Ciroos for Slack

Add the Ciroos AI SRE Teammate to your Slack workspace to investigate incidents faster, triage alerts, and query your Kubernetes environment — without leaving Slack

1. Overview

Ciroos is an AI SRE teammate that helps your team investigate incidents faster and increase reliability. Once connected to Slack, Ciroos works as a bot inside your workspace, so your team can triage alerts, run investigations, and ask questions about your environment right where conversations already happen.

What you can do once Ciroos is in Slack:

• Receive investigations in-channel — Ciroos posts incident alerts (with severity and context) and lets you trigger or view an investigation with a click.
• Chat with the AI assistant — ask questions in plain language to diagnose issues, list resources, and review alerts.
• Run quick commands — link channels to projects or clusters, list clusters, check status, and more.

This guide walks through connecting Ciroos to Slack and using it day to day.

2. Before you begin

Make sure you have the following before you start:

• A Ciroos account with access to your organization’s Integrations settings.
• A Slack workspace where you can install apps. If your workspace requires admin approval to add apps, you may need a Slack workspace admin to approve the installation.
• Permission to add the bot to channels you want Ciroos to monitor or respond in.

3. Connect Ciroos to Slack

Connecting takes three short steps and starts from the Ciroos web app.

Step 1 — Open Integrations in Ciroos

In the Ciroos web app, go to Settings → Integrations, find Slack in the list, and click Connect. A Connect Slack panel opens on the right, outlining the two actions ahead: select your target workspace and authorize access. Click Connect Slack to continue.

Settings → Integrations → Slack → Connect opens the Connect Slack panel.

Step 2 — Authorize Ciroos in Slack

You’re taken to Slack’s authorization screen. Choose the workspace you want to install Ciroos into from the dropdown, review the permissions Ciroos is requesting, and click Allow.

Select the target workspace, review permissions, and click Allow.

Step 3 — Confirm the connection

Once authorized, you’ll see a Slack Connected! confirmation telling you Ciroos has been installed to your workspace. You can close the window and start using Ciroos in Slack.

The confirmation screen after Ciroos is installed to your workspace.

4. Find Ciroos in Slack

Open Slack. Ciroos now appears under Apps in the left sidebar. Selecting it opens the app, which has four tabs:

• Home — an overview and quick links.
• Chat — a direct, DM-style conversation with the AI assistant.
• History — your past interactions with Ciroos.
• About — details about the app.

Ciroos appears under Apps in the sidebar, with Home, Chat, History, and About tabs.

5. Add Ciroos to a channel

To use Ciroos in a channel — and to receive investigations there — invite the bot to it. Open the channel and type @Ciroos (or use /invite @Ciroos); Slack will confirm with a message like “OK! I’ve invited @Ciroos to this channel.” Ciroos is now active in that channel and ready for commands.

Inviting Ciroos to a channel; Slackbot confirms the bot has been added.

Reminder: every command is run by mentioning the bot — for example, @Ciroos help.

6. Set up your channels

Linking a channel tells Ciroos where to route alerts and what context to use. Run these from inside the channel you want to configure:

• @Ciroos set-default-channel — set this channel as your organization’s default.
• @Ciroos set-project-channel <name> — link this channel to a specific project.
• @Ciroos set-cluster-channel <name> — link this channel to a specific cluster.

Ciroos confirms each change in a thread reply.

Setting the current channel as the organization default.

7. Discover your environment

Use the discovery commands to see what Ciroos can access. For example, @Ciroos list the clusters returns your Kubernetes clusters along with their health, while @Ciroos list-projects lists the projects available to you.

Listing the clusters in the environment with their health status.

8. Command reference

Send @Ciroos help at any time to see the full command list in Slack. All commands are invoked by mentioning the bot.

The @Ciroos help output, listing all available commands.

9. Investigate incidents & chat with the AI assistant

Investigations in your channel

When an alert fires, Ciroos posts an investigation in the linked channel with its severity, status, and key details (type, entity, cluster, cloud, alert source, and timestamp). Some investigations start automatically; others are queued and require manual approval. Use Trigger Investigation to start it or View Investigation to open the full analysis.

An investigation posted in-channel, with Trigger and View Investigation actions.

Ask the AI assistant

Mention Ciroos with a question in plain language — in a channel, a thread, or the Chat tab. Ciroos pulls from your live environment to answer. For instance, asking it to investigate why a cluster is unhealthy returns a structured diagnosis of the likely root causes.

Asking the AI assistant to diagnose an unhealthy cluster.

Query alerts and resources

You can also ask for operational snapshots, such as recent alerts or the resources running in a namespace.

Reviewing recent open and resolved alerts via the AI assistant.

Listing the deployments in a namespace on a specific cluster.

10. Tips & troubleshooting

• Always mention the bot. Commands and questions only work when you start with @Ciroos.
• Invite Ciroos to each channel where you want investigations or responses — it only acts in channels it has been added to.
• Check the connection with @Ciroos status if responses stop working.
• Link your account with @Ciroos login if Ciroos asks you to connect your identity.
• Set a default channel early so alerts have somewhere to go before you link projects and clusters.

Need more help? Visit ciroos.ai.