Устранение неполадок Data Gateway

В агенте Data Gateway используйте параметры навигатора Data Gateway, чтобы отобразить страницы "Статус", "Журналы" и "Запрос" для отслеживания трафика удаленного подключения, а также устранения распространенных проблем с подключением и производительностью.

Перед запуском настройте агенты Data Gateway с помощью консоли. См. здесь: Настройка и регистрация Data Gateway для отчетности.
Темы

Нажмите "Навигатор", чтобы перейти к страницам Data Gateway.

Описание GUID-12258C9F-20C9-4812-AED5-9A886A025BFE-default.png ниже
.png

Диагностика проблем подключения с помощью страницы "Статус"

Используйте эту страницу для просмотра запросов базы данных, которые агент Data Gateway создает с помощью удаленной базы данных.

В агенте Data Gateway нажмите Навигатор, а затем выберите Статус, чтобы просмотреть запросы базы данных.

Для диагностики проблем обычно выполняется поиск по дате или статусу задания:
  • Для поиска по дате в поле Поисковый запрос введите полностью или частично дату и время в формате "ГГГГ-ММ-ДД ЧЧ-ММ-СС". Например, введите "2022-03-28", чтобы просмотреть записи за 28 марта 2022 года.
  • Чтобы выполнить поиск заданий со сбоем, в поле Поисковый запрос введите "REQUEST FINISHED WITH ERRORS".

Очистите поле Поисковый запрос, чтобы просмотреть все задания.
Описание GUID-0476B3A6-F490-44F2-B7D4-E1EDE0FD0B49-default.png ниже
.png

Нажмите на задание, чтобы просмотреть подробную информацию о статусе.
Описание GUID-DDFD4D08-83CA-4134-A739-517DE4EBBC0B-default.png ниже
.png

Диагностика проблем подключения с помощью страницы "Журналы"

Эта страница используется для просмотра записей журнала агента Data Gateway с целью анализа трафика подключения.

В агенте Data Gateway нажмите Навигатор, а затем выберите Журналы, чтобы просмотреть записи журнала. Активируйте параметр Включить опрос журнала и выберите соответствующий уровень ведения журнала. Например, для диагностики проблем с подключением можно установить для параметра Тип журнала значение Отладка.
Описание GUID-B3F74324-7D86-492D-AF32-DD13F152A57F-default.png ниже
.png

После устранения неполадок Oracle рекомендует дезактивировать параметр Включить опрос для журнала или настроить Тип журнала, чтобы сохранять меньше информации.

Диагностика проблем подключения с помощью страницы "Запрос"

Используйте эту страницу, чтобы запрашивать удаленную базу данных от агента Data Gateway для тестирования подключения и оценки производительности.

В агенте Data Gateway нажмите Навигатор, а затем выберите Запрос, чтобы выполнить инструкцию SQL непосредственно из агента Data Gateway в (локальной) базе данных. Например, можно скопировать строку запроса, строку подключения и класс драйвера из задания со сбоем, указанного на странице Статус. Укажите учетные данные базы данных и выполните запрос, чтобы просмотреть результат и статистику производительности (затраченное время). Примечание. Удаленная база данных должна поддерживать подключение с использованием строки подключения JDBC.
Описание GUID-D263ECAE-DE5F-4FC7-8A4E-D468B24E0A90-default.png ниже
.png

Советы по устранению проблем с подключением

Ниже представлены некоторые проблемы с подключением, с которыми вы можете столкнуться, а также советы по их устранению.

Проблемы, связанные с информационными панелями и анализами

Проблема, о которой сообщили пользователи Требуемые действия
Код ошибки 603: агенты не подключены

Убедитесь, что агент Data Gateway запущен и включен на странице конфигурации Data Gateway. С помощью Data Gateway в Linux: запустите команду $ <Data Gateway Install Directory>/domain/bin/status.sh и узнайте, какое значение (UP или DOWN) имеет "Статус Data Gateway". С помощью Data Gateway в Windows: проверьте наличие процессов "datagateway.exe" на вкладке "Диспетчер задач > Сведения".
[nQSError: 77031] Ошибка возникает при вызове удаленного сервиса DatasourceService. Сведения. [JDSError : 78] Ошибка из-за неверно сформированного URL-адреса Просмотрите пул подключений в семантической модели и проверьте настройки на вкладках "Общие" и "Прочее".

Проблемы с подключениями или наборами данных

Проблема, о которой сообщили пользователи Требуемые действия
Код ошибки 603: агенты не подключены Убедитесь, что агент Data Gateway запущен. С помощью Data Gateway в Linux: запустите команду $ <Каталог установки Data Gateway>/domain/bin/status.sh и узнайте, какое значение (UP или DOWN) имеет "Статус Data Gateway". Для агентов Data Gateway в Windows: проверьте наличие процессов "datagateway.exe" на вкладке "Сведения" диспетчера задач.
Сбой при сохранении подключения. Указаны неверные сведения о подключении. Введите верные сведения и повторите попытку. Эта ошибка отображается в диалоговом окне подключения при создании подключения к DB2 или SQL Server.

На странице Статус агента, также отображается сообщение "REQUEST FINISHED WITH ERRORS", а при нажатии на запросы следующая ошибка: "[JDSError : 110] JDS - Invalid connect string / URL to external source, Cause: Invalid Oracle URL specified".

Обход:

  1. Отредактируйте файл <Data Gateway Install Directory>/oracle_common/jdk1.8.0_333/jre/lib/security/java.security.
  2. Найдите этот текст (примерно в строке номер 720):

    jdk.tls.disabledAlgorithms=SSLv3, TLSv1, TLSv1.1, RC4, DES, MD5withRSA, \

  3. Измените его на следующий текст:

    jdk.tls.disabledAlgorithms=SSLv3, TLSv1, RC4, DES, MD5withRSA, \

  4. Перезапустите агента с помощью команды <Data Gateway Install Directory>/domain/bin/stopJetty.sh, а затем выполните следующую команду: <Data Gateway Install Directory>/domain/bin/startJetty.sh.
JDSError: 110 — недопустимая строка соединения/недопустимый URL-адрес внешнего источника Убедитесь, что агент Data Gateway может подключаться к источнику данных. Например, при подключении к базе данных Oracle с помощью хоста <hostname> и порта <port> telnet протестируйте подключение на компьютере с установленным агентом Data Gateway.
Столбцы не отображаются Обновите агента Data Gateway. Эта проблема обычно возникает, если используется более раннее обновление агента Data Gateway, которое не соответствует обновлению Oracle Analytics Cloud.
Отсутствует параметр "Использовать удаленное подключение к данным"

На странице "Удаленное подключение к данным" в консоли убедитесь, что параметр Включить Data Gateway активен.

Общие неполадки

Проблема, о которой сообщили пользователи Требуемые действия
Изменение состояния агента завершилось следующей ошибкой: не указаны имя агента или URL-адрес Oracle Analytics Cloud, либо не создана пара ключей Нажмите Сохранить, а затем Включить. Если проблема не исчезает, перезапустите приложение. При необходимости проверьте сеть.
При тестировании происходит сбой аутентификации с ошибкой 401. Ниже описаны возможные причины.

- Ключ агента Data Gateway не был скопирован на страницу <uicontrol>Удаленное подключение к данным</uicontrol> в консоли Oracle Analytics Cloud. Например, вы могли нажать кнопку "Тестировать" перед вставкой ключа на странице "OAC > Консоль > Удаленное подключение к данным".

- Ключ агента Data Gateway был заново сгенерирован в агенте, но новый ключ не был скопирован на страницу "Удаленное подключение к данным" в консоли Oracle Analytics Cloud. Например, агент Data Gateway может быть уже зарегистрирован на странице "Удаленное подключение к данным" в консоли, но его идентификатор не соответствует идентификатору ключа на главной странице агента Data Gateway.


Описание GUID-993A05E7-934B-4EFE-A233-29A85B823B8C-default.png ниже
.png

Если ключ агента Data Gateway не был скопирован, вставьте его в консоль, чтобы зарегистрировать агента.

Если ключ агента Data Gateway был сгенерирован повторно, удалите агента Data Gateway в консоли, затем вставьте ключ в консоль, чтобы повторно зарегистрировать агента.
При сохранении происходит сбой аутентификации с ошибкой 404.

Обычно это происходит при обновлении экземпляра Oracle Analytics.

См. также:

- руководство по использованию удаленного агента Data Gateway в средах, обновленных с Oracle Analytics Cloud 105.2 и более ранних версий (идентификатор документа: 2574387.1);

- Oracle Analytics Cloud — Classic: как включить удаленного агента Data Gateway в управляемом заказчиком экземпляре Oracle Analytics Cloud-Classic, обновленном с выпуска 105.2 или более раннего (идентификатор документа: 2632064.1).
При тестировании происходит сбой с сообщением "Недопустимый URL-адрес OAC"/"Неизвестное исключение хоста" или ошибка/сообщение отсутствуют.

Ниже описаны возможные причины.

- На главной странице агента Data Gateway указан неверный URL-адрес. Например, вы могли указать такой URL-адрес, как https://oacinst-tenancy.analytics.ocp.oraclecloud.com/dv/ui или https://oacinst-tenancy.analytics.ocp.oraclecloud.com/analytics.

- Отсутствует подходящий сетевой маршрут от агента Data Gateway к экземпляру Oracle Analytics Cloud. Например, вы используете прокси-сервер для доступа в Интернет, а брандмауэр блокирует доступ агента Data Gateway к Oracle Analytics Cloud. Если прокси-сервер не требуется, подтвердите подключение компьютера, на котором запущен Data Gateway, к Oracle Analytics Cloud.

- Если на главной странице агента Data Gateway указан неверный URL-адрес, обновите URL-адрес в поле URL-адрес. Например, если URL-адресом Oracle Analytics Cloud является https://<instance details>.oraclecloud.com/dv/ui, укажите следующий URL-адрес: https://<instance details>.oraclecloud.com.

Отсутствует подходящий сетевой маршрут от агента Data Gateway к экземпляру Oracle Analytics Cloud.

- Команда для Linux: $ sudo traceroute -T -p 443 https://<instance details>.oraclecloud.com.

- Команда для Windows: C:\> telnet https://<instance details>.oraclecloud.com 443.

Если требуется прокси-сервер, проверьте сведения о прокси-сервере для Data Gateway. См. раздел Недействительный URL-адрес Oracle Analytics Cloud (Data Gateway не может установить связь с Oracle Analytics Cloud).

Недействительный URL-адрес Oracle Analytics Cloud (Data Gateway не может установить связь с Oracle Analytics Cloud)
  • Убедитесь, что шлюз Data Gateway включен и настроен в консоли Oracle Analytics Cloud.
  • Убедитесь в доступности URL-адреса Oracle Analytics Cloud из среды, в которой выполняется Data Gateway. Например, в Linux можно использовать команду traceroute, например sudo traceroute -T -p 443 <Fully qualified domain name of your Oracle Analytics Cloud instance>.
  • Убедитесь, что ничто не блокирует связь через брандмауэр.
  • При использовании прокси-сервера перейдите на главную страницу в агенте Data Gateway и проверьте настройки прокси-сервера для параметров Хост, Порт, Пользователь и Пароль.
Низкая производительность Проверьте страницу "Журналы" и выполните поиск:
  • по дате;
  • заданий со сбоем;
  • идентификатора задания;
  • "REMOTE".

После обнаружения записей журнала нажмите на задание и просмотрите диалоговое окно "Статус запроса", чтобы узнать о затраченном времени (в миллисекундах).

Обратитесь к команде отдела продаж за рекомендациями по определению размера Data Gateway.
Не пройден тест на странице консоли "Удаленное подключение к данным"

В случае сбоя тестирования агент Data Gateway не завершить аутентификацию по разным причинам, включая нижеуказанные.

  • Ключ агента Data Gateway не был скопирован на страницу Удаленное подключение к данным в консоли Oracle Analytics Cloud.
  • Ключ агента Data Gateway был заново сгенерирован в агенте, но новый ключ не был скопирован на страницу Удаленное подключение к данным в консоли Oracle Analytics Cloud.
  • Нет подходящего сетевого маршрута от агента Data Gateway к Oracle Analytics Cloud.