Документация / 14

Поиск неисправностей

Начните с симптома. Проверяйте по одному уровню за раз.

Панель запрашивает токен

Используйте токен панели из локального файла, отображаемого программой запуска. Для Docker запустите команду «docker compose exec tgwitness cat /data/panel-token.txt». Код входа в Telegram, токен BotFather и токен witness, доступный только для чтения, служат разным целям.

Telegram не подключается

Откройте настройки подключения и запустите проверку соединения. При использовании общедоступного прокси попробуйте другой запись и явно сохраните маршрут. Проверьте тип прокси и поддерживаемый формат секретного ключа. Обновление общедоступного списка не приводит к смене маршрута учетной записи.

Подключено, но новых сообщений нет

1. Убедитесь, что наблюдение выполняется в нужном рабочем пространстве.
2. Убедитесь, что источник выбран и доступен для просмотра данной учётной записи.
3. Отправьте новое уникальное сообщение в контролируемой группе и найдите именно этот текст.
4. Проверьте журнал работы на наличие перерывов, задержек в работе или ошибок Telegram.

Исторические моментальные снимки и события появления новых сообщений — это разные вещи. «Тихий» источник можно подключить без генерации новых сообщений. Если важна полнота данных, используйте тест контролируемой доставки.

FloodWait или задержка после перезапуска

FloodWait означает, что Telegram требует паузы. Подождите указанный период времени и проверьте нагрузку на систему сбора данных; повторные попытки подключения не снимают ограничение. Сохраненное состояние обновлений помогает наверстать упущенное после перезапуска, однако просроченные обновления и некоторые периоды прерывания остаются ограничениями. Зафиксируйте пробел, а не рассматривайте журнал как полный.

Бот настроен, но ничего не публикует

Убедитесь, что процесс Witness действительно запущен, что бот может публиковать сообщения в канале, а Witness имеет доступ к коллектору и API бота. Проверьте журнал на наличие неудачных публикаций. Один лишь успешный запрос к коллектору не подтверждает публикацию в канале.

Где находится интеграция с токенами GitHub?

В стадии планирования. В разделе «Дополнительная информация» описывается предлагаемый рабочий процесс проверки форка и сборки. В настоящее время отсутствует форма для ввода токена GitHub или автоматизированная проверка соответствия работающей установки репозиторию. Ознакомьтесь с текущим статусом функциональности.

При сообщении о проблеме указывайте версию, операционную систему, последовательность действий и отредактированное сообщение об ошибке. Не указывайте в публичных заявках данные о сессиях, токенах, личных сообщениях и каталоге данных.