AWS Open Distro for OpenTelemetry

Getting Started with ECS Configurations

Getting Started with ECS Configurations

In this tutorial we will provide a step-by-step walk-through of collecting ECS metrics and traces using the ADOT Collector to send to the AWS monitoring service destination of your choice. In this tutorial the monitoring destinations include AWS X-Ray for traces, Amazon CloudWatch, and Amazon Managed Service for Prometheus (AMP) for metrics.

This guide also provides a walk through of the setup and configuration needed for the ADOT Collector to receive and send telemetry data. We will provide an example of the end-to-end data path for ECS and the pipeline to collect and send metrics to Amazon CloudWatch or Amazon Managed Service for Prometheus (AMP), Amazon Managed Grafana (AMG) and send traces to X-Ray.

What is ECS?

Amazon Elastic Container Service (Amazon ECS) is a highly scalable, fast, container management service that makes it easy to run, stop, and manage Docker containers on a cluster of Amazon EC2 instances.

What is ADOT Collector?

AWS Distro for OpenTelemetry Collector (ADOT Collector) is a AWS supported version of the upstream OpenTelemetry Collector. It is fully compatible with AWS computing platforms including EC2, ECS and EKS. It enables users to send telemetry data to Amazon CloudWatch, AWS X-Ray, Amazon Managed Service for Prometheus (AMP), and other services.

End-to-End Data Path for ECS


Types of metrics being collected

The metrics that are listed in the table below are exported from the java-sample-app as an example, however your results may vary depending on your application.

http_server_active_requestsHTTP requests are messages sent by the client to initiate an action on the server
http_server_duration_countThe average amount of time it takes for a queried metric to deliver
queuesizeSize of HTTP queue requests that provides time for new connections to become available on the server,
runtime_jvm_gc_countJava virtual machine runtime metrics
runtime_jvm_gc_timeJava virtual machine runtime metrics
runtime_jvm_memory_areaJava virtual machine runtime metrics
runtime_jvm_memory_poolJava virtual machine runtime metrics
spansExportedByExporterNumber of spans that are exported by the exporter
spansSeenByExporterNumber of spans that are seen by the exporter

Understanding your Configurations


Prerequisites and Configuration Setup Using ECS Console

ECS Console Setup

Questions or Bugs?

Technical documentation is available on the AWS Distro for OpenTelemetry developer site. To learn more about how you can use AWS Distro for OpenTelemetry (ADOT) to collect data for your observability solution, check out the hands-on AWS Observability workshop. Please file an issue if you have questions or request for enhancements in the ADOT distribution, features, or components.