다음의 명령어에는 공통적으로 -G 옵션과 -c 옵션을 사용할 수 있다.
gvmstat
giostat
gnetinfo
gmpstat
gpsinfo
gsar
mkgraph
-G 옵션에서 지정하는 인수의 형식과 -c 옵션에서 지정한 구성파일에 들어갈
형식은 다음과 같다.
-G fn : [명령어 인수]
-G fn[:[[max][-min]][:title]][,fn[:[[max][-min]][:title]]]...
-G 옵션에 여러 개의 필드가 지정될 경우에 각각의 필드를 콤마(,)로 구분한다.
-G 옵션에 지정된 필드만 그래프로 만든다. -G option이 생략되면 디폴트로
정의되어 있는 필드에 대하여 그래프를 그린다.
(gsar 명령어에서는 사용할 수 없다.)
-c config : [구성파일]
fn[:[[max][-min]][:title]]
fn[:[[max][-min]][:title]]
fn[:[[max][-min]][:title]]
구성파일에는 한줄에 하나의 필드만 지정한다.
구성파일에서 공백 라인과 '#' 문자로 시작하는 라인은 스킵한다.
다음은 필드지정 형식에 대한 설명이다.
fn |
필드명을 지정한다.
다음과 같은 필드명이 각각의 명령어에 디폴트로 정의되어 있다.
giostat:
rw/s krw/s runit wunit wait actv svc_t %w %b
gmpstat:
cpu minf mjf xcal intr ithr csw icsw migr smtx srw syscl
gnetinfo:
pkt KB err coll
gvmstat:
cpu r b w swap free re mf pio fr de sr in sy cs
gpsinfo:
proc start end zomb run lwp load allcpu ptime maxwcpu allhs maxhs maxsz maxrss d-allcpu d-maxwcpu
gsar:
cpu runq-sz swpq-sz freemem freeswap pgio/s ppgio/s pgfree/s pgscan/s scall/s
srw/s fork/s exec/s rwchar/s read/s %rcache writ/s %wcache prw/s msg/s
sema/s sml_mem sml_alloc sml_fail lg_mem lg_alloc lg_fail ovsz_alloc
ovsz_fail swpin/s bswin/s swpot/s bswot/s pswch/s iget/s namei/s dirbk/s
rawch/s canch/s outch/s rcvin/s xmtin/s mdmin/s proc-sz porc-ov inod-sz
inod-ov file-sz file-ov lock-sz %busy avque r+w/s blks/s avwait avserv
mkgraph:
mkgraph 명령어에는 디폴트로 정의되어 있는 필드명이 없다.
-F mconfig 옵션을 사용하여 마스터 구성파일을 지정하여 디폴트 필드명과
그 속성을 정의할 수 있다.
gpsinfo 명령어는 mkgraph에서 -F 옵션으로 마스터 구성파일을
지정하여 만든 쉘스크립트이다.
mkgraph 명령어에서는 고려해야 할 사항이 더 있다. 이 문서의 하단부분을
참조하십시오.
|
max[-min] |
max[-min]는 선택된 필드에 대한 그래프의 최대값과 최소값을 지정한다.
이 값이 생략되면, 그래프의 최대값과 최소값은
데이타의 크기에 따라 자동으로 결정된다.
최대값이 지정될 경우, 데이타 값이 그래프의 최대값보다 클 때, 4 dot까지 그래프를 더
그리고, 그 보다 더 큰 값에는 그래프의 상단에 1 dot위에 1 dot의 점이 하나 더 찍힌다.
최소값이 지정될 경우, 데이타 값이 그래프의 최소값 보다 적을 때, 최소값 이하의 6 dot까지만
그래프를 그린다.
|
title |
해당되는 그래프에 제목을 지정한다. 제목을 지정하지 않으면 미리 정의되어
있는 제목이 그래프의 상단에 표시된다. 제목에 콜론(:)이 들어갈 수
있다.
만일 제목에 "."를 지정하면 제목이 생략된다.
-G 옵션에서는 필드를 구분하는 문자로 콤마(,)를 사용하기 때문에 제목에는 콤마를
사용할 수 없다.
|
-c 옵션에서 구성파일을 지정하면 그래프를 그릴 때 최대값과 최소값
그리고 그래프의 제목을 구성파일로부터 참조한다. 구성파일에 지정한
필드만 그래프를 그리는 것은 아니다.
(단, mkgraph 명령어에서 -F 옵션으로 마스터 구성파일을 지정하지 않으면
-c 옵션에 지정한 필드만 그래프로 그린다.)
그러나 -G 옵션에서 필드를 지정하면 지정한 필드만 그래프로 그린다.
구성파일과 -G 옵션에서 동시에 같은 필드에 대하여 다른 값이 지정되어
있으면 -G 옵션에 지정한 것이 사용된다.
구성파일에서는 한줄에 하나의 필드만 지정할 수 있고 -G 옵션에서는
콤마(,)로 구분하여 한줄에 다 지정하여야 한다. title에 공백이 들어갈
경우 -G 옵션의 인수 전체를 다음과 같이 인용부호로 둘러싸야 한다.
# gvmstat -G cpu,pio:100:PIO Page In and Out,swap:100000-50000:SWAP vmstat.log ----> 오류
# gvmstat -G "cpu,pio:100:PIO - Page In and Out,swap:100000-50000:SWAP_KB" vmstat.log ----> 정상
다음은 -G 옵션에 다양한 형태의 인수를 지정하는 예제이다. 다음의 형식은
구성파일에도 그대로 사용할 수 있다. 구성파일에서는 한줄에 하나만 지정 가능하다.
# gvmstat -T . -G cpu,r,free,sy vmstat.log
|
# gvmstat -T . -G "cpu::Usage of CPU,r:100,free:-0,sy:50000-30000:sy:System Call" vmstat.log
|
mkgraph 명령어에서의 고려 사항
mkgraph 명령어는 gvmstat 명령어와 달리 미리
정의되어 있는 필드가 없다.
따라서 그래프를 만들 때, 반드시 만들고 싶은 필드를 지정하여야 한다.
이렇게 필드를 지정하는 방법으로 mkgraph 명령어에서는
다음과 같은 3가지의 옵션이 있다.
-F mconfig
-c config
-G fn
그래프를 그리기 위해서는 적어도 이중에 하나의 옵션은 지정하여야 한다.
-c 옵션과 -G 옵션은 다른 명령어들에서도 있는 것이고 -F 옵션은
mkgraph 명령어에만 있다.
-F 옵션은 디폴트 필드를 정의하는데 사용된다.
다음은 mkgraph 명령어가 vmstat 명령어의 결과물에 대하여 그래프를 만들 수 있도록
마스터 구성파일을 만든 예제이다.
[파일명: vmstat.cfg]
-S kthr,proc,r
-p 1
-T vmstat
-o vmstat
-f 22
cpu; cpu: cpu usage [%]; 2; 100; 20,21; us,us+sy
r; r: run-queued process; 1; 10; 1;
b; b: blocked process; 1; 10; 2;
w; w: swapped process; 1; 10; 3;
swap; swap: free swap space [KB]; 1; 1000; 4;
free; free: free memory [KB]; 1; 100; 5;
re; re: page reclaim; 1; 50; 6;
mf; mf: minor page fault; 1; 50; 7;
pio; pio: page-in/out [KB]; 2; 50; 8,9; pi,pi+po
fr; fr: page free [KB]; 1; 50; 10;
de; de: page deflict [KB]; 1; 50; 11;
sr; sr: page scan rate; 1; 50; 12;
in; in: interrupt; 1; 500; 17;
sy; sy: system call; 1; 1000; 18;
cs; cs: context switching; 1; 1000; 19;
|
위의 vmstat.cfg 파일을 mkgraph 명령어의 -F 옵션에 다음과 같이 지정하여
그래프를 만들면 gvmstat 명령어로 만든 그래프와 거의 같다.
# mkgraph -o g1 -F vmstat.cfg vmstat.log
# gvmstat -o g2 vmstat.log
|
마스터 구성파일의 형식은 다음과 같다.
옵션을 지정하는 부분과 필드명을 지정하는 부분으로 나눈다.
첫번째, 옵션을 지정하는 부분에는 mkgraph의 명령어 라인에 인수로서 지정되는 것과
같은 효과를 가진다. 여기에 지정할 수 있는 옵션은 다음과 같은 6개의 옵션이다.
-A
-f n
-k
-o outfile
-p n
-S skiplist
-T title
각각의 옵션의 사용법은 mkgraph의 메뉴얼을 참조하십시오.
두번째, 필드를 지정하는 부분은 다음과 같은 형식이다.
fn; gfn; count; defmax; columns; [column notes]
각각의 컬럼들은 세미콜론(;)으로 구분되고 마지막에 column notes는 생략해도 된다.
fn |
필드명을 지정한다. 여기에 지정된 필드명이 -c config 옵션의 구성파일과
-G fn 옵션에 사용될 수 있다.
|
gfn |
해당 필드에 대하여 그래프를 그릴 때, 그래프의 제목을 지정한다.
|
count |
하나의 필드명에 대하여 몇개의 그래프를 그릴 것 인가를 지정한다.
최대 2개의 그래프를 그릴 수 있다. 따라서 count 값은 1 또는 2 이어야 한다.
|
defmax |
그래프를 그릴때 사용될 디폴트 최대 값을 지정한다. Y 축의 최대 값이 된다.
그래프의 최대 값은 사용자가 명시적으로 지정할 수 있다.
만일 최대 값을 명시적으로 지정하지 않으면 데이타 파일을 읽어서 적절한 최대 값을
구한다. 이 최대 값이 defmax 값 보다 작으면, defmax에 지정된 값을 사용한다.
|
columns |
해당 필드에 대하여 그래프를 만들 때, 데이타 파일에서 몇번째 컬럼의 데이타를
사용할지를 지정한다.
count가 2이면 2개의 컬럼번호를 지정하여야 한다. 각각은 콤마로 분리되어야 한다.
두개의 컬럼번호가 지정되어
있으면 첫번째 지정된 컬럼의 값을 사용하여 파란선으로 그래프를 그리고,
첫번째 지정된 컬럼의 값과 두번째 지정된 컬럼의 값을 더하여 빨간선으로
그래프를 그린다.
그래프를 그렸을 때, 빨간선과 파란선의 차이값이 두번째 지정된 컬럼의 원래 값이 된다.
|
column notes |
count가 1일 때에는 컬럼노트를 지정할 필요가 없고, count값이 2일 때 이 값을 지정할 수
있다. 각각은 콤마로 분리되어야 한다.
여기에 지정한 내용은 그래프의 우측 상단에 파란선과 빨간선에 옆에 표시된다.
가능한한 짧은 내용이 좋다.
|
mkgraph에서 -c config 옵션의 구성파일에서 필드명을 지정하는
방법이 gvmstat 명령어에서 -c config 옵션에서 지정하는 구성파일과
조금 다른 점이 있다.
mkgraph 명령어에서 -F 옵션으로 마스터 구성파일(mconfig)을
지정하였다면, 구성파일(config)에서 필드명(fn)은 반드시 마스터 구성파일에서
지정한 컬럼명이 들어가야 한다.
컬럼 번호를 사용할 수 없다.
구성파일의 형식은 위에서 설명한 것과 같다.
-F 옵션이 사용되지 않았으면 구성파일에 필드명은 컬럼 번호이어야 한다.
그 형식은 다음과 같다.
colnum[=colname][:[[max][-min]][:title]]
마스터 구성파일이 없기 때문에 그래프를 그릴 필드에 대한
컬럼번호를 지정하여야 한다. 컬럼번호뒤에 "=" 부호를 붙여서 컬럼명을
지정할 수 있다. 여기에 지정된 이름은 -G fn 옵션에서 필드명을 지정할 때 사용될
수 있다. 또한 그래프의 제목을 별도로 지정하지 않으면, 해당 그래프의 제목으로
출력된다.
다음은 구성파일의 예제이다.
1=proc::proc: all processes
2=zomb::zombie all processes
3::threads
4:1000-0:users
5:100000:memory
-F 옵션과 -c 옵션과 -G 옵션과의 관계
# mkgraph -F vmstat.cfg vmstat.log
mkgraph 명령어에 -F 옵션만 지정된 경우,
마스터 구성파일에 지정된 모든 필드에 대하여 그래프를 그린다.
|
# mkgraph -F vmstat.cfg -c vm.conf vmstat.log
mkgraph 명령어에 -F 옵션과 -c 옵션이 동시에 지정되면
, -F 옵션에 지정된 모든 필드에 대하여 그래프를 그린다. -c 옵션에
지정된 최대값 및 최소값, 및 그래프 제목을 참고한다.
|
# mkgraph -F vmstat.cfg -c vm.conf -G cpu,free::Memory,swap:500000 vmstat.log
mkgraph 명령어에 -F 옵션과 -c 옵션과 -G 옵션이
동시에 지정되면, -G 옵션에 지정된 필드에 대한 그래프만 그린다.
-G 옵션에서 지정되지 않은 최대값과 최소값과
그래프 제목은 구성파일에서 참조하여 그래프를 그린다.
참조되는 순서는 명령어 라인에서 지정된 순서와 관계없이 -c 옵션,
-F 옵션 순서이다.
|
# mkgraph -c vm.conf vmstat.log
mkgraph 명령어에 -c 옵션만 지정되어 있으면,
구성파일에 지정된 필드에 대한 그래프를 그린다.
|
# mkgraph -c vm.conf -G cpu,free,swap:10000-2000 vmstat.log
mkgraph 명령어에 -c 옵션과 -G 옵션이 동시에 지정되면,
-G 옵션에 지정된 필드에 대한 그래프만 그린다.
-G 옵션에서 지정되지 않은 최대값과 최소값과
그래프 제목은 구성파일에서 참조하여 그래프를 그린다.
|
| |