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:

1. No centro de atividades de Administração, acesse Gateways de dados e localize seu Direct Access gateway.

2. Clique no no final da linha e selecione Exibir logs.

   A janela Visualizador de log é aberta.

3. 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>)

4. 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 em para pular para o final do arquivo de log, que será atualizado com as últimas mensagens.

5. 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 detalhe de registro

Você pode visualizar e alterar o nível de detalhe dos logs do Direct Access gateway (DirectAccessAgent) conforme necessário. Para fazer isso, execute os seguintes comandos na subpasta 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:

1. 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).

2. Execute os seguintes comandos:

   • Gere a nova chave:

     connectoragent qcs generate_keys

   • Mostre a chave:

     connectoragent qcs get_registration

     A chave é mostrada:

     

3. Copie a chave inteira, conforme mostrado no exemplo acima.

4. 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.

5. Cole a chave no campo Chave(substituindo a chave atual) e salve as configurações.

6. Retorne ao servidor do gateway Direct Access 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:

1. 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.

2. Localize o parâmetro ODBC_RELOAD_SESSION_LIFE e aumente seu valor conforme necessário.
3. 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:

1. 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.

2. Localize o parâmetro EXTEND_FIRST_REQUEST_TIMEOUT e aumente seu valor para 5-10 minutos. O padrão é 0.
3. 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.

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:

1. 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.

2. Defina [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_PROCESS_ISOLATION_MODE (Colorir todas as medidas) como None (Medidas específicas).

3. 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:

1. 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>.

2. 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.

3. 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

 

A partir da Direct Access gateway versão 1.6.7, o valor MAX_PROCESS_COUNT pode exceder 10 sem a necessidade de alterar outras configurações. Para isolar completamente as recargas com um tipo de conector específico (ou seja, não mais do que uma recarga por processo de conector), esse valor deve ser definido como um mínimo de 30, mas pode ser necessário defini-lo como um valor tão alto quanto 60, dependendo da carga de trabalho.

Armazenar blocos de dados corrompidos ou ausentes para recarga futura

Para cada operação de recarga, o Direct Access gateway pode armazenar pedaços de dados corrompidos ou ausentes na memória e descarregá-los no disco. 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 corrompidos ou ausentes no 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:

1. 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.

2. Defina RELOAD_CACHE_MEMORY_MB como N (o padrão é 0, o que significa que o recurso não está habilitado).

   Em que:

   N = O tamanho que um bloco de dados pode atingir antes de ser recarregado.

   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.
3. Salve o arquivo configuration.properties e reinicie o serviço Qlik Data Gateway - Direct Access.