github.com/containers/podman/v2@v2.2.2-0.20210501105131-c1e07d070c4c/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  #### **--latest**, **-l**
    19  
    20  Instead of providing the pod name or ID, use the last created pod.
    21  
    22  The latest option is not supported on the remote client.
    23  
    24  #### **--no-reset**
    25  
    26  Do not clear the terminal/screen in between reporting intervals
    27  
    28  #### **--no-stream**
    29  
    30  Disable streaming pod stats and only pull the first result, default setting is false
    31  
    32  #### **--format**=*template*
    33  
    34  Pretty-print container statistics to JSON or using a Go template
    35  
    36  Valid placeholders for the Go template are listed below:
    37  
    38  | **Placeholder** | **Description**   |
    39  | --------------- | ---------------   |
    40  | .Pod            | Pod ID      |
    41  | .CID            | Container ID      |
    42  | .Name           | Container Name    |
    43  | .CPU            | CPU percentage    |
    44  | .MemUsage       | Memory usage      |
    45  | .Mem            | Memory percentage |
    46  | .NetIO          | Network IO        |
    47  | .BlockIO        | Block IO          |
    48  | .PIDS           | Number of PIDs    |
    49  
    50  When using a GO template, you may precede the format with `table` to print headers.
    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-pod(1), podman(1)
    90  
    91  ## HISTORY
    92  February 2019, Originally compiled by Dan Walsh <dwalsh@redhat.com>