Datadog

Use datadog in twins and put this configuration under seed_config.datadog. Datadog observability account with stateful monitors, dashboards, logs, metrics, events, SLOs, downtimes, incidents, synthetic tests, and notebooks.

Example seed

This is the complete Scenario request body for creating a Scenario. You can also import it with arga test-runner scenarios import --file scenario.json.

{
  "name": "Datadog eval fixture",
  "twins": [
    "datadog"
  ],
  "seed_config": {
    "datadog": {
      "seed": "scenario-datadog",
      "base_time": "2026-01-15T12:00:00Z",
      "monitors": [
        {
          "name": "Checkout error rate",
          "type": "metric alert",
          "query": "avg(last_5m):sum:checkout.errors{env:test}.as_rate() > 0.05",
          "message": "Checkout errors are elevated @team-checkout",
          "tags": [
            "service:checkout",
            "env:test"
          ],
          "options": {
            "thresholds": {
              "critical": 0.05
            }
          },
          "overall_state": "Alert"
        }
      ],
      "dashboards": [
        {
          "title": "Checkout Overview",
          "layout_type": "ordered",
          "description": "Checkout service health",
          "widgets": []
        }
      ],
      "logs": [
        {
          "message": "payment authorization failed",
          "service": "checkout",
          "status": "error",
          "host": "checkout-1",
          "tags": [
            "env:test"
          ],
          "trace_id": "abc123"
        }
      ],
      "metrics": [
        {
          "metric": "checkout.request.duration",
          "type": "gauge",
          "description": "Checkout request duration",
          "unit": "millisecond",
          "points": [
            [
              1768478400,
              134.2
            ]
          ],
          "tags": [
            "service:checkout",
            "env:test"
          ]
        }
      ],
      "events": [
        {
          "title": "Checkout deploy",
          "text": "Version 2026.01.15 deployed",
          "tags": [
            "service:checkout",
            "deployment"
          ],
          "alert_type": "info"
        }
      ],
      "slos": [
        {
          "name": "Checkout availability",
          "type": "metric",
          "tags": [
            "service:checkout"
          ],
          "thresholds": [
            {
              "timeframe": "30d",
              "target": 99.9,
              "warning": 99.95
            }
          ],
          "query": {
            "numerator": "sum:checkout.requests.ok{*}.as_count()",
            "denominator": "sum:checkout.requests.total{*}.as_count()"
          }
        }
      ],
      "downtimes": [],
      "incidents": [
        {
          "title": "Checkout degradation",
          "state": "active",
          "severity": "SEV-2",
          "customer_impacted": true
        }
      ],
      "synthetics": [
        {
          "name": "Checkout health",
          "type": "api",
          "subtype": "http",
          "status": "live",
          "locations": [
            "aws:us-east-1"
          ],
          "tags": [
            "service:checkout"
          ]
        }
      ],
      "notebooks": [],
      "failures": []
    }
  }
}

Parameters

The following fields belong directly inside seed_config.datadog. Required nested fields are marked in their tables. Provider-native objects can contain service-specific fields beyond the representative record shapes below.

Parameter	Type	Description
`seed`	`string`	Deterministic seed used by this twin.
`base_time`	`string`	Reference clock for repeatable fixtures. Omit to use the current clock.
`monitors`	`object[]`	Monitors fixtures in provider-native format.
`dashboards`	`object[]`	Dashboards fixtures in provider-native format.
`logs`	`object[]`	Logs fixtures in provider-native format.
`metrics`	`object[]`	Metrics fixtures in provider-native format.
`events`	`object[]`	Events fixtures in provider-native format.
`slos`	`object[]`	Slos fixtures in provider-native format.
`downtimes`	`object[]`	Downtimes fixtures in provider-native format.
`incidents`	`object[]`	Incidents fixtures in provider-native format.
`synthetics`	`object[]`	Synthetics fixtures in provider-native format.
`notebooks`	`object[]`	Notebooks fixtures in provider-native format.
`failures`	`FailureRule[]`	Deterministic failure-injection rules.
`api_key`	`string`	Synthetic API key accepted by the twin.
`app_key`	`string`	App key.
`access_token`	`string`	Synthetic access token used by the twin.
`access_token_scopes`	`string[] or null`	Access token scopes.
`access_token_user_id`	`string`	Access token user id.
`allow_unknown_credentials`	`boolean`	Enable or set allow unknown credentials behavior.
`entitlements`	`string[] or null`	Entitlements.
`mcp_observed_catalog`	`boolean`	Enable or set mcp observed catalog behavior.
`mcp_write_access`	`boolean`	Enable or set mcp write access behavior.
`rate_limit`	`integer`	Rate limit.
`rate_period_seconds`	`integer`	Rate period seconds, in seconds.
`telemetry_propagation_delay_seconds`	`number`	Telemetry propagation delay seconds, in seconds.
`audit_logs`	`object[]`	Audit logs fixtures in provider-native format.
`log_archives`	`object[]`	Log archives fixtures in provider-native format.
`log_custom_destinations`	`object[]`	Log custom destinations fixtures in provider-native format.
`log_metrics`	`object[]`	Log metrics fixtures in provider-native format.
`log_saved_views`	`object[]`	Log saved views fixtures in provider-native format.
`mcp_data`	`map<string, object[]>`	Mcp data keyed by identifier or resource name.
`incident_handles`	`object[]`	Incident handles fixtures in provider-native format.
`incident_postmortem_templates`	`object[]`	Incident postmortem templates fixtures in provider-native format.
`incident_settings`	`object`	Incident settings.
`static_analysis_rulesets`	`object[]`	Static analysis rulesets fixtures in provider-native format.
`static_analysis_rules`	`object[]`	Static analysis rules fixtures in provider-native format.
`scorecard_rules`	`object[]`	Scorecard rules fixtures in provider-native format.
`scorecard_outcomes`	`object[]`	Scorecard outcomes fixtures in provider-native format.
`scorecard_campaigns`	`object[]`	Scorecard campaigns fixtures in provider-native format.
`org_group_policies`	`object[]`	Org group policies fixtures in provider-native format.
`org_group_policy_overrides`	`object[]`	Org group policy overrides fixtures in provider-native format.
`seat_assignments`	`map<string, string[]>`	Seat assignments keyed by identifier or resource name.
`synthetic_results`	`object[]`	Synthetic results fixtures in provider-native format.
`synthetic_downtimes`	`object[]`	Synthetic downtimes fixtures in provider-native format.
`synthetic_suites`	`object[]`	Synthetic suites fixtures in provider-native format.
`api_keys`	`object[]`	Api keys fixtures in provider-native format.
`application_keys`	`object[]`	Application keys fixtures in provider-native format.
`users`	`object[]`	Users fixtures in provider-native format.
`roles`	`object[]`	Role definitions and their supported relationships.
`permissions`	`object[]`	Permissions fixtures in provider-native format.
`organizations`	`object[]`	Organizations fixtures in provider-native format.
`hosts`	`object[]`	Hosts fixtures in provider-native format.
`service_definitions`	`object[]`	Service definitions fixtures in provider-native format.
`catalog_entities`	`object[]`	Catalog entities fixtures in provider-native format.
`catalog_kinds`	`object[]`	Catalog kinds fixtures in provider-native format.
`catalog_relations`	`object[]`	Catalog relations fixtures in provider-native format.
`feature_flags`	`object[]`	Feature flags fixtures in provider-native format.
`feature_flag_environments`	`object[]`	Feature flag environments fixtures in provider-native format.
`status_pages`	`object[]`	Status pages fixtures in provider-native format.
`status_page_components`	`object[]`	Status page components fixtures in provider-native format.
`status_page_degradations`	`object[]`	Status page degradations fixtures in provider-native format.
`status_page_maintenances`	`object[]`	Status page maintenances fixtures in provider-native format.
`cases`	`object[]`	Cases fixtures in provider-native format.
`case_projects`	`object[]`	Case projects fixtures in provider-native format.
`case_comments`	`object[]`	Case comments fixtures in provider-native format.
`case_notification_rules`	`object[]`	Case notification rules fixtures in provider-native format.
`apm_services`	`object[]`	Apm services fixtures in provider-native format.
`apm_entities`	`object[]`	Apm entities fixtures in provider-native format.
`apm_dependencies`	`object[]`	Apm dependencies fixtures in provider-native format.
`apm_instrumentation_errors`	`object[]`	Apm instrumentation errors fixtures in provider-native format.
`apm_service_configs`	`object[]`	Apm service configs fixtures in provider-native format.
`apm_library_configs`	`object[]`	Apm library configs fixtures in provider-native format.
`apm_service_remapping_rules`	`object[]`	Apm service remapping rules fixtures in provider-native format.
`apm_sampling_rules`	`object[]`	Apm sampling rules fixtures in provider-native format.
`apm_adaptive_sampling_statuses`	`object[]`	Apm adaptive sampling statuses fixtures in provider-native format.
`apm_adaptive_sampling_allotment`	`object`	Apm adaptive sampling allotment.
`annotations`	`object[]`	Annotations fixtures in provider-native format.
`workflows`	`object[]`	Workflows fixtures in provider-native format.
`workflow_instances`	`object[]`	Workflow instances fixtures in provider-native format.
`action_connections`	`object[]`	Action connections fixtures in provider-native format.
`observability_pipelines`	`object[]`	Observability pipelines fixtures in provider-native format.
`fleet_agents`	`object[]`	Fleet agents fixtures in provider-native format.
`fleet_agent_versions`	`object[]`	Fleet agent versions fixtures in provider-native format.
`fleet_tracers`	`object[]`	Fleet tracers fixtures in provider-native format.
`fleet_deployments`	`object[]`	Fleet deployments fixtures in provider-native format.
`fleet_schedules`	`object[]`	Fleet schedules fixtures in provider-native format.
`authn_mappings`	`object[]`	Authn mappings fixtures in provider-native format.
`tag_policies`	`object[]`	Tag policies fixtures in provider-native format.
`reference_tables`	`object[]`	Reference tables fixtures in provider-native format.
`datasets`	`object[]`	Datasets fixtures in provider-native format.
`saved_widgets`	`object[]`	Saved widgets fixtures in provider-native format.
`deployment_gates`	`object[]`	Deployment gates fixtures in provider-native format.
`deployment_rules`	`object[]`	Deployment rules fixtures in provider-native format.
`deployment_gate_evaluations`	`object[]`	Deployment gate evaluations fixtures in provider-native format.
`log_restriction_queries`	`object[]`	Log restriction queries fixtures in provider-native format.
`data_deletion_requests`	`object[]`	Data deletion requests fixtures in provider-native format.
`app_builder_apps`	`object[]`	App builder apps fixtures in provider-native format.
`investigations`	`object[]`	Investigations fixtures in provider-native format.
`change_requests`	`object[]`	Change requests fixtures in provider-native format.
`change_request_decisions`	`object[]`	Change request decisions fixtures in provider-native format.
`csm_agent_policies`	`object[]`	Csm agent policies fixtures in provider-native format.
`csm_agent_rules`	`object[]`	Csm agent rules fixtures in provider-native format.
`security_monitoring_rules`	`object[]`	Security monitoring rules fixtures in provider-native format.
`security_findings`	`object[]`	Security findings fixtures in provider-native format.
`security_signals`	`object[]`	Security signals fixtures in provider-native format.
`security_iocs`	`object[]`	Security iocs fixtures in provider-native format.
`security_suppressions`	`object[]`	Security suppressions fixtures in provider-native format.
`security_content_packs`	`object[]`	Security content packs fixtures in provider-native format.
`asm_custom_rules`	`object[]`	Asm custom rules fixtures in provider-native format.
`asm_exclusions`	`object[]`	Asm exclusions fixtures in provider-native format.
`restriction_policies`	`object[]`	Restriction policies fixtures in provider-native format.
`agentless_aws_scan_options`	`object[]`	Agentless aws scan options fixtures in provider-native format.
`agentless_aws_on_demand_tasks`	`object[]`	Agentless aws on demand tasks fixtures in provider-native format.
`agentless_azure_scan_options`	`object[]`	Agentless azure scan options fixtures in provider-native format.
`agentless_gcp_scan_options`	`object[]`	Agentless gcp scan options fixtures in provider-native format.
`spans`	`object[]`	Spans fixtures in provider-native format.
`span_metrics`	`object[]`	Span metrics fixtures in provider-native format.
`error_tracking_issues`	`object[]`	Error tracking issues fixtures in provider-native format.
`network_devices`	`object[]`	Network devices fixtures in provider-native format.
`network_interfaces`	`object[]`	Network interfaces fixtures in provider-native format.
`network_device_tags`	`map<string, string[]>`	Network device tags keyed by identifier or resource name.
`network_interface_tags`	`map<string, string[]>`	Network interface tags keyed by identifier or resource name.
`ci_pipeline_events`	`object[]`	Ci pipeline events fixtures in provider-native format.
`ci_test_events`	`object[]`	Ci test events fixtures in provider-native format.
`flaky_tests`	`object[]`	Flaky tests fixtures in provider-native format.
`dora_deployments`	`object[]`	Dora deployments fixtures in provider-native format.
`test_optimization_service_settings`	`object[]`	Test optimization service settings fixtures in provider-native format.
`test_optimization_flaky_test_policies`	`object[]`	Test optimization flaky test policies fixtures in provider-native format.
`cloud_aws_accounts`	`object[]`	Cloud aws accounts fixtures in provider-native format.
`cloud_azure_accounts`	`object[]`	Cloud azure accounts fixtures in provider-native format.
`cloud_gcp_accounts`	`object[]`	Cloud gcp accounts fixtures in provider-native format.
`oci_tenancies`	`object[]`	Oci tenancies fixtures in provider-native format.
`oci_products`	`object[]`	Oci products fixtures in provider-native format.
`hosted_skills`	`object[]`	Hosted skills fixtures in provider-native format.
`onboarding_sessions`	`object[]`	Onboarding sessions fixtures in provider-native format.
`change_stories`	`object[]`	Change stories fixtures in provider-native format.
`sensitive_data_scanner_configuration`	`object`	Sensitive data scanner configuration.
`dbm_samples`	`object[]`	Dbm samples fixtures in provider-native format.
`hamr_connection`	`object`	Hamr connection.
`product_analytics_events`	`object[]`	Product analytics events fixtures in provider-native format.
`symdb_scopes`	`object[]`	Symdb scopes fixtures in provider-native format.
`ddsql_docs`	`string`	Ddsql docs.
`ddsql_tables`	`map<string, object[]>`	Ddsql tables keyed by identifier or resource name.
`ddsql_query_rows`	`object[]`	Ddsql query rows fixtures in provider-native format.
`idp_entities`	`object[]`	Idp entities fixtures in provider-native format.
`idp_teams`	`object[]`	Idp teams fixtures in provider-native format.
`service_dependencies`	`map<string, object>`	Service dependencies keyed by identifier or resource name.
`kafka_topic_configs`	`object[]`	Kafka topic configs fixtures in provider-native format.
`kafka_broker_configs`	`object[]`	Kafka broker configs fixtures in provider-native format.
`kafka_client_configs`	`object[]`	Kafka client configs fixtures in provider-native format.
`kafka_messages`	`object[]`	Kafka messages fixtures in provider-native format.
`kafka_subject_schemas`	`object[]`	Kafka subject schemas fixtures in provider-native format.
`debugger_probes`	`object[]`	Debugger probes fixtures in provider-native format.
`debugger_contexts`	`object[]`	Debugger contexts fixtures in provider-native format.
`model_lab_projects`	`object[]`	Model lab projects fixtures in provider-native format.
`model_lab_runs`	`object[]`	Model lab runs fixtures in provider-native format.
`model_lab_project_artifacts`	`map<string, object[]>`	Model lab project artifacts keyed by identifier or resource name.
`model_lab_run_artifacts`	`map<string, object[]>`	Model lab run artifacts keyed by identifier or resource name.
`rum_applications`	`object[]`	Rum applications fixtures in provider-native format.
`rum_events`	`object[]`	Rum events fixtures in provider-native format.
`rum_metrics`	`object[]`	Rum metrics fixtures in provider-native format.
`rum_retention_filters`	`map<string, object[]>`	Rum retention filters keyed by identifier or resource name.
`rum_playlists`	`object[]`	Rum playlists fixtures in provider-native format.
`rum_heatmap_snapshots`	`object[]`	Rum heatmap snapshots fixtures in provider-native format.
`on_call_teams`	`object[]`	On call teams fixtures in provider-native format.
`on_call_team_memberships`	`map<string, object[]>`	On call team memberships keyed by identifier or resource name.
`on_call_escalation_policies`	`object[]`	On call escalation policies fixtures in provider-native format.
`on_call_schedules`	`object[]`	On call schedules fixtures in provider-native format.
`on_call_notification_channels`	`map<string, object[]>`	On call notification channels keyed by identifier or resource name.
`on_call_notification_rules`	`map<string, object[]>`	On call notification rules keyed by identifier or resource name.
`on_call_pages`	`object[]`	On call pages fixtures in provider-native format.
`integrations_catalog`	`object[]`	Integrations catalog fixtures in provider-native format.
`jira_accounts`	`object[]`	Jira accounts fixtures in provider-native format.
`jira_issue_templates`	`object[]`	Jira issue templates fixtures in provider-native format.
`servicenow_instances`	`object[]`	Servicenow instances fixtures in provider-native format.
`servicenow_templates`	`object[]`	Servicenow templates fixtures in provider-native format.
`servicenow_users`	`map<string, object[]>`	Servicenow users keyed by identifier or resource name.
`servicenow_assignment_groups`	`map<string, object[]>`	Servicenow assignment groups keyed by identifier or resource name.
`servicenow_business_services`	`map<string, object[]>`	Servicenow business services keyed by identifier or resource name.
`google_chat_handles`	`map<string, object[]>`	Google chat handles keyed by identifier or resource name.
`google_chat_spaces`	`object[]`	Google chat spaces fixtures in provider-native format.
`ms_teams_handles`	`object[]`	Ms teams handles fixtures in provider-native format.
`ms_teams_workflows`	`object[]`	Ms teams workflows fixtures in provider-native format.
`ms_teams_channels`	`object[]`	Ms teams channels fixtures in provider-native format.
`aws_persona_mappings`	`object[]`	Aws persona mappings fixtures in provider-native format.
`slack_integration_channels`	`object[]`	Slack integration channels fixtures in provider-native format.
`webhook_integrations`	`object[]`	Webhook integrations fixtures in provider-native format.
`cost_custom_files`	`object[]`	Cost custom files fixtures in provider-native format.
`cost_tag_descriptions`	`object[]`	Cost tag descriptions fixtures in provider-native format.
`cost_budgets`	`object[]`	Cost budgets fixtures in provider-native format.
`cost_aws_configs`	`object[]`	Cost aws configs fixtures in provider-native format.
`cost_azure_configs`	`object[]`	Cost azure configs fixtures in provider-native format.
`cost_gcp_configs`	`object[]`	Cost gcp configs fixtures in provider-native format.
`llm_obs_projects`	`object[]`	Llm obs projects fixtures in provider-native format.
`llm_obs_experiments`	`object[]`	Llm obs experiments fixtures in provider-native format.
`llm_obs_datasets`	`object[]`	Llm obs datasets fixtures in provider-native format.
`llm_obs_dataset_records`	`map<string, object[]>`	Llm obs dataset records keyed by identifier or resource name.
`llm_obs_experiment_events`	`map<string, object[]>`	Llm obs experiment events keyed by identifier or resource name.
`llm_obs_annotation_queues`	`object[]`	Llm obs annotation queues fixtures in provider-native format.
`llm_obs_eval_configs`	`object[]`	Llm obs eval configs fixtures in provider-native format.
`llm_obs_pattern_configs`	`object[]`	Llm obs pattern configs fixtures in provider-native format.
`llm_obs_pattern_runs`	`object[]`	Llm obs pattern runs fixtures in provider-native format.
`llm_obs_pattern_topics`	`object[]`	Llm obs pattern topics fixtures in provider-native format.
`llm_obs_agent_insights`	`object[]`	Llm obs agent insights fixtures in provider-native format.
`llm_obs_spans`	`object[]`	Llm obs spans fixtures in provider-native format.
`bits_messages`	`object[]`	Bits messages fixtures in provider-native format.

Resource fields

These tables describe the record shapes used by the example. Keep native field names and casing. Map keys such as property names, IDs, and metadata keys are supplied by your fixture.

`monitors[]`

Parameter	Type	Description
`name`	`string`	Human-readable name.
`type`	`string`	Type.
`query`	`string`	Query.
`message`	`string`	Message.
`tags`	`string[]`	Tags fixtures in provider-native format.
`options`	`object`	Options.
`overall_state`	`string`	Overall state.

`dashboards[]`

Parameter	Type	Description
`title`	`string`	Human-readable name.
`layout_type`	`string`	Layout type.
`description`	`string`	Description.
`widgets`	`array`	Widgets fixtures in provider-native format.

`logs[]`

Parameter	Type	Description
`message`	`string`	Message.
`service`	`string`	Service.
`status`	`string`	Status.
`host`	`string`	Host.
`tags`	`string[]`	Tags fixtures in provider-native format.
`trace_id`	`string`	Trace id.

`metrics[]`

Parameter	Type	Description
`metric`	`string`	Metric.
`type`	`string`	Type.
`description`	`string`	Description.
`unit`	`string`	Unit.
`points`	`integer[][]`	Points fixtures in provider-native format.
`tags`	`string[]`	Tags fixtures in provider-native format.

`events[]`

Parameter	Type	Description
`title`	`string`	Human-readable name.
`text`	`string`	Text content.
`tags`	`string[]`	Tags fixtures in provider-native format.
`alert_type`	`string`	Alert type.

`slos[]`

Parameter	Type	Description
`name`	`string`	Human-readable name.
`type`	`string`	Type.
`tags`	`string[]`	Tags fixtures in provider-native format.
`thresholds`	`object[]`	Thresholds fixtures in provider-native format.
`query`	`object`	Query.

`slos[].thresholds[]`

Parameter	Type	Description
`timeframe`	`string`	Timeframe.
`target`	`number`	Target.
`warning`	`number`	Warning.

`incidents[]`

Parameter	Type	Description
`title`	`string`	Human-readable name.
`state`	`string`	State.
`severity`	`string`	Severity.
`customer_impacted`	`boolean`	Enable or set customer impacted behavior.

`synthetics[]`

Parameter	Type	Description
`name`	`string`	Human-readable name.
`type`	`string`	Type.
`subtype`	`string`	Subtype.
`status`	`string`	Status.
`locations`	`string[]`	Locations fixtures in provider-native format.
`tags`	`string[]`	Tags fixtures in provider-native format.

Typed configuration objects

Named object types in the parameter table use these fields.

FailureRule

Parameter	Type	Description
`method`	`string`	Method.
`path`	`string`	Path.
`status_code`	`integer`	Status code.
`errors`	`string[]`	Errors fixtures in provider-native format.
`remaining`	`integer`	Remaining.

API coverage and limitations

Twin name: datadog Supports

Datadog v1/v2 APIs for monitors, dashboards, events, log intake/search/aggregation, metrics, SLOs, downtime, incidents and attachments, Synthetic API tests and results, and notebooks.
Datadog Pup CLI 1.12.1 request and response contracts across common monitoring and investigation workflows.
API/application-key or bearer-token authentication, Datadog-shaped errors, rate-limit headers, fault injection, deterministic account state, and admin reset/state routes.
A small browsable Datadog-style overview for inspecting twin state.

Known limitations

Cloud integrations, IAM and key management, security, RUM, APM, traces, DBM, workflows, usage/cost, service catalog, on-call, and other unlisted product configuration APIs are not implemented.
Unknown API paths return 404; they do not return synthetic success.

Provision

arga twin-runs create --twins datadog --ttl 60 --wait

MCP tools: get_twin_catalog, provision_twins, start_url_validation, get_validation_results. See Scenario seeding for saving, provisioning, and resetting fixtures.

Get started

Digital twins

Tests

Setup

Integrations

Resources

Example seed

Parameters

Resource fields

`monitors[]`

`dashboards[]`

`logs[]`

`metrics[]`

`events[]`

`slos[]`

`slos[].thresholds[]`

`incidents[]`

`synthetics[]`

Typed configuration objects

FailureRule

API coverage and limitations

​Example seed

​Parameters

​Resource fields

​monitors[]

​dashboards[]

​logs[]

​metrics[]

​events[]

​slos[]

​slos[].thresholds[]

​incidents[]

​synthetics[]

​Typed configuration objects

​FailureRule

​API coverage and limitations

Example seed

Parameters

Resource fields

`monitors[]`

`dashboards[]`

`logs[]`

`metrics[]`

`events[]`

`slos[]`

`slos[].thresholds[]`

`incidents[]`

`synthetics[]`

Typed configuration objects

FailureRule

API coverage and limitations