github.com/hanks177/podman/v4@v4.1.3-0.20220613032544-16d90015bc83/docs/source/markdown/podman-pod-stats.1.md (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  | .Pod            | Pod ID             |
    27  | .CID            | Container ID       |
    28  | .Name           | Container Name     |
    29  | .CPU            | CPU percentage     |
    30  | .MemUsage       | Memory usage       |
    31  | .MemUsageBytes  | Memory usage (IEC) |
    32  | .Mem            | Memory percentage  |
    33  | .NetIO          | Network IO         |
    34  | .BlockIO        | Block IO           |
    35  | .PIDS           | Number of PIDs     |
    36  
    37  When using a GO template, you may precede the format with `table` to print headers.
    38  
    39  #### **--latest**, **-l**
    40  
    41  Instead of providing the pod name or ID, use the last created pod. (This option is not available with the remote Podman client, including Mac and Windows (excluding WSL2) machines)
    42  
    43  #### **--no-reset**
    44  
    45  Do not clear the terminal/screen in between reporting intervals
    46  
    47  #### **--no-stream**
    48  
    49  Disable streaming pod stats and only pull the first result, default setting is false
    50  
    51  ## EXAMPLE
    52  
    53  ```
    54  # podman pod stats -a --no-stream
    55  ID             NAME              CPU %   MEM USAGE / LIMIT   MEM %   NET IO    BLOCK IO   PIDS
    56  a9f807ffaacd   frosty_hodgkin    --      3.092MB / 16.7GB    0.02%   -- / --   -- / --    2
    57  3b33001239ee   sleepy_stallman   --      -- / --             --      -- / --   -- / --    --
    58  ```
    59  
    60  ```
    61  # podman pod stats --no-stream a9f80
    62  ID             NAME             CPU %   MEM USAGE / LIMIT   MEM %   NET IO    BLOCK IO   PIDS
    63  a9f807ffaacd   frosty_hodgkin   --      3.092MB / 16.7GB    0.02%   -- / --   -- / --    2
    64  ```
    65  
    66  ```
    67  # podman pod stats --no-stream --format=json a9f80
    68  [
    69      {
    70          "id": "a9f807ffaacd",
    71          "name": "frosty_hodgkin",
    72          "cpu_percent": "--",
    73          "mem_usage": "3.092MB / 16.7GB",
    74          "mem_percent": "0.02%",
    75          "netio": "-- / --",
    76          "blocki": "-- / --",
    77          "pids": "2"
    78      }
    79  ]
    80  ```
    81  
    82  ```
    83  # podman pod stats --no-stream --format "table {{.ID}} {{.Name}} {{.MemUsage}}" 6eae
    84  ID             NAME           MEM USAGE / LIMIT
    85  6eae9e25a564   clever_bassi   3.031MB / 16.7GB
    86  ```
    87  
    88  ## SEE ALSO
    89  **[podman(1)](podman.1.md)**, **[podman-pod(1)](podman-pod.1.md)**
    90  
    91  ## HISTORY
    92  February 2019, Originally compiled by Dan Walsh <dwalsh@redhat.com>