fixup! EDU-576: Datadog integration

Author: franrob-projects

content/datadog.textile

@@ -4,49 +4,41 @@ meta_description: "Connect Ably and Datadog to monitor messages, channels, and c
 meta_keywords: "Datadog, integrations, metrics, monitoring, analytics, enterprise"
 ---
 
-The Ably Datadog integration allows enterprise users to monitor real-time application metrics like messages, channels, and connections within Datadog. Data streams every 60 seconds make tracking key performance indicators easier in one place.
+The Ably "Datadog":https://docs.datadoghq.com/integrations/ably/ integration allows "enterprise":/pricing/enterprise users to monitor realtime application metrics like "messages":/messages, "channels":/channels, and connections within Datadog. Data streams every 60 seconds make tracking key performance indicators easier in one place. If you require access, contact "support":https://ably.com/support to enable the integration feature via your "dashboard":https://ably.com/accounts/any.
 
-This integration is available only to Ably enterprise customers. If you need access, contact your Ably representative. Once set up, Ably sends realtime statistics, including messages, channel counts, and connection usage, to Datadog every 60 seconds, helping you keep track of your application's performance.
+If you're on the Ably "Pro plan":/pricing/pro, you can enable a limited Datadog-lite integration. "Standard plan":/pricing/standard users may request a 30-day trial to evaluate Datadog-lite before upgrading. This version includes a smaller set of metrics but still provides visibility into your Ably usage. If you need detailed analytics, per-channel breakdowns, custom dashboards, or advanced logging, upgrade to the full Datadog integration available on the Enterprise plan.
 
-Ably includes App ID and Account ID tags with each metric to help with data organization. These ID tags enable you to filter, group, and analyze information efficiently, making it more manageable to spot trends and diagnose issues in your Datadog dashboard.
+|_. Feature |_. Datadog-lite |_. Full Datadog (Enterprise) |
+| Messages | ✅ | ✅ |
+| Connections | ✅ | ✅ |
+| Channels | ✅ | ✅ |
+| Bandwidth | ✅ | ✅ |
+| Message size | ✅ | ✅ |
+| Message direction breakdown (Inbound vs. Outbound) | ❌ | ✅ |
+| Per-Channel metrics | ❌ | ✅ |
+| Usage analytics & trends | ❌ | ✅ |
+| Custom dashboards & alerts | ❌ | ✅ |
+| Advanced logging & debugging | ❌ | ✅ |
 
-To connect Ably and Datadog, you must authorize the integration through Datadog's OAuth flow. This process requires the api_keys_write scope, allowing Ably to push data to your Datadog account. Once the integration is active, Datadog provides a default Ably dashboard so that you can monitor key metrics without extra setup.
 
-Ably follows a structured workflow to ensure secure authorization and reliable data transmission. After authorization, it stores the Datadog access_token and refresh_token (encrypted). It also saves the Datadog site URL (such as https://api.datadoghq.eu) to manage token refreshes.
+Ably includes @AppID@ and @AccountID@ tags with each metric to help with data organization. These ID tags enable you to filter, group, and analyze information efficiently, making it more manageable to spot trends and diagnose issues in your Datadog "dashboard":https://docs.datadoghq.com/dashboards/.
 
-Every 60 seconds, Ably pushes metrics to the Datadog API using the generated API key. Metrics come from channels like [meta]stats.minute and include App ID and Account ID tags. Datadog then displays these metrics in the Ably dashboard, giving you a clear view of messages, channels, and connections.
+To connect Ably and Datadog, you must authorize the integration through Datadog's "OAuth":https://docs.datadoghq.com/developers/integrations/oauth_for_integrations/ flow. This process requires the @api_keys_write@ scope, allowing Ably to push data to your Datadog account. Once the integration is active, Datadog provides a default Ably "dashboard":https://docs.datadoghq.com/integrations/ably/ so that you can monitor key metrics without extra setup.
 
-You can also manage the integration through Ably's Control API or Terraform. If OAuth isn't an option, you may need to use a manually generated Datadog API token.
-
-To use this integration, you must have an Ably Enterprise Account. Your Datadog Account also needs permission to install integrations and generate API keys. These requirements ensure the integration runs smoothly and provide full visibility into your Ably application metrics.
+Every 60 seconds, Ably streams "statistics":https://ably.com/docs/metadata-stats/stats to the Datadog API using the generated API key. Metrics come from channels like @[meta]stats.minute@ and include App ID and Account ID tags. Datadog then displays these metrics in the Ably dashboard, giving you a clear view of messages, channels, and connections.
 
 h2. Set up the Ably Datadog integration
 
-Initiate the integration from the Datadog Integrations menu or the Ably dashboard:
-
-h3. Set up in Datadog
-
-* Go to *Integrations* > *All Integrations*.
-* Find the *Ably* tile and select *Install Integration*.
-* Click *Connect Accounts* to proceed. Datadog redirects you to Ably.
-
-h4. Authorize Ably in Datadog
-
-* When prompted, grant Ably OAuth access with the @api_keys_write@ scope.
-* After authorization, Datadog redirects you back to Ably.
-
-h3. Setup in Ably
-
-* Log in to your Ably account.
-* Select your application from *Your apps*.
-* Go to the *Integrations* menu and select *Connect to Datadog* (if not already connected during redirection).
-* Confirm the integration. A success banner will appear with an option to *See the Dashboard* in Datadog.
-
-h4. Verify in Datadog
+Initiate the integration from the Datadog:
 
-* Click *See Dashboard* to access Datadog.
-* After about a minute, data from Ably should start flowing into Datadog and populate your default Ably dashboard.
-* _Note_: Ably pushes statistics to Datadog every 60 seconds, so data may take a moment to appear.
+# In Datadog, go to *Integrations*, find the *Ably* tile, and click *Install Integration*.
+# Click *Connect Accounts* to start the authorization process. Datadog redirects you to Ably.
+# Log in to your *Ably* account.
+# Select your application from the *Your Apps* page.
+# In the Ably dashboard, navigate to *Integrations* and select *Connect to Datadog*.
+# When prompted in Datadog, authorize Ably using *OAuth* to grant access. Required authorization scope:
+   * @api_keys_write@
+# After completing authorization, return to the Ably dashboard. A confirmation banner appears, along with a *See Dashboard* button that takes you to your Datadog dashboard list.
 
 h3. Troubleshoot
 
@@ -58,15 +50,15 @@ If your connection remains in this state, your setup may have been interrupted.
 
 For example, this can occur when a message is published while the connection is in a suspended state.
 
-*Resolution*: Reauthorize the integration or contact Ably Support for assistance.
+*Resolution*: Reauthorize the integration.
 
 h4. Connection failed
 
 If the connection fails, it may be due to incorrect network settings or insufficient OAuth permissions in Datadog.
 
 For example, this can happen if the OAuth scope api_keys_write was not granted during authorization or if network restrictions block communication between Ably and Datadog.
 
-*Resolution*: Verify your network settings and ensure the required OAuth permissions are granted in Datadog. If issues persist, contact Ably Support for assistance.
+*Resolution*: Verify your network settings and ensure the required OAuth permissions are granted in Datadog.
 
 h4. Duplicate API key