EDU-576: Datadog integration

Author: franrob-projects

content/integrations/index.textile

@@ -26,6 +26,7 @@ The following pre-built Webhooks can be configured:
 * "Zapier":/docs/integrations/webhooks/zapier
 * "Cloudflare Workers":/docs/integrations/webhooks/cloudflare
 * "IFTTT":/docs/integrations/webhooks/ifttt
+* "Datadog":/docs/integrations/webhooks/datadog
 
 h2(#continuous). Outbound streaming
 

content/integrations/streaming/datadog.textile

@@ -0,0 +1,57 @@
+---
+title: Datadog
+meta_description: "Connect Ably and Datadog to monitor messages, channels, and connections in realtime, integrating your Ably statistics with your existing Datadog setup."
+meta_keywords: "Datadog, integrations, statistics, metrics, monitoring, analytics, enterprise"
+---
+
+The Ably "Datadog":https://docs.datadoghq.com/integrations/ably/ integration enables you to monitor your application's statistics. Every 60 seconds, Ably streams a comprehensive set of "statistics":/docs/metadata-stats/stats#metrics to the Datadog API.
+
+h2(#setup). Setup the Datadog integration
+
+To connect Ably with Datadog, you must "request":https://ably.com/support access to the integration. Once granted, you can 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 specific Ably "dashboard":https://docs.datadoghq.com/integrations/ably/, enabling you to monitor key metrics without extra setup.
+
+The following steps setup the Datadog integration:
+
+# 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.
+# Navigate to *Integrations*, and select *Connect to Datadog*.
+# Datadog authorization page, authorize Ably using *OAuth* to grant access. The required authorization scope is: @api_keys_write@.
+# After completing authorization, you will be redirected to the *Ably dashboard*, and the process is complete.
+
+h2(#remove). Remove access
+
+Removing access disconnects Ably from Datadog, stopping data transmission and revoking authorization. Follow the steps remove the Ably and Datadog integration using either platform.
+
+h3(#in-ably). Remove access using Ably
+
+* Open your application's integration settings.
+* Click *Remove* next to the Datadog integration.
+* Ably revokes OAuth credentials and stops metric transmission.
+
+h3(#in-datadog). Remove access using Datadog
+
+* Remove associated Ably API keys via *Integrations* or *API Keys*.
+* Adjust scopes or entirely revoke OAuth tokens if necessary.
+
+h2(#lite). Datadog lite
+
+Datadog Lite is a lightweight version of the full Datadog integration that sends a reduced set of "statistics":/docs/metadata-stats/stats#metrics to the Datadog API, available for "enterprise":/docs/pricing/enterprise customers. This integration is designed for use cases where full statistics are not required, such as when you only need to monitor a limited number channels or connections.
+
+The following statistics are streamed from Ably to Datadog:
+
+|_. Metric |_. Description |
+| @messages.all.messages@ | Total number of messages (excluding presence and state messages). |
+| @messages.all.presence@ | Total number of presence messages. |
+| @messages.inbound.all.all@ | Total number of inbound messages received by Ably from clients. |
+| @messages.outbound.all.all@ | Total number of outbound messages sent from Ably to clients. |
+| @connections.all.peak@ | Peak number of simultaneous realtime connections. |
+| @channels.peak@ | Peak number of active channels. |
+| @push.channelMessages@ | Total number of channel messages that included a push payload. |
+| @messages.persisted.messages@ | Total number of persisted messages (excluding presence and state messages). |
+| @messages.persisted.presence@ | Total number of persisted presence messages. |
+
+

content/pricing/enterprise.textile

@@ -14,7 +14,7 @@ Enterprise packages can include features such as:
 - Custom CNAMEs := use your own custom domain, or a subdomain of Ably for your application or service.
 - SAML and SCIM := authenticate with Ably using your own Identity Provider (IdP) and automatically provision users within your Ably account.
 - Active traffic management := Ably can monitor the health of your own endpoints and proactively take steps to isolate, or move, traffic to ensure business continuity.
-- DataDog := send metrics from Ably into your DataDog account.
+- DataDog := send metrics from Ably into your "DataDog":/docs/integrations/streaming/datadog account.
 - PrivateLink := enable traffic from your users and servers into Ably without using the public internet via "AWS PrivateLink":https://aws.amazon.com/privatelink/.
 - Private clusters := guaranteed capacity and isolation from all other Ably users.
 

content/pricing/standard.textile

@@ -18,7 +18,7 @@ The Standard package includes the following limits on the key units of consumpti
 Standard package users also have access to the following features:
 
 * Google and GitHub SSO
-* DataDog Lite (30 day trial)
+* "DataDog Lite":/docs/integrations/streaming/datadog#lite (30 day trial)
 
 h2(#pricing). Pricing and billing
 

src/data/nav/platform.ts

@@ -148,6 +148,10 @@ export default {
               name: 'Pulsar',
               link: '/docs/integrations/streaming/pulsar',
             },
+            {
+              name: 'DataDog',
+              link: '/docs/integrations/streaming/datadog',
+            },
           ],
         },
         {