--- title: "Get detailed information about an agent" method: GET path: "/api/unstable/fleet/agents/{agent_key}" tags: ["Fleet Automation"] --- # Get detailed information about an agent `GET /api/unstable/fleet/agents/{agent_key}` ## Request - Base URL: `https://api.datadoghq.com` - URL: `https://api.datadoghq.com/api/unstable/fleet/agents/{agent_key}` - Auth: API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY` Retrieve detailed information about a specific Datadog Agent. This endpoint returns comprehensive information about an agent including: - Agent details and metadata - Configured integrations organized by status (working, warning, error, missing) - Detected integrations - Configuration files and layers ## Path parameters - `agent_key` string, required ## Response `200` OK - FleetAgentInfoResponse: Response containing detailed information about a specific agent. - `data` FleetAgentInfo, required: Represents detailed information about a specific Datadog Agent. - `attributes` FleetAgentInfoAttributes, required: Attributes for agent information. - `agent_infos` FleetAgentInfoDetails: Detailed information about a Datadog Agent. - `agent_version` string: The Datadog Agent version. - `api_key_name` string: The API key name (if available and not redacted). - `api_key_uuid` string: The API key UUID. - `cloud_provider` string: The cloud provider where the agent is running. - `cluster_name` string: Kubernetes cluster name (if applicable). - `datadog_agent_key` string: The unique agent key identifier. - `enabled_products` string[]: Datadog products enabled on the agent. - `env` string[]: Environments the agent is reporting from. - `first_seen_at` integer: Timestamp when the agent was first seen. - `hostname` string: The hostname of the agent. - `hostname_aliases` string[]: Alternative hostname list for the agent. - `install_method_installer_version` string: The version of the installer used. - `install_method_tool` string: The tool used to install the agent. - `ip_addresses` string[]: IP addresses of the agent. - `is_single_step_instrumentation_enabled` boolean: Whether single-step instrumentation is enabled. - `last_restart_at` integer: Timestamp of the last agent restart. - `os` string: The operating system. - `os_version` string: The operating system version. - `otel_collector_version` string: OpenTelemetry collector version (if applicable). - `otel_collector_versions` string[]: List of OpenTelemetry collector versions (if applicable). - `otel_collectors` FleetOtelCollector[]: OpenTelemetry collectors associated with the agent (if applicable). - `pod_name` string: Kubernetes pod name (if applicable). - `python_version` string: The Python version used by the agent. - `region` string[]: Regions where the agent is running. - `remote_agent_management` string: Remote agent management status. - `remote_config_status` string: Remote configuration status. - `services` string[]: Services running on the agent. - `tags` string[]: Tags associated with the agent. - `team` string: Team associated with the agent. - `configuration_files` FleetConfigurationLayer: Configuration information organized by layers. - `compiled_configuration` string: The final compiled configuration. - `env_configuration` string: Configuration from environment variables. - `file_configuration` string: Configuration from files. - `parsed_configuration` string: Parsed configuration output. - `remote_configuration` string: Remote configuration settings. - `runtime_configuration` string: Runtime configuration. - `detected_integrations` FleetDetectedIntegration[]: List of detected integrations. - `escaped_name` string: Escaped integration name. - `prefix` string: Integration prefix identifier. - `integrations` FleetIntegrationsByStatus: Integrations organized by their status. - `configuration_files` FleetConfigurationFile[]: Configuration files for integrations. - `file_content` string: The raw content of the configuration file. - `file_path` string: Path to the configuration file. - `filename` string: Name of the configuration file. - `datadog_agent_key` string: The unique agent key identifier. - `error_integrations` FleetIntegrationDetails[]: Integrations with errors. - `data_type` string: Type of data collected (metrics, logs). - `error_messages` string[]: Error messages if the integration has issues. - `init_config` string: Initialization configuration (YAML format). - `instance_config` string: Instance-specific configuration (YAML format). - `is_custom_check` boolean: Whether this is a custom integration. - `log_config` string: Log collection configuration (YAML format). - `name` string: Name of the integration instance. - `source_index` integer: Index in the configuration file. - `source_path` string: Path to the configuration file. - `type` string: Integration type. - `missing_integrations` FleetDetectedIntegration[]: Detected but not configured integrations. - `escaped_name` string: Escaped integration name. - `prefix` string: Integration prefix identifier. - `warning_integrations` FleetIntegrationDetails[]: Integrations with warnings. - `data_type` string: Type of data collected (metrics, logs). - `error_messages` string[]: Error messages if the integration has issues. - `init_config` string: Initialization configuration (YAML format). - `instance_config` string: Instance-specific configuration (YAML format). - `is_custom_check` boolean: Whether this is a custom integration. - `log_config` string: Log collection configuration (YAML format). - `name` string: Name of the integration instance. - `source_index` integer: Index in the configuration file. - `source_path` string: Path to the configuration file. - `type` string: Integration type. - `working_integrations` FleetIntegrationDetails[]: Integrations that are working correctly. - `data_type` string: Type of data collected (metrics, logs). - `error_messages` string[]: Error messages if the integration has issues. - `init_config` string: Initialization configuration (YAML format). - `instance_config` string: Instance-specific configuration (YAML format). - `is_custom_check` boolean: Whether this is a custom integration. - `log_config` string: Log collection configuration (YAML format). - `name` string: Name of the integration instance. - `source_index` integer: Index in the configuration file. - `source_path` string: Path to the configuration file. - `type` string: Integration type. - `id` string, required: The unique agent key identifier. - `type` 'datadog_agent_key', required: The type of Agent info resource. ## Other responses - `400`: Bad Request - `401`: Unauthorized - `403`: Forbidden - `404`: Not Found - `429`: Too many requests --- [API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)