Skip to main content

Awscontainerinsight Receiver

Status Available in: contrib Maintainers: @Aneurysm9, @pxaws Source: opentelemetry-collector-contrib

Supported Telemetry

Metrics

Overview

Overview

AWS Container Insights Receiver (awscontainerinsight) is an AWS specific receiver that supports CloudWatch Container Insights. CloudWatch Container Insights collect, aggregate, and summarize metrics and logs from your containerized applications and microservices. Data are collected as as performance log events using embedded metric format. From the EMF data, Amazon CloudWatch can create the aggregated CloudWatch metrics at the cluster, node, pod, task, and service level. CloudWatch Container Insights has been supported by ECS Agent and CloudWatch Agent to collect infrastructure metrics for many resources such as such as CPU, memory, disk, and network. To migrate existing customers to use OpenTelemetry, AWS Container Insights Receiver (together with CloudWatch EMF Exporter) aims to support the same CloudWatch Container Insights experience for the following platforms:
  • Amazon ECS
  • Amazon EKS
  • Kubernetes platforms on Amazon EC2

Design of AWS Container Insights Receiver

See the design doc

Configuration

Example configuration:
There is no need to provide any parameters since they are all optional. collection_interval (optional) The interval at which metrics should be collected. The default is 60 second. container_orchestrator (optional) The type of container orchestration service, e.g. eks or ecs. The default is eks. add_service_as_attribute (optional) Whether to add the associated service name as attribute. The default is true prefer_full_pod_name (optional) The “PodName” attribute is set based on the name of the relevant controllers like Daemonset, Job, ReplicaSet, ReplicationController, … If it cannot be set that way and PrefFullPodName is true, the “PodName” attribute is set to the pod’s own name. The default value is false. add_full_pod_name_metric_label (optional) The “FullPodName” attribute is the pod name including suffix. If false FullPodName label is not added. The default value is false

Sample configuration for Container Insights

This is a sample configuration for AWS Container Insights using the awscontainerinsight and awsemfexporter for an EKS cluster:
To deploy to an EKS cluster

Available Metrics and Resource Attributes

Cluster







Cluster Namespace







Cluster Service







Node







Node Disk IO







Node Filesystem







Node Network







Pod



Pod Network







Container



The attribute container_status_reason is present only when container_status is in “Waiting” or “Terminated” State. The attribute container_last_termination_reason is present only when container_status is in “Terminated” State. This is a sample configuration for AWS Container Insights using the awscontainerinsight and awsemfexporter for an ECS cluster to collect the instance level metrics:
To deploy to an ECS cluster check this doc for details

Available Metrics and Resource Attributes

Instance







Instance Disk IO







Instance Filesystem







Instance Network







Warnings

Root permissions

When using this component, the collector process needs root permission to be able to read the content of the files located in the following locations:
  • /
  • /var/run/docker.sock
  • /var/lib/docker
  • /run/containerd/containerd.sock
  • /sys
  • /dev/disk
This requirement comes from the fact that this component is based on cAdvisor.

Configuration

Example Configuration


Last generated: 2026-08-24