metrics metric_spec

関数リストに表示するメトリックを指定します。metric_spec には、キーワードの default (一群のデフォルトのメトリックが復元される) またはコロンで区切ったメトリックキーワードのリストを指定できます。次に、メトリックリストの指定例を示します。

% metrics i.user:i%user:e.user:e%user

このコマンドを入力すると、er_print ユーティリティーは次のメトリックを表示します。

• 包括的ユーザー CPU 時間 (秒単位)

• 包括的ユーザー CPU 時間 (百分率)

• 排他的ユーザー CPU 時間 (秒単位)

• 排他的ユーザー CPU 時間 (百分率)

デフォルトでは、「デフォルト値を設定するコマンド」の説明のように、.er.rc ファイルから処理された dmetrics コマンドに基づいたメトリック設定が使用されます。metrics コマンドで明示的に metric_spec を default に設定した場合は、記録するデータに適したデフォルト設定が復元されます。

メトリックがリセットされると、新しいリスト内でデフォルトのソートメトリックが設定されます。

metric_spec を省略した場合は、現在のメトリックの設定が表示されます。

metrics コマンドは、関数リスト用のメトリックを設定するほか、呼び出し元 - 呼び出し先のメトリックと、データ派生出力のメトリックを同じ設定値に設定します。詳細は、「cmetrics metric_spec」および 「data_metrics metric_spec」を参照してください。

metrics コマンドが処理されると、現在有効なメトリックを示すメッセージが表示されます。上記の例では、メッセージは次のようになります。

current: i.user:i%user:e.user:e%user:name

メトリックリストの構文については、「メトリックリスト」を参照してください。指定可能なメトリックを一覧表示するには、metric_list コマンドを使用します。

metrics コマンドに誤りがあった場合、そのコマンドは警告とともに無視され、以前の設定が引き続き有効になります。