settrace starttrace

settrace コマンドを使用して、システムを通して特定の入出力操作をトレースする場合のオプションを設定できます。

構文

構文図を読む構文図をスキップする>>- svctask -- -- settrace -- -- -type --+- mdisk -+-- --------->
                                         '- vdisk -'

>-- -file -- filename_arg -- -- -trigger --+- full ----+-- ----->
                                           +- status --+
                                           +- command -+
                                           +- timeout -+
                                           +- trigger -+
                                           '- abort ---'

>--+----------+-- --+--------------+-- --+---------+-- --------->
   '- -abort -'     '- -timestamp -'     '- -data -'

>--+--------+-- --+-----------+-- --+---------+-- -------------->
   '- -tag -'     '- -detect -'     '- -init -'

>--+----------+-- --+---------+-- ------------------------------>
   '- -sense -'     '- -cmds -'

>--+--------------------------+-- ------------------------------>
   '- -percent -- percentage -'

>--+----------------------------------------------------+-- ---->
   '- -cmdlist -- cmd_list --+------------------------+-'
                             '- -cmdmask -- cmd_mask -'

>--+--------------------------------------------------------+--><
   '- -skcqlist -- skcq_list --+--------------------------+-'
                               '- -skcqmask -- skcq_mask -'

パラメーター

-type mdisk | vdisk
オプションが関係するオブジェクト・タイプを指定します。
-file filename_arg
トレース・ファイルのファイル名接頭部を指定します。
-trigger full | status | command | timeout | trigger | abort
トリガー・オプション、つまりトレースが開始される (トリガーする) ときに行うことを指定します。

full、status、および command オプションは、MDisk と VDisk の両方に有効です。timeout および trigger オプションは、MDisk にのみ有効です。abort オプションは VDisk にのみ有効です。

  • full = トレース・バッファーが満杯で停止したとき、つまり、折り返さない場合。
  • status = センス・データとして特定の SCSI 状況 (-skcqlist) が報告されたとき。
  • command = 特定の SCSI コマンド (-cmdlist) が送られたとき。
  • timeout = タイムアウトになったとき。
  • trigger = トリガー・イベント (つまり、折り返し) まで実行を続ける。
  • abort = 打ち切りが起こったとき。
-abort
トレースに打ち切りの詳細を加える、打ち切り引き数を指定します (オプション)。 この引き数は VDisk にのみ有効です。
-timestamp
タイム・スタンプ・フラグを指定します (オプション)。トレース内の各項目にタイム・スタンプを付けます。 ファイル名は、接頭部とタイム・スタンプから作成されます。 ファイル名の形式は、<prefix>_NN_YYMMDD_HHMMSS (NN (現行の構成ノード ID) です。 ファイルは、/dumps/iotrace ディレクトリーに作成されます。
-data
I/O データをトレースに追加するデータ・フラグを指定します (オプション)。
-tag
ccb_tags フラグを指定します (オプション)。トレースに CCB タグを追加します。 この引き数は MDisk に有効です。
-detect
ディスカバリー・フラグを指定します (オプション)。MDisk のディスカバリー詳細を MDisk のトレースに追加します。
-init
MDisk 初期化の詳細を MDisk のトレースに追加する初期化フラグを指定します (オプション)。
-sense
SCSI センス・データをトレースに追加するセンス・フラグを指定します (オプション )。 このフラグは VDisk にのみ有効です。
-cmds
コマンド・データをトレースに追加するコマンド・フラグを指定します (オプション)。 このフラグは VDisk にのみ有効です。
-percent
トレース・ファイル内のどこに、選択したトリガー・ポイントを置くかを指定します (オプション)。 つまり、このフラグは、トリガー・ポイントの後にどのくらいのデータを集めるかを指定します。 デフォルトは 50% で、この場合、トリガー・ポイントはトレース・ファイルの中央に置かれます。
-cmdlist cmd_list
コマンド・リストを指定します (オプション)。指定されたコマンドのみがトレース・ファイルに追加されます。
-cmdmask cmd_mask
コマンド・マスクを指定します (オプション)。指定されたコマンドのみがトレース・ファイルに追加されます。 この引き数を入力できるのは、-cmdlist 引き数も入力した場合に限られます。
-skcqlist skcq_list
SKCQ リストを指定します (オプション)。リストされた SKCQ の詳細のみがトレース・ファイルに追加されます。
-skcqmask skcq_mask
SKCQ マスクを指定します (オプション)。指定された SKCQ の詳細のみがトレース・ファイルに追加されます。 この引き数を入力できるのは、-skcqlist 引き数も入力した場合に限られます。

記述

このコマンドは、特定のディスク・タイプ (管理対象ディスクまたは仮想ディスク) についてのさまざまな I/O トレース・オプションを設定します。 関連するディスク・タイプのトレースがその後トリガーされると、オプションは、ユーザーがトレース・ファイルに含めるデータを指定します。

ファイル名は、トレース・ファイルのファイル名接頭部を指定します。 システムが、ノード・パネル名とタイム・スタンプをファイル名に付加します。 ノード ID は、現行の構成ノードです。

最大で 10 個のトレース・ファイルがクラスターで保持されます。 11 番目のトレースが作成されると、もっとも古い既存のトレース・ファイルが上書きされます。

ディレクトリーには、他のノードからリトリーブされた ファイルが保持される場合があります。 これらのファイルはカウントされません。 SVC は、必要におじて最も古いファイルを削除して、最大ファイル数を維持します。

起こりうる障害

例

呼び出し例

svctask settrace -type vdisk -file tracedump -trigger abort
 -percent 100 -abort -timestamp