---
isPrivate: true
title: Infrastructure Modes
description: >-
  Change Agent behavior to control how much infrastructure monitoring the
  Datadog Agent performs on a host.
breadcrumbs: Docs > Agent > Agent Configuration > Infrastructure Modes
---

> For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt).

# 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.

## 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:
- [System Check](https://docs.datadoghq.com/integrations/system.md)
- [Disk](https://docs.datadoghq.com/integrations/disk.md)
- [Directory](https://docs.datadoghq.com/integrations/directory.md) (7.80+)
- [Network](https://docs.datadoghq.com/integrations/network.md)
- [NTP](https://docs.datadoghq.com/integrations/ntp.md)
- [Processes](https://docs.datadoghq.com/integrations/process.md)
- [Systemd](https://docs.datadoghq.com/integrations/systemd.md)
- [Windows Certificate Store](https://docs.datadoghq.com/integrations/windows-certificate.md) (7.80+)
- [Windows Crash Detection](https://docs.datadoghq.com/integrations/wincrashdetect.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)
- [WMI Check](https://docs.datadoghq.com/integrations/wmi.md) (7.80+)
- [Custom checks](https://docs.datadoghq.com/extend/custom_checks.md) prefixed with `custom_`
- Logs-only integrations (for example, [journald](https://docs.datadoghq.com/integrations/journald.md) or [Windows Event Log](https://docs.datadoghq.com/integrations/event-viewer.md))

{% /dd %}

{% /dl %}

### End User Device{% #end-user-device %}

{% alert level="info" %}
End User Device mode is in Preview. For configuration steps 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).
{% /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 %}

### New hosts{% #new-hosts %}

To configure the infrastructure mode when installing the Agent for the first time, set the `DD_INFRASTRUCTURE_MODE=<MODE>` environment variable before the installation script is invoked:

{% tab title="Linux" %}
In the following command, replace `<API_KEY>` with your organization's [Datadog API key](https://app.datadoghq.com/organization-settings/api-keys), `<DD_SITE>` with **{% placeholder "user-datadog-site" /%}**, and `<MODE>` with `full`, `basic`, `end_user_device`, or `none`:

```shell
DD_API_KEY="<API_KEY>" \
DD_SITE="<DD_SITE>" \
DD_INFRASTRUCTURE_MODE="<MODE>" \
bash -c "$(curl -L https://install.datadoghq.com/scripts/install_script_agent7.sh)"
```

{% /tab %}

{% tab title="Windows" %}
In the following command, replace `<API_KEY>` with your organization's [Datadog API key](https://app.datadoghq.com/organization-settings/api-keys), `<DD_SITE>` with **{% placeholder "user-datadog-site" /%}**, and `<MODE>` 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="<API_KEY>" SITE="<DD_SITE>" DD_INFRASTRUCTRURE_MODE="<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 `<MODE>` with `full`, `basic`, `end_user_device`, or `none`.

In the `datadog.yaml` file:

   ```yaml
   infrastructure_mode: <MODE>
       
```

1. [Restart the Datadog Agent](https://docs.datadoghq.com/agent/configuration/agent-commands.md#restart-the-agent).

## 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 click 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)