Go to main content

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

印刷ビューの終了

更新: 2022年7月27日
 
 

ipstat(8)

名前

ipstat - IP トラフィックに関する統計情報の報告

形式

ipstat [-cegkLmnrt] [-a 
address[,address...]] [-A 
address[,address...]]
[-d d|u] [-E all|event[,event...]] [-i interface[
,interface...]] [-l nlines]
	    [-p protocol[,protocol...
]] [-s key | -S key] [
-u R|K|M|G|T|P]
	    [-x opt[=val][
,opt[=val]...]] [interval [count]]

説明

ipstat ユーティリティーは、IP トラフィック、IP パケットドロップ、および IP 関連の MIB イベントに関する統計情報を収集し、選択した出力モードとソート順序に基づいて報告します。ipstat には、指定した発信元または宛先のアドレス、インタフェース、および上位階層プロトコルと一致する IP トラフィックまたはイベントに関する統計情報のみを収集して報告するためのオプションが用意されています。

オプション

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

–a address[,address...]

発信元アドレスをフィルタ処理します。

–A address[,address...]

宛先アドレスをフィルタ処理します。

–c

前のレポートに重ねて出力するのではなく、前のレポートの下に新しいレポートを出力します。

–d d|u

各レポートのタイムスタンプを標準日付形式 (–d d) または epoch からの秒数 (つまり、UNIX 時間 (–d u)) で出力します。

–e

パケットドロップイベントを表示します。

–E all|event[,event...]

IP 関連の MIB イベントのコンマ区切りリストまたはそれらのすべてを表示します。イベント名では大文字と小文字が区別されます。使用可能なイベントの完全セットについては、ipstat -L コマンドを実行してください。

–g

トラフィックフロー別にグループ化します。

–i interface[,interface...]

インタフェース名でフィルタ処理します。

–k

統計情報をパケット数で表示します。

–l nlines

レポートごとに出力するデータの行数。

–L

使用可能なすべての IP 関連の MIB イベントを一覧表示します。

–m

マシン解析可能な出力を生成します。

–n

ネットワークアドレスを数値で表示します。IP アドレスをホスト名に解決しません。

–p protocol[,protocol...]

プロトコル名でフィルタ処理します。

–r

受信されているパケットのデータのみを表示します。

–s key | –S key

キーの昇順 (–S) または降順 (–s) でソートします。キーは次のとおりです。

  • source - 送信元 IP アドレス

  • dest - 宛先 IP アドレス

  • proto - 上位階層プロトコル

  • int - インタフェース名

  • bytes - データ量

デフォルトでは、IP トラフィックのデータはバイト数で降順にソートされます。イベントまたはドロップのデータは、フロータプル別に降順でグループ化されます。

–t

送信されているパケットのデータのみを表示します。

–u R|K|M|G|T|P

使用した場合、すべての統計情報の表示単位を選択できます (たとえば、R: 生カウント、K: キロビット、M: メガビット、T: テラビット、P: ペタビット)。使用しない場合、必要に応じて異なる単位が使用され、xy.zU 形式で統計情報が表示されます (x、y、および z は数値、U は該当する単位です)。

–x opt=val[,opt=val]

DTrace の実行時オプションまたは D コンパイラオプションを有効化または変更します。オプションの完全なリストについては、dtrace(8) を参照してください。このユーティリティーでは、 aggsize および aggrate オプションがもっとも役立ちます。これらのオプションのいずれかを変更する必要がある場合、このユーティリティーは次のようなエラーメッセージを表示します。

Data dropped.  Consider using '-x aggsize=8k' option.

aggsize のデフォルトは 512K です。aggrate のデフォルトは 1 Hz です。

出力

列見出しと ipstat レポートの意味を、次のリストに示します。

SOURCE

このトラフィックに関連付けられている発信元 IP アドレスまたはホスト名。

DEST

このトラフィックに関連付けられている宛先 IP アドレスまたはホスト名。

PROTO

このトラフィックに関連付けられている上位階層プロトコル (TCP、UDP、SCTP)。

IFNAME

このトラフィックに関連付けられているインタフェースの名前。

RATE

サンプリング間隔あたりの IP トラフィックまたは IP パケットドロップのレート。レートはバイト数で表示されますが、–k を使用してパケット数に変更できます。解析不可モードでは、必要に応じてレートが拡大縮小され (オプションで –u オプションごとに調整され)、K、M、G、T、または P 接尾辞付きで表示されます。解析可能モードでは、拡大縮小されていないレートが常に表示されます。

EVENT

IP 関連イベントの名前です。

ERR-BYTES

サンプリング間隔あたりの IP パケットドロップのレート。通常の出力では、秒あたりのバイト数 (接尾辞なし)、K バイト数 (K)、M バイト数 (M)、G バイト数 (G)、T バイト数 (T)、または P バイト数 (P) でレートが報告されます。マシン解析可能な出力では、秒あたりのバイト数でレートが出力されます。–u オプションを使用すると、この数値に対して固定の単位を指定できます。

PKTS

サンプリング間隔あたりの IP トラフィックのパケットレート。通常の出力では、レートは、秒あたりのパケット数 (接尾辞なし)、秒あたりの K パケット数 (K)、秒あたりの M パケット数 (M)、秒あたりの G パケット数 (G)、秒あたりの T パケット数 (T)、秒あたりの P パケット数 (P) で報告されます。マシン解析可能な出力では、秒あたりのパケット数でレートが出力されます。–u オプションを使用すると、この数値に対して固定の単位を指定できます。

ERR-PKTS

サンプリング間隔あたりの IP パケットドロップのレート。通常の出力では、レートは、秒あたりのパケット数 (接尾辞なし)、秒あたりの K パケット数 (K)、秒あたりの M パケット数 (M)、秒あたりの G パケット数 (G)、秒あたりの T パケット数 (T)、秒あたりの P パケット数 (P) で報告されます。マシン解析可能な出力では、秒あたりのパケット数でレートが出力されます。–u オプションを使用すると、この数値に対して固定の単位を指定できます。

EVENT

IP 関連イベントの名前です。

オペランド

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

count

統計を繰り返す回数を指定します。デフォルトでは、ipstat は終了シグナルが受信されるまで統計を報告します。

interval

サンプリング間隔を秒単位で指定します。デフォルトの間隔は5秒です。

終了ステータス

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

0

正常終了。

1

エラーが発生しました。

使用例 1 もっともアクティブな 5 つの IP トラフィックフローの報告

次のコマンドは、もっともアクティブな 5 つのトラフィックフローを報告します。

$ ./ipstat -l 5
SOURCE                     DEST                       PROTO    IFNAME     BYTES
adc-twvpn-2.oraclevpn.com  duff.cs.uni.edu            UDP      net0        6.6K
inet-bip2v-10.oracle.com   bud.bang.uni.edu           TCP      tun0        6.1K
duff.cs.uni.edu            adc-twvpn-2.oraclevpn.com  UDP      net0      964.0 
bud.bang.uni.edu           inet-bip2v-10.oracle.com   TCP      tun0      563.0 
coors.foo.uni.edu          255.255.255.255            UDP      net0       66.0 
Total: bytes in: 12.6K bytes out:  2.2K
使用例 2 タイムスタンプの表示

次のコマンドは、最上位の IP トラフィックを標準日付形式のタイムスタンプとともに報告します。前のレポートの下に新しいレポートが出力され、間隔が 10 秒に設定されます。

$ ./ipstat -d d -c 10
Monday, March 26, 2012 08:34:07 PM EDT
SOURCE                     DEST                       PROTO    IFNAME     BYTES
adc-twvpn-2.oraclevpn.com  duff.cs.uni.edu            UDP      net0       15.1K
inet-bip2v-10.oracle.com   bud.bang.uni.edu           TCP      tun0       13.9K
duff.cs.uni.edu            adc-twvpn-2.oraclevpn.com  UDP      net0        2.4K
bud.bang.uni.edu           inet-bip2v-10.oracle.com   TCP      tun0        1.5K
coors.foo.uni.edu          255.255.255.255            UDP      net0       66.0 
bigip-stbeehive-adc.oracle bud.bang.uni.edu           TCP      tun0       29.0 
bud.bang.uni.edu           bigip-stbeehive-adc.oracle TCP      tun0       20.0 
Total: bytes in: 29.1K bytes out:  3.8K

使用例 3 DTrace の実行時オプションの指定

次のコマンドは、DTrace の実行時オプション aggsize を 4K に設定します。これは収集されるデータに対して小さすぎるため、データがドロップされたことを示すエラーが表示されます。

$ ./ipstat -c -x aggsize=4k 10
SOURCE                     DEST                       PROTO    IFNAME     BYTES
adc-twvpn-3.oraclevpn.com  duff.cs.uni.edu            UDP      net0       11.1K
adc-proxy.oracle.com       stella.baz.uni.edu         TCP      tun0       10.3K
duff.cs.uni.edu            adc-twvpn-3.oraclevpn.com  UDP      net0      907.0 
stella.baz.uni.edu         adc-proxy.oracle.com       TCP      tun0      505.0 
coors.foo.uni.edu          255.255.255.255            UDP      net0       66.0 
duff-lite.cs.uni.edu       182.168.1.255              UDP      net0       22.0 
duff.cs.uni.edu            adc-twvpn-3.oraclevpn.com  TCP      net0        7.0 
adc-twvpn-3.oraclevpn.com  duff.cs.uni.edu            TCP      net0        7.0 
coors.foo.uni.edu          169.254.1.255              UDP      net0        2.0 
Data dropped.  Consider using '-x aggsize=8k' option.
Total: bytes in: 21.5K bytes out:  2.1K
使用例 4 マシン解析可能な出力の生成

次のコマンドは、1 秒間のデータをマシン解析可能な形式で UNIX 形式のタイムスタンプとともに表示します。

$ ./ipstat -d u -m 1
timestamp:1333141886
duff.cs.uni.edu:duff-dry.cs.uni.edu:TCP:net0:144
duff-dry.cs.uni.edu:duff.cs.uni.edu:SCTP:net0:128
duff.cs.uni.edu:duff-dry.cs.uni.edu:SCTP:net0:128
duff-dry.cs.uni.edu:duff.cs.uni.edu:TCP:net0:80
coors.foo.uni.edu:169.254.1.255:UDP:net0:40
total:280:240
timestamp:1333141887
duff.cs.uni.edu:duff-dry.cs.uni.edu:TCP:net0:144
duff.cs.uni.edu:duff-dry.cs.uni.edu:SCTP:net0:128
duff-dry.cs.uni.edu:duff.cs.uni.edu:SCTP:net0:104
duff-dry.cs.uni.edu:duff.cs.uni.edu:TCP:net0:80
total:228:228
使用例 5 すべての IP パケットドロップを報告する

次のコマンドは、すべての IP パケットドロップを報告します。前のレポートの下に新しいレポートが出力され、間隔が 10 秒に設定されます。

$ ./ipstat -e -k -c 10
SOURCE                     DEST                    PROTO    IFNAME      ERR-PKTS    EVENT
fe80::214:4fff:fe40:d0c8   ff02::202               IP        net0       6           drop-in
impel                      example.net             IGMP      net0       1           drop-in
www.oracle.com             example.net             IGMP      net0       1           drop-in
Total: packets in:  8 packets out:  0
使用例 6 一部の IP イベントに関する統計情報を報告する

次のコマンドは、ipInMcastPktsipOutRequest、および ipFragOKs を含むイベントのトラフィックフローを報告します。

$ ./ipstat -E ipInMcastPkts,ipoutRequests,ipfragoks
SOURCE                     DEST                       PROTO    IFNAME  PKTS          EVENT
impel                      dhcp-santaclara18-3fl-west TCP      net0       2  ipOutRequests
fe80::a00:20ff:fec8:ca69   ff02::1                    ICMPv6   net0       1  ipInMcastPkts
www.oracle.com             example.net                UDP      net0       1  ipInMcastPkts
impel                      www.oracle.com             UDP      net0       1  ipOutRequests
Total packets: 5
使用例 7 すべての IP イベントを報告する
$ ./ipstat -E all
SOURCE                     DEST                       PROTO    IFNAME  PKTS          EVENT
impel                      www.oracle.com             TCP      net0       5   ipOutRequests
www.oracle.com             impel                      TCP      net0       5   ipInReceives
www.oracle.com             impel                      TCP      net0       4   ipInDelivers
www.oracle.com             impel                      TCP      net0       1   ipInDiscards
10.5.238.52                10.255.255.255             UDP      net0       2   ipInReceives
10.5.238.52                10.255.255.255             UDP      net0       2   ipInDelivers
10.5.238.52                10.255.255.255             UDP      net0       2   ipInBcastPkts
Total packets: 21

属性

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

属性タイプ
属性値
使用条件
system/core-os

関連項目

dtrace(8)netstat(8)tcpstat(8)

表示されるデータはサンプリングされたデータではありません。値は IP トラフィックの正確な数を表しています。データがドロップされた場合は、それを示すエラーメッセージが表示されます。