Перевіряйте проблему послідовно

  1. У Data Bridge відкрийте Налаштування → Доступ → Агенти й потрібного агента. Зафіксуйте стан, час проблеми, останню причину від’єднання та запис у журналі.
  2. На комп’ютері Agent відкрийте локальні налаштування та вкладку Стан. Перевірте, чи працює служба й чи комп’ютер не спить.
  3. Відкрийте Діагностика → Запустити діагностику. Усуньте першу суттєву помилку маршруту до Data Bridge.
  4. Після відновлення каналу натисніть Перевірити підключення для конкретного ресурсу й Тест у підключенні Data Bridge.

Діагностика працює від імені служби. Успішне відкриття API у вашому браузері не доводить, що служба має той самий проксі, сертифікати або права. Звичайні перевірки не змінюють дані; пробний запис у папку потребує окремого підтвердження.

Стани реєстрації та доступу

  • Очікує реєстрації. Введіть одноразовий ключ у локальному вікні. Для втраченого, використаного або простроченого ключа виберіть Видати новий ключ.
  • Очікує підтвердження. Порівняйте коди на комп’ютері й у Data Bridge; операції дозволяються після підтвердження точного збігу.
  • Діє, не на зв’язку. Перевірте службу, живлення та мережу. Сам статус «Діє» не означає активне з’єднання.
  • Вимкнено. Адміністратор відновлює доступ дією Увімкнути; новий ключ не потрібен.
  • Доступ відкликано. З’ясуйте причину відкликання, потім отримайте новий ключ для дозволеної повторної реєстрації.
  • Строк доступу минув. Адміністратор продовжує строк у 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_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_HUB_UNAVAILABLE — повторної перевірки після відновлення шлюзу.

Що підготувати для підтримки

Скопіюйте звіт діагностики, останні 200 рядків agent.log і потрібний часовий проміжок audit.log. Додайте назву агента, версії агента й ОС, час проблеми та ідентифікатор запуску, якщо він відомий. Windows зберігає журнали в C:\ProgramData\UBC Data Bridge Agent\logs\; macOS — у /Library/Logs/UBC Data Bridge Agent/. У Linux розташування журналу залежить від установленого пакета; уточніть його в адміністратора та скористайтеся інструкцією обслуговування.

Перед передаванням перегляньте назви файлів, користувачів і внутрішніх систем у журналі. Нікому не надсилайте ключ реєстрації, файли state або secrets.json. Після виправлення повторіть діагностику, тест ресурсу та контрольний запуск і переконайтеся, що результат операції відповідає очікуваному.