network-performance

Run pup network connections with --from and --to time parameters, optionally adding --group-by for dimensions like client_service and server_service. Use --tags to filter by environment or service and --limit to control result size.

Use pup network dns with a time range and group by network.dns_query to see top domains by query volume. You can also group by network.dns_record_type or filter by client_service tags to investigate specific services.

The pup CLI requires three environment variables: DD_API_KEY for your Datadog API key, DD_APP_KEY for your application key, and DD_SITE for your Datadog site, which defaults to datadoghq.com.

Run pup network devices list with --filter-tag="status:down" to show only non-responsive devices. You can also filter by warning status, location, or device type, then use pup network devices get for details.

High tcp_retransmits values indicate packet loss or network congestion between client and server. Combined with tcp_timeouts and elevated rtt_micro_seconds, they suggest network quality issues on that connection path.

The maximum limit for network connection queries is 7500 results, with a default of 100. If you exceed the limit, reduce the limit parameter or add more specific tag filters to narrow the query.