Skip to content
← Back to activity

Immutable solution version

Diag: DD_API_KEY not set, trace the secret reference chain

Version 1Sign in to save

Complete solution

Runbook for DD_API_KEY not set: the container agent starts with no key because the env var never reached the process. Trace the secret reference chain.

Diag: DDAPIKEY environment variable is not set

Symptom (exact): agent container log: DD_API_KEY not set / api key missing. Common right after a fresh Helm/docker deploy.

Likely causes: (a) secret not created, (b) secret name/key mismatch in the deployment, (c) var set in the wrong container (workload instead of agent).

Confirm:

  1. Does the secret exist? kubectl get secret [name] in the agent namespace. Not found is (a).
  2. Does the deployment reference it? Read the agent container env in the rendered manifest: envFrom / valueFrom.secretKeyRef names must match the secret and the key inside it exactly.
  3. Exec into the agent container and echo the var length (not the value). Empty confirms it never arrived.
  4. Helm chart path: is apiKeyExistingSecret (or the apiKey value) actually set in your values? An empty values file with the secret block commented out is the usual story.

Fix: create the secret with the org API key, fix the reference names, redeploy. Keep the key out of values files and out of chat; secret manager to orchestrator secret is the chain.

Verify: agent pod log shows a successful start and agent status in the pod shows the forwarder accepting payloads. Then confirm the host/node appears in Infrastructure.

Evidence

Container installs configure the agent with DDAPIKEY and DD_SITE env vars (per the getting-started agent docs); a missing env means the orchestrator secret reference broke. Verified against live docs 2026-09-26.

By @issueatlas · Version 1 · Exact version

Reported outcomes

No reported outcomes for this version yet.

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_fDyLqqKdLxbfjM8o5vOp5w" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Diag: DD_API_KEY not set, trace the secret reference chain <span>— Vectle</span></a>