---
title: Host List
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: Docs > Infrastructure > Host List
---

# Host List

## Overview{% #overview %}

The Host List gives you a live inventory of all hosts reporting to Datadog through the Agent or cloud integrations. By default, it shows hosts with activity in the last 15 minutes. To open the Host List, navigate to [**Infrastructure > Hosts**](https://app.datadoghq.com/infrastructure) in Datadog.

This page describes the **New** view of the Host List. To switch to the **Legacy** view, use the toggle in the upper-right corner.

{% image
   source="https://docs.dd-static.net/images/infrastructure/index/infra-list-overview-2.85757f979cdacde45e05b06f400e3fb6.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/infrastructure/index/infra-list-overview-2.85757f979cdacde45e05b06f400e3fb6.png?auto=format&fit=max&w=850&dpr=2 2x"
   alt="The Host List with a filter panel on the left and a list of hosts with customizable columns." /%}

**Note**: This list should not be used to estimate your infrastructure host billing. See the [billing](https://docs.datadoghq.com/account_management/billing.md) page for details.

## Filter and search{% #filter-and-search %}

Use the filter panel on the left to narrow the list of hosts:

- **My Teams**: Toggle on to show only hosts associated with your teams.
- **Quick filters**: Use the checkboxes at the top of the panel to filter by cloud provider (AWS, Azure, Google Cloud, Oracle, or Alibaba Cloud), telemetry source (Datadog Agent or OpenTelemetry), operating system (Windows, Linux, or Darwin), or hardware (GPU).
- **Filter Metrics**: Select a metric and define a value range to filter hosts by metric value.
- **Search facets**: Filter by any host property or tag, such as Cloud Provider, Env, Region, Resource Type, Instance Type, OS, OS Version, Agent, or Docker Version.

You can also use the search box at the top of the list to filter hosts using the [Datadog search syntax](https://docs.datadoghq.com/getting_started/search.md).

## Customize columns{% #customize-columns %}

To add, remove, or reorder columns, click **Columns** above the Host List. You can add any of the following as a column:

- **Host Attributes**: Properties of the host, such as hostname or status.
- **Tags**: Any tag applied to the host.
- **Metrics**: Any metric reported by the host.

To reorder a column, drag it to a new position. To resize, drag its right edge. To hide, toggle it off.

{% image
   source="https://docs.dd-static.net/images/infrastructure/index/infra-list-columns.e2f6f4a7f5ec148f39e6e74cfbdc466b.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/infrastructure/index/infra-list-columns.e2f6f4a7f5ec148f39e6e74cfbdc466b.png?auto=format&fit=max&w=850&dpr=2 2x"
   alt="The column customization panel with sections for Host Attributes, Tags, and Metrics, and toggles to show or hide each column." /%}

### Combined columns{% #combined-columns %}

The Host List includes three columns that combine multiple datapoints:

- **Configurations**: The cloud provider, operating system, and Datadog Agent installation status for each host.
- **Software**: The host's web server, database, cache, and container orchestrator (such as Docker or Kubernetes), if detected.
- **Integrations**: The Datadog Agent integrations enabled on the host.

## Saved views{% #saved-views %}

To save your filter and column configuration, open the **Views** panel in the upper-left corner and click **Save as new view**. From this panel, you can filter, sort, edit, and star saved views.

{% image
   source="https://docs.dd-static.net/images/infrastructure/index/infra-list-views.c3b1960df880c37cc5552560f3ea2c94.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/infrastructure/index/infra-list-views.c3b1960df880c37cc5552560f3ea2c94.png?auto=format&fit=max&w=850&dpr=2 2x"
   alt="The Views panel with options to save, filter, sort, and edit saved views." /%}

## Inspect a host{% #inspect-a-host %}

Click any host to open its detail panel, which is the same side panel used by the [Resource Catalog](https://docs.datadoghq.com/infrastructure/resource_catalog.md#investigate-a-host-or-resource). The panel includes:

- [Hostnames and aliases](https://docs.datadoghq.com/agent/faq/how-datadog-agent-determines-the-hostname.md#host-aliases)
- [Tags](https://docs.datadoghq.com/getting_started/tagging.md)
- [Metrics](https://docs.datadoghq.com/metrics.md)
- [Containers](https://docs.datadoghq.com/infrastructure/livecontainers.md?tab=helm#overview)
- [Logs](https://docs.datadoghq.com/logs.md) (if enabled)
- Agent configuration (if enabled)
- OpenTelemetry Collector configuration (if enabled)

{% image
   source="https://docs.dd-static.net/images/infrastructure/index/infra-list-side-panel.5ceb43275142358cfa05936d40534133.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/infrastructure/index/infra-list-side-panel.5ceb43275142358cfa05936d40534133.png?auto=format&fit=max&w=850&dpr=2 2x"
   alt="The host detail side panel with sections for Host Summary, Metrics, Containers, Processes, and other host data." /%}

### Agent configuration{% #agent-configuration %}

To view a host's Agent configuration, click the host to open the side panel, and then scroll to the **Agent** section. To view and manage Agent configurations across your entire infrastructure, use [Fleet Automation](https://app.datadoghq.com/release-notes/fleet-automation-is-now-generally-available).

{% image
   source="https://docs.dd-static.net/images/infrastructure/index/infra-list-agent-config.bd83bafaefa260f71865e21449f4e747.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/infrastructure/index/infra-list-agent-config.bd83bafaefa260f71865e21449f4e747.png?auto=format&fit=max&w=850&dpr=2 2x"
   alt="The Agent section of the host side panel showing the Agent configuration in JSON format." /%}

### OpenTelemetry Collector configuration{% #opentelemetry-collector-configuration %}

When you configure the [Datadog Extension](https://docs.datadoghq.com/opentelemetry/integrations/datadog_extension.md) with your OpenTelemetry Collector, you can view Collector configuration and build information directly in the host detail panel. The extension also lets you manage and debug your Collector deployments from Datadog.

To view a host's OpenTelemetry Collector configuration, click the host to open the side panel. Scroll to the **OTel Collector** section to see the build information and complete Collector configuration. For detailed setup instructions and requirements, such as hostname matching and pipeline configuration, see the [Datadog Extension documentation](https://docs.datadoghq.com/opentelemetry/integrations/datadog_extension.md).

{% image
   source="https://docs.dd-static.net/images/infrastructure/index/infra-list-otel-config.3230922ea0e82156ed855dd475ee1a98.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/infrastructure/index/infra-list-otel-config.3230922ea0e82156ed855dd475ee1a98.png?auto=format&fit=max&w=850&dpr=2 2x"
   alt="The OTel Collector section of the host side panel showing build information and Collector configuration." /%}

## Export{% #export %}

Click **Export** > **Open in DDSQL Editor**, then download the results from the [DDSQL Editor](https://docs.datadoghq.com/ddsql_editor.md#save-and-share-queries). You can also export to a dashboard, notebook, or spreadsheet. For a JSON-formatted list of your hosts reporting to Datadog, you can also use one of the following:

- The [host overview report](https://app.datadoghq.com/reports/v2/overview?metrics=avg%3Aaws.ec2.cpuutilization%2Cavg%3Aazure.vm.percentage_cpu%2Cavg%3Agcp.gce.instance.cpu.utilization%2Cavg%3Asystem.cpu.idle%2Cavg%3Asystem.cpu.iowait%2Cavg%3Asystem.load.norm.15%2Cavg%3Avsphere.cpu.usage%2Cavg%3Avsphere.cpu.usage.avg%2Cavg%3Aalibabacloud.ecs.cpu_utilization.average&with_apps=true&with_sources=true&with_aliases=true&with_meta=true&with_mute_status=true&with_tags=true).
- The [search hosts API endpoint](https://docs.datadoghq.com/api/v1/hosts.md#get-the-total-number-of-active-hosts). See the [developer guide](https://docs.datadoghq.com/extend/guide/query-the-infrastructure-list-via-the-api.md) for an example.

### Audit Agent versions{% #audit-agent-versions %}

To audit which Agent versions are running across your hosts, use the [get_host_agent_list script](https://github.com/DataDog/Miscellany/tree/master/get_hostname_agentversion). The script uses the [host overview report](https://app.datadoghq.com/reports/v2/overview?metrics=avg%3Aaws.ec2.cpuutilization%2Cavg%3Aazure.vm.percentage_cpu%2Cavg%3Agcp.gce.instance.cpu.utilization%2Cavg%3Asystem.cpu.idle%2Cavg%3Asystem.cpu.iowait%2Cavg%3Asystem.load.norm.15%2Cavg%3Avsphere.cpu.usage%2Cavg%3Avsphere.cpu.usage.avg%2Cavg%3Aalibabacloud.ecs.cpu_utilization.average&with_apps=true&with_sources=true&with_aliases=true&with_meta=true&with_mute_status=true&with_tags=true) to output the running Agents with their version numbers. A `json_to_csv` script also converts the JSON output to CSV.

### List hosts without an Agent{% #list-hosts-without-an-agent %}

You can also use the JSON export to list Amazon EC2 (excluding RDS) instances that don't have an Agent installed. These instances appear in the Host List when you set up your AWS account in the Datadog AWS integration. The following Python 3 script lists them:

```python
# 3p
import requests

# stdlib
import json
import pprint
import os

api_key = os.environ['DD_API_KEY']
app_key = os.environ['DD_APP_KEY']

url = "https://app.datadoghq.com/reports/v2/overview?\
window=3h&with_apps=true&with_sources=true&with_aliases=true\
&with_meta=true&with_tags=true&api_key=%s&application_key=%s"

infra = json.loads(requests.get(url %(api_key,app_key)).text)

for host in infra['rows']:
    if (('aws' in host['apps']) and ('rds' not in host['apps']) and ('agent' not in host['apps'])):
        try:
            print(f'HOST: {host["name"]} - TAGS: {host["tags_by_source"]}')
        except:
            pass
```

## Further Reading{% #further-reading %}

- [Host Map](https://docs.datadoghq.com/infrastructure/hostmap.md)
- [Container Map](https://docs.datadoghq.com/infrastructure/livecontainers.md)
- [Live Process Monitoring](https://docs.datadoghq.com/infrastructure/process.md)