github.com/containers/podman/v5@v5.1.0-rc1/docs/source/markdown/podman-pod-stats.1.md.in (about)

     1  % podman-pod-stats 1
     2  
     3  ## NAME
     4  podman\-pod\-stats - Display a live stream of resource usage stats for containers in one or more pods
     5  
     6  ## SYNOPSIS
     7  **podman pod stats** [*options*] [*pod*]
     8  
     9  ## DESCRIPTION
    10  Display a live stream of containers in one or more pods resource usage statistics.  Running rootless is only supported on cgroups v2.
    11  
    12  ## OPTIONS
    13  
    14  #### **--all**, **-a**
    15  
    16  Show all containers.  Only running containers are shown by default
    17  
    18  #### **--format**=*template*
    19  
    20  Pretty-print container statistics to JSON or using a Go template
    21  
    22  Valid placeholders for the Go template are listed below:
    23  
    24  | **Placeholder** | **Description**    |
    25  | --------------- | ------------------ |
    26  | .BlockIO        | Block IO           |
    27  | .CID            | Container ID       |
    28  | .CPU            | CPU percentage     |
    29  | .Mem            | Memory percentage  |
    30  | .MemUsage       | Memory usage       |
    31  | .MemUsageBytes  | Memory usage (IEC) |
    32  | .Name           | Container Name     |
    33  | .NetIO          | Network IO         |
    34  | .PIDS           | Number of PIDs     |
    35  | .Pod            | Pod ID             |
    36  
    37  When using a Go template, precede the format with `table` to print headers.
    38  
    39  @@option latest
    40  
    41  @@option no-reset
    42  
    43  @@option no-stream
    44  
    45  ## EXAMPLE
    46  
    47  List statistics about all pods without streaming:
    48  ```
    49  # podman pod stats -a --no-stream
    50  ID             NAME              CPU %   MEM USAGE / LIMIT   MEM %   NET IO    BLOCK IO   PIDS
    51  a9f807ffaacd   frosty_hodgkin    --      3.092MB / 16.7GB    0.02%   -- / --   -- / --    2
    52  3b33001239ee   sleepy_stallman   --      -- / --             --      -- / --   -- / --    --
    53  ```
    54  
    55  List statistics about specified pod without streaming:
    56  ```
    57  # podman pod stats --no-stream a9f80
    58  ID             NAME             CPU %   MEM USAGE / LIMIT   MEM %   NET IO    BLOCK IO   PIDS
    59  a9f807ffaacd   frosty_hodgkin   --      3.092MB / 16.7GB    0.02%   -- / --   -- / --    2
    60  ```
    61  
    62  List statistics about specified pod in JSON format without streaming:
    63  ```
    64  # podman pod stats --no-stream --format=json a9f80
    65  [
    66      {
    67          "id": "a9f807ffaacd",
    68          "name": "frosty_hodgkin",
    69          "cpu_percent": "--",
    70          "mem_usage": "3.092MB / 16.7GB",
    71          "mem_percent": "0.02%",
    72          "netio": "-- / --",
    73          "blocki": "-- / --",
    74          "pids": "2"
    75      }
    76  ]
    77  ```
    78  
    79  List selected statistics formatted in a table about specified pod:
    80  ```
    81  # podman pod stats --no-stream --format "table {{.ID}} {{.Name}} {{.MemUsage}}" 6eae
    82  ID             NAME           MEM USAGE / LIMIT
    83  6eae9e25a564   clever_bassi   3.031MB / 16.7GB
    84  ```
    85  
    86  ## SEE ALSO
    87  **[podman(1)](podman.1.md)**, **[podman-pod(1)](podman-pod.1.md)**
    88  
    89  ## HISTORY
    90  February 2019, Originally compiled by Dan Walsh <dwalsh@redhat.com>