Журнали та перевірка
На цій сторінці 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 не в мережі» і текстом «Очікуємо підключення застосунку…». Тунель запускається сам, щойно застосунок підключиться; Запустити все одно вмикає тунель зараз, і він запрацює, коли застосунок підключиться.
Дізнавайтеся, коли тунель перестає працювати. Сторінка Вебхуки на панелі керування може надсилати JSON POST-запит на вашу URL-адресу, коли тунель підключається або відключається. Див. Вебхуки.
Усунення несправностей #
«Спершу запустіть тунель.»
Кнопка інспектора у списку тунелів відкривається лише для запущеного тунелю. Запустіть тунель або відкрийте інспектор через Журнал запитів › Показати в налаштуваннях тунелю.
Інспектор залишається порожнім
Перевірте три речі: банер «Журналювання запитів вимкнено» не показується; фільтр за датою не активний (виберіть Наживо); запит справді надходить на адресу тунелю, а не на іншу адресу вашого сервісу.
«Запитів ще не записано.» або «Дані не знайдено!»
У журналі підключень немає записів для тунелю або немає записів за діапазон, який ви вибрали для CSV. Виберіть інший діапазон.
«Для цього тунелю журналів не знайдено.»
У журналі активності ще немає записів. Він заповнюється в міру запуску, зупинки та змін тунелю.