Solucionar problemas do gateway de dados local

Este artigo aborda alguns problemas comuns ao usar o gateway de dados local.

Observação

Se você encontrar um problema que não está listado aqui, crie um tíquete de suporte para o serviço de nuvem específico que está executando no gateway.

Atualizar para a versão mais recente

É uma boa prática geral ter certeza que você está usando uma versão com suporte. Todos os meses lançamos uma nova atualização para gateways de dados locais. No momento, a Microsoft oferece suporte ativamente somente às últimas seis versões do gateway de dados local. Se estiver enfrentando problemas com a versão que está usando, tente atualizar para a mais recente, pois seu problema pode ter sido resolvido nela.

Versões inconsistentes entre membros do gateway em um cluster

Mantenha sincronizadas as versões dos membros do gateway em um cluster. Ter a mesma versão em um cluster ajuda a evitar falhas inesperadas de atualização. Essas falhas de atualização podem ocorrer porque o membro do gateway ao qual uma consulta específica é roteada não é capaz de executá-la por ter uma versão mais antiga.

Solucionar problemas comuns de instalação

Veja alguns problemas comuns de instalação e as resoluções que ajudaram outros clientes.

Erro: falha ao adicionar usuário ao grupo. (-2147463168 PBIEgwService Usuários de log de desempenho)

Você poderá receber esse erro se estiver tentando instalar o gateway em um controlador de domínio. Não há suporte para a implantação em um controlador de domínio. Você precisará implantar o gateway em uma máquina que não seja um controlador de domínio.

Software antivírus desatualizado

Você poderá encontrar falhas na instalação se o software antivírus do computador de instalação estiver desatualizado. Você pode atualizar a instalação do antivírus ou desabilitá-lo apenas durante a instalação do gateway. Após a conclusão da instalação, reative o software antivírus.

Versão do gateway igual ou mais antiga

Você poderá encontrar esse erro se tentar instalar a mesma versão ou uma versão anterior do gateway, em comparação com a que já possui.

Erro de instalação do gateway

Solucionar problemas de configuração

Firewall ou proxy

Para testar se o gateway tem acesso a todas as portas necessárias, execute o teste de portas de rede. Os resultados do teste são Concluído (Bem-sucedido) ou Concluído (Falha, consulte os últimos resultados do teste). Se o teste tiver sido bem-sucedido, o gateway se conectou a todas as portas necessárias. Se o teste falhou, seu ambiente de rede pode ter bloqueado as portas e os servidores necessários.

Para aprender sobre como fornecer informações de proxy para o gateway, veja Definir as configurações de proxy do gateway de dados local.

Um firewall também pode bloquear conexões que o Barramento de Serviço do Azure faz aos data centers do Azure. Se esse for o caso, desbloqueie os endereços IP desses data centers na sua região. Você pode obter uma lista de endereços IP do Azure neste site. Para encontrar a região atual do data center em que você está, consulte Definir a região do data center.

Autenticação com o servidor proxy

Seu proxy pode exigir autenticação de uma conta de usuário do domínio. Por padrão, o gateway usa um SID de Serviço para o usuário de entrada do serviço Windows. Alterar o usuário de entrada para um usuário de domínio pode ajudar com essa situação. Para obter mais informações, veja Alterar a conta de serviço do gateway para um usuário de domínio.

Seu proxy permite apenas tráfego pelas portas 80 e 443

Alguns proxies restringem o tráfego exclusivamente para as portas 80 e 443. Por padrão, a comunicação com o Barramento de Serviço do Azure ocorre em outras portas que não a 443.

Você pode forçar o gateway a se comunicar com o Barramento de Serviço do Azure usando HTTPS em vez de TCP direto.

Erros comuns

Erro: falha ao criar um gateway. Tente novamente.

Esse erro pode ser devido a problemas de configuração de proxy. O log do gateway fornece detalhes adicionais para a solução de problemas. Para obter mais informações, consulte Definir as configurações de proxy do gateway de dados local.

Erro: o serviço do Power BI relatou o gateway local como inacessível. Reinicie o gateway e tente novamente.

No final da configuração, o serviço do Power BI é chamado novamente para validar o gateway. O serviço do Power BI não relata o gateway como dinâmico. Reiniciar o serviço Windows pode permitir que a comunicação seja bem-sucedida. Para obter mais detalhes, colete e analise os logs, conforme descrito na seção a seguir.

Ferramentas de solução de problemas

Coletar logs do aplicativo do gateway de dados local

Existem vários logs que você pode coletar para o gateway, e você sempre deve começar com os logs. A maneira mais simples de coletar logs após a instalação do gateway é por meio do aplicativo do gateway de dados local. No aplicativo do gateway de dados local, selecione Diagnóstico e, em seguida, o link Exportar logs, como mostra a imagem a seguir.

Logs do aplicativo do gateway de dados local

Esse arquivo é salvo na pasta ODGLogs na área de trabalho do Windows, no formato .zip.

Logs de eventos

Para encontrar os logs de eventos do serviço de gateway de dados local, siga estes passos:

  1. No computador com a instalação do gateway, abra o Visualizador de eventos.

  2. Expanda Visualizador de eventos > Aplicativos e Logs de Serviços.

  3. Selecione o Serviço de gateway de dados local.

Logs de eventos do gateway de dados local

Próximas etapas