네트워크측정(Iperf3)


iperf3 센서 연동을 통해 private 또는 public Iperf3 서버에 대한 네트워크 대역폭 성능을 측정할 수 있습니다.

이 통합구성요소를 활성화하면 모니터링된 조건(아래)에 대한 Iperf3 센서가 자동으로 생성됩니다. 기본적으로 매시간 실행됩니다. 사용자는 Iperf3 테스트를 실행할 scan_interval을 정의하여 설정에서 업데이트 빈도를 변경할 수 있습니다.

셋업

본 연동을 위해서는 OS에 iperf3 명령이 설치되어 있어야합니다. 설치 지침은 official Iperf3 documentation를 참조하십시오.

설정

iperf3 센서를 설치에 추가하려면 configuration.yaml 파일에 다음을 추가하십시오.

시간당 한 번, 시간 (기본값) :

# Example configuration.yaml entry
iperf3:
  hosts:
    - host: iperf.he.net

Configuration Variables

monitored_conditions

(list)(Optional)

Sensors to display in the frontend.

download

The download speed (Mbit/s).

upload

The upload speed (Mbit/s).

hosts

(list)(Required)

A list of Iperf3 servers to perform the test against.

scan_interval

(time)(Optional)

Minimum time interval between updates. Supported formats: scan_interval: 'HH:MM:SS', scan_interval: 'HH:MM' and Time period dictionary (see example below).

Default value:

60 minutes

manual

(boolean)(Optional)

true or false to turn manual mode on or off. Manual mode will disable scheduled tests.

Default value:

false

Configuration variables (host):

Configuration Variables

host

(string)(Required)

Server name/IP address running Iperf3 to test against.

port

(integer)(Optional)

Port that Iperf3 is running on.

Default value:

5201

duration

(integer)(Optional)

Specify the test duration in seconds. Default is 10 and the valid range is from 5 to 10.

Default value:

10

parallel

(integer)

Specify the number of concurrent streams to connect to the server. Default is 1 and the valid range is from 1 to 20.

Default value:

1

protocol

(string)(Optional)

Specify the protocol to be used on the test. Default is TCP and the valid values are TCP or UDP. If your Iperf3 server is located in the Internet, consider to use TCP instead of UDP. If the protocol is set to use UDP, the sensor may not get updated due to package retransmission issues due to its nature.

Default value:

tcp

Time period dictionary example

scan_interval:
  # At least one of these must be specified:
  days: 0
  hours: 0
  minutes: 3
  seconds: 30
  milliseconds: 0

public Iperf3 서버 목록은 여기에서 찾을 수 있습니다. mlabbe/iperf3’s 도커 이미지를 사용하여 자체 Iperf3 서버를 시작하거나 iperf3 명령의 매뉴얼 페이지를 참조할 수도 있습니다.

scan_interval 값을 초단위로 설정하여 테스트가 자동으로 트리거되는 빈도를 조정할 수 있습니다.

병렬 스트림은 일부 상황에서 도움이 될 수 있습니다. TCP가 공정하고 보수적일 때 parallel 속성을 높이는 것을 고려할 수 있습니다. 이 값을 신중하게 사용하고 자세한 내용은 Iperf3 매뉴얼 페이지를 참조하십시오.

sensor.iperf3_update 서비스를 사용하여 모든 센서에 대해 수동 속도 테스트를 시작할 수 있습니다. Iperf3에는 특정 엔티티에 대한 속도 테스트를 수행할 수있는 자체 서비스 호출이 있습니다.

서비스

iperf3 통합구성요소는 일단 로드되면 요청시 속도 테스트를 실행하기 위해 호출할 수 있는 서비스(ipepe3.speedtest)를 노출합니다. 수동 모드를 활성화한 경우 유용할 수 있습니다.

| Service data attribute | Description | | host | String that point at a configured host from configuration.yaml. Otherwise, tests will be run against all configured hosts.

서비스 데이터 예 :

{"host": "192.168.0.121"}

Notes

  • Raspberry Pi에서 실행할 때 최대속도는 100Mbit/s로서 LAN 어댑터에 의해 제한됩니다.