Infrastructure List
Incident Management is now generally available! Incident Management is now generally available!

Infrastructure List


The Infrastructure list shows all your hosts monitored by Datadog with activity during the last 2 hours. Search your hosts, group them by tags, or sort the list by column headers.


The following information is displayed in the infrastructure list for your hosts:

HostnameThe preferred hostname alias (use the dropdown to view cloud name or instance ID).
StatusDisplays UP when the expected metrics are received and displays ??? if no metrics are received.
CPUThe percent of CPU used (everything but idle).
IOWaitThe percent of CPU spent waiting on the IO (not reported for all platforms).
Load 15The system load over the last 15 minutes.
AppsThe Datadog integrations reporting metrics for the host.


The Datadog Agent collects potential hostnames from a number of different sources. For more details, see How does Datadog determine the Agent hostname?.

Note: Hostnames should be unique within a Datadog account, otherwise you may experience some inconsistencies on your host graphs.


Click on any host to view more details including aliases, tags, and logs (if enabled):


Datadog creates aliases for host names when there are multiple uniquely identifiable names for a single host. The names collected by the Agent are added as aliases for the chosen canonical name. For example, a single host running in EC2 might have an instance ID (i-abcd1234), a generic hostname provided by EC2 based on the host’s IP address (ip-192-0-0-1), and a meaningful host name provided by an internal DNS server or a config-managed hosts file (myhost.mydomain).


For a JSON formatted list of your hosts reporting to Datadog, use one of the following:

Agent version

At times it may also be prove useful to audit your Agent versions to ensure you are running the latest version. To accomplish this, use the get_host_agent_list script, which leverages the JSON permalink to output the current running Agents with version numbers. There is also a json_to_csv script to convert the JSON output into a CSV file.

No Agent

Another use case of the JSON export would be to get a list of AWS EC2 instances with no Agent installed. These instances appear in the infrastructure list by setting up your AWS account in the Datadog AWS integration tile. See this example script.

Further Reading