summaryrefslogtreecommitdiff
path: root/docs/kpod-stats.1.md
blob: 2b73616a0fc4f4df4738c24d8a821054eaa156bd (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
% kpod(1) kpod-stats - Display a live stream of 1 or more containers' resource usage statistics
% Ryan Cole
# kpod-stats "1" "July 2017" "kpod"

## NAME
kpod-stats - Display a live stream of 1 or more containers' resource usage statistics

## SYNOPSIS
**kpod** **stats** [*options* [...]] [container]

## DESCRIPTION
Display a live stream of one or more containers' resource usage statistics

## OPTIONS

**--all, -a**

Show all containers.  Only running containers are shown by default

**--no-reset**

Do not clear the terminal/screen in between reporting intervals

**--no-stream**

Disable streaming stats and only pull the first result, default setting is false

**--format="TEMPLATE"**

Pretty-print images using a Go template


## EXAMPLE

```
# kpod stats -a --no-stream

CONTAINER      CPU %   MEM USAGE / LIMIT   MEM %   NET IO    BLOCK IO       PIDS
132ade621b5d   0.00%   1.618MB / 33.08GB   0.00%   0B / 0B   0B / 0B        0
940e00a40a77   0.00%   1.544MB / 33.08GB   0.00%   0B / 0B   0B / 0B        0
72a1dfb44ca7   0.00%   1.528MB / 33.08GB   0.00%   0B / 0B   0B / 0B        0
f5a62a71b07b   0.00%   5.669MB / 33.08GB   0.02%   0B / 0B   0B / 0B        3
31eab2cf93f4   0.00%   16.42MB / 33.08GB   0.05%   0B / 0B   22.43MB / 0B   0

#
```

```
# kpod stats --no-stream 31eab2cf93f4
CONTAINER      CPU %   MEM USAGE / LIMIT   MEM %   NET IO    BLOCK IO       PIDS
31eab2cf93f4   0.00%   16.42MB / 33.08GB   0.05%   0B / 0B   22.43MB / 0B   0

#
```
```
# kpod stats --no-stream --format=json 31eab2cf93f4
[
    {
        "name": "31eab2cf93f4",
        "id": "31eab2cf93f413af64a3f13d8d78393238658465d75e527333a8577f251162ec",
        "cpu_percent": "0.00%",
        "mem_usage": "16.42MB / 33.08GB",
        "mem_percent": "0.05%",
        "netio": "0B / 0B",
        "blocki": "22.43MB / 0B",
        "pids": 0
    }
]
#
```


## SEE ALSO
kpod(1)

## HISTORY
July 2017, Originally compiled by Ryan Cole <rycole@redhat.com>