AWS ECS-EC2 OpenTelemetry Integration
Overview
The OpenTelemetry integration for AWS ECS on EC2 provides complete observability for workloads running on ECS clusters backed by Amazon EC2 instances.
This integration guides you through a UI-based configuration and deployment flow that generates a deployment template and commands. You can deploy using CloudFormation (using CLI/creating a CloudFormation stack directly through the UI) or Terraform, and enable observability features with simple toggles—no manual YAML editing required. Hosting your configuration on S3 enables you to streamline configuration sync and update processes.
Integration overview
- Application monitoring - Collect traces, generate metrics from spans, apply sampling strategies, and enable profiling—all to monitor application performance efficiently.
- Advanced log and event handling - Ingest structured events, support multiline logs, and reduce payload size by removing unused metadata.
- Infrastructure & metrics - Capture system metrics at all levels—hosts, processes, clusters—alongside StatsD ingestion and internal collector telemetry.
- Platform & fleet controls - Enable infrastructure explorer for infrastructure visibility and manage collectors centrally through OpAMP-based fleet management.
Coralogix features enabled
Unlock deep observability and cost-efficient monitoring with a single toggle—no manual configuration needed.
- APM - End-to-end tracing using OpenTelemetry, including head sampling strategies to control volume and focus on high-value traces. Automatically generates span metrics to transform and aggregate trace data into metrics, ensuring 100% APM metric coverage regardless of the sampling strategy.
- Logs and metrics - Collection of enriched application logs, multiline stack traces, and system metrics from hosts, processes, and clusters. Once ingested, logs and metrics become a powerful input across the Coralogix platform—powering alerts, dashboards, and many other features.
- Infrastructure Explorer - Explore a live, searchable inventory of your AWS EC2 resource metadata. Quickly audit costs, track accountability, and navigate complex systems without relying on spreadsheets or static dashboards.
- Fleet Management - Centralize control of your OpenTelemetry agents by monitoring, configuring, and maintaining them at scale.
Prerequisites
CloudFormation
Note
- This integration is incompatible with Fargate - this agent pattern is EC2-only.
- Uploading the ECS-EC2 template to S3 is required.
- ECS cluster (EC2 launch type) with at least one EC2 container instance joined
- A Security Group allowing app tasks to reach the agent on
4317 (gRPC)and/or4318 (HTTP) - AWS credentials configured for deployment
Terraform
Terraform provider requirements
| Provider | Version |
|---|---|
| terraform | >= 1.9.0 |
| aws | >= 5.24.0 |
| random | >= 3.6.0 |
Installation instructions
Follow the steps below to deploy the Coralogix AWS ECS on EC2 OTel integration in your cluster.
1. Set up the integration in Coralogix
- Access Integrations.
- From the Integrations section, select AWS ECS-EC2.
On the AWS ECS-EC2 integration page, click + Setup Collector to create a new integration. For existing integrations, click the arrow icon on the right to upgrade to the new version.
Provide a name to identify this integration (especially useful if you have multiple clusters).
- Enter a Send-Your-Data API key or click Create a New Key to generate a new dedicated API key.
- Enter your ECS cluster name in the Cluster Name field.
- Enter the AWS region of your cluster.
- Select the operating system that your ECS workloads are deployed on.
- Click Next.
2. Select observability features
- Toggle the observability features you want to enable through this integration. Toggling a feature will include the relevant fields and values in your resulting values.yaml configuration file.
- Click Save.
3. Review
Review and copy the generated configuration to your clipboard or download the coralogix-otel-config.yaml as a file for version control and reuse. When finished, click Next.
4. Deploy
Follow the UI deployment instructions, depending on your deployment method of choice. After completing the instructions, click Complete setup.
Limitations
- Coralogix places a hard limit of 10MB of data to our OpenTelemetry Endpoints, with a recommendation of 2MB.
- Metric names must be a maximum of 255 characters.
- Attribute keys for metric data must be a maximum of 255 characters.
Next steps
Advanced configuration instructions can be found here.
Support
Need help?
Our world-class customer success team is available 24/7 to walk you through your setup and answer any questions that may come up.
Feel free to reach out to us via our in-app chat or by sending us an email at support@coralogix.com.