マニュアルページセク ション 1M: システム管理コマンド

印刷ビューの終了

更新: 2014 年 7 月
 
 

acctadm(1M)

名前

acctadm - 拡張アカウンティング機能の構成

形式

/usr/sbin/acctadm [-DEsrux] [-d resource_list] 
     [-e resource_list] [-f filename] 
     [task | process | flow | net]

説明

acctadm は、拡張アカウンティング機能のさまざまな属性を構成します。引数なしの場合、acctadm は拡張アカウンティング機能の現在のステータスを表示します。

オプション

サポートしているオプションは、次のとおりです。

–d resource_list

リソースのリソース使用量の報告を無効にします。resource_list は、リソースまたはリソースグループのコンマ区切りリストとして指定します。

このオプションではオペランドが必要となります。「オペランド」の項を参照してください。

–D

指定されたオペランドタイプのアカウンティングを、アカウンティングファイルを閉じないで無効にします。このオプションを使えば、アカウンティングファイルへのアカウンティングレコードの書き込みを、ファイルを閉じることなく一時的に停止できます。ファイルを閉じる場合は –x オプションを使用します。–x を参照してください。

–e resource_list

リソースのリソース使用量の報告を有効にします。resource_list は、リソースまたはリソースグループのコンマ区切りリストとして指定します。

このオプションではオペランドが必要となります。「オペランド」の項を参照してください。

–E

指定されたオペランドタイプのアカウンティングを、アカウンティング出力をファイルに送信することなく有効にします。このオプションではオペランドが必要となります。「オペランド」の項を参照してください。

–f filename

指定されたオペランドタイプのアカウンティング出力を filename に送信します。filename が存在する場合は、その内容が指定されたアカウンティングタイプになっている必要があります。

このオプションではオペランドが必要となります。「オペランド」の項を参照してください。

–r

使用可能なリソースグループを表示します。

オペランドとともに使用された場合、このオプションは、指定されたアカウンティングタイプで使用可能なリソースグループを表示します。オペランドが指定されなかった場合、このオプションは、使用可能なすべてのアカウンティングタイプのリソースグループを表示します。「オペランド」の節を参照のこと。

–s

smf(5) インスタンスの start メソッド。このオプションは、ブート時に拡張アカウンティング構成を復元するために使用されます。

–x

指定されたオペランドタイプのアカウンティングを無効にします。このオプションはさらに、指定されたアカウンティングタイプのアカウンティングファイルが現在開いていれば、そのファイルを閉じます。

このオプションではオペランドが必要となります。「オペランド」の項を参照してください。

オペランド

–d–D–e–E–f、および –x オプションではオペランドが必要となります。

次のオペランドがサポートされています。

process

拡張アカウンティング機能のプロセスアカウンティングコンポーネントで acctadm を実行します。

task

拡張アカウンティング機能のタスクアカウンティングコンポーネントで acctadm を実行します。

flow

拡張アカウンティング機能の IPQoS アカウンティングコンポーネントで acctadm を実行します。

net

dladm(1M)flowadm(1M) によってそれぞれ管理されるリンクとフローで acctadm を実行します。基本ネットワークアカウンティングはリンクのみに関係しますが、拡張ネットワークアカウンティングにはリンクアカウンティングとフローアカウンティングの両方が含まれます。

acctadm の省略可能な最後のパラメータは、このコマンドが、拡張アカウンティング機能のプロセス、システムタスク、IPQoS、ネットワークのいずれのアカウンティングコンポーネントで動作するべきかを表します。

使用例 1 現在のステータスの表示

次のコマンドは現在のステータスを表示します。この例では、システムタスクアカウンティングがアクティブになっており、CPU リソースのみを追跡しています。プロセスアカウンティングとフローアカウンティングはアクティブになっていません。


$ acctadm
            Task accounting: active
       Task accounting file: /var/adm/exacct/task
     Tracked task resources: extended
   Untracked task resources: host
         Process accounting: inactive
    Process accounting file: none
  Tracked process resources: none
Untracked process resources: extended,host
            Flow accounting: inactive
       Flow accounting file: none
     Tracked flow resources: none
   Untracked flow resources: extended
             Net accounting: inactive
        Net accounting file: none
      Tracked Net resources: none
    Untracked Net resources: extended
使用例 2 基本プロセスアカウンティングのアクティブ化

次のコマンドは基本プロセスアカウンティングをアクティブ化します。


$ acctadm -e basic -f /var/adm/exacct/proc process

使用例 3 使用可能なリソースグループの表示

次のコマンドは、使用可能なリソースグループを表示します。


$ acctadm -r
  process:
  extended pid,uid,gid,cpu,time,command,tty,projid, \ 
  taskid,ancpid,wait-status,zone,flag,memory,mstate
  basic    pid,uid,gid,cpu,time,command,tty,flag
  task:
  extended taskid,projid,cpu,time,host,mstate,anctaskid,zone
  basic    taskid,projid,cpu,time
  flow:
  extended saddr,daddr,sport,dport,proto,dsfield,nbytes,npkts, \
  action,ctime,lseen,projid,uid
  basic    saddr,daddr,sport,dport,proto,nbytes,npkts,action
  net:
  extended name,devname,edest,vlan_tpid,vlan_tci,sap,cpuid, \
  priority,bwlimit,curtime,ibytes,obytes,ipkts,opks,ierrpkts \
  oerrpkts,saddr,daddr,sport,dport,protocol,dsfield
  basic    name,devname,edest,vlan_tpid,vlan_tci,sap,cpuid, \
  priority,bwlimit,curtime,ibytes,obytes,ipkts,opks,ierrpkts \
  oerrpkts

前述の出力では、extended で始まる行がバックスラッシュ文字付きで表示されています。実際の acctadm 出力では、これらの行は、改行のない長い行として表示されます。

使用例 4 タスクアカウンティングのリソースグループの表示

次のコマンドは、タスクアカウンティングのリソースグループを表示します。


$ acctadm -r task
  extended taskid,projid,cpu,time,host,mstate,anctaskid,zone
  basic    taskid,projid,cpu,time

終了ステータス

次の終了ステータスが返されます。

0

正常終了。

現在の構成に対する変更が有効であり、正常に行われました。

1

エラーが発生した。

アカウンティング構成の取得時または変更時に致命的なエラーが発生しました。

2

無効なコマンド行オプションが指定された。

95

smf(5) サービスインスタンスの起動中に致命的な非構成エラーが発生しました。

96

smf(5) サービスインスタンスの起動中に致命的な構成エラーが発生しました。

属性

属性についての詳細は、マニュアルページの attributes(5) を参照してください。

属性タイプ
属性値
使用条件
system/core-os
インタフェースの安定性
確実

関連項目

dladm(1M), flowadm(1M), acct(2), attributes(5), smf(5), ipqos(7ipp)

拡張アカウンティングと標準アカウンティングの両方をアクティブにできます。

使用可能なリソースは、システムごと、プラットフォームごとに異なる可能性があります。

拡張アカウンティングの構成は、サービス管理機能 (smf(5)) のリポジトリに格納されます。この構成はブート時に一時サービスインスタンス (アカウンティングタイプごとに 1 つ) によって復元されます:

svc:/system/extended-accounting:flow        Flow accounting
svc:/system/extended-accounting:process     Process accounting
svc:/system/extended-accounting:task        Task accounting
svc:/system/extended-accounting:net         Network accounting

インスタンスの有効化または無効化は、必要に応じて acctadm で行います。構成の変更は acctadm を使って行います。svccfg(1M) を使ってサービスプロパティーを直接変更しないようにしてください。

管理するアカウンティングタイプに対応する RBAC 権利プロファイルを持っているユーザーは、拡張アカウンティングの管理 (アカウンティングの開始、アカウンティングの停止、アカウンティング構成パラメータの変更) を行えます:

  • 拡張アカウンティングフロー管理

  • 拡張アカウンティングプロセス管理

  • 拡張アカウンティングタスク管理

  • 拡張アカウンティングネットワーク管理

前述のプロファイルはそれぞれ、フローアカウンティング、プロセスアカウンティング、タスクアカウンティング、ネットワークアカウンティング用です。