---
title: Podman Metrics
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: Docs > OpenTelemetry in Datadog > Integrations > Podman Metrics
---

> For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt).

# Podman Metrics

## Overview{% #overview %}

{% image
   source="https://docs.dd-static.net/images/opentelemetry/collector_exporter/podman_metrics.5f82e3ff16828462daa54f058b200ad7.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/opentelemetry/collector_exporter/podman_metrics.5f82e3ff16828462daa54f058b200ad7.png?auto=format&fit=max&w=850&dpr=2 2x"
   alt="The 'Containers - Overview' dashboard, showing metrics for CPU and Memory usage." /%}

The [Podman receiver](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/receiver/podmanreceiver) collects metrics that populate the [Containers - Overview](https://app.datadoghq.com/dash/integration/30657/containers---overview) dashboard.

This dashboard displays metrics from all container runtimes. To view your Podman data, use the runtime template variable at the top of the dashboard to select `podman`.

For more information, see the OpenTelemetry project documentation for the [Podman receiver](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/receiver/podmanreceiver).

## Setup{% #setup %}

This example uses component identifiers from OpenTelemetry Collector Contrib v0.154.0. For other versions or distributions, use the identifiers your distribution supports.

The Podman receiver reads the Podman API socket, so it doesn't run on Windows. Before you start, turn on the Podman API service: run `sudo systemctl enable --now podman.socket` for rootful Podman, or `systemctl --user enable --now podman.socket` for rootless Podman. Run the Collector as a user that can read the socket.

Add the following lines to your Collector configuration:

```yaml
receivers:
  podman_stats:
    endpoint: unix:///run/podman/podman.sock
```

This endpoint is the socket for rootful Podman. Podman runs rootless by default. For rootless Podman, set `endpoint` to `unix:///run/user/<UID>/podman/podman.sock`, and replace `<UID>` with the ID of the user that runs Podman.

Add `podman_stats` to the `receivers` list of the metrics pipeline in your configuration. Keep the processors already in that pipeline. The Datadog OTLP metrics intake accepts only delta metrics, and this receiver produces cumulative sums, so the pipeline needs `cumulativetodelta`. The [recommended Collector setup](https://docs.datadoghq.com/opentelemetry/setup/collector_exporter.md) includes it.

For all configuration options, see the [Podman receiver documentation](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/receiver/podmanreceiver).

## Data collected{% #data-collected %}

| OTEL                                               | DESCRIPTION                                                |
| -------------------------------------------------- | ---------------------------------------------------------- |
| container.blockio.io_service_bytes_recursive.read  | Number of bytes transferred from the disk by the container |
| container.blockio.io_service_bytes_recursive.write | Number of bytes transferred to the disk by the container   |
| container.cpu.usage.system                         | System CPU usage, as reported by docker.                   |
| container.cpu.usage.total                          | Total CPU time consumed.                                   |
| container.memory.usage.limit                       | Memory limit of the container.                             |
| container.memory.usage.total                       | Memory usage of the container.                             |
| container.network.io.usage.rx_bytes                | Bytes received by the container.                           |
| container.network.io.usage.tx_bytes                | Bytes sent by the container.                               |

For the full mapping between OpenTelemetry and Datadog metric names, see [OpenTelemetry Metrics Mapping](https://docs.datadoghq.com/opentelemetry/guide/metrics_mapping.md).

## Further reading{% #further-reading %}

Additional helpful documentation, links, and articles:

- [Send OpenTelemetry Data to Datadog](https://docs.datadoghq.com/opentelemetry/setup.md)
