---
title: Containerd module
description: Containerd module collects cpu, memory and blkio statistics about running containers controlled by containerd runtime. The current metricsets are: cpu,...
url: https://www.elastic.co/docs/reference/beats/metricbeat/metricbeat-module-containerd
products:
  - Beats
  - Metricbeat
applies_to:
  - Elastic Stack: Beta
---

# Containerd module
<warning>
  This functionality is in beta and is subject to change. The design and code is less mature than official GA features and is being provided as-is with no warranties. Beta features are not subject to the support SLA of official GA features.
</warning>

<admonition title="Prefer to use Elastic Agent for this use case?">
  Refer to the [Elastic Integrations documentation](https://www.elastic.co/docs/reference/integrations/containerd).
  <dropdown title="Learn more">
    Elastic Agent is a single, unified way to add monitoring for logs, metrics, and other types of data to a host. It can also protect hosts from security threats, query data from operating systems, forward data from remote services or hardware, and more. Refer to the documentation for a detailed [comparison of Beats and Elastic Agent](https://www.elastic.co/docs/reference/fleet).
  </dropdown>
</admonition>

Containerd module collects cpu, memory and blkio statistics about running containers controlled by containerd runtime.
The current metricsets are: `cpu`, `blkio` and `memory` and are enabled by default.

## Prerequisites

`Containerd` daemon has to be configured to provide metrics before enabling containerd module.
In the configuration file located in `/etc/containerd/config.toml` metrics endpoint needs to be set and containerd daemon needs to be restarted.
```
[metrics]
    address = "127.0.0.1:1338"
```


## Compatibility

The Containerd module is tested with the following versions of Containerd: v1.5.2

## Module-specific configuration notes

For cpu metricset if `calcpct.cpu` setting is set to true, cpu usage percentages will be calculated and more specifically fields `containerd.cpu.usage.total.pct`, `containerd.cpu.usage.kernel.pct`, `containerd.cpu.usage.user.pct`. Default value is true.
For memory metricset if `calcpct.memory` setting is set to true, memory usage percentages will be calculated and more specifically fields `containerd.memory.usage.pct` and  `containerd.memory.workingset.pct`. Default value is true.

## Example configuration

The Containerd module supports the standard configuration options that are described in [Modules](https://www.elastic.co/docs/reference/beats/metricbeat/configuration-metricbeat). Here is an example configuration:
```yaml
metricbeat.modules:
- module: containerd
  metricsets: ["cpu", "memory", "blkio"]
  period: 10s
  # containerd metrics endpoint is configured in /etc/containerd/config.toml
  # Metrics endpoint does not listen by default
  # https://github.com/containerd/containerd/blob/main/docs/man/containerd-config.toml.5.md
  hosts: ["localhost:1338"]
  # if set to true, cpu and memory usage percentages will be calculated. Default is true
  calcpct.cpu: true
  calcpct.memory: true
  #metrics_path: "v1/metrics"
```


## Metricsets

The following metricsets are available:
- [blkio](https://www.elastic.co/docs/reference/beats/metricbeat/metricbeat-metricset-containerd-blkio)  <applies-to>Elastic Stack: Beta</applies-to>
- [cpu](https://www.elastic.co/docs/reference/beats/metricbeat/metricbeat-metricset-containerd-cpu)  <applies-to>Elastic Stack: Beta</applies-to>
- [memory](https://www.elastic.co/docs/reference/beats/metricbeat/metricbeat-metricset-containerd-memory)  <applies-to>Elastic Stack: Beta</applies-to>