Перейти к основному содержимому Перейти к дополнительному содержимому
Ресурсы Qlik

Поиск и устранение неисправностей Direct Access Gateway

В этом разделе описаны различные способы устранения неполадок Direct Access Gateway.

Просмотр и загрузка файлов журналов

Файлы журнала содержат информацию об операциях Direct Access Gateway. Qlik Служба поддержки может попросить журналы для поиска и устранения неполадок. Можно просматривать или загружать файлы журнала в средстве просмотра журнала. В нормальных обстоятельствах не возникает причин изучать файлы журналов, но если возникают повторяющиеся сбои или другие проблемы, то журналы часто помогают выявить их причину.

Примечание к информацииДля просмотра и загрузки журналов требуется роль Может использовать данные.

Чтобы открыть средство просмотра журнала, выполните следующие действия.

  1. В центре активности Администрирование перейдите в раздел Шлюзы данных и найдите Direct Access Gateway.

  2. Нажмите кнопку в конце строки и выберите Просмотреть журналы.

    Откроется окно Средство просмотра журнала.

  3. В раскрывающемся списке вверху слева выберите тип журнала, который служба поддержки Qlik просит просмотреть или загрузить.

    Доступны следующие журналы:

    • Журналы Direct Access Gateway (DirectAccessAgent)
    • Журналы DCaaS(dcaas_logs)
    • Журналы коннектора на основе ODBC (odbc-connector_logs)
    • Журналы коннектора SAP BW (QvSAPBwConnector-<дата + метка времени>)
    • Журналы коннектора SAP ODP (QvSapConnectorPackage-<ид_процесса>)
    • Журналы коннектора SAP SQL (QvSqlBwConnector-<дата +метка времени>)
    • Журналы агента коннектора (connector-agent_logs_<дата>)

  4. В соседнем раскрывающемся списке выберите журнал, который требуется просмотреть или загрузить. Файлы журналов упорядочены от самого нового (текущий активный журнал) до самого старого. Выбрав файл журнала, используйте кнопки и , чтобы переходить в начало или в конец журнала соответственно.

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

  5. Чтобы загрузить файл журнала, нажмите кнопку Загрузить.

    В зависимости от настроек браузера файл будет загружен на компьютер, либо появится запрос сохранить его.

Открытие журналов Direct Access Gateway на машине Direct Access Gateway

Помимо возможности загружать журналы Direct Access Gateway (DirectAccessAgent) из центра активности Администрирование, их также можно открывать непосредственно на компьютере с Direct Access Gateway. При установке по умолчанию эти журналы находятся в папке:

C:\Program Files\Qlik\ConnectorAgent\data\logs

Изменение уровня детализации журнала

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

Можно просматривать и изменять уровень детализации журнала Direct Access Gateway (DirectAccessAgent) по необходимости. Для этого выполните следующие команды из подпапки ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent при установке по умолчанию).

  • Для просмотра текущего уровня журнала выполните:

    connectoragent configuration getloggers

  • Чтобы перейти на уровень журнала «Отслеживание», выполните:

    connectoragent configuration setloggers -l Root -v DEBUG

  • Чтобы перейти на уровень журнала «Подробно«, выполните:

    connectoragent configuration setloggers -l Root –v DETAILED_DEBUG

Обновление регистрационного ключа

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

Чтобы обновить регистрационный ключ, выполните следующие действия.

  1. На сервере шлюза прямого доступа откройте командную строку от имени администратора и измените рабочий каталог на вложенную папку ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent при установке по умолчанию).

  2. Выполните следующую команду:

    • Создайте новый ключ:

      connectoragent qcs generate_keys

    • Отобразите ключ:

      connectoragent qcs get_registration

      Ключ отображается:

  3. Скопируйте ключ полностью, как показано в примере выше.

  4. В центре активности Администрирование откройте настройки шлюза данных, нажав кнопку в конце соответствующей строки и выбрав Изменить.

  5. Вставьте ключ в поле Ключ (заменяя текущий ключ) и сохраните настройки.

  6. Вернитесь на сервер шлюза прямого доступа и переЗапустите сервис Qlik Data Gateway — Direct Access, как описано в Управление службой Qlik Data Gateway — Direct Access.

Увеличение тайм-аута сеанса перезагрузки

Если подключение между Direct Access Gateway и Qlik Cloud бездействует в течение 20 секунд и больше, операция перезагрузки иногда завершается ошибкой:

Invalid object name '#<TempTableName>' (indicating that the Direct Access Gateway temp tables are unavailable).

По умолчанию тайм-аут сеанса составляет 20 секунд, но если эта ошибка возникает часто, его можно увеличить следующим образом:

  1. Откройте файл C:\ProgramData\Qlik\Gateway\configuration.properties от имени администратора. Если для этого используется Проводник Windows, убедитесь, что установлен флажок Показывать скрытые файлы, папки и диски.

  2. Найдите параметр ODBC_RELOAD_SESSION_LIFE и задайте необходимое значение.
  3. Сохраните файл configuration.properties и перезапустите службу Qlik Data Gateway — Direct Access.

Продление тайм-аута для запросов на загрузку

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

Connector error: The session does not exist (DirectAccess-1509)

Connector error: The stream session expired for the load data request (DirectAccess-1012)

Если часто возникают подобные ошибки, попробуйте задать параметру EXTEND_FIRST_REQUEST_TIMEOUT значение 5-10 минут.

Примечание к информацииВ качестве единицы измерения для значения параметра используются минуты.

Порядок действий:

  1. Откройте файл C:\ProgramData\Qlik\Gateway\configuration.properties от имени администратора. Если для этого используется Проводник Windows, убедитесь, что установлен флажок Показывать скрытые файлы, папки и диски.

  2. Найдите параметр EXTEND_FIRST_REQUEST_TIMEOUT и увеличьте его значение до 5-10 минут. Значение по умолчанию ― 0.
  3. Сохраните файл configuration.properties и перезапустите службу Qlik Data Gateway — Direct Access.

Сокращение случаев сбоя коннектора во время перезагрузки

Изоляция процессов позволяет администраторам, которые имеют прямой доступ к операционной системе сервера шлюза, контролировать количество процессов, доступных для перезагрузок по типу коннекторов. Распространение перезагрузок по нескольким процессам коннектора повышает степень изоляции путем уменьшения количества перезагрузок, выполняемых одновременно для каждого процесса коннектора. Это, в свою очередь, улучшает общую стабильность Direct Access Gateway в случаях, когда коннектор неожиданно завершает работу.

Примечание к информации

Требуется Direct Access Gateway 1.6.1 или более поздней версии.

Выключение изоляции процесса

Служба поддержки Qlik может попросить вас отключить изоляцию процессов в целях устранения неполадок.

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

Чтобы выключить изоляцию процессов, выполните следующие действия.

  1. Откройте файл C:\ProgramData\Qlik\Gateway\configuration.properties. Если для этого используется Проводник Windows, убедитесь, что установлен флажок Показывать скрытые файлы, папки и диски.

  2. Для параметра [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_PROCESS_ISOLATION_MODE выберите значение None.

  3. Сохраните файл configuration.properties и перезапустите службу Qlik Data Gateway — Direct Access.

Включение изоляции процессов или изменение количества одновременных перезагрузок

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

  1. Откройте файл C:\ProgramData\Qlik\Gateway\configuration.properties от имени администратора. Если для этого используется Проводник Windows, убедитесь, что установлен флажок Показывать скрытые файлы, папки и диски.

    Файл содержит три префикса, соответствующие разным типам коннекторов: ODBC_<property-name>, SAPBW_<property-name>, SAPSQL_<property-name> и SAPPACKAGE_<property-name>.

  2. Задайте параметру [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_PROCESS_ISOLATION_MODE значение Load и параметру [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_MAX_PROCESS_COUNT значение N.

    Где:

    N = один процесс команды + количество одновременных процессов перезагрузки для распределения. Так, например, значение 10 означает максимум 9 одновременных перезагрузок.

  3. Сохраните файл configuration.properties и перезапустите службу Qlik Data Gateway — Direct Access.

Примеры изоляции процессов коннектора ODBC

Следующий фрагмент файла configuration.properties демонстрирует включение изоляции процесса коннектора ODBC для максимум 12 перезагрузок.

ODBC_PROCESS_ISOLATION_MODE=Load

ODBC_MAX_PROCESS_COUNT=13

 

Начиная с версии Direct Access Gateway 1.6.7, значение MAX_PROCESS_COUNT может превышать 10 без необходимости изменения других настроек. Чтобы полностью изолировать перезагрузки с определенным типом коннектора (то есть не более одной перезагрузки на один процесс коннектора), необходимо задать значение минимум 30, но в зависимости от рабочей нагрузки может потребоваться установить значение 60.

Хранение поврежденных или отсутствующих блоков данных для будущей перезагрузки

Для каждой операции перезагрузки Direct Access Gateway может хранить поврежденные или отсутствующие блоки данных в памяти и выгружать их на диск. Это особенно полезно, если не используется автоматическое восстановление и часто возникают ошибки 4025, 4020 и 4021. Чтобы включить эту функцию, установите пороговый размер кэша для выгрузки поврежденных или отсутствующих блоков данных на диск (при каждой перезагрузке). При достижении заданного порога шлюз выгружает следующие зашифрованные блоки на диск компьютера Direct Access Gateway.

Примечание к информацииТребуется Direct Access Gateway 1.6.8 или более поздней версии.

Чтобы задать размер кэша, выполните следующие действия.

  1. Откройте файл C:\ProgramData\Qlik\Gateway\configuration.properties от имени администратора. Если для этого используется Проводник Windows, убедитесь, что установлен флажок Показывать скрытые файлы, папки и диски.

  2. Задайте параметру RELOAD_CACHE_MEMORY_MB значение N (значение по умолчанию: 0 ― функция выключена).

    Где:

    N = размер, которого может достичь блок данных, прежде чем произойдет перезагрузка.

    Примечание к информацииВключение этой функции приведет к увеличению потребления памяти на компьютере Direct Access Gateway, поэтому рекомендуется отслеживать использование ресурсов памяти, когда функция включена. Задайте параметру RELOAD_CACHE_MEMORY_MB значение 100 ― этого должно быть достаточно в большинстве ситуаций.
  3. Сохраните файл configuration.properties и перезапустите службу Qlik Data Gateway — Direct Access.
Примечание к информацииЧтобы предотвратить снижение производительности из-за накопления ненужных файлов, обработанные блоки данных будут удаляться из памяти и с диска компьютера.

Помогла ли вам эта страница?

Если вы обнаружили какую-либо проблему на этой странице и с ее содержанием — будь то опечатка, пропущенный шаг или техническая ошибка, сообщите нам об этом, чтобы мы смогли ее исправить!

Оставьте свой отзыв здесь