-
Notifications
You must be signed in to change notification settings - Fork 1.3k
Create Slack Commands guide for Datadog integration #38248
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
+82
−0
Merged
Changes from all commits
Commits
Show all changes
5 commits
Select commit
Hold shift + click to select a range
3ee13c6
Create Slack Commands guide for Datadog integration
NancyZ278 f1249c8
Rename Slack Commands to Slack Actions
NancyZ278 72f58dc
Add guide to index and update frontmatter
estherk15 aeb1532
Apply reviewer suggestions to slack-actions guide
eyangx 1ef9a79
Add missing incident commands and region caveat
eyangx File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,81 @@ | ||
| --- | ||
| title: Slack Actions | ||
| description: "Use Slack actions to manage incidents, on-call, monitors, dashboards, workflows, and accounts directly from a Slack workspace with the Datadog app installed." | ||
| further_reading: | ||
| - link: "/integrations/slack/?tab=datadogforslack" | ||
| tag: "Documentation" | ||
| text: "Slack Integration" | ||
| --- | ||
| ## Overview | ||
|
|
||
| Slack actions are available in any Slack workspace with the Datadog App installed. Type `/dd` in the workspace to open an action tray listing all available actions. Alternatively, type the full command directly. | ||
|
|
||
| ## Incidents | ||
| Use the following commands for incidents navigation. All commands can use `/dd in` as an alias for `/dd incident`. For more details, see [Integrate Slack with Datadog Incident Management][2]. | ||
|
|
||
| | Command | Description| | ||
| | ------------------ | ---------- | | ||
| | `/dd in` or `/dd incident` | Declare an incident.| | ||
| | `/dd in test` | Declare a test incident.| | ||
| | `/dd in update` or `/dd in edit`| Update the incident's title, state, severity, and attributes.| | ||
| | `/dd in responders`| Manage the incident's response team.| | ||
| | `/dd in investigate` | Trigger Bits Investigation. | | ||
| | `/dd in summary` | Generate the incident's summary with AI. Not available in Gov and Gov2 regions.| | ||
| | `/dd in notify` | Notify @-handles about the incident. | | ||
| | `/dd in list` | List open incidents.| | ||
| | `/dd in private`| Archive the current channel, create a private channel, and add all existing responders.| | ||
| | `/dd in public` | Make the incident and its timeline visible to anyone with incident-read permissions. | | ||
| | `/dd followup` | Create a new follow-up.| | ||
| | `/dd followup list` | List Incident Follow-ups.| | ||
| | `/dd task` | Create an incident task.| | ||
| | `/dd task list` | List incident tasks.| | ||
| | `/dd shortcuts` | View Incident Actions.| | ||
|
|
||
| ## On-Call | ||
| Use the following commands for On-Call. For more details, see [On-Call Pages][3]. | ||
|
|
||
| | Command | Description| | ||
| | ------------------ | ---------- | | ||
| | `/dd page` | Page an on-call team.| | ||
| | `/dd shifts`| See your upcoming on-call shifts.| | ||
| | `/dd override`| Request someone to cover an on-call shift. | | ||
|
|
||
| ## Monitors | ||
| Use the following commands for Monitors. For more information on adding Slack to monitors, see [Monitor Notifications][4]. | ||
|
|
||
| | Command | Description| | ||
| | ------------------ | ---------- | | ||
| | `/dd monitors` | List monitors that are currently alerting.| | ||
|
|
||
|
|
||
| ## Dashboard | ||
| Use the following commands for [Dashboards][5]. | ||
|
|
||
| | Command | Description| | ||
| | ------------------ | ---------- | | ||
| | `/dd dashboard` | Share a dashboard widget to this channel.| | ||
|
|
||
|
|
||
| ## Workflows | ||
| Use the following commands for Workflows. For more information on using Slack in Workflows, see [Trigger a workflow][6]. | ||
|
|
||
| | Command | Description| | ||
| | ------------------ | ---------- | | ||
| | `/dd workflow` | Run an automation workflow.| | ||
|
|
||
|
|
||
| ## Accounts | ||
| Use the following commands for [account management][7]. | ||
|
|
||
| | Command | Description| | ||
| | ------------------ | ---------- | | ||
| | `/dd accounts` | Manage your linked Datadog accounts. | | ||
|
|
||
|
|
||
| [1]: /integrations/slack/?tab=datadogforslack | ||
| [2]: /incident_response/incident_management/setup_and_configuration/integrations/slack/#slack-commands | ||
| [3]: /incident_response/on-call/pages/#through-slack | ||
| [4]: /monitors/notify/#notification-recipients | ||
| [5]: /dashboards/ | ||
| [6]: /actions/workflows/trigger/#slack-triggers | ||
| [7]: /account_management/ | ||
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Is this guide supposed to be a singular reference for all commands? If so, should we be referencing out to other docs?
Is there a possibility for drift since we're documenting this in multiple places? For example
Commands listed here that I couldn't find documented elsewhere:
Commands missing from this guide that exist elsewhere:
Possible description mismatch for /dd in private:
This guide says: "Archive the current channel, create a new private channel, and add all existing responders."
The Incident Management doc says: "Make the incident private (if private incidents are enabled)."
Region availability:
The Incident Management doc notes /datadog incident summary isn't available in gov/gov2 regions. Should the same caveat apply to /dd in summary here?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Yes! We want this guide to be the source of truth for all possible actions existing on the /dd command modal.
Will update this doc so the other pages align.