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

Поиск и устранение неисправностей 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, как описано ниже.

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

Для устранения неполадок может потребоваться изменить уровень журнала для компонентов коннектора.

Для этого выполните следующие действия:

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

    • AGENT
    • DCAAS
    • ODBC
    • SAPBW
    • SAPSQL
    • SAPPACKAGE
    • FILE
  3. Установите одно из следующих значений: ERROR, WARN, INFO или DEBUG
  4. Сохраните файл configuration.properties и перезапустите службу Qlik Data Gateway — Direct Access.

    Примечание к информацииНачиная с Direct Access Gateway 1.7.1, если изменен только компонент AGENT, не нужно перезапускать службу Qlik Data Gateway — Direct Access.

Изменение уровня журнала DirectAccessAgent

Для устранения неполадок может потребоваться изменить уровень журнала для DirectAccessAgent. DirectAccessAgent отвечает за подключение к службам Qlik Cloud. Чтобы просмотреть и изменить уровень детализации журналов 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

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

      Изображение регистрационного ключа Direct Access

  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.
Примечание к информацииЧтобы предотвратить снижение производительности из-за накопления ненужных файлов, обработанные блоки данных будут удаляться из памяти и с диска компьютера.

Переопределение каталога кэша блоков по умолчанию

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

Для каждой операции перезагрузки Direct Access Gateway может кэшировать блоки данных в памяти и выгружать их на диск (при превышении размера, выделенного для кэширования). Можно переопределить каталог кэша блоков по умолчанию(C:\ProgramData\Qlik\Gateway\tmp), если на системном диске недостаточно места.

Примечание к информацииЧтобы обеспечить стабильность и оптимизировать производительность, лучше всего использовать только локальные пути.

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

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

    Пример:

    OVERRIDE_CHUNKS_CACHE_DIR=C:\tmp

    Примечание к информацииНе заключайте путь в кавычки.
  3. Сохраните файл configuration.properties и перезапустите службу Qlik Data Gateway — Direct Access.

Переопределение типа данных Qlik Cloud по умолчанию при работе с коннектором ODBC (через Direct Access Gateway)

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

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

Примечание к предупреждениюМногие проблемы можно решить, просто заменив QlikDataType на String, однако если это невозможно сделать, рекомендуется обратиться в службу поддержки Qlik, чтобы узнать, с какими типами данных Qlik Cloud можно сопоставить исходный тип данных.

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

  1. В текстовом редакторе откройте файл C:\ProgramData\Qlik\Gateway\custom_type_mapping.json от имени администратора. Если для этого используется Проводник Windows, убедитесь, что установлен флажок Показывать > Скрытые элементы. Этот файл содержит пример сопоставления источника с типами данных Qlik Cloud.
  2. Добавьте раздел, который сопоставляет проблемный тип данных с желаемым типом данных Qlik Cloud.

    В следующем примере (который включен в файл custom_type_mapping.json) клиенту необходимо изменить размер типа данных Qlik Cloud DateTime на 27.

    {

    "Identifier": "Amazon Athena ODBC (x64)",

    "NativeDataType": "timestamp with time zone",

    "QlikDataType": "DateTime",

    "Size": 27,

    "IsBit": false

    }

  3. Сохраните файл custom_type_mapping.json и перезапустите службу Qlik Data Gateway — Direct Access.
  4. Загрузите данные.

Принудительное восстановление подключения Direct Access Gateway к Qlik Cloud

По умолчанию, если Direct Access Gateway отсоединяется от Qlik Cloud, подключение должно восстановиться через 45 секунд. Если вы замечаете, что для переподключения требуется значительно больше времени, можно принудительно восстановить подключение шлюза.

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

  1. В текстовом редакторе откройте файл C:\ProgramData\Qlik\Gateway\configuration.properties от имени администратора. Если для этого используется Проводник Windows, убедитесь, что установлен флажок Показывать > Скрытые элементы. Этот файл содержит пример сопоставления источника с типами данных Qlik Cloud.
  2. Добавьте AGENT_PONG_TIMEOUT_SECONDS=<time-in-seconds> в раздел # Connector Agent в начале файла.

    Пример:

    AGENT_PONG_TIMEOUT_SECONDS=30

    Примечание к информацииМинимальное время составляет 30 секунд.
  3. Сохраните файл configuration.properties и перезапустите службу Qlik Data Gateway — Direct Access.

Увеличение детализации сообщений об ошибках при подключении к источникам данных ODBC

По соображениям безопасности, сообщение об ошибке, по умолчанию возвращаемое драйвером ODBC, содержит минимум информации. Однако в некоторых случаях может понадобиться больше информации для устранения конкретной проблемы. Чтобы получить более подробное сообщение об ошибке, добавьте свойство ShowErrorDetailMessage в раздел Дополнительно в диалоговом окне коннектора и задайте ему значение True. Настоятельно рекомендуется после устранения проблемы либо удалить это свойство, либо установить для него значение False, чтобы обеспечить оптимальную безопасность.

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

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