AWS ECS Metrics

Configuration Options

Required Options

type(required)

The component type. This is a required field for all components and tells Vector which component to use.

TypeSyntaxDefaultExample
stringliteral["aws_ecs_metrics"]

Advanced Options

endpoint(optional)

Base URI of the task metadata endpoint. If empty, the URI will be automatically discovered based on the latest version detected. The version 2 endpoint base URI is 169.254.170.2/v2/. The version 3 endpoint base URI is stored in the environment variable ECS_CONTAINER_METADATA_URI. The version 4 endpoint base URI is stored in the environment variable ECS_CONTAINER_METADATA_URI_V4.

TypeSyntaxDefaultExample
stringliteral${ECS_CONTAINER_METADATA_URI_V4}
namespace(optional)

The namespace of the metric. Disabled if empty.

TypeSyntaxDefaultExample
stringliteralawsecs
scrape_interval_secs(optional)

The interval between scrapes, in seconds.

TypeSyntaxDefaultExample
uint15
version(optional)

The version of the metadata endpoint. If empty, the version is automatically discovered based on environment variables.

TypeSyntaxDefaultExample
stringliteralv4

How it Works

State

This component is stateless, meaning its behavior is consistent across each input.

Context

By default, the aws_ecs_metrics source augments events with helpful context keys.