diff --git a/docs/source/procedures/datadog/cloud-integration.rst b/docs/source/procedures/datadog/cloud-integration.rst index 553a11dcb..7903c3116 100644 --- 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 `_. 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 `_ 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 `_ 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 ` 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 ` 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"