Docs: Alerting - On call integration (#74719)

* Alerting docs: adds oncall integration docs and release note

* adds oncall integ to structure

* corrects link

* updates links

* Update docs/sources/alerting/monitor/_index.md

Co-authored-by: Jack Baldry <jack.baldry@grafana.com>

* updates metamonitoring link

* update to product name

* Update docs/sources/alerting/alerting-rules/manage-contact-points/configure-oncall.md

Co-authored-by: Jack Baldry <jack.baldry@grafana.com>

* Update docs/sources/alerting/alerting-rules/manage-contact-points/configure-oncall.md

Co-authored-by: Jack Baldry <jack.baldry@grafana.com>

* Modify reference links to ensure that `doc-validator` ignores them

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>

* breaks up sentence

---------

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
Co-authored-by: Jack Baldry <jack.baldry@grafana.com>

docs/sources/alerting/alerting-rules/manage-contact-points/configure-oncall.md

@@ -0,0 +1,71 @@
+---
+canonical: https://grafana.com/docs/grafana/latest/alerting/alerting-rules/manage-contact-points/configure-oncall/
+description: Configure the Alerting - Grafana OnCall integration
+keywords:
+  - grafana
+  - alerting
+  - oncall
+  - integration
+labels:
+  products:
+    - cloud
+    - enterprise
+    - oss
+title: Configure Grafana OnCall integration
+weight: 300
+---
+
+## Grafana OnCall integration for Alerting
+
+Use the Grafana Alerting - Grafana OnCall integration to effortlessly connect alerts generated by Grafana Alerting with Grafana OnCall, where you can then route them according to defined escalation chains and schedules.
+
+You can set up the integration using the Grafana Alerting application or the Grafana OnCall application. For more information on setting it up from the Grafana OnCall application, see [Grafana OnCall documentation][oncall-integration].
+
+### Before you begin
+
+- Ensure you have Installed and enabled the Grafana OnCall plugin
+- Ensure your version of Grafana is up-to-date and supports the new features
+
+### Procedure
+
+To set up the Grafana OnCall integration using the Grafana Alerting application, complete the following steps.
+
+1. Navigate to **Alerts&IRM** -> **Alerting** -> **Contact points**.
+1. Click **+ Add contact point**.
+1. Enter a contact point name.
+1. From the Integration list, select Grafana OnCall.
+
+{{% admonition type="note" %}}
+The Grafana OnCall integration is only available for Grafana Alertmanager.
+{{% /admonition %}}
+
+5. Choose whether to add a new OnCall integration or add an existing one.
+
+   - If you add a new one, enter an Integration name.
+   - If you add an existing one, choose from the list of available integrations
+
+6. Click **Save contact point**.
+
+7. On the Contact points list view page, you can see the contact point with the Grafana OnCall icon.
+
+   If the integration is not yet being used anywhere in the notification policies tree, it will have **Unused** as its status in the **Health** column. It won’t receive any notifications, because there are no notifications using that integration.
+
+8. Connect your contact point to a notification policy.
+
+   For more information on connecting your contact point to a notification policy, see
+   [Create notification policy][create-notification-policy]
+
+9. To view your integration in the Grafana OnCall application and set up routes and escalation chains, click the Link next to the integration on the Contact points list view page in the **Type** column.
+
+   This redirects you to the Grafana OnCall integration page in the Grafana OnCall application. From there, you can add [routes and escalation chains][escalation-chain].
+
+{{% docs/reference %}}
+[create-notification-policy]: "/docs/grafana/ -> /docs/grafana/<GRAFANA VERSION>alerting/alerting-rules/create-notification-policy"
+[create-notification-policy]: "/docs/grafana-cloud/ -> /docs/grafana-cloud/alerting-and-irm/alerting/alerting-rules/create-notification-policy"
+
+[oncall-integration]: "/docs/grafana/ -> /docs/oncall/latest/integrations/grafana-alerting"
+[oncall-integration]: "/docs/grafana-cloud/ -> /docs/oncall/latest/integrations/grafana-alerting"
+
+[escalation-chain] "/docs/grafana/ -> /docs/oncall/latest/escalation-chains-and-routes"
+[escalation-chain] "/docs/grafana-cloud/ -> /docs/oncall/latest/escalation-chains-and-routes"
+{{% /docs/reference %}}

docs/sources/alerting/monitor/_index.md

@@ -23,5 +23,5 @@ Monitor your alerting metrics to ensure you identify potential issues before the
 
 {{% docs/reference %}}
 [meta-monitoring]: "/docs/grafana/ -> /docs/grafana/<GRAFANA VERSION>/alerting/monitor/meta-monitoring"
-[meta-monitoring]: "/docs/grafana-cloud/ -> /docs/grafana-cloud/alerting-and-irm/alerting/meta-monitoring"
+[meta-monitoring]: "/docs/grafana-cloud/ -> /docs/grafana-cloud/alerting-and-irm/alerting/monitor/meta-monitoring"
 {{% /docs/reference %}}

docs/sources/whatsnew/whats-new-next/index.md

@@ -29,3 +29,14 @@ The Tempo data source now supports query-type template variables. With this upda
 To learn more, refer to the following video demo, as well as the [Grafana Variables documentation](/docs/grafana/latest/dashboards/variables/).
 
 {{< video-embed src="/media/docs/tempo/screen-recording-grafana-10.2-tempo-query-type-template-variables.mp4" >}}
+
+## Grafana OnCall integration for Alerting
+
+<!-- Brenda Muir -->
+<!-- OSS, Enterprise -->
+
+_Generally available in Grafana Cloud_
+
+Use the Grafana Alerting - Grafana OnCall integration to effortlessly connect alerts generated by Grafana Alerting with Grafana OnCall. From there, you can route them according to defined escalation chains and schedules.
+
+To learn more, refer to the [Grafana OnCall integration for Alerting documentation](/docs/grafana/next/alerting/alerting-rules/manage-contact-points/configure-oncall/).