Ably Datadog integration

Author: franrob-projects

src/pages/docs/platform/integrations/streaming/datadog.mdx

@@ -28,6 +28,20 @@ The following steps setup the Datadog integration:
 6. Datadog authorization page, authorize Ably using **OAuth** to grant access. The required authorization scope is: `api_keys_write`.
 7. After completing authorization, you will be redirected to the **Ably dashboard**, and the process is complete.
 
+## Troubleshooting integration states <a id="troubleshooting"/>
+
+Having trouble connecting? Here's what usually goes wrong.
+
+Stuck on "Connecting"? Your connection probably got interrupted. Contact support if it won't budge.
+
+Getting "Connection failed"? Same deal - reach out to support.
+
+"API key with this name already exists"? You've already got that key in Datadog. Delete the old one first.
+
+"Forbidden" or permission errors? You need Datadog Admin permissions to set this up.
+
+Once it's working, hit "See Dashboard" in Ably to jump over to Datadog. Your data shows up every minute.
+
 ## Remove access <a id="remove"/>
 
 Removing access disconnects Ably from Datadog, stopping data transmission and revoking authorization. Follow the steps remove the Ably and Datadog integration using either platform.