|
0 |
.\" Copyright Folkert van Heusden, 2003-2015
|
|
1 |
.\"
|
|
2 |
.\" This file may be copied under the conditions described
|
|
3 |
.\" in the GNU GENERAL PUBLIC LICENSE, version 2
|
|
4 |
.\" that can be found on the website of the free software
|
|
5 |
.\" foundation.
|
|
6 |
.\"
|
|
7 |
.TH HTTPING 1 2015-07 "httping"
|
|
8 |
.SH ИМЯ
|
|
9 |
httping - измеряет задержку и пропускную способность веб-сервера
|
|
10 |
.SH СИНТАКСИС
|
|
11 |
.BI "httping [" опции "]
|
|
12 |
.sp
|
|
13 |
опции:
|
|
14 |
.BI "[\-g url] [\-h имя_хоста] [\-p номер_порта] [\-x прокси_хост:порт] [\-c число] [\-i интервал] [\-t тайм-аут] [\-s] [\-G] [\-b] [\-L предел_передачи] [\-X] [\-l] [\-z] [\-f] [\-m] [\-o ко,...] [\-e строка]"
|
|
15 |
.BI "[\-I UserAgent строка] [\-R Referer строка] [\-r] [\-n warn,crit] [\-N режим] [\-q] [\-V]"
|
|
16 |
.SH ОПИСАНИЕ
|
|
17 |
Утилита
|
|
18 |
.B httping
|
|
19 |
позволяет измерять задержку веб-сервера. Начиная с версии 1.0.6 также есть возможность измерять пропускную способность.
|
|
20 |
.PP
|
|
21 |
.SH ОПЦИИ
|
|
22 |
.TP
|
|
23 |
.B "\-5"
|
|
24 |
Выбранный прокси-сервер — это SOCKS5 сервер.
|
|
25 |
.TP
|
|
26 |
.B "\-6"
|
|
27 |
Включить режим IPv6. По умолчанию IPv4.
|
|
28 |
.TP
|
|
29 |
.B "\-a"
|
|
30 |
Слышимый пинг
|
|
31 |
.TP
|
|
32 |
.B "\-b"
|
|
33 |
Используйте этот переключатель вместе с '-\G'. Когда эта опция используется, показывается пропускная способность (в КБ/с).
|
|
34 |
.TP
|
|
35 |
.B "\-B"
|
|
36 |
Используйте этот переключатель вместе с '-\G'. Просит HTTP сервер сжимать возвращаемые данные: это позволит уменьшить важность пропускной способности вашего соединения, увеличивая важность вычислительной мощности HTTP сервера.
|
|
37 |
.TP
|
|
38 |
.B "\-c число"
|
|
39 |
Сколько проб отправить перед тем как выйти.
|
|
40 |
.TP
|
|
41 |
.B "\-D"
|
|
42 |
Не рисовать графики в режиме ncurses (-\K).
|
|
43 |
.TP
|
|
44 |
.B "\-e строка"
|
|
45 |
Когда код ответа отличается от указанных в '\-o', отображать данную строку.
|
|
46 |
.TP
|
|
47 |
.B "\-E"
|
|
48 |
Получить настройки прокси-сервера из переменных окружения ('http_proxy' и 'https_proxy').
|
|
49 |
.TP
|
|
50 |
.B "\-F"
|
|
51 |
Попытаться использовать TCP Fast Open подключаясь к серверу (для Linux ядра версии 3.7 и более)
|
|
52 |
.TP
|
|
53 |
.B "\-f"
|
|
54 |
Флуд пинг: не сидеть сложа руки между каждым пингом, а пинговать быстро, насколько компьютер и сеть позволит вам.
|
|
55 |
.TP
|
|
56 |
.B "\-G"
|
|
57 |
Делать GET запрос вместо HEAD запроса: это значит, что полная страница/файл будет передан. Обратите внимание, в данном случае вы больше не измеряете задержку!
|
|
58 |
.TP
|
|
59 |
.B "\-g URL"
|
|
60 |
Устанавливает URL для проб. К примеру: http://localhost/
|
|
61 |
.TP
|
|
62 |
.B "\-h имя_хоста"
|
|
63 |
Используя '\-h' вместо '\-g' можно также установить имя хоста, к примеру: \-h localhost
|
|
64 |
.TP
|
|
65 |
.B "\-I строка"
|
|
66 |
UserAgent строка для отправки веб-серверу (по умолчанию 'HTTPing <версия>').
|
|
67 |
.TP
|
|
68 |
.B "\-i interval"
|
|
69 |
Сколько секунд между отправкой каждой пробы.
|
|
70 |
.TP
|
|
71 |
.B "\-K"
|
|
72 |
Включить пользовательский интерфейс ncurses.
|
|
73 |
.TP
|
|
74 |
.B "\-L x"
|
|
75 |
Используйте этот переключатель вместе с '\-G'. Ограничивает объем передаваемых данных значением 'х'. Обратите внимание, это влияет только на содержание страницы/файла, а не на заголовки.
|
|
76 |
.TP
|
|
77 |
.B "\-l"
|
|
78 |
Подключаться с помощью SSL: чтобы это работало вы должны задать 'https'-URL или номер порта 443.
|
|
79 |
.TP
|
|
80 |
.B "\-m"
|
|
81 |
Показывать машиносчитываемый вывод (смотрите также '\-o' и '\-e').
|
|
82 |
.TP
|
|
83 |
.B "\-N x"
|
|
84 |
Переключает HTTPing в режим 2 Nagios плагина: возвращает 0, когда все хорошо, "х", когда что-то не так. Т.е.: 1 => Nagios состояние warning, 2 => Nagios состояние critical.
|
|
85 |
.TP
|
|
86 |
.B "\-n warn,crit"
|
|
87 |
Переключает HTTPing в режим 1 Nagios плагина: возвращает код выхода '1', когда среднее время отклика больше "warn", и возвращает код выхода '2', когда время средний отклик больше "crit". Во всех остальных случаях возвращает код выхода '0'.
|
|
88 |
.TP
|
|
89 |
.B "\-o x,x,..."
|
|
90 |
Устанавливает HTTP-коды, которые рассматриваются как ОК-состояния (только с '\-m').
|
|
91 |
.TP
|
|
92 |
.B "\-p portnumber"
|
|
93 |
\-p может быть использован вместе с \-h. \-p выбирает номер_порта для пробы.
|
|
94 |
.TP
|
|
95 |
.B "\-q"
|
|
96 |
Без подробностей, возвращать только код выхода.
|
|
97 |
.TP
|
|
98 |
.B "\-R строка"
|
|
99 |
Referer строка для отправки на веб-сервер.
|
|
100 |
.TP
|
|
101 |
.B "\-Q"
|
|
102 |
Использовать постоянное соединение, т.е. переиспользовать то же самое TCP соединение для нескольких HTTP запросов. обычно возможно когда 'Connection: Keep-Alive' отправлено сервером. добавляет 'C' в вывод если httping был вынужден переподключиться
|
|
103 |
.TP
|
|
104 |
.B "\-r"
|
|
105 |
Резолвить имя хоста только раз: это убирает резолвинг из цикла, так что латентность DNS не измеряется. Также полезно когда вы хотите измерить только 1 веб-сервер, а DNS возвращает новый IP-адрес на каждом резолве ('round robin').
|
|
106 |
.TP
|
|
107 |
.B "\-S"
|
|
108 |
Разделяет измеряемую задержку на время для подключения и на время обмена запросом с HTTP сервером.
|
|
109 |
.TP
|
|
110 |
.B "\-s"
|
|
111 |
Когда транзакция успешна завершена, показывать HTTP код ответа (200, 404 и т.д.).
|
|
112 |
.TP
|
|
113 |
.B "\-T x"
|
|
114 |
Читать пароль для аутентификации веб-сайта из файла 'х' (вместо ввода его в командной строке).
|
|
115 |
.TP
|
|
116 |
.B "\-t тайм-аут"
|
|
117 |
Как долго ждать ответа с другой стороны.
|
|
118 |
.TP
|
|
119 |
.B "\-U"
|
|
120 |
Включить аутентификацию для веб-сайта. Установливайте имя пользователя с помощью \-U, пароль с помощью \-P (или используйте \-T, чтобы прочитать пароль из файла).
|
|
121 |
.TP
|
|
122 |
.B "\-v"
|
|
123 |
Увеличить уровень подробностей. Покажет стандартное отклонение и даты в выводе.
|
|
124 |
.TP
|
|
125 |
.B "\-W"
|
|
126 |
Не прерывать программу если резолвинг не удался.
|
|
127 |
.TP
|
|
128 |
.B "\-X"
|
|
129 |
Используйте этот переключатель вместе с '\-G'. Для каждого пинга показывать количество переданных данных (за исключением заголовков).
|
|
130 |
.TP
|
|
131 |
.B "\-x прокси_хост[:порт]
|
|
132 |
Совершать пробу с помощью прокси сервера. Обратите внимание, вы также измеряете задержку работы с прокси сервером!
|
|
133 |
.TP
|
|
134 |
.B "\-Y"
|
|
135 |
Включить цвета
|
|
136 |
.TP
|
|
137 |
.B "\-z"
|
|
138 |
При подключении с помощью SSL, показывать фингерпринт X509 сертификата(ов) пиров.
|
|
139 |
.TP
|
|
140 |
.B "\-\-abbreviate"
|
|
141 |
Сокращать значения больше, чем тысяча, миллион, миллиард, и т.д.
|
|
142 |
.TP
|
|
143 |
.B "\-\-adaptive-interval" или "\-\-ai"
|
|
144 |
(Пытается) исполнять пинг на одном интервале. Например, если интервал установлен в 1.0 секунду и t[n] от пинга до пинга является 500s с длительностью 250 мс, то следующий пинг (t[n+1]) произойдет на 501 секунде, а не на 501.25 секунде. Конечно, когда длительность пинга > больше, чем интервал, пинг будет "пропущен" (не в буквальном смысле: последовательный номер продолжится) и t[n+1] будет на 502-й секунде вместо ожидаемой 501-й. Это полезно, например, в режиме вывода библиотеки, где FFT вычисляется по длительности пинга.
|
|
145 |
.TP
|
|
146 |
.B "\-\-aggregates x[,y[,z[,т.д.]]]"
|
|
147 |
Показывать совокупный результат каждые x[,y[,z[,т.д.]]] секунд.
|
|
148 |
.TP
|
|
149 |
.B "\-\-divert\-connect x"
|
|
150 |
Не обращать внимания на имя хоста в URL и вместо этого подключаться к 'х'. Данный ранее URL будет запрошен у 'х'.
|
|
151 |
.TP
|
|
152 |
.B "\-\-draw-phase"
|
|
153 |
Рисовать не только величину преобразования Фурье, но также и фазу.
|
|
154 |
.TP
|
|
155 |
.B "\-\-graph\-limit x"
|
|
156 |
Если измеренные значения больше, чем х, то ограничить их х.
|
|
157 |
.TP
|
|
158 |
.B "\-\-header x"
|
|
159 |
Добавить дополнительный заголовок запроса 'х'.
|
|
160 |
.TP
|
|
161 |
.B "\-\-keep\-cookies"
|
|
162 |
Когда сервер отправляет куки, оно будет отправлено назад в следующем запросе.
|
|
163 |
.TP
|
|
164 |
.B "\-\-max\-mtu x"
|
|
165 |
Максимальное значение MTU для использования. Не может быть больше, чем MTU сетевого интерфейса.
|
|
166 |
.TP
|
|
167 |
.B "\-\-no\-host\-header"
|
|
168 |
Не ставить "Host:" заголовок в заголовки запроса.
|
|
169 |
.TP
|
|
170 |
.B "\-\-no\-tcp\-nodelay"
|
|
171 |
Не отключать "задержку TCP" (Naggle).
|
|
172 |
.TP
|
|
173 |
.B "\-\-priority x"
|
|
174 |
Установить приоритет пакетов.
|
|
175 |
.TP
|
|
176 |
.B "\-\-tos x"
|
|
177 |
Установить тип сервиса.
|
|
178 |
.TP
|
|
179 |
.B "\-\-proxy\-user x"
|
|
180 |
Использовать имя пользователя 'х' для аутентификации на прокси-сервере (http/socks5) (опционально).
|
|
181 |
.TP
|
|
182 |
.B "\-\-proxy\-password x"
|
|
183 |
Использовать пароль 'х' для аутентификации на прокси-сервере (http/socks5) (опционально).
|
|
184 |
.TP
|
|
185 |
.B "\-\-proxy\-password-file x"
|
|
186 |
Читать пароль из файла 'х' для аутентификации на прокси-сервере (http/socks5) (опционально).
|
|
187 |
.TP
|
|
188 |
.B "\-\-recv-buffer x"
|
|
189 |
Установить размер буфера приема (в байтах).
|
|
190 |
.TP
|
|
191 |
.B "\-\-slow\-log x"
|
|
192 |
Когда длительность больше или равна x, показывать строку пинга в окне медленного журнала (среднее окно).
|
|
193 |
.TP
|
|
194 |
.B "\-\-threshold\-red x"
|
|
195 |
Если измеренный пинг выше, чем х (и \-Y установлен), то показываемое значение будет покрашено в красный. Если вы также используете \-\-threshold\-yellow, то это значение должно быть больше.
|
|
196 |
.TP
|
|
197 |
.B "\-\-threshold\-yellow x"
|
|
198 |
Если измеренный пинг выше, чем х (и \-Y установлен), то показываемое значение будет покрашено в желтый.
|
|
199 |
.TP
|
|
200 |
.B "\-\-threshold\-show x"
|
|
201 |
Если измеренный пинг выше, чем х, то результат будет отображен (по умолчанию отображается всегда). Значение х в мс.
|
|
202 |
.TP
|
|
203 |
.B "\-\-timestamp" or "\-\-ts"
|
|
204 |
Показывать таймстамп перед строками с результатами. Используйте опцию \-v, чтобы показывать также и дату.
|
|
205 |
.TP
|
|
206 |
.B "\-\-tx-buffer x"
|
|
207 |
Установить размер буфера передачи (в байтах).
|
|
208 |
.TP
|
|
209 |
.B "\-V"
|
|
210 |
Показать версию и выйти.
|
|
211 |
|
|
212 |
.SH ВЫВОД
|
|
213 |
В режиме разделения экрана (\-S) вы увидите что-то вроде "время=0.08+24.09+23.17+15.64+0.02=62.98 мс". Первое значение — это время, которое потребовалось, чтобы зарезолвить имя хоста (или 'Н/Д', если оно не резолвилось на этой итерации, например, в режиме "резолвить один раз" (\-r)), затем время, которое потребовалось для подключения (Или \-1 в, например, постоянных соединениях (\-Q, HTTP v1.1)), после этого время, которое потребовалось, чтобы произвести операцию записи, затем, то время, которое потребовалось для HTTP сервера, чтобы обработать запрос и отправить его обратно и, наконец, время, которое потребовалось, чтобы закрыть соединение.
|
|
214 |
|
|
215 |
.SH ГРАФИК
|
|
216 |
График в ncurses использует цвета для кодирования смысла. Зеленый: значение меньше, чем 1 блок. Красный: значение не укладывается в график. Синий: значение было ограничено опцией -\-\-graph\-limit. Бирюзовый: нет измерения для этого момента времени.
|
|
217 |
|
|
218 |
.SH КЛАВИШИ
|
|
219 |
Нажмите <Ctrl> + <c>, чтобы выйти из программы. Это отобразит краткую информацию о том, что было измерено.
|
|
220 |
В графическом интерфейсе ncurses, нажмите клавишу <Ctrl> + <l> для принудительной перерисовки экрана. Нажмите 'H', чтобы остановить графики (и снова, чтобы продолжить). Нажмите 'q', чтобы остановить программу (или <Ctrl> + <c>).
|
|
221 |
|
|
222 |
.SH ПРИМЕРЫ
|
|
223 |
.TP
|
|
224 |
.B "httping \-g http://localhost/"
|
|
225 |
Исполнить пинг к веб-серверу на хосте "localhost".
|
|
226 |
.TP
|
|
227 |
.B "httping \-h localhost \-p 1000"
|
|
228 |
Исполнить пинг к веб-серверу на хосте "localhost" с номером порта 1000.
|
|
229 |
.TP
|
|
230 |
.B "httping \-l \-g https://localhost/"
|
|
231 |
Исполнить пинг к веб-серверу на хосте "localhost" с помощью соединения SSL.
|
|
232 |
.TP
|
|
233 |
.B "httping \-g http://localhost/ -U username -P password"
|
|
234 |
Исполнить пинг к веб-серверу на хосте "localhost", используя HTTP Basic Authentication..
|
|
235 |
.SH БАГИ
|
|
236 |
Нету. В этой программе полностью отсутствуют баги.
|
|
237 |
|
|
238 |
.SH "СМОТРИТЕ ТАКЖЕ"
|
|
239 |
.BR http://www.vanheusden.com/httping/
|
|
240 |
|
|
241 |
.SH ЗАМЕТКИ
|
|
242 |
Эта страница описывает
|
|
243 |
.B httping
|
|
244 |
, который содержится в пакете httping-2.3; другие версии могут немного отличаться.
|
|
245 |
Пожалуйста, отправляйте исправления и дополнения на mail@vanheusden.com.
|
|
246 |
Сообщить об ошибках в программе можно по адресу mail@vanheusden.com.
|
|
247 |
Пожалуйста, рассмотрите возможность отправки Биткоинов по адресу 1N5Sn4jny4xVwTwSYLnf7WnFQEGoVRmTQF
|