Pushing VGS Metrics to Datadog

To connect VGS Metrics to your Datadog account and begin collecting metrics, follow these steps:

Prerequisites

• Datadog API Key: Obtain this from your Datadog account.

• Datadog Site Parameter: Identify the appropriate site for your account.

Step 1. Configure the Datadog Agent

Create a configuration file named dd-agent-conf.yml. This file specifies:

• The Prometheus endpoints to be scraped

• Basic authentication credentials

• Specific metrics to collect

Here's an example configuration:

init_config:
instances:
  - prometheus_url: https://metrics.apps.verygood.systems/vaults/tntasd123/api/metrics # note, your Vault ID must be added to the path
    username: prometheus
    password: hunter2
    namespace: vgs
    send_distribution_buckets: true
    max_returned_metrics: 10000
    send_histograms_buckets: true
    label_to_hostname: vgs_tier
    metrics: # List of metrics to collect (required)
    - vault_record_usage: record_usage
    - vault_record_usage_failure: record_usage_failure
    - http_proxy_request
    - http_proxy_response
    - http_proxy_processing_duration_ms
    - http_upstream_response
    - http_upstream_processing_duration_ms
    - sftp_proxy_request
    - sftp_proxy_processing_duration_ms
    - iso_8583_proxy_request
    - iso_8583_proxy_processing_duration_ms

Step 2. Start the Datadog Agent in Docker

Run the following command to start the Datadog Agent in a Docker container. Replace path/to/your/dd-agent-conf.yml with the actual path to your configuration file.

docker run -d --name dd-agent \
    -v /var/run/docker.sock:/var/run/docker.sock:ro \
    -v /proc/:/host/proc/:ro \
    -v /sys/fs/cgroup/:/host/sys/fs/cgroup:ro \
    -e DD_API_KEY="my-dd-api-key" \
    -e DD_SITE="datadoghq.com" \
    -v path/to/your/dd-agent-conf.yml:/etc/datadog-agent/conf.d/openmetrics.d/conf.yaml \
    gcr.io/datadoghq/agent:latest

Step 3. Verify the Agent

Once the Docker container has successfully started, the agent will begin periodic checks and push metrics to your Datadog account. Verify the metrics in your Datadog dashboard.

Further Reading

For more information on integrating Prometheus metrics with Datadog, check out these resources:

• Getting Started with Datadog

• Prometheus and OpenMetrics metrics collection from a host