# 管理解説書

## afsmonitor

目的

ファイル・サーバーおよびキャッシュ・マネージャーをモニターします。

構文

    afsmonitor [initcmd]  [-config <configuration file>]
               [-frequency <poll frequency, in seconds>]
               [-output <storage file name>]  [-detailed]
               [-debug <turn debugging output on to the named file>]
               [-fshosts <list of file servers to monitor>+]
               [-cmhosts <list of cache managers to monitor>+]
               [-buffers <number of buffer slots>]  [-help]

    afsmonitor [i]  [-co <configuration file>]
               [-fr <poll frequency, in seconds>]
               [-o <storage file name>]  [-det]
               [-deb <turn debugging output on to the named file>]
               [-fs <list of file servers to monitor>+]
               [-cm <list of cache managers to monitor>+]
               [-b <number of buffer slots>]  [-h]

構文

afsmonitor コマンドは、特定のファイル・サーバーとキャッシュ・マネージャーの操作についての統計を集めて表示するプログラムを初期化します。このコマンドを使うと、発行者は、単一のロケーションから、広い範囲のファイル・サーバーとキャッシュ・マネージャーの操作を、モニターすることができます。この場合、何台のマシンで実行されていても、ローカルと外部セルの両方でモニターすることができます。

ファイル・サーバーの場合、統計は 271 で、キャッシュ・マネージャーの場合は 570 です。これらは、AFS 管理の手引き の afsmonitor 統計についての付録にリストされています。デフォルトではこのコマンドは、 -fshosts 引き数で指定されたファイル・サーバー・マシンと、 -cmhosts 引き数で指定されたクライアント・マシンの関連統計をすべて表示します。重要な統計だけを表示するように制限を設けるには、 -config 引き数に指定する構成ファイルに、表示したい統計だけをリストします。さらに、構成ファイルは、以下のような目的で使用します。

- 任意のモニター統計に対するしきい値を設定する。統計値がしきい値を超えた時、afsmonitor コマンドは、その値を反転表示で表示します。デフォルトのしきい値はありません。
- 統計がそのしきい値を超える場合に、プログラムまたはスクリプトを自動的に呼び出す。 AFS 分散は、任意のスクリプトを組み込みません。
- -fshosts 引き数や -cmhosts 引き数を使用する代わりに、モニターするファイル・サーバーおよびクライアント・マシンをリストする。

構成ファイルの説明については、afsmonitor 構成ファイルの解説ページを参照してください。

注意

次のソフトウェアが、 afsmonitor プログラムを実行中のマシンにアクセスできるようになっている必要があります。

- afsmonitor プログラムがデータ収集に使用する、 AFS xstat ライブラリー
- ほとんどの UNIX 分散で、標準ユーティリティーとして提供されている、 curses グラフィックス・パッケージ

afsmonitor 画面は、いわゆるダム端末と端末をエミュレートするウィンドウ内操作システムの両方で、正常に形式化されます。モニター環境では、出力が最も良く表示されるように、反転表示およびカーソル・アドレス指定がサポートされていなければなりません。 TERM 環境変数を正しい端末タイプに設定するか、実際の端末タイプに類似した特性を持つ値に設定します。表示ウィンドウまたは表示端末は、少なくとも表示幅が 80 列で、表示行数が 12 行でなければなりません。

afsmonitor プログラムは、それ自身の独立した専用ウィンドウまたは端末のフォアグラウンドで実行されなければなりません。ウィンドウまたは端末は、afsmonitor が実行されている間は、他の活動に使用できません。 afsmonitor プログラムのインスタンスは、各インスタンスが独自の専用ウィンドウや端末で実行している限り、単一マシンでいくつでも実行することができます。追加したインスタンスを開始するのに 3 分かかることがあるので注意してください。

オプション

initcmd
  コマンドの AFS コマンド・パーサーの使用状況を調べます。これはオプションです。

-config
  モニターするマシン、表示する統計、あれば、しきい値をリストする構成ファイルを指定します。相対パス名は、現行作業ディレクトリーを起点にして解釈されます。 -fshosts 引き数または -cmhosts 引き数のいずれか、あるいはどちらも指定しない場合に、この引き数を指定します。このファイルの作成方法については、前述の [説明] セクションと AFS 管理の手引き の afsmonitor プログラムのセクションを参照してください。

-frequency
  afsmonitor プログラムがファイル・サーバーとキャッシュ・マネージャーをプローブするかを、秒単位で指定します。有効な値の範囲は、 1 から 86400 (24 時間) です。デフォルト値は、60 です。この頻度は、ファイル・サーバーとキャッシュ・マネージャーの両方に適用されますが、 afsmonitor プログラムは、2 つのタイプのプローブを開始し、それらの結果を別々に処理します。ホストへのプローブ間の実際のインターバルは、頻度に応答するすべてのホストのために必要とされる時間を加えてプローブされます。

-output
  afsmonitor が収集するすべての統計を書き込むファイル名を指定します。デフォルトでは、作成された出力ファイルはありません。 AFS 管理の手引き にある afsmonitor コマンドのセクションを参照してください。このファイルに情報があります。

-detailed
  -output 引き数で指定された出力ファイルの情報を、最も読みやすいように書式化します。この値といっしょに -output 引き数を与えます。

-fshosts
  収集するファイル・サーバーの統計から 1 つ以上のマシンの名前を指定します。それぞれのマシンごとに、完全修飾ホスト名か明確な省略形のいずれかを指定してください (省略形の解析能力は、コマンドが出されたときのセル名サービスの状態によって異なります)。この引き数は、-config 引き数とでなく、 -cmhosts 引き数と組み合わせることが可能です。

-cmhosts
  収集するキャッシュ・マネージャーの統計から 1 つ以上のマシンの名前を指定します。それぞれのマシンごとに、完全修飾ホスト名か明確な省略形のいずれかを指定してください (省略形の解析能力は、コマンドが出されたときのセル名サービスの状態によって異なります)。この引き数は、-config 引き数とでなく、 -fshosts 引き数と組み合わせることが可能です。

-buffers
  機能しません。将来におけるプログラムの拡張に備えて提供されます。

-help
  このコマンドのオンライン・ヘルプを出力します。これ以外の有効なオプションはすべて無視されます。

出力

afsmonitor プログラムは、3 つの画面にデータを表示します。

- [`システム概説`]: afsmonitor プログラムの初期化時に、自動的に表示されます。ファイル・サーバーおよびキャッシュ・マネージャーについて、モニターされているマシンの数と、それらのうちいくつにアラートが出されている (統計がしきい値を超えている) かを、別々に合計します。その後、モニターされているマシンごとに、ホスト名とアラートの回数がリストされ、適宜、プロセスが最後のプローブへの応答に失敗したことを示します。
- [`ファイル・サーバー`]: モニターされているファイル・サーバー・マシンごとのファイル・サーバー統計を表示します。しきい値を超えている統計を強調表示し、最後のプローブへの応答に失敗したマシンを識別します。
- [`キャッシュ・マネージャー`]: モニターされているクライアント・マシンごとにキャッシュ・マネージャー統計を表示します。しきい値を超えている統計を強調表示し、最後のプローブへの応答に失敗したマシンを識別します。

各画面の角にあるフィールドには、次の情報が表示されます。

- 左上の角には、プログラム名およびバージョン番号。
- 右上の角には、画面名、現行ページ番号および合計ページ数、現行列番号および合計列数。ページ番号 (たとえば、`p. 1 of 3`) は、データが表示されている現行ページのインデックスと合計ページ数 (垂直) を示します。列番号 (たとえば、`c. 1 of 235`) は、データが表示されている現行の左端の列のインデックスと合計列数を示します。 (記号 `>>>` は、右に追加データがあることを示しています。記号 `<<<` は、左に追加データがあることを示しています。)
- 左下の角には、使用可能なコマンドのリストが表示されます。コマンド名の先頭文字を入力することで、そのコマンドを実行できます。現在可能なオプションだけが表示されます。たとえば、データが 1 ページ分だけしかない場合、それぞれ画面を上下にスクロールする `next` および `prev` コマンドは、表示されません。コマンドの説明については、表示画面のナビゲートに関する次のセクションを参照してください。
- 右下の角には、`probes` フィールドがあり、プログラムがファイル・サーバー (`fs`)、キャッシュ・マネージャー (`cm`)、またはその両方を何回プローブしたかを報告します。ファイル・サーバーとキャッシュ・マネージャーのカウント数は、異なることがあります。 `freq` フィールドは、プログラムがプローブを送信する頻度を報告します。

afsmonitor 表示画面のナビゲート

注にあるように、それぞれの表示画面の左下角には、代替画面への移動に現在使用可能なコマンド名が表示されます。代替画面は、異なるタイプ、またはより多くの統計の表示、あるいは現行タイプのマシンです。コマンドを実行するには、小文字バージョンの名前の最初の文字を押します。コマンドによっては、次のリストにあるように、多少機能が異なる大文字バージョンがあります。

`cm`
  [`キャッシュ・マネージャー`] 画面に切り替えます。 [`システム概説`] と [`ファイル・サーバー`] 画面でのみ使用可能です。

`fs`
  [`ファイル・サーバー`] 画面に切り替えます。 [`システム概説`] と [`キャッシュ・マネージャー`] 画面でのみ使用可能です。

`left`
  現行セットの左にあるデータ列にアクセスするために、左にスクロールします。 `<<<` 記号が画面左上に表示されているときに、使用可能です。英大文字の L を押して、左端まで横にスクロールします (データ列の最初のセットを表示)。

`next`
  次のページのマシン名まで、縦方向にスクロールダウンします。 2 ページ分以上のマシンがあり、最終ページが現在表示されているときに、使用可能です。英大文字の N を押して、最終ページへスクロールします。

`oview`
  [`システム概説`] 画面に切り替えます。 [`キャッシュ・マネージャー`] および [`ファイル・サーバー`] 画面でのみ使用可能です。

`prev`
  直前のページのマシン名まで、縦方向にスクロールアップします。 2 ページ分以上のマシンがあり、最初のページが現在表示されているときに、使用可能です。英大文字の N を押して、最初のページへスクロールします。

`right`
  現行セットの右にあるデータ列にアクセスするために、右にスクロールします。このコマンドは、画面右上に `>>>` 記号が表示されているときに、使用可能です。英大文字の R を押して、右端まで横にスクロールします (データ列の最終セットを表示)。

システム概説画面

[`システム概説`] 画面は、 afsmonitor プログラムの初期化時に自動的に表示されます。この画面には、現行ウィンドウに収まる数のファイル・サーバーとキャッシュ・マネージャー・プロセスの状況が表示されます。スクロールダウンすると、追加情報にアクセスすることができます。

この画面上の情報は、左側のファイル・サーバー情報と、右側のキャッシュ・マネージャー情報に分割されます。各グループの見出しには、次の 2 つの情報が報告されます。

- 指定されたプロセスを、プログラムがモニターしているマシンの数
- アラートの回数とそれらによって影響を受けたマシンの数。 (アラート は、統計がしきい値を超えていたり、プロセスが最後のプローブへの応答に失敗したことを示します)

その後に、モニターされているマシンのリストが続きます。マシンに出されているアラートがある場合、ホスト名の左の大括弧内に、アラートの数が表示されます。プロセスが最後のプローブへの応答に失敗すると、ホスト名の左の大括弧内に、`PF` (プローブ失敗) という文字が表示されます。

ファイル・サーバー画面

[`ファイル・サーバー`] 画面は、ファイル・サーバー統計の最新のプローブで収集された値を表示します。

画面上部の合計行 (標準プログラム・バージョンと画面タイトル・ブロックのすぐ下) は、モニターされたファイル・サーバーの数、アラート回数、およびアラートの影響を受けたマシンの数を指定します。

最初の列には、モニターされたファイル・サーバーを実行しているマシンのホスト名が常に表示されます。

ホスト名列の右には、表示画面またはウィンドウの現行幅に収まる数の統計の列が表示されます。各列には、10 文字分のスペースが必要です。統計の名前は、各列の一番上に表示されます。マシン上のファイル・サーバーが最新のプローブに応答しなかった場合、各列に、1 対のダッシュ (`--`) が表示されます。値が構成済みのしきい値を超えた場合、その値が反転表示で強調されます。値が長すぎて割り振られた列幅に収まらない場合、その値は、次の行の同じ列にあふれます。

キャッシュ・マネージャー画面

[`キャッシュ・マネージャー`] 画面は、キャッシュ・マネージャー統計の最新のプローブで収集された値を表示します。

画面上部の合計行 (標準プログラム・バージョンと画面タイトル・ブロックのすぐ下) は、モニターされたキャッシュ・マネージャーの数、アラート回数、およびアラートの影響を受けたマシンの数を指定します。

最初の列には、モニターされたキャッシュ・マネージャーを実行しているマシンのホスト名が常に表示されます。

ホスト名列の右には、表示画面またはウィンドウの現行幅に収まる数の統計の列が表示されます。各列には、10 文字分のスペースが必要です。統計の名前は、各列の一番上に表示されます。マシン上のキャッシュ・マネージャーが最新のプローブに応答しなかった場合、各列に、1 対のダッシュ (`--`) が表示されます。値が構成済みのしきい値を超えた場合、その値が反転表示で強調されます。値が長すぎて割り振られた列幅に収まらない場合、その値は、次の行の同じ列にあふれます。

出力ファイルへの書き込み

afsmonitor プログラムが集めるすべての統計の書き込み先ファイルを指定する、 -output 引き数を組み込みます。出力ファイルは、長期間に渡るパフォーマンスの追跡に役立ち、システムの動向を明らかにする後処理技法を管理者が適用できるようにします。 AFS 分散は、任意の後処理プログラムを組み込みません。

出力ファイルは ASCII 形式で、 [`ファイル・サーバー`] または [`キャッシュ・マネージャー`] 表示画面と同じ情報を記録します。ファイルの各行には、 afsmonitor プログラムが指示された統計を集める時刻を記録する、次のような形式が使用されます。この統計は、 host_name と呼ばれるマシンで実行しているキャッシュ・マネージャー (`CM`) またはファイル・サーバー (`FS`) から集められます。プローブが失敗すると、エラー・コード `-1` が statistic フィールドに表示されます。

          time  host_name  CM|FS   statistic

管理者が、出力ファイルを自動解析プログラムまたはスクリプトに入力して処理するのではなく、普通に手作業で出力ファイルを検討する場合、 -detail フラグを指定しておけば、さらに読みやすい形式でデータを書式化することができます。

例

コマンド、画面表示、および構成ファイルの例については、 AFS 管理の手引き の afsmonitor プログラムに関するセクションを参照してください。

必要となる特権

なし。

関連情報

afsmonitor 構成ファイル

fstrace

scout

[ ページのトップ | 前ページ | 次ページ | 目次 | 索引 ]

(C) IBM Corporation 2000. All Rights Reserved