--- title: Configure Agent Infrastructure Modes description: >- Change Agent behavior to control how much infrastructure monitoring the Datadog Agent performs on a host. breadcrumbs: Docs > Agent > Agent Configuration > Configure Agent Infrastructure Modes --- > For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt). # Configure Agent Infrastructure Modes ## Overview{% #overview %} Infrastructure modes determine which infrastructure monitoring capabilities the Datadog Agent enables on a host. Use these modes to match the Agent's behavior to the host's role: full infrastructure monitoring, basic system resource metrics, no infrastructure monitoring, or End User Device monitoring. Selecting an infrastructure mode controls Agent behavior; it does not enroll your organization in a product or change your subscription. For End User Device Monitoring capabilities and access requirements, see [End User Device Monitoring](https://docs.datadoghq.com/infrastructure/end_user_device_monitoring.md). ## Available modes{% #available-modes %} The Agent supports four infrastructure modes. A checkmark ( {% icon name="icon-check-bold" /%} ) indicates the capability is available in that mode. | Capability | Full (default) | Basic | End User Device | None | | ---------------------------------------- | -------------- | ----------------- | --------------- | ---- | | System resource metrics | yes | yes | yes | | Infrastructure integrations | yes (all) | yes (limited set) | yes | | Container Monitoring | yes | | Live Processes | yes | yes | | Custom checks and logs-only integrations | yes | yes | yes | yes | | Custom metrics | yes | yes | yes | yes | | Visible in infrastructure dashboards | yes | yes | ### Full{% #full %} {% dl %} {% dt %} `full` {% /dt %} {% dd %} **Default**: Yes **Minimum Agent version**: 7.73.0 **Recommended for**: Most use cases {% /dd %} {% dd %} The Agent collects system resource metrics and process data, runs all infrastructure integrations, and supports Container Monitoring and Live Processes. If you have not set an `infrastructure_mode` value, the Agent runs in `full` mode. {% /dd %} {% /dl %} ### Basic{% #basic %} {% dl %} {% dt %} `basic` {% /dt %} {% dd %} **Minimum Agent version**: 7.73.0 (Linux, macOS), 7.76.2 (Windows) **Recommended for**: VMs and physical servers that only need system resource metrics {% /dd %} {% dd %} The Agent collects system resource metrics (CPU, memory, disk, network) and limited process and service data. Only the following integrations run: - [Cisco ACI](https://docs.datadoghq.com/integrations/cisco-aci.md) (7.78+) - [Cisco SD-WAN](https://docs.datadoghq.com/integrations/cisco-sdwan.md) (7.78+) - [Directory](https://docs.datadoghq.com/integrations/directory.md) (7.80+) - [Disk](https://docs.datadoghq.com/integrations/disk.md) - [Network](https://docs.datadoghq.com/integrations/network.md) - [NTP](https://docs.datadoghq.com/integrations/ntp.md) - [Processes](https://docs.datadoghq.com/integrations/process.md) - [SNMP](https://docs.datadoghq.com/integrations/snmp.md) (7.78+) - [System Check](https://docs.datadoghq.com/integrations/system.md) - [Systemd](https://docs.datadoghq.com/integrations/systemd.md) - [Versa](https://docs.datadoghq.com/integrations/versa.md) (7.78+) - [Windows Certificate Store](https://docs.datadoghq.com/integrations/windows-certificate.md) (7.80+) - [Windows Crash Detection](https://docs.datadoghq.com/integrations/wincrashdetect.md) - [Windows Event Log](https://docs.datadoghq.com/integrations/event-viewer.md) - [Windows Kernel Memory](https://docs.datadoghq.com/integrations/winkmem.md) - [Windows Performance Counters](https://docs.datadoghq.com/integrations/windows-performance-counters.md) (7.80+) - [Windows Registry](https://docs.datadoghq.com/integrations/windows-registry.md) (7.80+) - [Windows Services](https://docs.datadoghq.com/integrations/windows-service.md) (7.78+) - [WMI Check](https://docs.datadoghq.com/integrations/wmi.md) (7.80+) - [Custom checks](https://docs.datadoghq.com/extend/custom_checks.md) prefixed with `custom_` {% /dd %} {% /dl %} To monitor hosts through vSphere, Proxmox, or Nutanix in Basic mode, see Configure Basic mode for virtualization integrations. ### End User Device{% #end-user-device %} {% alert level="info" %} End User Device mode is in Preview. For product capabilities and to request access, see [End User Device Monitoring](https://docs.datadoghq.com/infrastructure/end_user_device_monitoring.md). {% /alert %} {% dl %} {% dt %} `end_user_device` {% /dt %} {% dd %} **Minimum Agent version**: 7.76.2 **Recommended for**: Employee desktops, laptops, and workstations {% /dd %} {% dd %} The Agent includes all full mode capabilities except Container Monitoring, plus the following. - Device Performance Monitoring - Logs Collection - Wi-Fi Monitoring - Windows Crash Detection - Network Path Monitoring {% /dd %} {% dd %} For full descriptions, see [Key capabilities](https://docs.datadoghq.com/infrastructure/end_user_device_monitoring.md#key-capabilities). For device-specific requirements and installation instructions, see [Set up End User Device Monitoring](https://docs.datadoghq.com/infrastructure/end_user_device_monitoring/setup.md). {% /dd %} {% /dl %} ### None{% #none %} {% dl %} {% dt %} `none` {% /dt %} {% dd %} **Minimum Agent version**: 7.77.0 **Recommended for**: Hosts configured only for [Log Management](https://docs.datadoghq.com/logs.md), [APM](https://docs.datadoghq.com/tracing.md), or [Error Tracking](https://docs.datadoghq.com/error_tracking.md) {% /dd %} {% dd %} The Agent does not collect any infrastructure metrics or run infrastructure integrations. You can still use custom metrics, [custom checks](https://docs.datadoghq.com/extend/custom_checks.md) prefixed with `custom_`, and logs-only integrations such as [journald](https://docs.datadoghq.com/integrations/journald.md) or [Windows Event Log](https://docs.datadoghq.com/integrations/event-viewer.md). {% /dd %} {% dd %} Hosts in `none` mode appear in [Fleet Automation](https://app.datadoghq.com/fleet) under the View Agents tab because the Agent continues to send metadata to Datadog. However, these hosts do not appear in infrastructure dashboards or queries that rely on infrastructure metrics. {% /dd %} {% /dl %} ## Configure Agent infrastructure mode{% #configure-agent-infrastructure-mode %} Set the Agent's infrastructure mode on each host you want to monitor. ### New hosts{% #new-hosts %} To configure the infrastructure mode when installing the Agent for the first time, set the `DD_INFRASTRUCTURE_MODE=` environment variable before the installation script is invoked: {% tab title="Linux" %} In the following command, replace `` with your organization's [Datadog API key](https://app.datadoghq.com/organization-settings/api-keys), `` with **{% placeholder "user-datadog-site" /%}**, and `` with `full`, `basic`, `end_user_device`, or `none`: ```shell DD_API_KEY="" \ DD_SITE="" \ DD_INFRASTRUCTURE_MODE="" \ bash -c "$(curl -L https://install.datadoghq.com/scripts/install_script_agent7.sh)" ``` {% /tab %} {% tab title="Windows" %} In the following command, replace `` with your organization's [Datadog API key](https://app.datadoghq.com/organization-settings/api-keys), `` with **{% placeholder "user-datadog-site" /%}**, and `` with `full`, `basic`, `end_user_device`, or `none`: ```powershell $p = Start-Process -Wait -PassThru msiexec -ArgumentList '/qn /i "https://windows-agent.datadoghq.com/datadog-agent-7-latest.amd64.msi" /log C:\Windows\SystemTemp\install-datadog.log APIKEY="" SITE="" DD_INFRASTRUCTURE_MODE=""' if ($p.ExitCode -ne 0) { Write-Host "msiexec failed with exit code $($p.ExitCode) please check the logs at C:\Windows\SystemTemp\install-datadog.log" -ForegroundColor Red } ``` {% /tab %} ### Existing hosts{% #existing-hosts %} To set the infrastructure mode for an existing host: 1. Open the [Agent configuration file](https://docs.datadoghq.com/agent/configuration/agent-configuration-files.md) and add `infrastructure_mode` at the root level. Replace `` with `full`, `basic`, `end_user_device`, or `none`. In the `datadog.yaml` file: ```yaml infrastructure_mode: ``` 1. [Restart the Datadog Agent](https://docs.datadoghq.com/agent/configuration/agent-commands.md#restart-the-agent). ## Configure Basic mode for virtualization integrations{% #configure-basic-mode-for-virtualization-integrations %} Set `infrastructure_mode: basic` in the virtualization integration instance to report the hosts and VMs it discovers as Basic, including VMs that don't run the Datadog Agent. This setting is separate from the mode configured in `datadog.yaml` on the host running the integration. That host's Agent must use Full mode, because an Agent in Basic mode can't run virtualization integrations. If a monitored VM also runs the Datadog Agent in Full or Basic mode, the Agent's mode takes precedence over the integration's mode. Configure that Agent to use Basic mode. The following table shows the effective mode for a monitored VM: | Agent on the monitored VM | Effective mode for the VM | | ------------------------------- | ------------------------- | | No Agent, or Agent in None mode | The integration's mode | | Agent in Basic mode | Basic | | Agent in Full mode | Full | The examples below show the fields to add or update in an existing integration configuration. Retain the authentication settings and other required options from the integration's setup instructions. After updating the configuration, [restart the Agent](https://docs.datadoghq.com/agent/configuration/agent-commands.md#restart-the-agent) running the integration. ### vSphere{% #vsphere %} On the host running the vSphere integration, use Agent version 7.74.0 or later. Follow the [vSphere integration setup instructions](https://docs.datadoghq.com/integrations/vsphere.md#setup), then set `infrastructure_mode` to `basic` in the relevant instance: ```yaml instances: - host: infrastructure_mode: basic # Retain the other required settings for this instance. ``` ### Proxmox{% #proxmox %} On the host running the Proxmox integration, use Agent version 7.82.0 or later. Follow the [Proxmox integration setup instructions](https://docs.datadoghq.com/integrations/proxmox.md#setup), then set `infrastructure_mode` to `basic` in the relevant instance: ```yaml instances: - proxmox_server: infrastructure_mode: basic # Retain the other required settings for this instance. ``` ### Nutanix{% #nutanix %} On the host running the Nutanix integration, use Agent version 7.83.0 or later. Follow the [Nutanix integration setup instructions](https://docs.datadoghq.com/integrations/nutanix.md#setup), then set `infrastructure_mode` to `basic` in the relevant instance: ```yaml instances: - pc_ip: infrastructure_mode: basic # Retain the other required settings for this instance. ``` ## Verify infrastructure mode{% #verify-infrastructure-mode %} To verify the infrastructure mode set on your hosts: 1. Navigate to [Fleet Automation](https://app.datadoghq.com/fleet) and select the View Agents tab. 1. Select Infrastructure Mode from the Group by dropdown. 1. Click a mode group to expand it and see the hosts it contains. 1. Optionally, use the search bar to filter to a specific hostname (for example, `hostname:worker1`). {% image source="https://docs.dd-static.net/images/agent/configuration/fa_group_by_infra_mode-1.1772d216cef79b1005a65fea658e7496.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/agent/configuration/fa_group_by_infra_mode-1.1772d216cef79b1005a65fea658e7496.png?auto=format&fit=max&w=850&dpr=2 2x" alt="Fleet Automation View Agents page with Infrastructure Mode selected in the Group by dropdown, showing the Full group expanded with 311 hosts and columns for hostname, Agent, OTEL, integrations, services, and remote configuration status." /%} ## Further reading{% #further-reading %} Additional helpful documentation, links, and articles: - [Agent Configuration Files](https://docs.datadoghq.com/agent/configuration/agent-configuration-files.md) - [Upgrade your Datadog Agent](https://docs.datadoghq.com/agent/guide/upgrade.md)