Create Slack Commands guide for Datadog integration#38248
Conversation
Added a comprehensive guide for using Slack commands with Datadog, including sections for incidents, on-call, monitors, dashboards, workflows, and account management.
Preview links (active after the
|
|
Created DOCS-15131 for Docs team review |
estherk15
left a comment
estherk15
left a comment
There was a problem hiding this comment.
Thanks for adding this information! Is this supposed to be the source of truth for these commands? If so, we should be linking from other docs here, and not the other way around. We should deduplicate where possible, and prevent information getting out of sync.
Also, can you confirm the correct link for dashboards documentation you want to link out to?
|
|
||
| To run any Slack actions, type `/dd` in any workspace with the Datadog App installed to pull up an action tray listing all actions you can take. Alternatively, directly type out the action. | ||
|
|
||
| ## Incidents |
There was a problem hiding this comment.
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:
- /dd in investigate ("Trigger Bits Investigation")
- /dd shortcuts ("View Incident Actions") — the Incident Management doc documents the bare /datadog command as opening the action tray instead. Is /dd shortcuts an alias for that, or a separate command?
Commands missing from this guide that exist elsewhere:
- /datadog incident test (declare a test incident)
- /datadog task / /datadog task list (create/list incident tasks)
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.
Yes! We want this guide to be the source of truth for all possible actions existing on the /dd command modal.
- /dd shortcuts is a new command that we added to invoke the incident action tray. The bare /datadog command will now invoke the command modal, so we need a new way to be able to pull up the action tray.
Will update this doc so the other pages align.
- Rewrite overview sentence for clarity - Replace "keyboard shortcuts" with "commands" in all section intros - Replace "refer to" with "see" and update link text to match linked page titles - Remove "new" from /dd in private description - Update dashboard reference link from /product_analytics/dashboards/ to /dashboards/
- Add /dd in test (declare a test incident) - Add /dd task and /dd task list (create/list incident tasks) - Note /dd in summary is not available in Gov and Gov2 regions
estherk15
left a comment
estherk15
left a comment
There was a problem hiding this comment.
Looks good, thanks for the update!
4 participants
Added a comprehensive guide for using Slack commands with Datadog, including sections for incidents, on-call, monitors, dashboards, workflows, and account management.
What does this PR do? What is the motivation?
Provide a quick reference guide for customers to view all Slack commands available through Datadog Slack App.
Merge readiness
For Datadog employees:
<name>/<description>convention and include the forward slash (/). If you've already created your PR with an incorrect branch name, please rename your branch and open a fresh PR./reviewto run an automated check that catches common issues before a Documentation team member reviews your PR.AI assistance
Additional notes