Skip to main content

Slack Integration

Bring AI-powered observability insights directly into your Slack workspace. Ask questions about your alerts, metrics, logs, and traces without leaving Slack.

Overview

The Oodle AI Slack integration allows your team to:

  • Query metrics, logs, and traces using natural language
  • Get AI-powered insights and analysis
  • Mention @Oodle in channels
  • Use slash commands for quick queries

Features

Natural Language Queries

Ask questions in plain English and get immediate insights:

  • Metrics: "What is the error rate for my API?"
  • Logs: "Show me logs from the last hour with errors"
  • Traces: "What's causing high latency in the checkout service?"
  • Analysis: "Why did CPU spike at 3pm today?"

Agents

Agent Mentions

Mention @Oodle in any channel where the bot is added:

@Oodle What is the p99 latency for the auth service?

Direct Messages

Send queries directly to the Oodle AI bot:

Show me all ERROR logs from the payments service

Slash Commands

Use the /oodle slash command for quick queries:

/oodle analyze database performance

Installation

Prerequisites

  • Admin access to your Slack workspace
  • An active Oodle instance

Step 1: Navigate to Integrations

  1. Log in to your Oodle instance
  2. Go to Settings > Integrations
  3. Find the Slack integration card

Step 2: Add Workspace

  1. Click Add Your First Workspace (or Add Workspace if you already have workspaces connected)
  2. You'll be redirected to Slack's OAuth page
  3. Review the permissions requested
  4. Click Allow to authorize the integration

Step 3: Verify Installation

  1. Return to the Oodle Integrations page
  2. Your workspace should appear in the Connected Workspaces section
  3. Open Slack and you should see Oodle AI in your Apps list

Step 4: Add to Channels

  1. In Slack, go to any channel where you want to use Oodle AI
  2. Type /invite @Oodle
  3. The bot will join the channel and be ready to answer questions

Usage Examples

@Oodle What is the request rate for my API over the last hour?
@Oodle Show me ERROR logs from the payment service in the last 30 minutes
@Oodle What's causing high latency in the user-service?
/oodle summarize logs for last 15 minutes

Best Practices

Channel Strategy

Public Channels

Add Oodle AI to incident response or monitoring channels:

  • #incidents
  • #alerts
  • #on-call

Team Collaboration

  • Share queries and insights with your team in channels
  • Use threads to keep discussions organized
  • Pin important findings for future reference

Query Tips

  • Be specific with time ranges: "last hour", "past 24 hours", "today"
  • Mention service names: "payment service", "auth API"
  • Include severity levels: "ERROR logs", "critical alerts"
  • Use natural language - no need for complex syntax

Managing Workspaces

View Connected Workspaces

  1. Navigate to Settings > Integrations > Slack
  2. See all connected workspaces with connection dates

Add Multiple Workspaces

You can connect multiple Slack workspaces to the same Oodle instance:

  1. Click Add Workspace in the Slack integration card
  2. Authenticate with the new workspace
  3. Both workspaces will appear in your connected list

Remove a Workspace

To disconnect a Slack workspace:

  1. Go to Settings > Integrations > Slack
  2. Find the workspace you want to remove
  3. Click Remove
  4. Confirm the removal
warning

Removing a workspace will disconnect the bot immediately. You'll need to reinstall to use Oodle AI again in that workspace.

Troubleshooting

Bot Not Responding

Check if bot is in the channel:

/invite @Oodle

Verify the workspace is still connected:

  1. Go to Settings > Integrations > Slack
  2. Check if your workspace appears in the connected list
  3. If not, reinstall the integration

Try a direct message:

Send a simple query directly to the bot to test connectivity.

"Permission Denied" Errors

This means you don't have access to the requested data in Oodle:

  • Check your user permissions in Oodle
  • Ask your Oodle admin to grant appropriate access
  • Try querying data you know you have access to

Slow Responses

  • Complex queries may take longer to process
  • Large time ranges increase processing time
  • Try narrowing your query scope

Can't Install in Workspace

Ensure you have:

  • Admin permissions in your Slack workspace
  • Access to the Oodle instance
  • A stable internet connection

If issues persist, contact your Slack workspace admin.

FAQ

Q: Can I use Oodle AI in multiple Slack workspaces?

A: Yes, you can connect multiple Slack workspaces to a single Oodle instance.

Q: Can I customize the bot's responses?

A: The bot automatically formats responses for optimal readability in Slack. Custom formatting is not currently supported.

Q: What happens if I remove the integration?

A: The bot will immediately stop responding in your workspace. You can reinstall at any time to restore functionality.

Q: Does the bot work in private channels?

A: Yes, simply invite the bot to any private channel where you want to use it.