- The added line is THIS COLOR.
- The deleted line is THIS COLOR.
*System Activity Grapher - インストール手順
**表記
説明中の引用で、
$ foo
は一般ユーザ権限でコマンドfooを実行することを表します。また、
|This is
|the file
|contents
はファイルの容(あるいはそれをエディタで編集している状態)を表します。
**インストール手順
-インストールのシステムが前項の要件を満たしていることを確認します。必要なソフトで未インストールのものがあればインストールしておきます。
-http://fuguita.org/kawhc/dl/pub/sag/よりSAGのソースコードを取得します。
$ cd
$ ftp http://fuguita.org/kawhc/dl/pub/sag/sag-1.0.tar.gz
$ tar xvzf sag-1.0.tar.gz
$ mv sag .sag
(インストールするシステムがCobaltRaQあるいはOpenBSDの場合は、
~/.sag/arch/ARCH_NAME以下のファイルでオリジナルのファイルを置き換えます)
実行ディレクトリ($HOME/.sag/bin)にgnuplotおよびppmtogifへのリンクを
張ります(もしくは、実行バイナリをコピーしておきます)。
$ cd ~/.sag/bin
$ ln -s `which gnuplot` .
$ ln -s `which ppmtogif` .
.sag/confディレクトリのサンプルファイルをコピーし、実際の設定ファイルを
編集します。
$ cd ~/.sag/conf
$ cp crontab.sample crontab
$ cp dfplot.gp.sample dfplot.gp
$ cp netdev.pl.sample netdev.pl
$ cp shconf.sh.sample shconf.sh
crontabの編集を行います。
(実行スケジュールを変更したい特別の理由がない限り、編集は不要です。)
$ emacs -nw crontab.gp
|# ### for System Activity Grapher logging system ###
|#
|* * * * * exec $HOME/.sag/bin/tick ←毎分の処理(t0001)
|*/5 * * * * chmod u+x $HOME/.sag/bin/t0005 ←5分毎のデータ収集処理
|55 * * * * chmod u+x $HOME/.sag/bin/t0100 ←1時間毎のデータ収集処理
|30 0 * * * chmod u+x $HOME/.sag/bin/t2400 ←毎日のデータ更新処理
ディスク容量グラフ描画スクリプト中のディスクパーティション設定を編集します。
$ emacs -nw dfplot.gp
|plot "sumtmp-0100df" using 1:3 title "/" \
| ,"sumtmp-0100df" using 1:4 title "/usr" \
| ,"sumtmp-0100df" using 1:5 title "/home" \
| ,"sumtmp-0100df" using 1:6 title "/opt/1"
dfplot.gpはgnuplotのコマンドファイル(の一部)です。
行末の\は行の継続を表し、実際には描画を行うplotコマンド一命令を表します。
取得データの第3フィールド以降が各パーティションの使用率になりますので、
plotコマンドのusing 1:'''n'''の'''n'''に相当するフィールド番号を当し、
title "'''labelstring'''"の'''labelstring'''にはディスクパーティション
、マウントするディレクトリ名、あるいは用途などを記します。
#author("2023-06-19T00:45:58+09:00","default:kaw","kaw")
#navi(SAG)
*System Activity Grapher - インストール手順(手動) [#eb67032d]
前章で説明したように、SAGにはインストーラが付属しており、これを使ってSAGをインストールすることができます。
ネットワークトラフィック集計スクリプト中のネットワークインタフェース名を設定します。
(Linux系OSの場合)
$ emacs -nw netdev.pl
|$IFACE='eth0'; ←ネットワークインタフェース名を指定
|
|1;
この章では、インストーラを使わずにSAGを手動でインストールする方法について説明します。
----
#contents
*rootでの作業 [#ec23c073]
最初に、ルート権限でSAGの実行に要なソフトのインストールとアカウントの作成を行います。
**gitのインストール [#m4f51c2e]
gitは、SAGをGitHubから取得するために要です。
# pkg_add git
quirks-6.121 signed 2023-06-01 07:54:26
quirks-6.121: ok
:
:
git-2.40.0: ok
The following new rcscripts were installed: /etc/rc.d/gitdaemon
See rcctl(8) for details.
New and changed readme(s):
/usr/local/share/doc/pkg-readmes/git
#
**gnuplotのインストール [#e3d77dd1]
SAGは、グラフの描画をgnuplotを使って行っているため、gnuplotをインストールします。~
インストールを開始すると、どのパッケージを使うか訊かれるので「1: gnuplot-5.2.7p1」を選択します。~
gnuplot-5.2.7p1-no_x11は、PNGなどの画像ファイルを生成する機能を持っていません。
# pkg_add gnuplot
quirks-6.121 signed 2023-06-01 07:54:26
Ambiguous: choose package for gnuplot
a 0: <None>
1: gnuplot-5.2.7p1
2: gnuplot-5.2.7p1-no_x11
Your choice: 1
gnuplot-5.2.7p1:readline-7.0p0: ok
:
:
gnuplot-5.2.7p1: ok
Running tags: ok
New and changed readme(s):
/usr/local/share/doc/pkg-readmes/glib2
#
**sagユーザの作成 [#jb9b1131]
SAGを実行するユーザ「sag」を作成します。
# adduser -silent
Enter username []: sag
Enter full name []: System Activity Grapher
Enter shell csh git-shell ksh nologin sh [ksh]:
Uid [1000]:
Login group sag [sag]:
Login group is ``sag''. Invite sag into other groups: guest no
[no]:
Login class authpf bgpd daemon default pbuild staff unbound vmd xenodm
[default]:
Enter password []:
Enter password again []:
Name: sag
Password: ****
Fullname: System Activity Grapher
Uid: 1000
Gid: 1000 (sag)
Groups: sag
Login Class: default
HOME: /home/sag
Shell: /bin/ksh
OK? (y/n) [y]: y
Added user ``sag''
Copy files from /etc/skel to /home/sag
Add another user? (y/n) [y]: n
Goodbye!
#
*sagユーザでの作業 [#xe5ac3b1]
以降の作業はsuコマンドを実行し、一時的にsagユーザになって行います。
# su - sag
$
**SAGの取得と置
GitHubから最新バージョンのSAGを取得します。
$ git clone https://github.com/ykaw/sag
Cloning into 'sag'...
remote: Enumerating objects: 515, done.
remote: Counting objects: 100% (92/92), done.
remote: Compressing objects: 100% (48/48), done.
remote: Total 515:(delta(40),5reused 66 (delta 33), pack-reused 423
Receiving objects: 100% (515/515), 368.37 KiB | 784.00 KiB/s, done.
Resolving deltas: 100% (229/229), done.
$
取得したファイル群はsagというディレクトリに格納されているので、それをsagユーザのホームディレクトリに移動します。
$ mv sag/.git sag/* ~
$ rmdir sag
$ ls -l ~
total 22
-rw-r--r-- 1 sag sag 3304 Jun 3 01:39 README.en
-rw-r--r-- 1 sag sag 2687 Jun 3 01:39 README.eucjp
drwxr-xr-x 2 sag sag 512 Jun 3 02:35 bin
drwxr-xr-x 3 sag sag 512 Jun 3 01:41 conf
drwxr-xr-x 3 sag sag 512 Jun 3 02:35 plot
drwxr-xr-x 2 sag sag 1024 Jun 3 04:10 var
$
**gnuplotへのシンボリックリンクを作成 [#fce33700]
PATH環境変数の設定に関係なく実行できるよう、binディレクトリにgnuplotのシンボリックリンクを作成します。
$ ln -s /usr/local/bin/gnuplot ~/bin
$ ls -l ~/bin
total 24
-rwxr-xr-x 1 sag sag 298 Jun 3 01:39 addgap
-rwxr-xr-x 1 sag sag 721 Jun 3 01:39 fnrot
-rwxr-xr-x 1 sag sag 860 Jun 3 01:39 gengraph
lrwxr-xr-x 1 sag sag 22 Jun 3 01:40 gnuplot -> /usr/local/bin/gnuplot
-rwxr-xr-x 1 sag sag 785 Jun 3 01:39 mkoldsum
-rwxr-xr-x 1 sag sag 947 Jun 3 01:39 rotate
-rwxr-xr-x 1 sag sag 1030 Jun 3 01:39 split_byday
-rw-r--r-- 1 sag sag 258 Jun 3 02:20 t0001
-rw-r--r-- 1 sag sag 255 Jun 3 01:39 t0005
-rw-r--r-- 1 sag sag 236 Jun 3 01:39 t0100
-rw-r--r-- 1 sag sag 104 Jun 3 01:39 t2400
-rwxr-xr-x 1 sag sag 437 Jun 3 01:39 tick
$
**設定ファイルの編集 [#vadf7e23]
***サンプルファイルをコピー [#z08f841c]
confディレクトリのexamplesディレクトリからファイルをコピーし、編集します。
$ cd ~/conf
$ ls -l
total 10
drwxr-xr-x 2 sag sag 512 Jun 3 01:43 examples
$ cp examples/dfplot.gp examples/netcmd.sh examples/postgproc.sh examples/shconf.sh .
$ ls -l
total 10
-rw-r--r-- 1 sag sag 398 Jun 3 01:41 dfplot.gp
drwxr-xr-x 2 sag sag 512 Jun 3 01:43 examples
-rw-r--r-- 1 sag sag 245 Jun 3 01:41 netcmd.sh
-rwxr-xr-x 1 sag sag 326 Jun 3 01:44 postgproc.sh
-rw-r--r-- 1 sag sag 384 Jun 3 02:12 shconf.sh
(OpenBSDの場合)
$ emacs $HOME/.sag/bin/t0001
|(echo =dt $DAYTIME
| echo =la `cat /kern/loadavg`
| echo =net
| set `netstat -I tun0 -b -n -i`; echo $7 ${10} ${11} ←-Iオプションで指定
| echo =end) >> var/rl0001
データの保存期間、および集計結果グラフの描画期間を設定します。
$ emacs -nw shconf.sh
|# category to process data
|#
|targets='0001la 0001ps 0001net 0005mem 0100df' ←測定を行う目を記入
| (注:アーキテクチャによりサポートしてない目あり)
|# days to restore data
|#
|rotate_max=60 ←ログを保存する期間
|
|# days to display graph
|#
| span_la=7 ←ロードアベレージをグラフ上で表示する日数
| span_ps=7 ←プロセス起動数
|span_net=7 ←ネットワークトラフィック
|span_mem=7 ←メモリ
| span_df=60 ←ディスク使用率
crontabを設定し、実際にスクリプトが実行されるようにします。
(新たにcronを設定する場合)
$ crontab ./crontab
***dfplot.gpの編集 [#e9dc7936]
dfplot.gpは、ディスク使用率の表示を行う際に要なシステムのパーティション構成を設定するファイルです。~
dfコマンドの出力に合わせ、容を編集します。
(既にcronを設定している場合)
$ crontab -e
以上でインストールは終了です。
サンプルファイルは、河豚板をモード0で起動した場合のファイルシステムに合わせてあります。
$ df
Filesystem 512-blocks Used Avail Capacity Mounted on
/dev/rd0a 3039 2088 951 69% /
/dev/cd0a 2094988 2094988 0 100% /sysmedia
/dev/vnd5a 2040700 2037920 2780 100% /fuguita
mfs:69062 1494238 581876 837652 41% /ram
$ vi dfplot.gp
編集容
# definitions of disk partitions
#
# $Id: dfplot.gp,v 1.2 2017/01/07 06:10:54 kaw Exp $
#
# This file will included from $SAGHOME/plot/gen0100df.gp
# Reconfigure following to fit to the disk layout.
plot "sumtmp-0100df" using 1:3 title "RDROOT", \ <--+ この部分をdfコマンドの
"sumtmp-0100df" using 1:4 title "LIVEMEDIA", \ | 出力に合わせて編集
"sumtmp-0100df" using 1:5 title "SYSTEM", \ | (1:3が一番最初に表示される
"sumtmp-0100df" using 1:6 title "WRITABLE" <--+ パーティション)
----
***netcmd.shの編集 [#x6061040]
測定対象としたいネットワークデバイスを指定します。
$ vi netcmd.sh
編集容
# a command line to get i/f name, send/receive bytes
# then print them out
#
# this command will eval-ed by $SAGHOME/bin/t00
#
# $Id: netcmd.sh,v 1.3 2021/10/05 02:29:26 kaw Exp $
netcmd='set $(netstat -I bce0 -b -n -i); echo $7 ${11} ${12}'
~~~~ここを実際のインターフェース名に変更
***shconf.shの編集 [#hb77edaa]
shconf.shでは、測定目、ファイルに保存する日数、測定項目それぞれのグラフへの描画日数を指定します。~
サンプルファイルの容でよければ、編集する必要はありません。
$ vi shconf.sh
編集容
# shconf.sh - shell variable configuration for SAG
#
# $Id: shconf.sh,v 1.3 2021/10/04 15:22:35 kaw Exp $
# categories to process data
#
targets='0001la 0001net 0005mem 0100df 0100time 0005timeofs'
# days to store data
#
rotate_max=64 <--ファイルに保存する日数
# days to display graph <--グラフに描画する日数
#
span_la=8
span_net=8
span_mem=8
span_df=32
span_time=32
span_timeofs=8
| ←[[SAG/概要]] | ↑[[SAG TOP>SAG]] | [[SAG/運用]]→ |
**グラフ描画関連のセットアップ [#g86ec0df]
plotディレクトリでは、データの集計とグラフの描画指示を行っています。~
デフォルト設定から変えなければ、examplesディレクトリから要ファイルをコピーするだけでOKです。
$ cd ~/plot
$ cp examples/common.gp examples/gen* .
$ ls -l
total 40
-rw-r--r-- 1 sag sag 1207 Jun 3 01:42 common.gp
drwxr-xr-x 2 sag sag 512 Jun 3 01:39 examples
-rw-r--r-- 1 sag sag 259 Jun 3 01:42 gen0001la.gp
-rwxr-xr-x 1 sag sag 882 Jun 3 01:42 gen0001la.pl
-rw-r--r-- 1 sag sag 356 Jun 3 01:42 gen0001net.gp
-rwxr-xr-x 1 sag sag 1502 Jun 3 01:42 gen0001net.pl
-rw-r--r-- 1 sag sag 418 Jun 3 01:42 gen0005mem.gp
-rwxr-xr-x 1 sag sag 1046 Jun 3 01:42 gen0005mem.pl
-rw-r--r-- 1 sag sag 422 Jun 3 01:42 gen0005timeofs.gp
-rwxr-xr-x 1 sag sag 1536 Jun 3 01:42 gen0005timeofs.pl
-rw-r--r-- 1 sag sag 160 Jun 3 01:42 gen0100df.gp
-rwxr-xr-x 1 sag sag 553 Jun 3 01:42 gen0100df.pl
-rw-r--r-- 1 sag sag 198 Jun 3 01:42 gen0100time.gp
-rwxr-xr-x 1 sag sag 338 Jun 3 01:42 gen0100time.pl
gen*.plファイルは生ログから目的とする測定目を集計し、出力するPerlスクリプトです。
gen*.gpファイルは、集計結果からgnuplotでグラフの画像ファイルを生成するための描画指示です。~
common.gpは、ての測定項目で共通なgnuplotのグラフの描画設定が定義されています。
**ファイル置場の作成 [#j7fbed6f]
測定結果の生ログやその集計ファイル、最終的な生成物であるグラフの画像ファイルを置くディレクトリを作成します。
$ mkdir ~/var
*rootでの作業 [#n20828a3]
以降は、sagユーザから抜けて再度root権限で作業します。
$ exit
#
**システムファイルの設定 [#g3b4d723]
***rootのcrontabにSAG関連のエントリを追加します。 [#jd30a5da]
# cd ~sag/conf/examples/
# crontab -l > crontab.orig
# cat crontab.orig crontab-root | crontab -
***/etc/rc.localの編集 [#u6732f29]
システムが起動した時のSAG関連の処理を/etc/rc.localに追加し、その一部を編集します。
# cat rc.local >> /etc/rc.local
# vi /etc /rc.local
編集容
# for System Activity Grapher
# Add this to /etc/rc.local
#
# $Id: rc.local,v 1.2 2017/01/07 06:10:54 kaw Exp $
su -l sag -c 'PATH-TO-CMD/bin/addgap' # Rewrite to the real location.
~~~~~~~~~~~実際のパス(/home/sag)に書換え
# setups for ntp monitoring
#
touch /tmp/ntpctl.out
chown sag:sag /tmp/ntpctl.out
chmod 0640 /tmp/ntpctl.out
***sagユーザのcrontabを有効化します。 [#y93bd727]
これ以降、SAGの測定が開始されます。
# crontab -u sag ~sag/conf/examples/crontab
**ウェブサーバ関連の設定 [#i8d73277]
以下は、SAGが生成したグラフをウェブブラウザで閲覧するための設定です。~
グラフの画像ファイルを画像ビューアで直接見るなどの場合は要ありません。
***postgproc.shの編集 [#x2c6c365]
postgproc.shは、グラフ画像ファイルが生成された後の処理を行い、サンプルファイルでは画像ファイルがウェブのコンテンツディレクトリへコピーされる処理がコメントアウトされています。~
ウェブ経由で画像を閲覧する場合は、postgroc.shを編集し、処理を有効化します。
編集はsagユーザ権限で行います。
# su - sag
$ vi ~/conf/postgproc.sh
編集容
#!/bin/sh
# processes after generating graphs
# This script will be called by $SAGHOME/bin/t0100
#
# $Id: postgproc.sh,v 1.3 2021/10/04 15:26:38 kaw Exp $
# To enable this,
# # Make next line commented.
# exit 0 <--この行をコメント化する
# and follwing lines uncommented
#
# sample of post process
sleep 60 <--この行以降をアンコメントする
cp $SAGHOME/var/*.png /var/www/htdocs/sag/.
$ exit
#
**ウェブ関連の設定 [#x85a1906]
ウェブサーバ関連の設定です。
# mkdir /var/www/htdocs/sag
# cp index.html /var/www/htdocs/sag
# chown -R sag:sag /var/www/htdocs/sag
httpd.confの編集
# vi /etc/httpd.conf
編集容
server "example.com" {
listen on * port 80
}
これはウェブサーバを稼働させるための最低限の設定です。ユーザ認証による閲覧制限やTLSによる通信を行いたい場合は[[httpd.conf(5)>man:httpd.conf]]などを参して下さい。
ウェブサーバを起動します。
# rcctl enable httpd
# rcctl start httpd
*その他 [#y6ed7acc]
**あとかたづけ [#w67c0801]
SAGのインストール後に、gitを使う用事がなければ、gitとその依存パッケージをアンインストールできます。
# pkg_delete git
git-2.40.0: ok
Read shared items: ok
--- -git-2.40.0 -------------------
You should also run /usr/sbin/userdel _gitdaemon
You should also run /usr/sbin/groupdel _gitdaemon
# pkg_delete -a
ngtcp2-0.13.1:curl-8.1.1: ok
ngtcp2-0.13.1: ok
p5-Error-0.17029: ok
cvsps-2.1p2: ok
p5-Mail-Tools-2.21p0: ok
p5-Time-TimeDate-2.33: ok
nghttp3-0.9.0: ok
nghttp2-1.52.0: ok
Read shared items: ok
#
**動作の確認 [#a2a57382]
-sagのcrontabエントリを有効化した後、varディレクトリに測定結果の生ログrl0001, rl0005, rl0100が生成されていることを確認します。
-毎時50分にグラフの生成が行われるので、その後にグラフの画像ファイルが生成されていることを確認します。また、ウェブでの閲覧を設定した場合は、ウェブブラウザでも閲覧できることを確認します。
#navi(SAG)