Cluster Agent for Kubernetes
Overview
The Datadog Cluster Agent provides a streamlined, centralized approach to collecting cluster level monitoring data. By acting as a proxy between the API server and node-based Agents, the Cluster Agent helps to alleviate server load. It also relays cluster level metadata to node-based Agents, allowing them to enrich the metadata of locally collected metrics.
Using the Datadog Cluster Agent allows you to:
- Alleviate the impact of Agents on your infrastructure.
- Isolate node-based Agents to their respective nodes, reducing RBAC rules to solely read metrics and metadata from the kubelet.
- Provide cluster level metadata that can only be found in the API server to the Node Agents, in order for them to enrich the metadata of the locally collected metrics.
- Enable the collection of cluster level data, such as the monitoring of services or SPOF and events.
- Use Horizontal Pod Autoscaling (HPA) with custom Kubernetes metrics and external metrics. See the Autoscaling on custom and external metrics guide for more details.
If you installed the Datadog Agent using Helm chart v2.7.0 or Datadog Operator v1.0.0+, the Datadog Cluster Agent is enabled by default.
Datadog publishes container images to Google Artifact Registry, Amazon ECR, Azure ACR, and Docker Hub:
| Google Artifact Registry | Amazon ECR | Azure ACR | Docker Hub |
|---|
| gcr.io/datadoghq | public.ecr.aws/datadog | datadoghq.azurecr.io | docker.io/datadog |
By default, the Cluster Agent image is pulled from Google Artifact Registry (gcr.io/datadoghq). If Artifact Registry is not accessible in your deployment region, use another registry.
Docker Hub is subject to image pull rate limits. If you are not a Docker Hub customer, Datadog recommends that you update your Datadog Agent and Cluster Agent configuration to pull from GCR or ECR. For instructions, see
Changing your container registry.
Minimum Agent and Cluster Agent versions
For optimal compatibility Datadog recommends to keep your Cluster Agent and Agent on matching versions. For a full support matrix of Kubernetes versions and Datadog versions see the Kubernetes installation page.
This section includes the following topics:
Monitoring the Cluster Agent
The Datadog Agent includes an integration that automatically monitors the Cluster Agent. The integration runs on the regular Datadog Agent pod that is on the same node as the Cluster Agent. It will not run in the Cluster Agent itself. Refer to the Datadog Cluster Agent integration documentation for details.
Further Reading
Additional helpful documentation, links, and articles:
