infrastructure

List and filter Datadog infrastructure hosts across cloud and on-premises environments.

5|2|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/lauhon/pi --skill infrastructure-lauhon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: infrastructure
Source: https://github.com/lauhon/pi/tree/main/skills/infrastructure
Command: npx skills add https://github.com/lauhon/pi --skill infrastructure-lauhon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing infrastructure inventory across multiple cloud providers and environments requires manually querying the Datadog API or navigating dashboards, making host audits, capacity planning, and cost tracking slow and error-prone. ## Core Features & Use Cases - Host Listing & Filtering: List all infrastructure hosts and filter by tags such as environment, service, cloud provider, availability zone, instance type, or OS. - Host Totals & Statistics: Retrieve host counts and status breakdowns (active, muted, offline) for capacity planning and cost management. - Use Case: When asked "How many production AWS hosts are we running?", the agent runs pup infrastructure hosts --filter="env:production" and presents a formatted table with uptime, status, and distribution summaries. ## Quick Start Ask the agent to list all production hosts in your Datadog organization and show their status and uptime.

Frequently Asked Questions about infrastructure

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I list all hosts in Datadog?

Run `pup infrastructure hosts` to list all infrastructure hosts reporting to your Datadog organization. The output includes host name, ID, uptime, and status, formatted as a readable table.

How to filter Datadog hosts by environment or tag?

Use the --filter flag with key:value syntax, such as `pup infrastructure hosts --filter="env:production"`. Supported filters include env, service, cloud_provider, availability_zone, instance_type, os, and custom tags.

What credentials does the Datadog infrastructure CLI need?

The pup CLI requires three environment variables: DD_API_KEY, DD_APP_KEY, and DD_SITE (defaulting to datadoghq.com). Missing credentials produce an error prompting you to export these variables.

Can this agent monitor container CPU and memory metrics?

No, container performance monitoring is out of scope. For container CPU, memory, Kubernetes pod, and deployment metrics, use the Container Monitoring agent instead.

Why does my host filter return no results?

Empty results usually mean the Datadog Agent is not installed or running on the hosts, the filter syntax is incorrect, or hosts report to a different Datadog organization. Verify the key:value filter format and agent status.