# Kedify Agent and data collection

The Agent connects a Kubernetes cluster to the Kedify service through an outbound authenticated gRPC connection. It manages enabled KEDA and HTTP Scaler releases, HTTP traffic autowiring, and collection of component and selected workload metrics.

Install one Agent per connected cluster using [Helm](https://docs.kedify.io/installation/helm/). Optional capabilities, including [KPA](https://docs.kedify.io/features/kedify-pod-autoscaler/) and [Insights](https://docs.kedify.io/features/insights/), have separate enablement and collection settings.

### Configuration

Use [Helm values](https://docs.kedify.io/reference/helm-values/) for enablement paths, environment mappings and chart defaults; use [KedifyConfiguration](https://docs.kedify.io/reference/kubernetes-api/kedifyconfiguration/) for installation resource fields. Select compatible releases before enabling an optional controller.

### Container Metrics for Resource Recommendations

The Agent reads selected container utilization from the Kubernetes Metrics API and sends it for recommendation processing. Label-gated namespaces and explicit namespace overrides determine collection scope. Follow [Insights settings](https://docs.kedify.io/features/insights/) to enable, verify or stop collection; this does not enable PRA or PRP automatically.

### API Key

The Agent uses a credential to authenticate its outbound service connection. Obtain and store it through the [Helm installation credential flow](https://docs.kedify.io/installation/helm/#getting-api-key) and your approved secret owner. Base64 is encoding, not encryption; do not paste real keys into documentation or shared diagnostics. [Access, telemetry and connectivity boundaries](https://docs.kedify.io/security-and-compliance/access-and-data/) explains the trust/data responsibilities.

For signal-to-workload inspection, use [Workload diagnostics](https://docs.kedify.io/troubleshooting/workload-scaling/).

Last updated: Sep 21, 2026

---
Canonical: https://docs.kedify.io/concepts/kedify-agent/
Source: src/content/docs/concepts/kedify-agent.md
Documentation index: https://docs.kedify.io/llms.txt