Solução de problemas Direct Access gateway
Esta seção descreve várias ações que você pode executar para solucionar problemas com o Direct Access gateway.
Visualizando e fazendo download de arquivos de log
Os arquivos de log fornecem informações sobre as operações do Direct Access gateway. Qlik O suporte pode solicitar que você forneça arquivos de log para fins de solução de problemas. Você pode visualizar ou baixar os arquivos de log no visualizador de log. Em circunstâncias normais, não há motivo para examinar os arquivos de log, mas se você tiver falhas repetidas ou outros problemas, os arquivos de log geralmente ajudarão a identificar a causa.
Para abrir o visualizador de log:
-
No centro de atividades de Administração, acesse Gateways de dados e localize seu Direct Access gateway.
-
Clique no
no final da linha e selecione Exibir logs.
A janela Visualizador de log é aberta.
-
Na lista suspensa no canto superior esquerdo, escolha o tipo de log que o Suporte Qlik solicitou que você visualizasse ou baixasse.
Os seguintes registros estão disponíveis:
- Logs do Direct Access gateway (DirectAccessAgent)
- Logs do DCaaS (dcaas_logs)
- Logs do conector baseado em ODBC (odbc-connector_logs)
- Logs do conector do SAP BW (QvSAPBwConnector-<data + carimbo de data/hora>)
- Logs do conector SAP ODP (QvSapConnectorPackage-<process_id>)
- Logs do conector do SAP SQL (QvSqlBwConnector-<data + carimbo de data/hora)
- Logs do agente do conector (connector-agent_logs_<date>)
-
Na lista suspensa adjacente, selecione o registro que deseja visualizar ou baixar. Os arquivos de log são ordenados do mais novo (o arquivo de log atualmente ativo) para o mais antigo. Depois de selecionar um arquivo de log, você pode usar os botões
e
para pular para o início ou o fim do arquivo de log, respectivamente.
Nota de dicaA exibição do arquivo de log não é atualizada automaticamente com as mensagens mais recentes. Para atualizar a visualização, clique empara pular para o final do arquivo de log, que será atualizado com as últimas mensagens.
-
Para baixar o arquivo de log, clique em Download.
O arquivo será baixado para o seu computador ou você será solicitado a salvá-lo, dependendo das configurações do seu navegador.
Abrindo logs do Direct Access gateway na máquina do Direct Access gateway
Além de poder baixar os logs do Direct Access gateway (DirectAccessAgent) do centro de atividades de Administração, você também pode abri-los diretamente da máquina do Direct Access gateway. Com uma instalação padrão, esses registros estão localizados em:
C:\Program Files\Qlik\ConnectorAgent\data\logs
Alterando o nível de registro
Você pode alterar o nível de registro dos logs do Direct Access gateway conforme descrito abaixo.
Alterar o nível de registro dos componentes do conector
Para fins de solução de problemas, talvez seja necessário alterar o nível de registro dos logs dos componentes do conector.
Para isso:
- Abra C:\ProgramData\Qlik\Gateway\configuration.properties como administrador. Se você estiver fazendo isso por meio do Windows Explorer, certifique-se de que Mostrar> Itens ocultos esteja selecionado.
-
Localize a propriedade <COMPONENT>_LOG_LEVEL, em que COMPONENT pode ser um dos seguintes:
- AGENT
- DCAAS
- ODBC
- SAPBW
- SAPSQL
- SAPPACKAGE
- FILE
- Defina-o como um dos seguintes: ERROR, WARN, INFO ou DEBUG
-
Salve o arquivo configuration.properties e reinicie o serviço Qlik Data Gateway - Direct Access.
Nota informativaA partir do Direct Access gateway 1.7.1, se você tiver alterado apenas o componente AGENT, não será necessário reiniciar o serviço Qlik Data Gateway - Direct Access.
Alterando o nível de registro de DirectAccessAgent
Para fins de solução de problemas, talvez seja necessário alterar o nível de registro dos logs do DirectAccessAgent. DirectAccessAgent é responsável pela conexão com os serviços do Qlik Cloud. Para visualizar e alterar o nível de detalhes de log dos logs do DirectAccessAgent, execute os seguintes comandos na subpasta do ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent com uma instalação padrão):
-
Para visualizar o nível de registro em log atual, execute:
connectoragent configuration getloggers -
Para definir o nível de registro em log para Rastreio, execute:
connectoragent configuration setloggers -l Root -v DEBUG -
Para definir o nível de registro em log para Detalhado, execute:
connectoragent configuration setloggers -l Root –v DETAILED_DEBUG
Atualizando a chave de registro
Pode ser necessário alterar a chave de registro no caso improvável de que essa chave esteja corrompida ou se você suspeitar de que o servidor do gateway de dados foi acessado por um usuário não autorizado.
Para atualizar a chave de registro:
- Na servidor do Direct Access gateway, abra um Prompt de Comando como administrador e altere o diretório de trabalho para a subpasta ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent com uma instalação padrão).
-
Execute os seguintes comandos:
-
Gere a nova chave:
connectoragent qcs generate_keys
-
Mostre a chave:
connectoragent qcs get_registration
A chave é mostrada:
-
-
Copie a chave inteira, conforme mostrado no exemplo acima.
-
No centro de atividades de Administração, abra as configurações do gateway de dados clicando no botão
no final da linha relevante e selecionando Editar.
-
Cole a chave no campo Chave(substituindo a chave atual) e salve as configurações.
-
Retorne ao servidor do Direct Access gateway e reinicie o serviço do Qlik Data Gateway - Direct Access, conforme descrito em Gerenciando o serviço Qlik Data Gateway - Direct Access.
Aumento da vida útil da sessão de recarregamento
Se a conexão entre o Direct Access gateway e o Qlik Cloud estiver ociosa por 20 segundos ou mais, a operação de recarregamento poderá falhar com o seguinte erro:
Invalid object name '#<TempTableName>' (indicating that the Direct Access gateway temp tables are unavailable).
A duração padrão da sessão é de 20 segundos, mas se esse erro ocorrer com frequência, você poderá estender a duração da sessão da seguinte forma:
-
Abra C:\ProgramData\Qlik\Gateway\configuration.properties como administrador. Se você estiver fazendo isso por meio do Windows Explorer, certifique-se de que Mostrar arquivos, pastas e unidades ocultas esteja selecionado.
- Localize o parâmetro ODBC_RELOAD_SESSION_LIFE e aumente seu valor conforme necessário.
- Salve o arquivo configuration.properties e reinicie o serviço Qlik Data Gateway - Direct Access.
Estendendo o tempo limite para solicitações de carga
Quando ocorrem interrupções de rede, as recargas podem falhar com os seguintes erros:
Connector error: The session does not exist (DirectAccess-1509)
Connector error: The stream session expired for the load data request (DirectAccess-1012)
Se você encontrar frequentemente os erros acima, tente definir o parâmetro EXTEND_FIRST_REQUEST_TIMEOUT como 5-10 minutos.
Para fazer isso:
-
Abra C:\ProgramData\Qlik\Gateway\configuration.properties como administrador. Se você estiver fazendo isso por meio do Windows Explorer, certifique-se de que Mostrar arquivos, pastas e unidades ocultas esteja selecionado.
- Localize o parâmetro EXTEND_FIRST_REQUEST_TIMEOUT e aumente seu valor para 5-10 minutos. O padrão é 0.
- Salve o arquivo configuration.properties e reinicie o serviço Qlik Data Gateway - Direct Access.
Atenuar falhas de conectores durante um recarregamento
O isolamento do processo permite que os administradores com acesso direto ao sistema operacional do servidor de gateway controlem quantos processos estão disponíveis para recarregamentos por tipo de conector. A distribuição de recarregamentos por vários processos de conector aumenta o nível de isolamento, reduzindo o número de recarregamentos executados simultaneamente em cada processo de conector. Isso, por sua vez, pode melhorar a estabilidade geral do Direct Access gateway nos casos em que ocorreram falhas no conector.
Requer o Direct Access gateway 1.6.1 ou mais recente.
Desativando o isolamento do processo
O Suporte Qlik poderá solicitar que você desative o isolamento do processo para fins de solução de problemas.
Para desativar o isolamento do processo:
- Abra o arquivo C:\ProgramData\Qlik\Gateway\configuration.properties. Se você estiver fazendo isso por meio do Windows Explorer, certifique-se de que Mostrar arquivos, pastas e unidades ocultas esteja selecionado.
-
Defina [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_PROCESS_ISOLATION_MODE (Colorir todas as medidas) como None (Medidas específicas).
- Salve o arquivo configuration.properties e reinicie o serviço Qlik Data Gateway - Direct Access.
Ativando o isolamento do processo ou alterando o número de recargas simultâneas
Para ativar o isolamento do processo ou alterar o número de recargas simultâneas:
-
Abra C:\ProgramData\Qlik\Gateway\configuration.properties como administrador. Se você estiver fazendo isso por meio do Windows Explorer, certifique-se de que Mostrar arquivos, pastas e unidades ocultas esteja selecionado.
O arquivo contém três prefixos correspondentes aos diferentes tipos de conectores: ODBC_<property-name>, SAPBW_<property-name>, SAPSQL_<property-name> e SAPPACKAGE_<property-name>.
-
Defina [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_PROCESS_ISOLATION_MODE como Load e [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_MAX_PROCESS_COUNT como N.
Em que:
N = Um processo de comando + O número de processos de recarga simultâneos a serem alocados. Assim, por exemplo, um valor 10 significaria um máximo de 9 recargas simultâneas.
- Salve o arquivo configuration.properties e reinicie o serviço Qlik Data Gateway - Direct Access.
Exemplos de isolamento de processo do conector ODBC
O trecho do arquivo configuration.properties a seguir mostra como ativar o isolamento do processo do conector ODBC para até 12 recargas:
ODBC_PROCESS_ISOLATION_MODE=Load
ODBC_MAX_PROCESS_COUNT=13
Armazenando dados em cache para recarga no caso de um problema
Para cada operação de recarga, o Direct Access gateway pode armazenar em cache dados na memória e descarregá-los no disco (quando o tamanho alocado para o armazenamento em cache for excedido). Isso é especialmente útil se você não usa a recuperação automática e frequentemente encontra erros 4025, 4020 e 4021. Você ativa esse recurso definindo o limite de tamanho do cache para descarregar blocos de dados para o disco (por recarga). Quando o limite especificado for atingido, o gateway descarregará os próximos pedaços criptografados no disco da máquina do Direct Access gateway.
Para definir o tamanho do cache:
-
Abra C:\ProgramData\Qlik\Gateway\configuration.properties como administrador. Se você estiver fazendo isso por meio do Windows Explorer, certifique-se de que Mostrar arquivos, pastas e unidades ocultas esteja selecionado.
-
Defina RELOAD_CACHE_MEMORY_MB como N (o padrão é 0, o que significa que o recurso não está habilitado).
Em que:
N = A quantidade de memória alocada para armazenamento em cache dos segmentos de dados (por recarga)
Nota informativaHabilitar esse recurso aumentará o consumo de memória na máquina do Direct Access gateway, por isso recomendamos monitorar o impacto na memória enquanto ele estiver habilitado. Definir o valor de RELOAD_CACHE_MEMORY_MB como 100 deve ser suficiente para a maioria das situações. - Salve o arquivo configuration.properties e reinicie o serviço Qlik Data Gateway - Direct Access.
Substituindo o diretório de cache de blocos padrão
Para cada operação de recarga, o Direct Access gateway pode armazenar em cache dados na memória e descarregá-los no disco (quando o tamanho alocado para o armazenamento em cache for excedido). Você pode substituir o diretório padrão do cache de blocos (C:\ProgramData\Qlik\Gateway\tmp) se não tiver espaço suficiente em disco na unidade do sistema.
Para fazer isso:
- Usando um editor de texto, abra C:\ProgramData\Qlik\Gateway\configuration.properties como admin. Se você estiver fazendo isso por meio do Windows Explorer, certifique-se de que Mostrar> Itens ocultos esteja selecionado.
-
Localize a propriedade OVERRIDE_CHUNKS_CACHE_DIR e defina-a como o diretório de sua escolha.
Exemplo:
OVERRIDE_CHUNKS_CACHE_DIR=C:\tmp
Nota informativaNão coloque o caminho entre aspas. - Salve o arquivo configuration.properties e reinicie o serviço Qlik Data Gateway - Direct Access.
Substituindo o tipo de dados padrão do Qlik Cloud ao trabalhar com o conector ODBC (via Direct Access gateway)
Às vezes, devido a um problema com o tratamento dos tipos de dados da fonte pelo driver ODBC do fornecedor, ocorrerá um erro durante o recarregamento ou serão carregados dados incorretos em Qlik Cloud. Nesses casos, você pode substituir o tipo de dados Qlik Cloud ou sua especificação (escala ou precisão, por exemplo).
Para fazer isso:
- Usando um editor de texto, abra C:\ProgramData\Qlik\Gateway\custom_type_mapping.json como admin. Se você estiver fazendo isso por meio do Windows Explorer, certifique-se de que Mostrar> Itens ocultos esteja selecionado. Esse arquivo contém um exemplo de fonte de dados para os tipos de dados do Qlik Cloud.
-
Adicione uma seção que mapeia o tipo de dados problemático para o tipo de dados desejado do Qlik Cloud.
No exemplo a seguir (que está incluído no arquivo custom_type_mapping.json), o cliente precisa alterar o tamanho do tipo de dados Qlik Cloud do Qlik Cloud para 27.
{
"Identifier": "Amazon Athena ODBC (x64)",
"NativeDataType": "timestamp with time zone",
"QlikDataType": "DateTime",
"Size": 27,
"IsBit": false
}
- Salve o arquivo custom_type_mapping.json e reinicie o serviço Qlik Data Gateway - Direct Access.
- Recarregue os dados.
Forçando o Direct Access gateway a se reconectar ao Qlik Cloud
Por padrão, se o Direct Access gateway for desconectado do Qlik Cloud, ele deverá se reconectar após 45 segundos. Se você perceber que está demorando muito mais, pode forçar o gateway a se reconectar mais cedo.
Para fazer isso:
- Usando um editor de texto, abra C:\ProgramData\Qlik\Gateway\configuration.properties como admin. Se você estiver fazendo isso por meio do Windows Explorer, certifique-se de que Mostrar> Itens ocultos esteja selecionado. Esse arquivo contém um exemplo de fonte de dados para os tipos de dados do Qlik Cloud.
-
Adicione AGENT_PONG_TIMEOUT_SECONDS=<time-in-seconds> à seção # Connector Agent no início do arquivo.
Exemplo:
AGENT_PONG_TIMEOUT_SECONDS=30
Nota informativaO tempo mínimo é de 30 segundos. - Salve o arquivo configuration.properties e reinicie o serviço Qlik Data Gateway - Direct Access.
Aumentando os detalhes da mensagem de erro ao se conectar a fontes de dados ODBC
Devido a questões de segurança, a mensagem de erro padrão retornada pelo driver ODBC contém informações mínimas. No entanto, em determinados cenários, você pode precisar de mais informações para solucionar um problema específico. Para obter uma mensagem de erro mais detalhada, adicione a propriedade ShowErrorDetailMessage à seção Avançado no diálogo do conector e defina-a como True. Depois que você tiver resolvido o problema, para otimizar a segurança, é altamente recomendável excluir a propriedade ou defini-la como False.