Инструкция этого типа производит оценку времени и результата выполнения операции обращения ресурсу в сети Интернет или контроль скорости передачи данных.
Рекомендуется создавать инструкции типа Quality с указанием желаемого таргета подключения
В качестве параметров задаются:
Параметр | Значение | Комментарий |
---|---|---|
url_0 | http://mirror.yandex.ru/gentoo-distfiles/snapshots/gentoo-latest.tar.xz | Ссылка на внешний ресурс |
iperf_0 | hostname или IP | Ссылка на iperf-сервер |
ping_0 | hostname или IP | Адрес хоста для проверки |
ping6_0 | hostname или IP | Адрес хоста для проверки |
tracert_0 | hostname или IP | Адрес хоста для проверки |
interface | wlan0 или wlan1 | Использовать только заданный интерфейс |
icmpv6ra | 10 | Длительность сбора пакетов ICMPv6 Router Advertisement |
icmpv6ra_prefix | prefix | Ожидаемый префикс сети |
limit_rate | Ограничение скорости для wget и iperf проверок | |
apname | Имя точки доступа, для которой проводить тест. Только для неё тест будет выполняться | |
bssid | 00:11:22:33:44:55 | Идентификатор точки доступа/радио (BSSID), для которого проводить тест. Только для него тест будет выполняться |
ssid | abcdef | Имя сети (SSID) , для которой проводить тест. Только для неё тест будет выполняться |
channel | 1 | Номер радио-канала, для которого проводить тест |
reach_dns_resname | hostname или IP | Адрес хоста для проверки доступности DNS сервиса |
reach_tcp443_resname | hostname или IP | Адрес хоста для проверки доступности TCP сервиса по порту 443 |
reach_http_resname | hostname или IP | Адрес хоста для проверки доступности TCP сервиса по порту 80 |
В качестве url вы можете задать ссылку и на Youtube-ролик.
В качестве цели проверки, hostname или IP, вы можете указать слово "$gateway" (без кавычек), в этом случае в качестве значения сенсор динамически подставит адрес шлюза по умолчанию, полученный в ходе DHCP-процесса.
Если вам требуется сделать проверки нескольких ресурсов, сделайте несколько записей в параметрах инструкции, и укажите порядковый номер вместо "0".
Для инструкций типа reach в её названии следует явным образом указать название тестируемой цели вместо _resname, что автоматически приведет к созданию метрики с этим именем, например:
reach_tcp443_yandex : yandex.ru
reach_dns_1111 : 1.1.1.1
В качестве результата инструкция для каждой из проверок выдает результат выполнения, численную метрику, например объем скаченных данных, и время скачивания (в миллисекундах):
Результаты возвращаемые различными проверками
проверка | результаты |
---|---|
url_ | success - успешность выполнения проверки (True:False) url - адрес ресурса в сети size - размер загруженной информации duration - время выполнения проверки speed - скорость загрузки |
iperf_ | success - успешность выполнения проверки (True:False) target - адрес ресурса в сети speed_in - входящая скорость speed_out - исходящая скорость jitter_in - входящий джиттер jitter_out - исходящий джиттер lost_percent_in - процент потели входящих пакетов lost_percent_out - процент потери исходящих пакетов |
ping_ | success - успешность выполнения проверки (True:False) target - адрес ресурса в сети delay - задержка loss - процент потели пакетов |
tracert_ | success - успешность выполнения проверки (True:False) target - адрес ресурса в сети delay - задержка hops - число промежуточных хостов на пути также при различных ошибках трассировки может возвращаться error с текстом ошибки |
reach_tcp | success - успешность выполнения проверки (True:False) url - адрес ресурса в сети code - время выполнения проверки key - имя ключа (пример reach_tcp443_yandex ) type - тип проверки (пример TCP443) |
reach_http | success - успешность выполнения проверки (True:False) url - адрес ресурса в сети code - код возврата http key - имя ключа (пример reach_http_yandex) type - тип проверки (пример HTTP) |
reach_dns | success - успешность выполнения проверки (True:False) url - адрес ресурса в сети code - время выполнения проверки key - имя ключа (пример reach_dns_8) type - тип проверки (пример DNS) |
Также возвращается параметры wifi соединения:
tx_fail_rate - процент не переданых кадров
tx_retry_rate - процент павторно отправленных кадров
На основании собираемых данных инструкциями этого типа строится, в том числе, отчет "Качество связи", а также отчеты по метрикам.