diff --git a/config/_default/menus/main.en.yaml b/config/_default/menus/main.en.yaml index b63e379a26435..1cb97d0b7405d 100644 --- a/config/_default/menus/main.en.yaml +++ b/config/_default/menus/main.en.yaml @@ -2458,18 +2458,23 @@ menu: - name: Jira url: service_management/incident_management/integrations/jira parent: incidents_integrations - identifier: incidents_jira + identifier: incidents_integrations_jira weight: 901 - name: Slack url: service_management/incident_management/integrations/slack parent: incidents_integrations - identifier: incidents_slack + identifier: incidents_integrations_slack weight: 902 + - name: Status Pages + url: service_management/incident_management/integrations/status_pages + parent: incidents_integrations + identifier: incidents_integrations_status_pages + weight: 903 - name: Statuspage url: service_management/incident_management/integrations/statuspage parent: incidents_integrations - identifier: incidents_statuspage - weight: 903 + identifier: incidents_integrations_statuspage + weight: 904 - name: On-Call url: service_management/on-call/ pre: on-call diff --git a/content/en/service_management/incident_management/integrations/_index.md b/content/en/service_management/incident_management/integrations/_index.md index 68b13ea9a6f80..f04af4d18503d 100644 --- a/content/en/service_management/incident_management/integrations/_index.md +++ b/content/en/service_management/incident_management/integrations/_index.md @@ -11,7 +11,7 @@ further_reading: Datadog Incident Management integrates with third-party platforms to support collaboration and response. Integrations connect your incident workflows with ticketing systems, communication channels, and status pages so your teams can coordinate, escalate, and resolve incidents in their existing tools. -Use integrations in Datadog Incident Management to:** +Use integrations in Datadog Incident Management to: - **Automate workflows:** Trigger actions in external systems (such as creating Jira tickets or updating Statuspage) directly from Datadog incidents. - **Centralize communication:** Sync incident updates and notifications with chat tools, ticketing platforms, and on-call systems to keep stakeholders informed. @@ -26,11 +26,12 @@ Configure and manage incident-related integrations from the **Incident Settings* {{< whatsnext desc="Set up and use the following integrations within the context of Datadog Incident Management:">}} {{< nextlink href="/service_management/incident_management/integrations/jira" >}}Jira{{< /nextlink >}} {{< nextlink href="/service_management/incident_management/integrations/slack" >}}Slack{{< /nextlink >}} - {{< nextlink href="/service_management/incident_management/integrations/statuspage" >}}Statuspage{{< /nextlink >}} + {{< nextlink href="/service_management/incident_management/integrations/status_pages" >}}Status Pages{{< /nextlink >}} + {{< nextlink href="/service_management/incident_management/integrations/statuspage" >}}Atlassian Statuspage{{< /nextlink >}} {{< /whatsnext >}} ## Further reading {{< partial name="whats-next/whats-next.html" >}} -[1]: /service_management/incident_management/incident_settings/integrations \ No newline at end of file +[1]: /service_management/incident_management/incident_settings/integrations diff --git a/content/en/service_management/incident_management/integrations/status_pages.md b/content/en/service_management/incident_management/integrations/status_pages.md index 60b3f35ad31a3..93eb59b834d95 100644 --- a/content/en/service_management/incident_management/integrations/status_pages.md +++ b/content/en/service_management/incident_management/integrations/status_pages.md @@ -1,19 +1,56 @@ --- -title: Datadog Status Pages +title: Integrate Datadog Status Pages with Datadog Incident Management +description: Learn how to integrate Datadog Status Pages with Incident Management to communicate real-time service status during incidents. further_reading: -- link: "service_management/status_pages/" +- link: "/service_management/status_pages/" tag: "Documentation" - text: "Learn more about Status Pages" + text: "Learn more about Datadog Status Pages" --- ## Overview +Status Pages is a way to keep internal and external stakeholders informed during service disruptions by publishing real-time updates about system health. +This integration enables responders to publish and update status page notices directly from Incident Management. +- Eliminate context switching by managing public communications without leaving your incident workflow +- Publish notices quickly and consistently during high-severity incidents +- Keep incident timelines and public-facing updates in sync to reduce confusion and messaging mistakes +## Prerequisites +At least one status page is required to enable the Status Pages integration for Incident Management. +You must have a role with the Incident Settings Write permission to enable the Status Pages integration for Incident Management. +## Setup -## Further reading +1. In the [Integration Settings page][1], find the Status Pages integration. +1. Toggle **Enable Status Pages notice creation**. -{{< partial name="whats-next/whats-next.html" >}} \ No newline at end of file +## Publish a Status Pages notice + +You must have a role with Incidents Write and Status Pages Notice Write permissions to add a Status Pages notice from an incident. + +{{< img src="/service_management/incidents/Integrations/status_pages/status_pages_config_modal.png" alt="Configuration modal for integrating a Datadog incident with a status page notice" style="width:70%;" >}} + +1. In the [Incidents List page][2], open an existing incident. +1. At the top of the incident page, click **Update Status Page**. +1. Enter all the required fields, including _Select a Status Page_, _Notice title_, and _Notice status_. You can also specify which status page components are affected. + +## Update a Status Pages notice + +After a notice is added to an incident, you can continue updating the status page until the incident is resolved. + +{{< img src="/service_management/incidents/Integrations/status_pages/incident_status_pages.png" alt="Screenshot showing the integration of a Datadog incident with a Status Page notice, including fields for selecting a status page, notice title, and status" style="width:100%;" >}} + +1. In the [Incidents List page][2], open the incident you want to update. +1. At the top of the incident page, find the status page you added, and hover over the button to open the integration modal. You can update the current status page notice or unlink the notice. +1. Click **Update** to update the status page notice. + +## Further Reading + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: https://app.datadoghq.com/incidents/settings?section=integrations +[2]: https://app.datadoghq.com/incidents +[3]: /account_management/rbac/permissions diff --git a/content/en/service_management/incident_management/integrations/statuspage.md b/content/en/service_management/incident_management/integrations/statuspage.md index d0488a3ff9e4c..283cbbd007c17 100644 --- a/content/en/service_management/incident_management/integrations/statuspage.md +++ b/content/en/service_management/incident_management/integrations/statuspage.md @@ -1,18 +1,18 @@ --- -title: Integrate Statuspage with Datadog Incident Management +title: Integrate Atlassian Statuspage with Datadog Incident Management aliases: - /service_management/incident_management/guides/statuspage further_reading: - link: "integrations/statuspage/" tag: "Documentation" - text: "Install the Statuspage Integration" + text: "Install the Atlassian Statuspage Integration" - link: "https://app.datadoghq.com/integrations/statuspage" tag: "App" text: "In-app Statuspage integration tile" - link: "monitors/guide/integrate-monitors-with-statuspage/" tag: "Guide" text: "Integrating Monitors With Statuspage" -- link: "synthetics/guide/synthetic-test-monitors/#integrate-your-synthetic-test-monitor-with-statuspage" +- link: "synthetics/guide/synthetic-test-monitors/#integrate-your-synthetic-test-monitor-with-atlassian-statuspage" tag: "Guide" text: "Integrate your Synthetic test monitor with Statuspage" --- @@ -28,10 +28,12 @@ Atlassian's Statuspage conveys real-time status of an organization's services on Install the integration through the [Statuspage Integration tile][1]. For more information, see the [Statuspage integration][2] documentation. +You must have a role with the Incident Settings Write permission to enable the Atlassian Statuspage integration for Incident Management. + ## Setup -1. In the [Integration Settings page][3], find the Statuspage integration. -1. Toggle **Enable Statuspage incident creation**. +1. In the [Integration Settings page][3], find the Atlassian Statuspage integration. +1. Toggle **Enable Atlassian Statuspage incident creation**. ## Add a Statuspage incident @@ -60,5 +62,5 @@ After a Statuspage is added to an incident, you can continue updating the Status [1]: https://app.datadoghq.com/integrations/statuspage [2]: /integrations/statuspage/ -[3]: https://app.datadoghq.com/incidents/settings#Integrations +[3]: https://app.datadoghq.com/incidents/settings?section=integrations [4]: https://app.datadoghq.com/incidents diff --git a/content/en/service_management/status_pages/_index.md b/content/en/service_management/status_pages/_index.md index 83d7b737b98ab..5cc04583b9745 100644 --- a/content/en/service_management/status_pages/_index.md +++ b/content/en/service_management/status_pages/_index.md @@ -7,6 +7,9 @@ further_reading: - link: "service_management/on-call/" tag: "Documentation" text: "Learn more about On-Call Scheduling" +- link: "service_management/incident_management/integrations/status_pages" + tag: "Documentation" + text: "Integrate Datadog Status Pages with Incident Management" --- {{< callout url="https://www.datadoghq.com/product-preview/status-pages/">}} diff --git a/static/images/service_management/incidents/Integrations/status_pages/incident_status_pages.png b/static/images/service_management/incidents/Integrations/status_pages/incident_status_pages.png new file mode 100644 index 0000000000000..420017b2c9ebc Binary files /dev/null and b/static/images/service_management/incidents/Integrations/status_pages/incident_status_pages.png differ diff --git a/static/images/service_management/incidents/Integrations/status_pages/status_pages_config_modal.png b/static/images/service_management/incidents/Integrations/status_pages/status_pages_config_modal.png new file mode 100644 index 0000000000000..2a8941e19dfc0 Binary files /dev/null and b/static/images/service_management/incidents/Integrations/status_pages/status_pages_config_modal.png differ