Datadog Integration

Reference information about the StormForge Optimize Live Datadog integration

Optimize Live Controller

Enabling the Datadog integration

The Datadog integration is enabled when the DD_API_KEY secret value is defined in the optimize-live secret. For the integration to function correctly, all other required values must also be defined.

Configuration

To configure the Datadog integration for the Optimize Live controller, you need to set a series of secret values in the the optimize-live secret.

To update Datadog environment variables defined in the optimize-live secret, first edit the secret, setting or replacing the appropriate keys and base64-encoded values, then restart the optimize-live deployment.

For example:

kubectl patch secret optimize-live -n stormforge-system -p "$(jq -n '.data.DD_API_KEY=("YOUR_DD_API_KEY_HERE" | @base64)')" && \
kubectl rollout restart deployment optimize-live -n stormforge-system

An optimize-live secret containing Datadog integration values might look something like this:

apiVersion: v1
kind: Secret
type: Opaque
metadata:
  name: optimize-live
  namespace: stormforge-system
  [...]
data:
  DD_API_KEY: <base64-encoded-api-key>
  DD_APP_KEY: <base64-encoded-app-key>
  DD_CLUSTER_NAME: <base64-encoded-cluster-name>
  [...]

Secret Values

DD_API_KEY

Required.

Set to the value of your Datadog API key.

DD_APP_KEY

Required.

Set to the value of your Datadog application key.

DD_CLUSTER_NAME

Required.

Set this value to the same name the Datadog Kubernetes agent is configured to use.

DD_SITE

Optional.

Defaults to datadoghq.com. If you want to use a different Datadog site, such as us5.datadoghq.com, set DD_SITE to the name of the site to use.

DD_RATE_LIMIT_THRESHOLD

Optional.

By default we throttle the queries against the DataDog API to use up to 80% of the available rate limit. Because DataDog has a global rate limit per organization, this may negatively impact other integrations. In these circumstances, DD_RATE_LIMIT_THRESHOLD can be adjusted to leave appropriate headroom for additional integrations.

Last modified September 15, 2022