Проверяйте в постоянном порядке
- В Data Bridge откройте Настройки → Доступ → Агенты и выберите Agent. Запишите его статус, время инцидента, причину последнего отключения и соответствующую запись журнала.
- На компьютере Agent откройте локальные настройки и Статус. Убедитесь, что служба работает, а компьютер не спит.
- Откройте Диагностика → Запустить диагностику. Устраните первую существенную ошибку на маршруте к Data Bridge.
- После восстановления канала выберите Проверить подключение для ресурса и Проверить в подключении Data Bridge.
Диагностика выполняется от имени учётной записи службы. Открытие API в вашем браузере не подтверждает, что у службы те же прокси, сертификаты и права. Стандартные проверки не изменяют данные; проверка записи в папку требует отдельного подтверждения.
Состояния регистрации и доступа
- Ожидает регистрации. Введите одноразовый ключ локально. Выберите Выдать новый ключ , если он потерян, использован или просрочен.
- Ожидает подтверждения. Сравните локальный код с кодом Data Bridge. Операции станут доступны после подтверждения точного совпадения.
- Активен, не в сети. Проверьте службу, питание и сеть. Само по себе действующее разрешение доступа не означает, что Agent подключён.
- Отключён. Администратор выбирает Включить; новый ключ не требуется.
- Доступ отозван. Выясните причину отзыва, затем получите новый ключ для согласованной регистрации.
- Срок доступа истёк. Администратор продлевает срок доступа в Data Bridge.
AGENT_MACHINE_CHANGED означает несовпадение с зарегистрированным компьютером. При плановом переносе зарегистрируйте новый компьютер с новым ключом; не копируйте каталог состояния. Если перенос не планировался, проверьте журнал и при необходимости отзовите доступ. После временной блокировки попыток регистрации подождите 15 минут и проверьте правильность ключа.
Сеть, прокси и TLS
Диагностика проверяет настройки, прокси, DNS, TCP 443, TLS и шлюз, часы, регистрацию, транспорт и защищённый канал. Выполните рекомендацию рядом с первым неудачным шагом. Если внешние имена разрешает прокси, одно предупреждение DNS ещё не означает сбой.
Если TCP 443 заблокирован, согласуйте исходящий доступ к Data Bridge или настройте прокси. При блокировке WebSocket оставьте автоматический режим или вручную выберите HTTPS-запросы. Для недоверенного сертификата добавьте согласованный корневой PEM, доступный службе для чтения; не отключайте проверку TLS. Если шлюз не найден, проверьте с администратором адрес установки и маршрут agent/v1/ .
Проверьте системный прокси Windows командой netsh winhttp show proxyили настройки прокси macOS командой scutil --proxy. Синхронизируйте часы через настройки операционной системы. Дополнительные настройки приведены в руководстве по настройке сети . В Linux проверьте настройки прокси, доступные самой службе Agent; см. подготовку сети.
Ресурс недоступен
AGENT_POLICY_DENIED означает, что сервер, порт или папка не соответствуют разрешённому ресурсу. Сравните точные параметры подключения с локальной политикой. AGENT_RIGHTS_DENIED указывает на запрещённый метод API или файловую операцию; также проверьте права папки в подключении Data Bridge.
При AGENT_DNS_FAILEDпроверьте разрешение имён на компьютере Agent. AGENT_CONNECT_REFUSED часто означает, что целевая служба не слушает этот порт. При AGENT_CONNECT_TIMEOUT или AGENT_UNREACHABLEпроверьте маршрутизацию и правила межсетевого экрана. AGENT_TLS_CERTIFICATE относится к доверию сертификату ресурса, а не к правам учётной записи базы данных.
AGENT_ACCESS_DENIED — отказ операционной системы. Предоставьте права самой учётной записи службы. Для путей UNC проверьте доступ к общему ресурсу и NTFS; в macOS — системные подключения и необходимые разрешения конфиденциальности. Следуйте соответствующим инструкциям для Windows или macOS . В Linux также проверьте права служебной учётной записи, сетевые подключения и правила SELinux или AppArmor по инструкции доступа.
Ошибки файлов и безопасные повторы
При AGENT_PATH_OUTSIDEиспользуйте путь внутри разрешённой папки без выхода наверх и внешних ссылок. При AGENT_NOT_FOUNDпроверьте путь и маски. AGENT_CHANGED указывает на одновременное изменение файла; повторите после завершения изменения. При AGENT_INTEGRITY_FAILEDфайл не записан из-за несовпадения размера или SHA-256; проверьте стабильность передачи.
При WRITE_OUTCOME_UNKNOWNсначала проверьте целевую папку. Канал отключился после отправки данных, поэтому запись могла завершиться. Не повторяйте её автоматически до проверки результата. При AGENT_TOO_LARGE, AGENT_DISK_FULL и AGENT_BUSYпроверьте соответственно ограничения, свободное место и нагрузку. Оцените возможности системы до увеличения ограничений.
Ошибки установки и обновления
При ошибке установки прочитайте журнал и выполните указанное системное требование. Повторно получите повреждённый пакет у администратора и проверьте SHA-256. Если установка успешна, а регистрация нет, завершите регистрацию в локальной вкладке Подключение .
В разделе Версия и обновленияпроверьте результат: успешно, ошибка, откат или отклонено. Не устанавливайте пакет с недоверенной подписью; обратитесь к поставщику. После отката изучите agent.log, устраните причину и повторите обновление. AGENT_OPERATION_UNKNOWN может требовать обновления Agent; AGENT_HUB_UNAVAILABLE — повторной проверки после восстановления шлюза.
Подготовьте полезный отчёт для поддержки
Скопируйте диагностический отчёт, последние 200 строк agent.log и нужный временной интервал из audit.log. Укажите имя Agent, версии Agent и операционной системы, время инцидента и идентификатор запуска, если он известен. В Windows журналы находятся в C:\ProgramData\UBC Data Bridge Agent\logs\; в macOS — в /Library/Logs/UBC Data Bridge Agent/. В Linux расположение журнала зависит от установленного пакета. Уточните его у администратора и следуйте инструкции обслуживания.
Перед передачей журналов проверьте имена файлов, пользователей и внутренних систем. Никогда не отправляйте ключ регистрации, файлы state или secrets.json. После исправления повторите диагностику, проверку ресурса и контролируемый запуск, затем убедитесь, что операция дала ожидаемый результат.