Журналы и просмотр запросов
На этой странице 8 разделов
- Что и где доступно
- Инспектор запросов для HTTP-туннелей
- Открытие инспектора
- Список запросов
- Сведения о запросе и ответе
- Повтор запроса
- Выключение и включение журнала запросов
- Журнал подключений для других туннелей
- Скачивание журнала в CSV
- Журнал активности
- Состояние туннеля
- Когда туннель останавливается
- Устранение неполадок
- Связанные страницы
Посмотрите, что происходит с туннелем: просматривайте и повторяйте HTTP-запросы, которые он получает, изучайте список подключений к нему, читайте журнал запусков, остановок и изменений настроек и проверяйте его состояние в течение дня. Эта страница также подскажет, где искать причину, если туннель остановился.
Что и где доступно #
Всё это строки панели настроек туннеля: откройте страницу нужного типа туннеля в разделе Мои туннели и выберите Настройки в строке туннеля.
| Строка | Что открывается | Типы туннелей |
|---|---|---|
| Журнал запросов | Инспектор запросов с записанными запросами и ответами. | HTTP, MCP-шлюз |
| Журнал запросов | Журнал подключений: кто подключался, когда и куда. | TCP - UDP, TLS, Файловый сервер, Прокси-сервер |
| Журнал активности | Запуски, остановки и изменения настроек туннеля. | Все типы туннелей |
| Состояние туннеля | Результаты регулярных проверок состояния. | Все типы туннелей, кроме Файлового сервера |
| Статистика трафика | Данные, прошедшие через туннель. См. Лимиты и срок действия. | Все типы туннелей |
Ротационный прокси ведёт журналы запросов отдельно для каждого клиента: используйте кнопку Журнал запросов у клиента. См. Ротационный прокси.
Инспектор запросов для HTTP-туннелей #
Инспектор показывает HTTP-запросы, которые поступают на туннель HTTP или MCP-шлюза, вместе с их заголовками и телами, а также ответы вашего сервиса. Используйте его для отладки вебхуков и вызовов API без добавления журналирования в ваш собственный код. Запросы записываются только после того, как вы включите журнал, как описано ниже.
Запись не является побайтовой копией. Тело сохраняется до 16 КБ и только для текстовых форматов, таких как JSON, XML, HTML, простой текст и данные формы в URL-кодировке. Значения чувствительных заголовков, таких как Authorization, Cookie и X-Api-Key, сохраняются как [MASKED].
Открытие инспектора #
- В настройках туннеля выберите Журнал запросов › Показать или
- в списке туннелей нажмите кнопку с подсказкой Журнал запросов и ответов. Если туннель остановлен, эта кнопка сначала просит его запустить. Для туннелей, у которых в столбце Сервер указано Локальный или VPN, она отключена, с подсказкой «Недоступно для Client Relay».
Страница Инспектор откроется в новой вкладке.
Список запросов #
Карточка HTTP-запросы показывает запросы, сначала самые новые, и подгружает ещё при прокрутке. Пока значок показывает Онлайн, список обновляется каждые 3 секунды.
| Столбец | Что показывает |
|---|---|
| Метод | HTTP-метод, например GET или POST. |
| Эндпоинт | Запрошенный путь. |
| Страна, IP | Откуда пришёл запрос. |
| Дата и время | Когда запрос поступил, по времени вашего браузера. |
| Статус | Код состояния HTTP, которым ответил ваш сервис. |
| Длительность | Сколько времени занял ответ, в секундах. |
Без фильтра список охватывает последние 24 часа. Фильтр по дате предлагает Сегодня, Вчера, Последние 7 дней и Свой период и охватывает сегодняшний день и шесть предыдущих. Фильтр по дате приостанавливает обновление списка в реальном времени; чтобы вернуться к нему, выберите В реальном времени. Журналы инспекции хранятся до 7 дней.
Сведения о запросе и ответе #
Выберите запрос, чтобы открыть его сведения.
| Часть | Вкладка | Что показывает |
|---|---|---|
| Запрос | Сводка | Идентификатор запроса, IP запроса, метод, хост, путь, полный URL, время, длина URL и число заголовков. |
| Запрос | Заголовки | Все заголовки запроса с их значениями. |
| Запрос | Тело | Тело запроса. JSON форматируется для удобного чтения. Кнопка Копировать копирует его. |
| Запрос | Данные IP | Часовой пояс, континент, страна, город, почтовый индекс, регион и координаты IP-адреса посетителя. |
| Ответ | Сводка | Идентификатор ответа, статус, время ответа и число заголовков. |
| Ответ | Заголовки, Тело | Что ваш сервис отправил в ответ. |
Повтор запроса #
Повтор избавляет от необходимости заново запускать тот же вебхук у отправителя.
- Повторить отправляет выбранный запрос ещё раз по его записи. Страница показывает «Запрос успешно повторён.» сразу после того, как повтор запрошен; результата она не ждёт.
- Изменить открывает окно Изменить запрос, где перед нажатием Повторить можно изменить метод (GET, POST, PUT, DELETE или PATCH), Путь, заголовки (Добавить заголовок) и Тело.
Повторный запрос отправляет приложение Localtonet на устройстве туннеля, поэтому приложение должно быть подключено.
Выключение и включение журнала запросов #
Запросы записываются только пока журнал включён, а туннель запускается с выключенным журналом. Пока он выключен, страница показывает «Журнал запросов выключен — новые запросы не записываются.» с кнопкой Включить журнал. Кнопка Выключить журнал снова прекращает запись новых запросов. Выключайте журнал для туннеля, который передаёт данные, не подлежащие хранению, например пароли или персональные данные в телах запросов. Изменение записывается в Журнал активности как «Настройка HTTP-вебхука изменена.»
Журнал подключений для других туннелей #
В туннелях TCP - UDP, TLS, Файловый сервер и Прокси-сервер Журнал запросов › Показать открывает окно Журнал запросов. В нём перечислены подключения к туннелю, сначала самые новые, по 30 на страницу.
| Столбец | Что показывает |
|---|---|
| IP посетителя | Адрес, который подключился к туннелю. |
| IP клиента | Адрес клиента, записанный для подключения. |
| Назначение | Куда направлено подключение. Для прокси-туннеля это посещённые хост и порт. |
| Дата | Когда это произошло, по часовому поясу вашего аккаунта. |
Этот журнал содержит только метаданные подключений. Того, что передавалось по подключению, в нём нет.
Скачивание журнала в CSV #
В разделе Скачать в CSV выберите период до 30 дней и нажмите Скачать. Имя файла начинается с RequestLogs-, затем идёт внутренний идентификатор туннеля, а заканчивается оно на .csv. В файле есть столбцы Дата и время, IP запроса, IP клиента, Назначение, Токен и Протокол. Для более длительного периода скачайте несколько диапазонов по очереди. Скачивание ограничено одним разом в минуту, поэтому между двумя скачиваниями подождите минуту.
Журнал активности #
Журнал активности › Показать перечисляет события, произошедшие с самим туннелем, сначала самые новые. В каждой записи указаны дата и время по часовому поясу вашего аккаунта, канал, из которого пришло действие, и предложение, описывающее изменение.
| Канал | Действие пришло из |
|---|---|
| Веб | Панель управления. |
| API | API. |
| CLI | Командная строка. |
| Система | Сам Localtonet, например при достижении лимита. |
Типичные записи:
- Туннель запущен.
- Туннель остановлен.
- Локальный порт изменён с «3000» на «8080».
- Добавлено ограничение по IP: «203.0.113.10»
- Лимит трафика изменён: «10.00 GB»
- Срок действия отключён.
Новый или изменённый пароль в журнал не записывается. Он отображается как «Пароль задан.» или «Пароль изменён.»
Состояние туннеля #
Состояние туннеля › Показать открывает окно Проверки состояния. Localtonet проверяет туннель каждые 10 минут. Каждый квадрат — одна проверка, по времени суток, за текущий день.
| Значение | Смысл |
|---|---|
| Исправен | Во время проверки туннель был подключён. |
| Сбой | Во время проверки туннель не был подключён. |
| Неизвестно | Для этого времени и для более раннего времени результата нет. |
| Нет данных | Это время сегодня ещё не наступило. |
| Аптайм | Доля успешных проверок среди успешных и неуспешных. |
Если в окне нет квадратов, оно сообщает «Проверок пока нет. Результаты появятся здесь, когда туннель поработает какое-то время.»
Когда туннель останавливается #
Сначала откройте Журнал активности туннеля. Причина указана в самой новой записи об остановке.
| Запись в журнале активности | Что произошло | Что делать |
|---|---|---|
| «Туннель остановлен.» | Его остановил кто-то из пользователей. Канал показывает, откуда пришло действие, например Веб для панели управления или API. | Нажмите Запустить. |
| «Туннель остановлен: достигнут лимит трафика туннеля.» | Достигнут собственный Лимит трафика туннеля. | Увеличьте лимит или сбросьте использование. См. Лимиты и срок действия. |
| «Туннель остановлен: истёк срок действия.» | Срок действия туннеля истёк. | Задайте более позднюю дату или отключите срок. См. Лимиты и срок действия. |
| «Туннель остановлен: исчерпан лимит бесплатного использования.» | Достигнут лимит сеанса Бесплатного тарифа. | Нажмите Запустить, чтобы начать новый сеанс, или пополните баланс. См. Тарифы и баланс. |
| «Туннель остановлен: превышен общий лимит трафика.» | Трафик аккаунта исчерпан. | См. Тарифы и баланс. |
| «Туннель остановлен: он был неактивен и не имел подключений.» | Localtonet остановил туннель, который был запущен, но не подключён. | Держите приложение Localtonet подключённым и нажмите Запустить, когда туннель снова понадобится. |
Если в журнале нет остановки, но адрес не отвечает, посмотрите столбец Подключение в списке туннелей. ВЫКЛ означает, что туннель не подключён: запустите приложение Localtonet на устройстве. Если вы нажмёте Запустить, пока приложение не в сети, панель управления откроет окно с заголовком «NAME не в сети» и текстом «Ждём подключения приложения…». Туннель запустится сам, как только приложение подключится; Всё равно запустить включает туннель сейчас, и он заработает, когда приложение подключится.
Узнавайте, когда туннель отключается. Страница Вебхуки панели управления может отправлять POST-запрос с JSON на ваш URL, когда туннель подключается или отключается. См. Вебхуки.
Устранение неполадок #
«Сначала запустите туннель.»
Кнопка инспектора в списке туннелей открывается только для работающего туннеля. Запустите туннель или откройте инспектор через Журнал запросов › Показать в настройках туннеля.
Инспектор остаётся пустым
Проверьте три момента: не показан баннер «Журнал запросов выключен»; не включён фильтр по дате (выберите В реальном времени); запрос действительно приходит на адрес туннеля, а не на другой адрес вашего сервиса.
«Запросов пока нет.» или «Данные не найдены!»
В журнале подключений нет записей для туннеля или нет записей за период, выбранный для CSV. Выберите другой период.
«Для этого туннеля записей в журнале нет.»
В журнале активности пока нет записей. Он заполняется по мере запуска, остановки и изменения туннеля.