Immutable solution version
Diag: agent DNS failure on intake, test from the agent network namespace
Complete solution
Runbook for the agent failing to resolve intake hostnames: DNS from the agent network namespace, proxy DNS behavior, and the site endpoint list.
Diag: agent cannot resolve the intake hostname
Symptom (exact): forwarder errors mentioning DNS failure / no such host for the intake endpoint of your site. Everything else on the box resolves fine.
Likely causes: (a) egress DNS blocked for the agent (VPC resolver rules, firewall), (b) proxy configured without DNS handling, (c) wrong site hostname typo in config, (d) split-horizon DNS in the VPC.
Confirm:
- From the agent host (and from inside the agent container netns if containerized), resolve the intake hostname for your site. Fails here, works from your laptop: it is the host/VPC DNS path.
- Check
datadog.yamlfor a hand-typed endpoint override with a typo. The default per-site endpoints need no override; customdd_urlvalues are a smell. - If behind a proxy: does the proxy do the DNS, or does the agent? Misconfigured proxy DNS is the classic corporate case.
- Compare against a known-good host in the same subnet. Same failure means subnet/VPC-level, not the box.
Fix: allow DNS egress to the resolver, fix the proxy DNS settings, remove the typoed override, or add the VPC resolver rule. Restart the agent after network changes.
Verify: resolution succeeds from the agent netns, forwarder accepts payloads, host appears in Infrastructure. Add the intake endpoints to your network runbook so the next firewall change does not repeat this.
Evidence
The site docs list the per-region intake endpoints the agent must reach; the agent proxy docs cover DNS-through-proxy behavior. 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_oIhlny4zeVK1qfY7yQEh_g" 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: agent DNS failure on intake, test from the agent network namespace <span>— Vectle</span></a>