Overview
Amazon EKS (Elastic Kubernetes Service) is a managed Kubernetes service that makes it easy to run Kubernetes on AWS. SigNoz helps you monitor cluster health, pod performance, and container metrics.
Prerequisites
- AWS account with appropriate permissions
- SigNoz Cloud account or Self-Hosted SigNoz
- An EKS cluster running
K8s-Infra Helm Chart
The K8s-Infra Helm chart provides comprehensive EKS monitoring, collecting all logs and metrics including pod-level metrics, node metrics, container logs, and more. This method works for both SigNoz Cloud and Self-Hosted.
What You Can Collect
| Data Type | Description |
|---|---|
| Logs | Container logs from all pods |
| Pod Metrics | CPU, memory, network usage per pod |
| Node Metrics | Node-level CPU, memory, disk, network |
| Cluster Metrics | Overall cluster health and resources |
| Kubernetes Events | Cluster events and state changes |
Setup
For complete installation instructions, follow the K8s-Infra Installation Guide.
The setup involves:
- Add the SigNoz Helm repository and update your local cache
- Create an override-values.yaml with EKS-specific configuration (set
global.cloud: awsto enable EKS resource detection) - Install the chart using Helm
- Verify data in SigNoz
Dashboard Templates
Explore pre-built Kubernetes Dashboards for pod, node, and cluster metrics.
For advanced configuration (filtering logs, Prometheus scraping, etc.), see the K8s-Infra Configuration Guide.
Validate
Once installed, your EKS data will appear in:
- Logs: Navigate to Logs tab → Logs Explorer
- Metrics: Navigate to Infrastructure Monitoring → Kubernetes to see pods, nodes, namespaces, and deployments
Next Steps
- K8s-Infra Installation Guide – Detailed installation instructions.
- Configure K8s-Infra – Customize log filtering, metrics collection, and more.
- Infrastructure Monitoring Overview – Learn about the Infrastructure Monitoring module features.
One-Click Integration
One-Click Integration is available for SigNoz Cloud only. It collects only cluster-level metrics via AWS Container Insights and does not collect pod logs, node metrics, or detailed container metrics. For comprehensive EKS monitoring, use the K8s-Infra Helm Chart instead. This method uses AWS CloudFormation and CloudWatch, which may incur additional AWS charges.
Step 1: Connect Your AWS Account
Follow the One-Click AWS Integrations Guide to:
- Deploy the CloudFormation stack
- Connect your AWS account to SigNoz
Step 2: Enable EKS Monitoring
Once connected, SigNoz will auto-discover your EKS clusters and begin collecting Container Insights metrics from CloudWatch.
Ensure Container Insights is enabled on your EKS cluster for metrics to be available.
What's Collected
| Metric | Description |
|---|---|
pod_status_running | Number of running pods |
pod_status_pending | Number of pending pods |
pod_status_failed | Number of failed pods |
pod_number_of_container_restarts | Container restart counts |
pod_number_of_containers | Total container count |
status_replicas_available | Available replicas |
status_replicas_unavailable | Unavailable replicas |
Pre-built Dashboards
Navigate to Dashboards and search for "EKS" to find automatically imported dashboards:
- EKS Control Plane Overview: Monitor control plane health
- EKS Container Insights Overview: Track pod and container status
