Amazon ECS and Thanos Integration

Input and output integration overview

The Amazon ECS Input Plugin enables Telegraf to gather metrics from AWS ECS containers, providing detailed insights into container performance and resource usage.

This plugin sends metrics from Telegraf to Thanos using the Prometheus remote write protocol over HTTP, allowing efficient and scalable ingestion into Thanos Receive components.

Integration details

Amazon ECS

The Amazon ECS plugin for Telegraf is designed to collect metrics from ECS (Elastic Container Service) tasks running on AWS Fargate or EC2 instances. By utilizing the ECS metadata and stats API endpoints (v2 and v3), it fetches real-time information about container performance and health within a task. This plugin operates within the same task as the inspected workload, ensuring seamless access to metadata and statistics. Notably, it incorporates ECS-specific features that distinguish it from the Docker input plugin, such as handling unique ECS metadata formats and statistics. Users can include or exclude specific containers and adjust which container states to monitor, along with defining tag options for ECS labels. This flexibility allows for a tailored monitoring experience that aligns with the specific needs of an ECS environment, thereby enhancing observability and control over containerized applications.

Thanos

Telegraf’s HTTP plugin can send metrics directly to Thanos via its Remote Write-compatible Receive component. By setting the data format to prometheusremotewrite, Telegraf can serialize metrics into the same protobuf-based format used by native Prometheus clients. This setup enables high-throughput, low-latency metric ingestion into Thanos, facilitating centralized observability at scale. It is particularly useful in hybrid environments where Telegraf is collecting metrics from systems outside Prometheus’ native reach, such as SNMP devices, Windows hosts, or custom apps, and streams them directly to Thanos for long-term storage and global querying.

Configuration

Amazon ECS

[[inputs.ecs]]
  # endpoint_url = ""
  # container_name_include = []
  # container_name_exclude = []
  # container_status_include = []
  # container_status_exclude = []
  ecs_label_include = [ "com.amazonaws.ecs.*" ]
  ecs_label_exclude = []
  # timeout = "5s"

[[inputs.ecs]]
  endpoint_url = "http://169.254.170.2"
  # container_name_include = []
  # container_name_exclude = []
  # container_status_include = []
  # container_status_exclude = []
  ecs_label_include = [ "com.amazonaws.ecs.*" ]
  ecs_label_exclude = []
  # timeout = "5s"

Thanos

[[outputs.http]]
  ## Thanos Receive endpoint for remote write
  url = "http://thanos-receive.example.com/api/v1/receive"

  ## HTTP method
  method = "POST"

  ## Data format set to Prometheus remote write
  data_format = "prometheusremotewrite"

  ## Optional headers (authorization, etc.)
  # [outputs.http.headers]
  #   Authorization = "Bearer YOUR_TOKEN"

  ## Optional TLS configuration
  # tls_ca = "/path/to/ca.pem"
  # tls_cert = "/path/to/cert.pem"
  # tls_key = "/path/to/key.pem"
  # insecure_skip_verify = false

  ## Request timeout
  timeout = "10s"

Input and output integration examples

Amazon ECS

1. Dynamic Container Monitoring: Use the Amazon ECS plugin to monitor container health dynamically within an autoscaling ECS architecture. As new containers spin up or down, the plugin will automatically adjust the metrics it collects, ensuring that each container’s performance data is captured efficiently without manual configuration.

2. Custom Resource Allocation Alerts: Implement the ECS plugin to establish thresholds for resource usage per container. By integrating with notification systems, teams can receive alerts when a container’s CPU or memory usage exceeds predefined limits, enabling proactive resource management and maintaining application performance.

3. Cost-Optimization Dashboard: Leverage the metrics gathered from the ECS plugin to create a dashboard that visualizes resource usage and costs associated with each container. This insight allows organizations to identify underutilized resources, optimizing costs associated with their container infrastructure, thus driving financial efficiency in cloud operations.

4. Advanced Container Security Monitoring: Utilize this plugin in conjunction with security tools to monitor ECS container metrics for anomalies. By continuously analyzing usage patterns, any sudden spikes or irregular behaviors can be detected, prompting automated security responses and maintaining system integrity.

Thanos

1. Agentless Cloud Monitoring: Deploy Telegraf agents across cloud VMs to collect system and application metrics, then stream them directly into Thanos using Remote Write. This provides centralized observability without requiring Prometheus nodes at each location.

2. Scalable Windows Host Monitoring: Use Telegraf on Windows machines to collect OS-level metrics and send them via Remote Write to Thanos Receive. This enables observability across heterogeneous environments with native Prometheus support only on Linux.

3. Cross-Region Metrics Federation: Telegraf agents in multiple geographic regions can push data to region-local Thanos Receivers using this plugin. From there, Thanos can deduplicate and query metrics globally, reducing latency and network egress costs.

4. Integrating Third-Party Data into Thanos: Collect metrics from custom telemetry sources such as REST APIs or proprietary logs using Telegraf inputs and forward them to Thanos via Remote Write. This brings non-native data into a Prometheus-compatible, long-term analytics pipeline.

Feedback

Thank you for being part of our community! If you have any general feedback or found any bugs on these pages, we welcome and encourage your input. Please submit your feedback in the InfluxDB community Slack.