Troubleshooting

flowlink: command not found

Бинарный файл не найден в PATH

Permission denied при запуске flowlink

Нет прав на выполнение бинарного файла

Port 9081 already in use

Другой сервис использует порт

Missing shared library errors

Отсутствуют системные зависимости

Агент не может подключиться к релею

WebSocket connection failed — проверьте URL и firewall

WebSocket connection drops frequently

Network instability или proxy configuration

Connection timeout при подключении

Port blocked или slow network

TLS handshake failed

Невалидный сертификат или несовместимые cipher suites

DNS resolution failed for relay host

DNS сервер недоступен или неверный hostname

Policy rule not matching expected commands

Неверный паттерн glob или regex

Wrong action applied (block instead of allow)

Конфликт приоритетов между правилами

Policy syntax error on upload

Невалидный JSON или неверная схема

Multiple policies with conflicting rules

Несколько политик применяются к одному агенту

False positive — безопасная команда заблокирована

Shield уровень слишком строгий или неверное правило

Slow shield scan (>2s per command)

Большое количество правил или тяжёлые regex

Shield process crashed with segfault

Баг в eBPF программе или нехватка ресурсов

eBPF program failed to load

Ядро не поддерживает eBPF или неверные параметры

MCP tool not found

MCP сервер не запущен или не обнаружен AI агентом

MCP tools not showing in IDE

Неверная конфигурация MCP в IDE

Tool calls failing with MCP error

Неверный формат аргументов или серверная ошибка

Wrong response format from MCP tool

Версия протокола MCP несовместима

High CPU usage (>80%)

Shield сканирование или слишком частые подключения

High memory usage (>2GB)

Утечка памяти или большой кэш

Slow response time (>1s latency)

Медленный relay или network latency

Periodic latency spikes

GC pauses или scheduled tasks

JWT token expired

Сессия истекла (24h по умолчанию)

Invalid agent token

Token истек или неверный формат

Permission denied при выполнении команд

Insufficient scopes в API ключе

Two-factor authentication not working

Неверный TOTP код или рассинхронизация времени

SAML authentication error

Неверная конфигурация Identity Provider

API key invalid or revoked

Ключ был отозван или содержит опечатку

Database connection refused

PostgreSQL не запущен или неверные credentials

Database migration failed

Несовместимая версия схемы или locked migrations

Slow database queries (>5s)

Отсутствие индексов или большая таблица

Нужно включить verbose логирование

По умолчанию логи в уровне info

Нужно собрать debug output для support

Техподдержке нужны подробные логи для диагностики

Как отслеживать webhook/MCP запросы в реальном времени

Нужен live мониторинг для диагностики

Не могу найти решение проблемы

Проблема может быть уникальной для вашей конфигурации

Нужно сообщить о баге

Нашли баг или неожиданное поведение

Как получить коммерческую поддержку

Нужна гарантированная помощь от команды Flowlink