Merge pull request #2221 from amnonh/update_docs

datadog cloud-integration
scylladb · Mar 12, 2024 · a6a8ae0 · a6a8ae0
2 parents 800ba1f + d42e369
commit a6a8ae0
Showing 1 changed file with 7 additions and 9 deletions.
diff --git a/docs/source/procedures/datadog/cloud-integration.rst b/docs/source/procedures/datadog/cloud-integration.rst
@@ -2,16 +2,15 @@
 ScyllaDB Cloud Monitoring Datadog Integration
 =============================================
 
-For security reasons, the ScyllaDB cloud does not have direct access to the Prometheus server.
-To allow external server scrapping, you will need to enable the Prometheus proxy.
+To allow external server scrapping, you will need to enable the `Prometheus proxy <https://cloud.docs.scylladb.com/stable/monitoring/cloud-prom-proxy.html>`_.
 The Datadog agent reads from the proxy, which reads from the Promethues server.
 
 1. Installing and configuring the Datadog Agent.
 2. Add Datadog recording rules.
-3. Loading Scylla dashboard to Datadog.
+3. Loading ScyllaDB dashboard to Datadog.
 4. Optionally load Monitor (Alerts).
 
-Scylla Monitoring Datadog Integration Overview
+ScyllaDB Monitoring Datadog Integration Overview
 ==============================================
 A typical ScyllaDB cluster generates thousands of metrics, sometimes even tens of thousands.
 The sheer number of metrics is too much for Datadog.
@@ -21,18 +20,17 @@ Instead of letting the Datadog agent scrap all metrics, the monitoring stack mar
 Install And configure the Datadog Agent
 =======================================
 
-Start by following `Installation <https://docs.datadoghq.com/agent/>`_ guide. The datadog agent should run on a machine that can reach the Prometheus Proxy server.
+Start by installing DataDog Agent on a server with access to ScyllaDB Cloud Prometheus Proxy server, following `Installation <https://docs.datadoghq.com/agent/>`_ guide.
+The datadog agent should run on a machine that can reach the Prometheus Proxy server.
 
-Once the Datadog agent is working, download the configuration file and place it under /etc/datadog-agent/conf.d/prometheus.d/conf.yaml
-
-Download the configuration file :download:`conf.yaml <cloud-conf.yaml>` move it to: /etc/datadog-agent/conf.d/prometheus.d/conf.yaml
+Once the Datadog agent is working, download the configuration file :download:`conf.yaml <cloud-conf.yaml>` move it to: /etc/datadog-agent/conf.d/prometheus.d/conf.yaml
 
 
 Edit the file. You must replace the cluster id (CLUSTER_ID) and the token (TOKEN).
 
 Post configuration
 ^^^^^^^^^^^^^^^^^^
-Restart the agent based on your installation. Scylla metrics should be visible in Datadog.
+Restart the agent based on your installation. ScyllaDB metrics should be visible in Datadog.
 
 
 .. note::  By default, Datadog will not scrap per-shard metrics. To enable per-shard metrics, edit the conf.yaml file and replace dd=~"1" with dd=~"1|2"