System Activity Grapher - インストール手順(通常)

SAGにはインストーラが付属しており、通常のインストールは、このインストーラにより行うことができます。

インストールはroot権限で行います。

ダウンロード

インストーラをダウンロードします。

sag-demo# ftp https://raw.githubusercontent.com/ykaw/sag/master/install.sh
Trying 185.199.111.133...
Requesting https://raw.githubusercontent.com/ykaw/sag/master/install.sh
100% |**************************************************|  4511	      00:00 ETA
4511 bytes received in 0.00 seconds (1.17 MB/s)
# 

起動

ダウンロードが完了したら、インストーラを実行します。

sag-demo# sh ./install.sh

gitとgnuplotがインストールされます。

## Installing dependencies from package
quirks-6.121(signed) 2023-06-16T09:53:28Z
quirks-6.121: ok
git-2.40.0:cvsps-2.1p2: ok
  〜略〜
git-2.40.0:ok
gnuplot-5.2.7p1:bzip2-1.0.8p0: ok
  〜略〜
gnuplot-5.2.7p1:pcre2-10.37p1: ok
gnuplot-5.2.7p1: ok
Running tags: 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
	/usr/local/share/doc/pkg-readmes/glib2

sagアカウントが作成されます。

## Creating SAG account: user=sag, group=sag, home=/home/sag

sagがダウンロードされます。

## Retrieving SAG source from the repository
Cloning into 'sag'...
remote: Enumerating objects: 542, done.
remote: Counting objects: 100% (119/119), done.
remote: Compressing objects: 100% (65/65), done.
Receiving objects: 100% (542/542), 384.74 KiB | 374.00 KiB/s, done.
Resolving deltas: 100% (242/242), done.
remote: Total 542 (delta 53), reused 89 (delta 42), pack-reused 423K

ディスクパーティションのプロットを指定するファイルdfplot.gpを編集するためにテキストエディタが起動されます。

## Edit dfplot.gp - specify disk partitions to plot, if necessary.

編集内容はgnuplotの設定ファイルで、内容は以下のとおりです。これは、実際のパーティション情報をもとに自動生成されているので、このままでよければエディタをそのまま終了して下さい。

plot \
    "sumtmp-0100df" using 1:3 title "/", \
    "sumtmp-0100df" using 1:4 title "/sysmedia", \
    "sumtmp-0100df" using 1:5 title "/fuguita", \
    "sumtmp-0100df" using 1:6 title "/ram"
#
# Edit the gnuplot configuration above to match the actual file system
# layout shown below.
#
# You can rearrange or delete the configuration lines as you wish.
#
# Filesystem     Size    Used   Avail Capacity  Mounted on
# /dev/rd0a      1.5M    1.0M    476K    69%    /
# /dev/cd0a     1023M   1023M      0B   100%    /sysmedia
# /dev/vnd5a     996M    995M    1.4M   100%    /fuguita
# mfs:12614      1.4G    296M    1.1G    22%    /ram

ネットワークインターフェースを指定するファイルnetcmd.shを編集するためにテキストエディタが起動されます。

## Edit netcmd.sh - specify the network interface to plot.

下のように、実際に測定したいネットワークインターフェース名を指定して下さい。当初はデフォルトルートとなるデバイスが指定されています。そのようなデバイスがない場合は、適当なイーサネット、あるいはWiFiデバイスが指定されています。

# a command line to get i/f name, send/receive bytes
# then print them out
#
# this command will eval-ed by $SAGHOME/bin/t0001
#
# $Id: netcmd.sh,v 1.4 2023/06/15 08:45:27 kaw Exp $

netcmd='set $(netstat -I vio0 -b -n -i); echo $7 ${11} ${12}'
#                        ~~~~\
#                             rewrite this to your actual
#                             network interface

取得データの保持日数と各測定項目のグラフ表示期間を指定するファイルnetcmd.shを編集するためにテキストエディタが起動されます。

## Edit shconf.sh - specify spans to archive logs and plot graphs.

デフォルトでよければ編集を行わずにエディタを終了して下さい。

#  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

続いて、各種設定が自動で行われます。

## Preparing stuffs to aggregate and plot data
## Setting up root's crontab
## Setting up the startup file
## Setting up sag's crontab
## Setting up web-related stuffs

グラフの画像ファイルをウェブのドキュメントルート配下にコピーするためのファイルgpostproc.shを編集するためにテキストエディタが起動されます。

## Edit a script to copy graphs to Web. if not needed, leave this untouched.

グラフをウェブで閲覧する場合はファイル内のコメントに従って編集して下さい。

#!/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/.

以上で終りです。
グラフをウェブで閲覧する場合はhttpd.confの編集など、関連する設定を行って下さい。

## All done.
##
## You need to add the entry on your httpd.conf(8) file.
##
sag-demo# 


Front page   New Page list Search Recent changes   Help   RSS of recent changes