Manage Datadog Synthetic private locations at scale using the Terraform provider

domain: docs.datadoghq.com/synthetics/platform/private_locations · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Add the Datadog Terraform provider (hashicorp/datadog) and authenticate with DD_API_KEY and DD_APP_KEY environment variables
  2. Define a datadog_synthetics_private_location resource with name and tags; apply to generate the location ID and config JSON output
  3. Store the output config JSON in a secrets manager (e.g., AWS Secrets Manager or Vault); reference it when launching worker containers
  4. Reference the private location's id in datadog_synthetics_test resources via the locations attribute
  5. Use terraform state to track location IDs; destroying the resource invalidates the config JSON and disconnects all workers
  6. Scale horizontally by running multiple worker containers with the same config JSON — they compete for work without additional configuration

Known gotchas

Related routes

Create and manage Datadog dashboards as code using the datadog_dashboard Terraform resource
registry.terraform.io · 6 steps · unrated
Implement a multi-region synthetic monitoring strategy using Datadog Synthetics
datadoghq.com · 6 steps · unrated
Create a Datadog Synthetic browser test programmatically and schedule it on a private location
docs.datadoghq.com/synthetics · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans