Cortex connects to many third-party vendors whose system interfaces frequently change. As a result, integration behavior or configuration steps may shift without notice. If you encounter unexpected issues, check with your system administrator or refer to the vendor’s documentation for the most current information. Additionally, integration sync times vary and are subject to scheduling overrides and timing variance.
Why use the integration for Slack
Slack is where your team already communicates. Connecting it to Cortex brings your ownership, standards, and alerts into the same place, so you spend less time switching tools. With the Slack integration, you can:- Ask questions, get answers. Query Cortex in natural language instead of clicking through the UI. Mention
@Cortexand ask things like “Which entities do I own?” or “Show me all critical services failing the Production Readiness Scorecard.” - Reach the right team faster. Slack channels appear in the Communications block on entity details pages, so you always know where to go when you’re coordinating work or responding to an incident.
- Stay on top of what matters. Get notified in Slack when Scorecard results change, when an Initiative deadline is coming up, and when your weekly entity performance summary is ready, so you don’t have to watch a dashboard.
- Enforce communication standards. Make having a Slack channel part of your definition of production-ready. Write a Scorecard rule that checks whether an entity defines a Slack channel in its YAML, so every service is held to the same bar. Teams can see which entities are missing one, and you can attach the rule to an Initiative when you need a deadline.
Configuring Slack
Prerequisites
- Users with the
Configure Integrationspermissions can configure Slack in Cortex. - You must be an admin in your Slack account.
- The Slack account must not be linked to another Cortex tenant.
Step 1: Configuring Slack in Cortex
- From the main sidebar, expand Integrations, then select Configurations.
- Locate Slack, then click Install. The Slack side panel opens.
- In the Slack side panel, click Add to Slack. The Allow access window opens.
- From the Workspace dropdown, select your workspace.
- Review the app permissions, then click Allow.
- After signing in to Slack and granting permission for Cortex to access the Slack workspace, you are redirected to the Slack settings page in Cortex.
- In the upper-right corner of the page, click Test configuration to test the connection. A successful connection means your integration is configured correctly.
Slack channels are cached and refreshed every four (4) hours, so newly added or updated channels may not appear immediately in the UI or on an entity’s details page.
Step 2: Configuring app settings
Follow the steps below to configure additional settings in the Cortex Slack app.- From the main sidebar, expand Integrations, then select Configurations.
- Locate Slack, then click Settings.
- From the Integration settings tab, do any of the following:
- In the Configurations section:
- Click the trash icon to delete the current configuration.
- In the Slack app settings section:
- Click Notification settings to configure notifications to be sent via Slack for your organization. See Managing Slack notifications for more information.
- Click Identity mappings to map email addresses from your Slack workspace to email addresses of team members in Cortex, making sure the integration works as expected for users. See Configuring identity mappings for more information.
- In the Configurations section: