Slack
Summary
Slack is a way to communicate with your team. By integrating with Cortex's Slack app, you can use Slash Commands to drive insights into values such as:
- Ownership
- Notifications
- Who's on call
Also with the integration, Cortex will message service owners regarding any Scorecard improvements or if are any action items for upcoming Initiatives.
Setup
In order to connect Cortex to your Slack instance, you’ll need to install Cortex's Slack app in Settings → Slack.
If you do not see the Settings page you're looking for in the sidebar, you likely don't have the proper permissions and need to contact your admin.
If using Cortex Server, you'll need to follow a manual configuration process to use Cortex's Slack app. Reach out to the support team to receive instructions.
Catalog Descriptor
Ownership
You can define the following block in your Cortex Catalog Descriptor to add your Slack channels.
x-cortex-owners:
# List Slack channels, *without* the preceeding "#"
- type: slack
channel: team-engineering
notificationsEnabled: true #optional
description: This is a description for this Slack channel # optional
Slash Commands
We have a list of commands you can use to quickly query catalog metadata and Scorecard scores. The <tag>
refers to the entity tag.
You need to be a Slack administrator in order to install Cortex's Slack app.
/cortex service <tag>
- Lists entity information such as owners, current on-call, links, and timeline events
/cortex runbooks <tag>
- List all runbook links
/cortex docs <tag>
- List all documentation links
/cortex logs <tag>
- List all logs links
/cortex links <tag>
- List all links
/cortex links [type] <tag>
- List all links of optional type param such as "metrics" or "openapi"
/cortex oncall <tag>
- Find current on-call
/cortex owners <tag>
- List all owners, along with their emails
/cortex dependencies <tag>
- List all incoming and outgoing first-level dependencies
/cortex scores <tag>
- List all Scorecard scores
/cortex sentry <tag>
- List recent Sentry issues
/cortex timeline <tag>
- List recent timeline events
/cortex search <query>
- Query for services using Lucene queries
Privacy Policy
We will retain basic Slack metadata like user IDs for the period necessary to fulfill the purposes outlined in our Privacy Policy unless a longer retention period is required or permitted by law, or where the Customer Agreement requires or permits specific retention or deletion periods.