This tutorial demonstrates how to deploy OpenTelemetry to AWS ECS-EC2 to facilitate the collection of logs, metrics, and traces.
Telemetry is sent to Coralogix via the Coralogix Exporter, which allows for the use of enrichments such as dynamic application
or subsystem
name, defined using application_name_attributes
and subsystem_name_attributes
, respectively. Find out more here.
This implementation utilizes the wrapper image coralogixrepo/otel-coralogix-ecs-ec2, based on the official OpenTelemetry contrib image. The wrapper image is used to dynamically apply the OpenTelemetry configuration at runtime from an environment variable.
The image configuration utilizes the otlp receiver for both HTTP (on 4318) and GRPC (on 4317). Data can be sent using either endpoint.
The OpenTelemetry configuration for the agent is stored in a Base64 encoded environment variable and applied at runtime. This allows you to dynamically pass any configuration values you choose as a parameter to CloudFormation.
The following configuration files work directly with the coralogixrepo/otel-coralogix-ecs-wrapper docker image for ECS:
Create other configurations by combining logs, metrics and/or traces.
If you already have an existing ECS cluster, skip this step.
Deploy a new cluster:
ecs-cli up --region <region> --keypair <your-key-pair> --cluster <cluster-name> --size <no. of instances> --capability-iam
Notes:
--keypair
flag is not mandatory. However, if not supplied, you will not be able to connect to any of the instances in the cluster via SSH. Create a key pair using the command below:aws ec2 create-key-pair --key-name MyKeyPair --query 'KeyMaterial' --output text > MyKeyPair.pem
ecs-cli up
command will leverage CloudFormation to create an ECS cluster. ecs-cli
using the following command:ecs-cli up --help
STEP 1. Once an ECS cluster has been deployed, deploy a task definition to be used by ECS to create an ECS service to run OpenTelemetry.
STEP 2. Deploy this CloudFormation template, with necessary parameters provided:
STEP 3. Once the template is deployed successfully, verify that the container is running:
ecs-cli ps --region <region> -c <cluster name>
Github | Official OpenTelemetry Collector with Coralogix Exporter |
Features | Coralogix APM features APM using Amazon EC2 |
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 [email protected].