﻿---
title: AWS Fargate fields
description: awsfargate module collects AWS fargate metrics from task metadata endpoint. task_stats contains the metrics that were scraped from AWS fargate task stats...
url: https://www.elastic.co/elastic/docs-builder/docs/2746/reference/beats/metricbeat/exported-fields-awsfargate
products:
  - Beats
  - Metricbeat
applies_to:
  - Elastic Cloud Serverless: Beta
  - Elastic Stack: Beta
---

# AWS Fargate fields
`awsfargate` module collects AWS fargate metrics from task metadata endpoint.
<definitions>
  <definition term="awsfargate.container.labels.com_amazonaws_ecs_cluster">
    ECS Cluster name
    type: keyword
  </definition>
  <definition term="awsfargate.container.labels.com_amazonaws_ecs_container-name">
    ECS container name
    type: keyword
  </definition>
  <definition term="awsfargate.container.labels.com_amazonaws_ecs_task-arn">
    ECS task ARN
    type: keyword
  </definition>
  <definition term="awsfargate.container.labels.com_amazonaws_ecs_task-definition-family">
    ECS task definition family
    type: keyword
  </definition>
  <definition term="awsfargate.container.labels.com_amazonaws_ecs_task-definition-version">
    ECS task definition version
    type: keyword
  </definition>
</definitions>


## task_stats

<applies-to>
  - Elastic Stack: Beta
</applies-to>

`task_stats` contains the metrics that were scraped from AWS fargate task stats ${ECS_CONTAINER_METADATA_URI_V4}/task/stats metadata endpoint.
<definitions>
  <definition term="awsfargate.task_stats.cluster_name">
    Cluster name (Pippero)
    type: keyword
  </definition>
  <definition term="awsfargate.task_stats.task_name">
    ECS task name
    type: keyword
  </definition>
  <definition term="awsfargate.task_stats.identifier">
    Container identifier across tasks and clusters, which equals to container.name + '/' + container.id.
    type: keyword
  </definition>
  <definition term="awsfargate.task_stats.task_desired_status">
    The desired status for the task from Amazon ECS.
    type: keyword
  </definition>
  <definition term="awsfargate.task_stats.task_known_status">
    The known status for the task from Amazon ECS.
    type: keyword
  </definition>
  <definition term="awsfargate.task_stats.memory_hard_limit">
    The Hard Memory Limit for the task from Amazon ECS.
    type: scaled_float
  </definition>
</definitions>


## cpu

Runtime CPU metrics.
<definitions>
  <definition term="awsfargate.task_stats.cpu.kernel.pct">
    Percentage of time in kernel space, expressed as a value between 0 and 1.
    type: scaled_float
    format: percent
  </definition>
  <definition term="awsfargate.task_stats.cpu.kernel.norm.pct">
    Percentage of time in kernel space normalized by the number of CPU cores, expressed as a value between 0 and 1.
    type: scaled_float
    format: percent
  </definition>
  <definition term="awsfargate.task_stats.cpu.kernel.ticks">
    CPU ticks in kernel space.
    type: long
  </definition>
  <definition term="awsfargate.task_stats.cpu.system.pct">
    Percentage of total CPU time in the system, expressed as a value between 0 and 1.
    type: scaled_float
    format: percent
  </definition>
  <definition term="awsfargate.task_stats.cpu.system.norm.pct">
    Percentage of total CPU time in the system normalized by the number of CPU cores, expressed as a value between 0 and 1.
    type: scaled_float
    format: percent
  </definition>
  <definition term="awsfargate.task_stats.cpu.system.ticks">
    CPU system ticks.
    type: long
  </definition>
  <definition term="awsfargate.task_stats.cpu.user.pct">
    Percentage of time in user space, expressed as a value between 0 and 1.
    type: scaled_float
    format: percent
  </definition>
  <definition term="awsfargate.task_stats.cpu.user.norm.pct">
    Percentage of time in user space normalized by the number of CPU cores, expressed as a value between 0 and 1.
    type: scaled_float
    format: percent
  </definition>
  <definition term="awsfargate.task_stats.cpu.user.ticks">
    CPU ticks in user space.
    type: long
  </definition>
  <definition term="awsfargate.task_stats.cpu.total.pct">
    Total CPU usage, expressed as a value between 0 and 1.
    type: scaled_float
    format: percent
  </definition>
  <definition term="awsfargate.task_stats.cpu.total.norm.pct">
    Total CPU usage normalized by the number of CPU cores, expressed as a value between 0 and 1.
    type: scaled_float
    format: percent
  </definition>
</definitions>


## diskio

Disk I/O metrics.

## read

Accumulated reads during the life of the container
<definitions>
  <definition term="awsfargate.task_stats.diskio.read.ops">
    Number of reads during the life of the container
    type: long
  </definition>
  <definition term="awsfargate.task_stats.diskio.read.bytes">
    Bytes read during the life of the container
    type: long
    format: bytes
  </definition>
  <definition term="awsfargate.task_stats.diskio.read.rate">
    Number of current reads per second
    type: long
  </definition>
  <definition term="awsfargate.task_stats.diskio.read.service_time">
    Total time to service IO requests, in nanoseconds
    type: long
  </definition>
  <definition term="awsfargate.task_stats.diskio.read.wait_time">
    Total time requests spent waiting in queues for service, in nanoseconds
    type: long
  </definition>
  <definition term="awsfargate.task_stats.diskio.read.queued">
    Total number of queued requests
    type: long
  </definition>
  <definition term="awsfargate.task_stats.diskio.reads Elastic Stack: Deprecated since 6.4">
    Number of current reads per second
    type: scaled_float
  </definition>
</definitions>


## write

Accumulated writes during the life of the container
<definitions>
  <definition term="awsfargate.task_stats.diskio.write.ops">
    Number of writes during the life of the container
    type: long
  </definition>
  <definition term="awsfargate.task_stats.diskio.write.bytes">
    Bytes written during the life of the container
    type: long
    format: bytes
  </definition>
  <definition term="awsfargate.task_stats.diskio.write.rate">
    Number of current writes per second
    type: long
  </definition>
  <definition term="awsfargate.task_stats.diskio.write.service_time">
    Total time to service IO requests, in nanoseconds
    type: long
  </definition>
  <definition term="awsfargate.task_stats.diskio.write.wait_time">
    Total time requests spent waiting in queues for service, in nanoseconds
    type: long
  </definition>
  <definition term="awsfargate.task_stats.diskio.write.queued">
    Total number of queued requests
    type: long
  </definition>
  <definition term="awsfargate.task_stats.diskio.writes Elastic Stack: Deprecated since 6.4">
    Number of current writes per second
    type: scaled_float
  </definition>
</definitions>


## summary

Accumulated reads and writes during the life of the container
<definitions>
  <definition term="awsfargate.task_stats.diskio.summary.ops">
    Number of I/O operations during the life of the container
    type: long
  </definition>
  <definition term="awsfargate.task_stats.diskio.summary.bytes">
    Bytes read and written during the life of the container
    type: long
    format: bytes
  </definition>
  <definition term="awsfargate.task_stats.diskio.summary.rate">
    Number of current operations per second
    type: long
  </definition>
  <definition term="awsfargate.task_stats.diskio.summary.service_time">
    Total time to service IO requests, in nanoseconds
    type: long
  </definition>
  <definition term="awsfargate.task_stats.diskio.summary.wait_time">
    Total time requests spent waiting in queues for service, in nanoseconds
    type: long
  </definition>
  <definition term="awsfargate.task_stats.diskio.summary.queued">
    Total number of queued requests
    type: long
  </definition>
  <definition term="awsfargate.task_stats.diskio.total Elastic Stack: Deprecated since 6.4">
    Number of reads and writes per second
    type: scaled_float
  </definition>
</definitions>


## memory

Memory metrics.
<definitions>
  <definition term="awsfargate.task_stats.memory.stats">
    Raw memory stats from the cgroups memory.stat interface
    type: object
  </definition>
</definitions>


## commit

Committed bytes on Windows
<definitions>
  <definition term="awsfargate.task_stats.memory.commit.total">
    Total bytes
    type: long
    format: bytes
  </definition>
  <definition term="awsfargate.task_stats.memory.commit.peak">
    Peak committed bytes on Windows
    type: long
    format: bytes
  </definition>
  <definition term="awsfargate.task_stats.memory.private_working_set.total">
    private working sets on Windows
    type: long
    format: bytes
  </definition>
  <definition term="awsfargate.task_stats.memory.fail.count">
    Fail counter.
    type: scaled_float
  </definition>
  <definition term="awsfargate.task_stats.memory.limit">
    Memory limit.
    type: long
    format: bytes
  </definition>
</definitions>


## rss

RSS memory stats.
<definitions>
  <definition term="awsfargate.task_stats.memory.rss.total">
    Total memory resident set size.
    type: long
    format: bytes
  </definition>
  <definition term="awsfargate.task_stats.memory.rss.pct">
    Memory resident set size percentage, expressed as a value between 0 and 1.
    type: scaled_float
    format: percent
  </definition>
</definitions>


## usage

Usage memory stats.
<definitions>
  <definition term="awsfargate.task_stats.memory.usage.max">
    Max memory usage.
    type: long
    format: bytes
  </definition>
  <definition term="awsfargate.task_stats.memory.usage.total">
    Total memory usage.
    type: long
    format: bytes
  </definition>
  <definition term="awsfargate.task_stats.network.*.inbound.bytes">
    Total number of incoming bytes.
    type: long
    format: bytes
  </definition>
  <definition term="awsfargate.task_stats.network.*.inbound.dropped">
    Total number of dropped incoming packets.
    type: long
  </definition>
  <definition term="awsfargate.task_stats.network.*.inbound.errors">
    Total errors on incoming packets.
    type: long
  </definition>
  <definition term="awsfargate.task_stats.network.*.inbound.packets">
    Total number of incoming packets.
    type: long
  </definition>
  <definition term="awsfargate.task_stats.network.*.outbound.bytes">
    Total number of incoming bytes.
    type: long
    format: bytes
  </definition>
  <definition term="awsfargate.task_stats.network.*.outbound.dropped">
    Total number of dropped incoming packets.
    type: long
  </definition>
  <definition term="awsfargate.task_stats.network.*.outbound.errors">
    Total errors on incoming packets.
    type: long
  </definition>
  <definition term="awsfargate.task_stats.network.*.outbound.packets">
    Total number of incoming packets.
    type: long
  </definition>
</definitions>