Welcome to the AWS Observability Accelerator for Terraform!
The AWS Observability Accelerator for Terraform is a set of opinionated modules to help you set up observability for your AWS environments with AWS-managed observability services such as Amazon CloudWatch, Amazon Managed Service for Prometheus, Amazon Managed Grafana, and OpenTelemetry.
We provide curated metrics, logs, traces collection, alerting rules and Grafana dashboards for your AWS infrastructure and custom applications.
To explore the complete project documentation, please visit our documentation site.
The EKS monitoring module offers three collector profiles. Pick the one that matches your observability backend:
| Profile | Backend | Collector | Best for |
|---|---|---|---|
cloudwatch-otlp |
Amazon CloudWatch | OpenTelemetry Collector (Helm) | CloudWatch-native observability with OTLP |
managed-metrics |
Amazon Managed Prometheus | AMP Managed Collector (agentless) | Agentless setup, no in-cluster collector to manage |
self-managed-amp |
Amazon Managed Prometheus | OpenTelemetry Collector (Helm) | Full control over collection pipeline, traces + logs |
All profiles deploy kube-state-metrics and node-exporter for infrastructure metrics, and provision Grafana dashboards for cluster visibility.
module "eks_monitoring" {
source = "github.com/aws-observability/terraform-aws-observability-accelerator//modules/eks-monitoring?ref=v3.0.0"
providers = { grafana = grafana }
collector_profile = "cloudwatch-otlp" # or "managed-metrics", "self-managed-amp"
eks_cluster_id = "my-cluster"
cloudwatch_metrics_endpoint = "https://monitoring.us-west-2.amazonaws.com/v1/metrics"
cloudwatch_log_group = "/eks/my-cluster/otel"
cloudwatch_log_stream = "collector"
}See the EKS monitoring guide for full walkthroughs of each profile.
-
EKS Monitoring with Enhanced CloudWatch Container Insights - Deep visibility into EKS using Amazon CloudWatch for metrics collection, aggregation, and insights summaries. Includes support for CloudWatch Application Signals (preview)
-
ECS Monitoring on EC2 with AWS-Managed Open Source - Collect metrics, traces, and logs for ECS on EC2 and send them to a Managed Prometheus workspace, X-Ray, and CloudWatch Logs. Includes pre-built Grafana dashboards for key metrics and logs.
-
Managed Prometheus Monitoring - Automated observability for Amazon Managed Service for Prometheus workspaces, including a Grafana dashboard, CloudWatch monitoring, and service quota alarms.
To gain deep visibility into your workloads and environments, AWS proposes a set of secure, scalable, highly available, production-grade managed open source services such as Amazon Managed Service for Prometheus, Amazon Managed Grafana and Amazon OpenSearch.
AWS customers have asked for best-practices and guidance to collect metrics, logs and traces from their containerized applications and microservices with ease of deployment. Customers can use the AWS Observability Accelerator to configure their metrics and traces collection to have opinionated dashboards and alerts available in only minutes.
AWS Observability Accelerator for Terraform is maintained by AWS Solution Architects. It is not part of an AWS service and support is provided best-effort by the AWS Observability Accelerator community.
To post feedback, submit feature ideas, or report bugs, please use the Issues section of this GitHub repo.
If you are interested in contributing, see the Contribution guide.
See CONTRIBUTING for more information.
Apache-2.0 Licensed. See LICENSE.