このページで
net.if.get の戻り値
概要
このセクションでは、net.if.get アイテムの戻り値の詳細について説明します。
このアイテムは、Linux 上で Zabbix エージェントおよび Zabbix エージェント 2 によってサポートされています。
詳細
このアイテムは、名前が指定された正規表現に一致するネットワークインターフェースに関する詳細情報を返します。
出力は、config 配列と values 配列を含むJSONオブジェクトとして構成されます。
出力には、以下のプロパティが含まれます。
- name - インターフェース名。
/proc/net/devから読み取られます。 - ifalias - インターフェースのエイリアス。
/sys/class/net/<name>/ifaliasから読み取られます。 - mac - インターフェースのMACアドレス。
/sys/class/net/<name>/addressから読み取られます。 - type - インターフェースのタイプ（
physical、virtual、loopback）。 - speed - リンク速度（Mbits/sec）。Ethernet固有で、
/sys/class/net/<name>/speedから読み取られます。 - duplex - インターフェースの最新または現在の duplex 値（
half、full）。Ethernet固有で、/sys/class/net/<name>/duplexから読み取られます。 - administrative_state - 設定された状態（
down、up）。/sys/class/net/<name>/flagsから読み取られます。 - operational_state - インターフェースのRFC2863運用状態（
unknown、notpresent、down、lowerlayerdown、testing、dormant、up）。sys/class/net/<name>/operstateから読み取られます。 - carrier - 物理リンクの有無（
0- 物理リンクがダウン、1- 物理リンクがアップ）。/sys/class/net/<name>/carrierから読み取られます。 - carrier_changes - リンク状態がアップからダウン、またはその逆に変化した総回数。
/sys/class/net/<name>/carrier_changesから読み取られます。 - carrier_up_count - リンクがアップになった回数。
/sys/class/net/<name>/carrier_up_countから読み取られます。 - carrier_down_count - リンクがダウンになった回数。
/sys/class/net/<name>/carrier_down_countから読み取られます。 - in - 受信トラフィック。
/proc/net/devから読み取られます。インターフェースカウンターを含みます。- bytes - 正常なバイト数。
- packets - 正常なパケット数。
- errors - 不正なパケットの総数。
- dropped - 受信されたが処理されなかったパケット数 + ホストが取りこぼしたパケット数。
- overruns - オーバーフローイベントの回数。
- frame - フレーミングエラーのあるパケット数。
- compressed - 正常に受信された圧縮パケット数。
- multicast - 受信したマルチキャストパケット数。
- out - 送信トラフィック。
/proc/net/devから読み取られます。インターフェースカウンターを含みます。- bytes - 正常なバイト数。
- packets - 正常なパケット数。
- errors - 不正なパケットの総数。
- dropped - 受信されたが処理されなかったパケット数 + ホストが取りこぼしたパケット数。
- overruns - オーバーフローイベントの回数。
- collisions - パケット送信中に発生したコリジョン数。
- carrier - 送信中のキャリア喪失によるフレーム送信エラー数。
- compressed - 送信された圧縮パケット数。
利用できないメトリクスはJSON出力から除外されます。
以下の例では、"lo" インターフェースにエイリアスが設定されていないため、ifalias プロパティは除外されています。
例:
{
"config": [
{
"name": "lo",
"mac": "00:00:00:00:00:00",
"type": "loopback",
"administrative_state": "up",
"operational_state": "unknown",
"carrier": 1
},
{
"name": "enp3s0",
"ifalias": "Wired Ethernet connection",
"mac": "8c:16:45:e3:1d:58",
"type": "physical",
"duplex": "unknown",
"administrative_state": "up",
"operational_state": "down",
"carrier": 0
},
{
"name": "wlp5s0",
"ifalias": "Wi-Fi network adapter",
"mac": "34:e1:2d:72:67:c6",
"type": "physical",
"administrative_state": "up",
"operational_state": "up",
"carrier": 1
}
],
"values": [
{
"name": "lo",
"mac": "00:00:00:00:00:00",
"carrier": 1,
"carrier_changes": 0,
"carrier_up_count": 0,
"carrier_down_count": 0,
"in": {
"bytes": 1040047,
"packets": 10784,
"errors": 0,
"dropped": 0,
"overruns": 0,
"frame": 0,
"compressed": 0,
"multicast": 0
},
"out": {
"bytes": 1040047,
"packets": 10784,
"errors": 0,
"dropped": 0,
"overruns": 0,
"collisions": 0,
"carrier": 0,
"compressed": 0
}
},
{
"name": "enp3s0",
"ifalias": "Wired Ethernet connection",
"mac": "8c:16:45:e3:1d:58",
"carrier": 0,
"carrier_changes": 1,
"carrier_up_count": 0,
"carrier_down_count": 1,
"in": {
"bytes": 0,
"packets": 0,
"errors": 0,
"dropped": 0,
"overruns": 0,
"frame": 0,
"compressed": 0,
"multicast": 0
},
"out": {
"bytes": 0,
"packets": 0,
"errors": 0,
"dropped": 0,
"overruns": 0,
"collisions": 0,
"carrier": 0,
"compressed": 0
}
},
{
"name": "wlp5s0",
"ifalias": "Wi-Fi network adapter",
"mac": "34:e1:2d:72:67:c6",
"carrier": 1,
"carrier_changes": 6,
"carrier_up_count": 3,
"carrier_down_count": 3,
"in": {
"bytes": 165537298,
"packets": 216182,
"errors": 0,
"dropped": 291,
"overruns": 0,
"frame": 0,
"compressed": 0,
"multicast": 0
},
"out": {
"bytes": 252574347,
"packets": 246607,
"errors": 0,
"dropped": 0,
"overruns": 0,
"collisions": 0,
"carrier": 0,
"compressed": 0
}
}
]
}関連項目
ネットワークデバイスのsysfs ABIの詳細については、以下を参照してください。