Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

datadog cloud-integration #2221

Merged
merged 1 commit into from
Mar 12, 2024
Merged

datadog cloud-integration #2221

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 7 additions & 9 deletions docs/source/procedures/datadog/cloud-integration.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand All @@ -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"
Expand Down
Loading