system-nic-metrics
로컬 서버의 네트워크 인터페이스별 수신·송신 통계를 조회합니다.
명령어 속성
| 항목 | 설명 |
|---|---|
| 명령어 유형 | 드라이버 쿼리 |
| 필요 권한 | 클러스터 관리자 |
| 라이선스 사용량 | 집계 안 함 |
| 병렬 실행 | 미지원 |
| 분산 실행 | 미지원 |
문법
system-nic-metrics
출력 필드
| 필드 | 타입 | 설명 |
|---|---|---|
| name | 문자열 | 네트워크 인터페이스 이름 (예: eth0, lo) |
| rx_bytes | 64비트 정수 | 수신한 데이터 크기 (바이트) |
| rx_pkts | 64비트 정수 | 수신한 패킷 수 |
| rx_errors | 64비트 정수 | 수신 오류 수 |
| rx_dropped | 64비트 정수 | 수신 중 버려진 패킷 수 |
| rx_overruns | 64비트 정수 | 수신 FIFO 오버런 수 |
| rx_frame | 64비트 정수 | 수신 프레임 오류 수 |
| tx_bytes | 64비트 정수 | 송신한 데이터 크기 (바이트) |
| tx_pkts | 64비트 정수 | 송신한 패킷 수 |
| tx_errors | 64비트 정수 | 송신 오류 수 |
| tx_dropped | 64비트 정수 | 송신 중 버려진 패킷 수 |
| tx_overruns | 64비트 정수 | 송신 FIFO 오버런 수 |
| tx_carrier | 64비트 정수 | 송신 캐리어 오류 수 |
| tx_collisions | 64비트 정수 | 송신 충돌 수 |
오류 코드
파싱 오류
| 오류 코드 | 메시지 | 설명 |
|---|---|---|
| 10000 | no-read-permission | 클러스터 관리자 권한이 없는 경우 |
런타임 오류
해당 사항 없음
설명
system-nic-metrics 명령어는 로컬 서버의 네트워크 인터페이스별 통계를 조회합니다. /proc/net/dev 파일에서 통계를 읽어오므로 리눅스 환경에서만 동작합니다.
각 인터페이스의 수신(rx_*)과 송신(tx_*) 지표를 통해 네트워크 오류, 패킷 유실, 충돌 등의 이상 여부를 모니터링할 수 있습니다.
이 명령어를 실행하려면 클러스터 관리자 권한이 필요합니다.
사용 예
-
전체 네트워크 인터페이스 통계 조회
system-nic-metrics -
수신 오류가 있는 인터페이스 조회
system-nic-metrics | search rx_errors > 0 or rx_dropped > 0 | fields name, rx_errors, rx_dropped, rx_overruns -
인터페이스별 수신·송신량 조회
system-nic-metrics | eval rx_mb = round(rx_bytes / 1048576, 2) | eval tx_mb = round(tx_bytes / 1048576, 2) | fields name, rx_mb, tx_mb
호환성
system-nic-metrics 명령어는 소나 4.0.2308.0 버전부터 제공되었습니다.