Solução de problemas do gateway de dados localTroubleshooting the on-premises data gateway

Este artigo aborda alguns problemas comuns que você poderá encontrar ao usar o gateway de dados local.This article discusses some common issues you may encounter when using the on-premises data gateway.

Observação

Se você encontrar um problema que não esteja listado abaixo, peça assistência adicional nos locais a seguir.If you encounter an issue that is not listed below, you can ask for further assistance in the following locations.

Atualize para a versão mais recenteUpdate to the latest version

Muitos problemas podem surgir quando a versão de gateway estiver desatualizada.A lot of issues can surface when the gateway version is out of date. É uma boa prática geral ter certeza que você está na última versão.It is a good general practice to make sure you are on the latest version. Se não tiver atualizado o gateway por um mês ou mais, considere a possibilidade de instalar a última versão do gateway e tentar reproduzir o problema.If you haven't updated the gateway for a month, or longer, you may want to consider installing the latest version of the gateway and see if you can reproduce the issue.

Problemas comunsCommon issues

Aqui estão algumas resoluções e problemas comuns que ajudaram um número de clientes em ambientes com acesso restrito à Internet.Here are a few common issues and resolutions that have helped a number of customers in environments that restrict internet access.

Autenticação com o servidor proxyAuthentication to proxy server

Seu proxy pode exigir autenticação de uma conta de usuário do domínio.Your proxy may require authentication from a domain user account. Por padrão, o gateway usa um SID de Serviço para o log de serviço Windows no usuário.By default, the gateway uses a Service SID for the windows service log on user. Alterar o usuário de logon para um usuário de domínio pode ajudar com isso.Changing the log on user to a domain user can help with this. Para obter mais informações, veja Alterando a conta de serviço do gateway para um usuário de domínio.For more information, see Changing the gateway service account to a domain user.

Seu proxy permite apenas tráfego pelas portas 80 e 443Your proxy only allows ports 80 and 443 traffic

Alguns proxies restringem o tráfego exclusivamente para as portas 80 e 443.Some proxies restrict traffic to only ports 80 and 443. Por padrão, a comunicação com o Barramento de Serviço do Azure ocorrerá em outras portas que não a 443.By default, communication to Azure Service Bus will occur on ports other than 443.

Você pode forçar o gateway para se comunicar com o Barramento de Serviço do Azure usando HTTPS em vez de TCP direto.You can force the gateway to communicate with Azure Service Bus using HTTPS instead of direct TCP. Você precisará modificar o arquivo Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config.You will need to modify the Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config file. Altere o valor de AutoDetect para Https.Change the value from AutoDetect to Https. Este arquivo está localizado, por padrão, em C:\Arquivos de Programas\Gateway de dados local.This file is located, by default, at C:\Program Files\On-premises data gateway.

<setting name="ServiceBusSystemConnectivityModeString" serializeAs="String">
    <value>Https</value>
</setting>

InstalaçãoInstallation

Erro: falha ao adicionar usuário ao grupo.Error: Failed to add user to group. (-2147463168 PBIEgwService Usuários de Log de Desempenho)(-2147463168 PBIEgwService Performance Log Users )

Você poderá receber esse erro se estiver tentando instalar o gateway em um controlador de domínio.You may receive this error if you are trying to install the gateway on a domain controller. Não há suporte para a implantação em um controlador de domínio.Deploying on a domain controller is not supported. Você precisará implantar o gateway em um computador que não seja um controlador de domínio.You will need to deploy the gateway on a machine that is not a domain controller.

ConfiguraçãoConfiguration

Como reiniciar o gatewayHow to restart the gateway

O gateway é executado como um serviço Windows, então você pode iniciá-lo e pará-lo de várias maneiras.The gateway runs as a Windows service, so you can start and stop it in multiple ways. Por exemplo, você pode abrir um prompt de comando com permissões elevadas no computador em que o gateway está em execução e, em seguida, executar um destes comandos:For example, you can open a command prompt with elevated permissions on the machine where the gateway is running and then run either of these commands:

  • Para interromper o serviço, execute este comando:To stop the service, run this command:

    ''' net stop PBIEgwService '''''' net stop PBIEgwService '''

  • Para iniciar o serviço, execute este comando:To start the service, run this command:

    ''' net start PBIEgwService '''''' net start PBIEgwService '''

Erro: falha ao criar gateway.Error: Failed to create gateway. Tente novamente.Please try again.

Todos os detalhes estão disponíveis, mas a chamada para o serviço do Power BI retornou um erro.All of the details are available, but the call to the Power BI service returned an error. O erro e uma ID de atividade serão exibidos.The error, and an activity id, will be displayed. Isso pode acontecer por diferentes motivos.This could happen for different reasons. Você pode coletar e examinar os logs da maneira descrita abaixo para obter mais detalhes.You can collect, and review, the logs, as mentioned below, to get more details.

Isso também pode ser devido a problemas de configuração de proxy.This could also be due to proxy configuration issues. A interface do usuário agora permite a configuração de proxy.The user interface does now allow for proxy configuration. Saiba mais sobre como fazer alterações da configuração de proxyYou can learn more about making proxy configuration changes

Erro: falha ao atualizar detalhes do gateway.Error: Failed to update gateway details. Tente novamente.Please try again.

As informações foram recebidas do serviço do Power BI para o gateway.Information was received from the Power BI service, to the gateway. As informações foram transmitidas para o serviço do Windows local, mas houve uma falha ao retornar.The information was passed onto the local windows service, but it failed to return. Ou então, uma falha de geração de chave simétrica.Or, a symmetric key generation failed. A exceção interna será exibida em Mostrar detalhes.The inner exception will be displayed under Show details. Você pode coletar e examinar os logs da maneira descrita abaixo para obter mais detalhes.You can collect, and review, the logs, as mentioned below, to get more details.

Erro: o serviço do Power BI relatou o gateway local como inacessível.Error: Power BI service reported local gateway as unreachable. Reinicie o gateway e repita a operação.Please restart the gateway and try again.

No final da configuração, o serviço do Power BI será chamado novamente para validar o gateway.At the end of configuration, the Power BI service will be called again to validate the gateway. O serviço do Power BI não relata o gateway como dinâmico.The Power BI service does not report the gateway as live. Reiniciar o serviço do Windows pode permitir que a comunicação seja bem-sucedida.Restarting the windows service may allow the communication to be successful. Você pode coletar e examinar os logs da maneira descrita abaixo para obter mais detalhes.You can collect, and review, the logs, as mentioned below, to get more details.

Erro de script durante a conexão no Power BIScript error during sign into Power BI

Você pode receber um erro de script ao entrar no Power BI como parte da configuração de gateway de dados local.You may receive a script error when signing into Power BI as part of the on-premises data gateway configuration. Instalar a seguinte atualização de segurança deve resolver o problema.Installing the following security update should resolve the issue. Isso pode ser instalado por meio do Windows Update.This can be installed via Windows Update.

MS16-051: atualização de segurança do Internet Explorer: 10 de maio de 2016 (KB 3154070)MS16-051: Security update for Internet Explorer: May 10, 2016 (KB 3154070)

Falha de configuração do gateway com uma exceção de referência nulaGateway configuration failed with a null reference exception

Você pode receber um erro semelhante a este:You may encounter an error similar to the following.

    Failed to update gateway details.  Please try again.
    Error updating gateway configuration.

Isso incluirá um rastreamento de pilha, que poderá incluir o seguinte:This will include a stack trace, and that stack trace will may include the following.

    Microsoft.PowerBI.DataMovement.Pipeline.Diagnostics.CouldNotUpdateGatewayConfigurationException: Error updating gateway configuration. ----> System.ArgumentNullException: Value cannot be null.
    Parameter name: serviceSection

Se você estiver atualizando um gateway mais antigo, o arquivo de configuração será preservado.If you are upgrading from an older gateway, we preserve the config file. Pode haver uma seção ausente.There may be a section that is missing. Quando o gateway tentar ler isso, obteremos a exceção de referência nula acima.When the gateway tries to read it, we will get the above null reference exception.

Para corrigir esse problema, faça o seguinte:To correct this, do the following.

  1. Desinstale o gateway.Uninstall the gateway.
  2. Exclua a seguinte pasta:Delete the following folder.

     c:\Program Files\on-premises data gateway
    
  3. Reinstale o gateway.Reinstall the gateway.
  4. Se preferir, aplique a chave de recuperação para restaurar um gateway existente.Optionally apply the recovery key to restore an existing gateway.

Suporte para TLS 1.1/1.2Support for TLS 1.1/1.2

Com a atualização de agosto de 2017 e as posteriores, o gateway de dados local usa o protocolo TLS 1.1 ou 1.2 para comunicar-se com o serviço do Power BI por padrão.With the August 2017 update and beyond, the on-premises data gateway uses Transport Layer Security (TLS) 1.1 or 1.2 to communicate with the Power BI service by default. As versões anteriores do gateway de dados local usam o TLS 1.0 por padrão.Previous versions of the on-premises data gateway use TLS 1.0 by default. Em 1º de novembro de 2017, o suporte para o TLS 1.0 será encerrado. Por isso, você deverá atualizar as instalações do gateway de dados local para a versão de agosto de 2017 ou mais recente para garantir que os gateways continuem a funcionar.On November 1st 2017 support for TLS 1.0 will end, so by then you must upgrade your on-premises data gateway installations to the August 2017 release or newer to ensure your gateways continue to operate.

É importante observar que o TLS 1.0 ainda é compatível com o gateway de dados local antes de 1º de novembro e é usado pelo gateway como um mecanismo de fallback.It's important to note that TLS 1.0 is still supported by the on-premises data gateway prior to November 1st, and is used by the gateway as a fallback mechanism. Para garantir que todo o tráfego de gateway use o TLS 1.1 ou 1.2 (e evite o uso do TLS 1.0 no gateway), você deverá adicionar ou modificar as seguintes chaves do registro no computador que executa o serviço de gateway:To ensure all gateway traffic uses TLS 1.1 or 1.2 (and to prevent the use of TLS 1.0 on your gateway), you must add or modify the following registry keys on the machine running the gateway service:

    [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\v4.0.30319]"SchUseStrongCrypto"=dword:00000001
    [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\.NETFramework\v4.0.30319]"SchUseStrongCrypto"=dword:00000001

Observação

A adição ou modificação dessas chaves do Registro aplica a alteração a todos os aplicativos .NET.Adding or modifying these registry keys applies the change to all .NET applications. Para obter informações sobre as alterações no registro que afetam o TLS em outros aplicativos, consulte Transport Layer Security (TLS) registry settings (Configurações de registro do protocolo TLS).For information about registry changes that affect TLS for other applications, see Transport Layer Security (TLS) registry settings.

Fontes de dadosData sources

Erro: impossível conectar.Error: Unable to Connect. Detalhes: "Credenciais de conexão inválidas"Details: "Invalid connection credentials"

Em Mostrar detalhes, deve ser exibida a mensagem de erro recebida da fonte de dados.Within Show details, it should display the error message received from the data source. Para o SQL Server, você verá algo semelhante ao seguinte.For SQL Server, you should see something like the following.

Login failed for user 'username'.

Verifique se você tem o nome de usuário correto e a senha.Verify that you have the correct username and password. Verifique também se essas credenciais podem se conectar à fonte de dados com êxito.Also verify that those credentials can successfully connect to the data source. Verifique se a conta que está sendo usada corresponde ao Método de Autenticação.Make sure the account being used matches the Authentication Method.

Erro: impossível conectar.Error: Unable to Connect. Detalhes: "Não é possível se conectar ao banco de dados"Details: "Cannot connect to the database"

Conseguimos nos conectar ao servidor, mas não ao banco de dados fornecido.We were able to connect to the server, but not to the database supplied. Verifique o nome do banco de dados e se as credenciais do usuário têm a permissão apropriada para acessar esse banco de dados.Verify the name of the database, and that the user credential as the proper permission to access that database.

Em Mostrar detalhes, deve ser exibida a mensagem de erro recebida da fonte de dados.Within Show details, it should display the error message received from the data source. Para o SQL Server, você verá algo semelhante ao seguinte.For SQL Server, you should see something like the following.

Cannot open database "AdventureWorks" requested by the login. The login failed. Login failed for user 'username'.

Erro: impossível conectar.Error: Unable to Connect. Detalhes: "Erro desconhecido no gateway de dados"Details: "Unknown error in data gateway"

Esse erro pode ocorrer por diferentes motivos.This error could occur for different reasons. Não se esqueça de validar que você pode se conectar à fonte de dados do computador que hospeda o gateway.Be sure to validate that you can connect to the data source from the machine hosting the gateway. Isso pode ocorrer devido ao fato de o servidor não estar acessível.This could be the result of the server not being accessible.

Em Mostrar detalhes, você verá um código de erro DM_GWPipeline_UnknownError.Within Show details, you will see an error code of DM_GWPipeline_UnknownError.

Você também pode examinar os Logs de Eventos > Logs de Aplicativos e Serviços > Serviço do gateway de dados local para obter mais detalhes.You can also look in the Event Logs > Applications and Services Logs > on-premises data gateway Service for more details.

Erro: encontramos um erro ao tentar conectar-se com .Error: We encountered an error while trying to connect to . Detalhes: "Alcançamos o gateway de dados, mas o gateway não consegue acessar a fonte de dados local".Details: "We reached the data gateway, but the gateway can't access the on-premises data source."

Não é possível se conectar à fonte de dados especificada.We were unable to connect to the specified data source. Certifique-se de validar as informações fornecidas para essa fonte de dados.Be sure to validate the information provided for that data source.

Em Mostrar detalhes, você encontrará um código de erro de DM_GWPipeline_Gateway_DataSourceAccessError.Within Show details, you will see an error code of DM_GWPipeline_Gateway_DataSourceAccessError.

Se a mensagem de erro subjacente for semelhante à seguinte, isso significa que a conta que você está usando para a fonte de dados não é um administrador do servidor para essa instância do Analysis Services.If the underlying error message is similar to the following, this means that the account you are using for the data source is not a server admin for that Analysis Services instance. Saiba maisLearn more

The 'CONTOSO\account' value of the 'EffectiveUserName' XML for Analysis property is not valid.

Caso a mensagem de erro subjacente seja semelhante à seguinte, isso pode indicar que a conta de serviço do Analysis Services pode não ter o atributo de diretório TGGAU (token-groups-global-and-universal).If the underlying error message is similar to the following, it could mean that the service account for Analysis Services may be missing the token-groups-global-and-universal (TGGAU) directory attribute.

The user name or password is incorrect.

Domínios com acesso de compatibilidade de versões anteriores ao Windows 2000 terão o atributo TGGAU habilitado.Domains with Pre-Windows 2000 compatibility access will have the TGGAU attribute enabled. No entanto, os domínios criados mais recentemente não habilitarão esse atributo por padrão.However, most newly created domains will not enable this attribute by default. Leia mais sobre isso aqui.You can read more about this here.

Confirme isso fazendo o seguinte:You can confirm this by doing the following.

  1. Conecte-se ao computador do Analysis Services no SQL Server Management Studio.Connect to the Analysis Services machine within SQL Server Management Studio. Nas propriedades de conexão Avançada, inclua EffectiveUserName para o usuário em questão e veja se isso reproduz o erro.Within the Advanced connection properties, include EffectiveUserName for the user in question and see if this reproduces the error.
  2. Você pode usar a ferramenta dsacls do Active Directory para validar se o atributo está listado.You can use the dsacls Active Directory tool to validate whether the attribute is listed. Essa é a ferramenta normalmente encontrada em um controlador de domínio.This is tool is normally found on a domain controller. Você precisará saber qual é o nome diferenciado de domínio da conta e passá-lo para a ferramenta.You will need to know what the distinguished domain name is for the account and pass that to the tool.

     dsacls "CN=John Doe,CN=UserAccounts,DC=contoso,DC=com"
    

    Você deseja ver algo semelhante ao mostrado a seguir nos resultados.You want to see something similar to the following in the results.

         Allow BUILTIN\Windows Authorization Access Group
                                       SPECIAL ACCESS for tokenGroupsGlobalAndUniversal
                                       READ PROPERTY
    

Para corrigir esse problema, você precisará habilitar o TGGAU na conta usada para o serviço Windows do Analysis Services.To correct this issue, you will need to enable TGGAU on account used for the Analysis Services windows service.

Outra possibilidade de nome de usuário ou senha incorretosAnother possibility for user name or password incorrect

Esse erro também poderá ser causado se o servidor do Analysis Services estiver em um domínio diferente dos usuários e não houver uma relação de confiança bidirecional estabelecida.This error could also be caused if the Analysis Services server is in a different domain than the users and there is not a two-way trust established.

Você precisará trabalhar com seus administradores de domínio para verificar a relação de confiança entre os domínios.You will need to work with your domain administrators to verify the trust relationship between domains.

Não é possível ver as fontes de dados do gateway de dados na experiência "Obter Dados" do Analysis Services por meio do serviço do Power BIUnable to see the data gateway data sources in the 'Get Data' experience for Analysis Services from the Power BI service

Confira se sua conta está listada na guia Usuários da fonte de dados na configuração do gateway.Make sure that your account is listed in the Users tab of the data source within the gateway configuration. Se não tiver acesso ao gateway, verifique com o administrador do gateway e solicite a verificação.If you don't have access to the gateway, check with the administrator of the gateway and ask them to verify. Somente as contas na lista Usuários verão a fonte de dados relacionada na lista do Analysis Services.Only accounts in the Users list will see the data source listed in the Analysis Services list.

Conjuntos de dadosDatasets

Erro: não há espaço suficiente para esta linha.Error: There is not enough space for this row.

Isso ocorrerá se você tiver uma única linha com um tamanho maior que 4 MB.This will occur if you have a single row greater than 4 MB in size. Você precisará determinar qual linha é proveniente da fonte de dados e tentar filtrá-la ou reduzir o tamanho desta linha.You will need to determine what the row is from your data source and attempt to filter it out or reduce the size for that row.

Erro: O nome fornecido para o servidor não corresponde ao nome do servidor no certificado SSL do SQL Server.Error: The server name provided doesn't match the server name on the SQL Server SSL Certificate.

Isso pode ocorrer quando o certificado CN é para o nome de domínio totalmente qualificado (FQDN) do servidor, mas você somente forneceu o nome NetBIOS para o servidor.This can occur when the certificate CN is for the servers fully qualified domain name (FQDN) but you only supplied the netbios name for the server. Isso causará uma incompatibilidade para o certificado.This will cause a mismatch for the certificate. Para resolver esse problema, você precisará criar o nome do servidor e do arquivo PBIX na fonte de dados do gateway, para usar o FQDN do servidor.To resolve this issue, you will need to make the server name within the gateway data source, and the PBIX file, to use the FQDN of the server.

Não consigo ver o gateway de dados local presente ao configurar a atualização agendada.I don't see the on-premises data gateway persent when configuring scheduled refresh.

Isso pode ser devido a alguns cenários diferentes.This could be because of a few different scenarios.

  1. O nome do servidor e do banco de dados não corresponde entre o que foi inserido no Power BI Desktop e a fonte de dados configurada para o gateway.The server and database name don't match between what was entered in Power BI Desktop and the data source configured for the gateway. Eles precisam ter os mesmos valores.These need to be the same values. Eles não diferenciam maiúsculas de minúsculas.They are not case sensitive.
  2. Sua conta não está listada na guia Usuários da fonte de dados na configuração do gateway.Your account is not listed in the Users tab of the data source within the gateway configuration. Você precisará solicitar ao administrador do gateway para ser adicionado à lista.You will need to get with the administrator of the gateway to be added to that list.
  3. O arquivo do Power BI Desktop contém dados de várias fontes e nem todas as fontes de dados estão configuradas com o gateway.Your Power BI Desktop file has multiple data sources within it and not all of those data sources are configured with the gateway. Você precisará ter cada fonte de dados definida com o gateway para que o gateway apareça na Atualização Agendada.You will need to have each data source defined with the gateway for the gateway to show up within Scheduled Refresh.

Erro: os dados descompactados recebidos no cliente de gateway excederam o limite.Error: The received uncompressed data on the gateway client has exceeded limit.

A limitação exata é de 10 GB de dados descompactados por tabela.The exact limitation is 10 GB of uncompressed data per table. Se você estiver tendo esse problema, há boas opções para otimizá-lo e evitá-lo.If you are hitting this issue, there are good options to optimize and avoid the issue. Especificamente, será útil reduzir o uso de valores de cadeia de caracteres longos e altamente repetitivos e, em vez disso, usar uma chave normalizada ou remover a coluna (se ela não estiver em uso).In particular, reducing the use of highly repetitive, long string values and instead using a normalized key or removing the column (if not in use) will help.

RelatóriosReports

O relatório não pôde acessar a fonte de dados porque você não tem acesso à nossa fonte de dados por meio de um gateway de dados local.Report could not access the data source because you do not have access to our data source via an on-premises data gateway.

Isso geralmente é causado por um dos motivos a seguir.This is usually caused by one of the following.

  1. As informações da fonte de dados não correspondem as que estão no conjunto de dados subjacente.The data source information does not match what is in the underlying dataset. O servidor e o nome do banco de dados precisam corresponder à fonte de dados definida para o gateway de dados local e às informações fornecidas no Power BI Desktop.The server and database name need to match between the data source defined for the on-premises data gateway and what you supply within Power BI Desktop. Se você usar um Endereço IP no Power BI Desktop, a fonte de dados do gateway de dados local também precisará usar um Endereço IP.If you use an IP Address in Power BI Desktop, the data source, for the on-premises data gateway, needs to use an IP Address as well.
  2. Não há uma fonte de dados disponível em nenhum gateway de sua organização.There is not a data source available on any gateway within your organization. É possível configurar a fonte de dados em um gateway de dados local novo ou existente.You can configure the data source on a new, or existing, on-premises data gateway.

Detalhes: erro de acesso à fonte de dados.Error: Data source access error. Entre em contato com o administrador do gateway.Please contact the gateway administrator.

Se este relatório estiver usando uma conexão dinâmica do Analysis Services, você poderá ter problemas ao passar um valor para EffectiveUserName que não seja válido ou que não tenha permissões no computador do Analysis Services.If this report is making use of a live Analysis Services connection, you could be encountering an issue with a value being passed to EffectiveUserName that is either not valid, or doesn't have permissions on the Analysis Services machine. Normalmente, um problema de autenticação ocorre devido ao fato de que o valor passado para EffectiveUserName não corresponde a um nome UPN local.Typically, an authentication issue is due to the fact that the value being passed for EffectiveUserName doesn't match a local user principal name (UPN).

Para confirmar isso, faça o seguinte:To confirm this, you can do the following.

  1. Encontre o nome de usuário efetivo nos logs do gateway.Find the effective username within the gateway logs.
  2. Depois de obter o valor que está sendo passado, valide se ele está correto.Once you have the value being passed, validate that it is correct. Se ele for seu usuário, você poderá usar o comando a seguir em um prompt de comando para ver qual deve ser o UPN.If it is your user, you can use the following command from a command prompt to see what the UPN should be. O UPN será parecido com um endereço de email.The UPN will look like an email address.

     whoami /upn
    

Se preferir, é possível ver o que o Power BI obtém do Azure Active Directory.Optionally, you can see what Power BI gets from Azure Active Directory.

  1. Navegue até https://graphexplorer.cloudapp.net.Browse to https://graphexplorer.cloudapp.net.
  2. Selecione Entrar no canto superior direito.Select Sign in in the upper right.
  3. Execute a consulta a seguir.Run the following query. Você verá uma resposta JSON bem grande.You will see a rather large JSON response.

     https://graph.windows.net/me?api-version=1.5
    
  4. Procure userPrincipalName.Look for userPrincipalName.

Se o UPN do Azure Active Directory não corresponder ao UPN local do Active Directory, você poderá usar o recurso Mapear nomes de usuário para substituí-lo por um valor válido.If your Azure Active Directory UPN doesn't match your local Active Directory UPN, you can use the Map user names feature to replace it with a valid value. Se preferir, você pode trabalhar com seu administrador de locatários, ou com o administrador local do Active Directory, para alterar o UPN.Or you can work with either your tenant admin, or local Active Directory admin, to get your UPN changed.

Firewall ou proxyFirewall or Proxy

Para obter informações sobre como fornecer informações de proxy para o gateway, veja Definindo as configurações de proxy dos gateways do Power BI.For information on providing proxy information for your gateway, see Configuring proxy settings for the Power BI gateways.

É possível testar para ver se seu firewall, ou proxy, pode estar bloqueando as conexões, executando Test-NetConnection em um prompt do PowerShell.You can test to see if your firewall, or proxy, may be blocking conections by running Test-NetConnection from a PowerShell prompt. Isso testará a conectividade com o Barramento de Serviço do Azure.This will test connectivity to the Azure Service Bus. Isso apenas testa a conectividade de rede e não tem nenhuma relação com o serviço do servidor de nuvem nem com o gateway.This only tests network connectivity and doesn't have anything to do with the cloud server service or the gateway. Isso ajuda a determinar se seu computador pode realmente acessar a Internet.It helps to determine if your machine can actually get out to the internet.

Test-NetConnection -ComputerName watchdog.servicebus.windows.net -Port 9350

Observação

Test-NetConnection só está disponível no Windows Server 2012 R2 e versões posteriores.Test-NetConnection is only available on Windows Server 2012 R2 and later. Também está disponível no Windows 8.1 e versões posteriores.It is also available on Windows 8.1 and later. Em versões anteriores do sistema operacional, é possível usar o Telnet para testar a conectividade da porta.On earlier OS versions, you can use Telnet to test port connectivity.

Os resultados devem ser parecidos ao mostrado a seguir.The results should look similar to the following. A diferença será em TcpTestSucceeded.The difference will be with TcpTestSucceeded. Se TcpTestSucceeded não for true, isso indica que você poderá estar sendo bloqueado por um firewall.If TcpTestSucceeded is not true, then you may be blocked by a firewall.

ComputerName           : watchdog.servicebus.windows.net
RemoteAddress          : 70.37.104.240
RemotePort             : 5672
InterfaceAlias         : vEthernet (Broadcom NetXtreme Gigabit Ethernet - Virtual Switch)
SourceAddress          : 10.120.60.105
PingSucceeded          : False
PingReplyDetails (RTT) : 0 ms
TcpTestSucceeded       : True

Se você quiser fazer uma verificação completa, substitua os valores de ComputerName e Port por aqueles listados para portasIf you want to be exhaustive, substitute the ComputerName and Port values with those listed for ports

O firewall também pode estar bloqueando as conexões que o Barramento de Serviço do Azure estabelece com os datacenters do Azure.The firewall may also be blocking the connections that the Azure Service Bus makes to the Azure data centers. Se este for o caso, será recomendável adicionar à lista branca (desbloquear) todos os endereços IP da sua região para os data centers.If that is the case, you will want to whitelist (unblock) the IP addresses for your region for those data centers. Você pode obter uma lista de endereços IP do Azure aqui.You can get a list of Azure IP addresses here.

É possível encontrar a região do datacenter em que você está fazendo o seguinte:You can find the data center region you are in by doing the following:

  1. Selecione ?Select the ? na parte superior direita do serviço do Power BI.in the upper right of the Power BI service.
  2. Selecione Sobre o Power BI.Select About Power BI.
  3. Sua região de dados será listada em Seus dados estão armazenados em.Your data region will be listed in Your data is stored in.

Se você ainda não conseguiu descobri-la, tente obter um rastreamento de rede usando uma ferramenta como fiddler ou netsh, embora esses sejam métodos de coleta avançados e você possa precisar de assistência para analisar os dados coletados.If you are still not getting anywhere, you could try getting a network trace using a tool like fiddler or netsh, although these are advanced collection methods and you may need assistance in analyzing the collected data. Entre em contato com o suporte para obter assistência.You can contact support for assistance.

DesempenhoPerformance

Contadores de desempenhoPerformance Counters

Existem inúmeros contadores de desempenho que podem ser usados para medir as atividades do gateway.There are a number of performance counters that can be used to gauge the activities for the gateway. Eles podem ser úteis para entender quando há uma grande carga de atividade e talvez seja necessário criar um novo gateway.These can be helpful to understanding if we have a large load of activity and may need to make a new gateway. Esses contadores não refletirão a duração de algo.These counters will not reflect how long something takes.

Eles podem ser acessados por meio da ferramenta Monitor de Desempenho do Windows.These counters can be access through the Windows Performance Monitor tool.

Há agrupamentos gerais desses contadores.There are general groupings of these counters.

Tipo de contadorCounter Type DescriçãoDescription
ADO.NETADO.NET É usado para qualquer conexão de DirectQuery.This is used for any DirectQuery connection.
ADOMDADOMD É usado para o Analysis Services 2014 e anterior.This is used for Analysis Services 2014 and earlier.
OLEDBOLEDB É usado por determinadas fontes de dados.This is used by certain data sources. Inclui o SAP HANA e o Analysis Service 2016 ou posterior.This includes SAP HANA and Analysis Service 2016 or later.
MashupMashup Inclui qualquer fonte de dados importados.This includes any imported data source. Se estiver agendando uma atualização ou fazendo uma atualização sob demanda, esse processo passará pelo mecanismo de mashup.If you are scheduling refresh or doing an on-demand refresh, it will go through the mashup engine.

Aqui está uma lista de contadores de desempenho disponíveis.Here is a listing of the available performance counters.

ContadorCounter DescriçãoDescription
Número de conexões abertas do ADO.NET executadas por segundo# of ADO.NET open connection executed / sec Número de ações de conexões abertas do ADO.NET executadas por segundo (com êxito ou falha).Number of ADO.NET open connection actions executed per second (succeeded or failed).
Número de conexões abertas do ADO.NET com falha por segundo# of ADO.NET open connection failed / sec Número de ações de conexões abertas do ADO.NET com falha por segundo.Number of ADO.NET open connections actions failed per second.
Número de consultas do ADO.NET executadas por segundo# of ADO.NET queries executed / sec Número de consultas do ADO.NET executadas por segundo (com êxito ou falha).Number of ADO.NET queries executed per second (succeeded or failed).
Número de consultas do ADO.NET com falha por segundo# of ADO.NET queries failed / sec Número de consultas do ADO.NET com falha executadas por segundo.Number of ADO.NET failed queries executed per second.
Número de conexões abertas do ADOMD executadas por segundo# of ADOMD open connection executed / sec Número de ações de conexões abertas do ADOMD executadas por segundo (com êxito ou falha).Number of ADOMD open connection actions executed per second (succeeded or failed).
Número de conexões abertas do ADOMD com falha por segundo# of ADOMD open connection failed / sec Número de ações de conexões abertas do ADOMD com falha por segundo.Number of ADOMD open connection actions failed per second.
Número de consultas do ADOMD executadas por segundo# of ADOMD queries executed / sec Número de consultas do ADOMD executadas por segundo (com êxito ou falha).Number of ADOMD queries executed per second (succeeded or failed).
Número de consultas do ADOMD com falha por segundo# of ADOMD queries failed / sec Número de consultas do ADOMD com falha executadas por segundo.Number of ADOMD failed queries executed per second.
Número de todas as conexões abertas executadas por segundo# of all open connection executed / sec Número de ações de conexões abertas executadas por segundo (com êxito ou falha).Number of open connection actions executed per second (succeeded or failed).
Número de todas as conexões abertas com falha por segundo# of all open connection failed / sec Número de ações de conexões abertas com falha executadas por segundo.Number of failed open connection actions executed per second.
Número de todas as consultas executadas por segundo# of all queries executed / sec Número de consultas executadas por segundo (com êxito ou falha).Number of queries executed per second (succeeded or failed).
Número de itens no pool de conexões do ADO.NET# of items in the ADO.NET connection pool Número de itens no pool de conexões do ADO.NET.Number of items in the ADO.NET connection pool.
Número de itens no pool de conexões do OLEDB# of items in the OLEDB connection pool Número de itens no pool de conexões do OLEDB.Number of items in the OLEDB connection pool.
Número de itens no pool de Barramentos de Serviço# of items in the Service Bus pool Número de itens no pool de Barramentos de Serviço.Number of items in the Service Bus pool.
Número de conexões abertas do Mashup executadas por segundo# of Mashup open connection executed / sec Número de ações de conexões abertas do Mashup executadas por segundo (com êxito ou falha).Number of Mashup open connection actions executed per second (succeeded or failed).
Número de conexões abertas do Mashup com falha por segundo# of Mashup open connection failed / sec Número de ações de conexões abertas do Mashup com falha por segundo.Number of Mashup open connection actions failed per second.
Número de consultas do Mashup executadas por segundo# of Mashup queries executed / sec Número de consultas do Mashup executadas por segundo (com êxito ou falha).Number of Mashup queries executed per second (succeeded or failed).
Número de consultas do Mashup com falha por segundo# of Mashup queries failed / sec Número de consultas do Mashup com falha executadas por segundoNumber of Mashup failed queries executed per second
Número de consultas do OLEDB de vários conjuntos de resultados com falha por segundo# of multiple result set OLEDB queries failed / sec Número de consultas do OLEDB de vários conjuntos de resultados com falha por segundo.Number of multiple resultset OLEDB failed queries executed per second.
Número de consultas do OLEDB de vários conjuntos de resultados por segundo# of OLEDB multiple resultset queries executed / sec Número de consultas do OLEDB de vários conjuntos de resultados executadas por segundo (com êxito ou falha).Number of OLEDB multiple resultset queries executed per second (succeeded or failed).
Número de conexões abertas OLEDB executadas por segundo# of OLEDB open connection executed / sec Número de ações de conexões abertas do OLEDB executadas por segundo (com êxito ou falha).Number of OLEDB open connection actions executed per second (succeeded or failed).
Número de conexões abertas do OLEDB com falha por segundo# of OLEDB open connection failed / sec Número de ações de conexões abertas do OLEDB com falha por segundo.Number of OLEDB open connection actions failed per second.
Número de consultas do OLEDB executadas por segundo# of OLEDB queries executed / sec Número de consultas do OLEDB de vários conjuntos de resultados executadas por segundo (com êxito ou falha).Number of OLEDB multiple resultset queries executed per second (succeeded or failed).
Número de consultas do OLEDB com falha por segundo# of OLEDB queries failed / sec Número de consultas do OLEDB de vários conjuntos de resultados com falha executadas por segundo.Number of OLEDB mutiple resultset failed queries executed per second.
Número de consultas do OLEDB de conjunto de resultados único por segundo# of OLEDB single resultset queries executed / sec Número de consultas do OLEDB de conjunto de resultados único executadas por segundo (com êxito ou falha).Number of OLEDB single resultset queries executed per second (succeeded or failed).
Número de consultas com falha por segundo# of queries failed / sec Número de consultas com falha executadas por segundo.Number of failed queries executed per second.
Número de consultas do OLEDB de conjunto de resultados único com falha por segundo# of single result set OLEDB queries failed / sec Número de consultas do OLEDB de conjunto de resultados único com falha executadas por segundo.Number of single resultset OLEDB failed queries executed per second.

Examinando consultas com desempenho lentoReviewing slow performing queries

Você pode achar que a resposta pelo gateway está lenta.You may find that response through the gateway is slow. Isso pode ser em consultas DirectQuery ou ao atualizar o conjunto de dados importado.This could be for DirectQuery queries or when refreshing your imported dataset. Você pode habilitar um registro em log adicional para emitir as consultas e seus tempos para ajudar a entender o que está com desempenho lento.You can enable additional logging to output queries and their timings to help understand what is performing slow. Ao encontrar alguma consulta de execução longa, poderá ser necessário fazer modificações adicionais na fonte de dados para ajustar o desempenho da consulta.When you find a long running query, it may require additional modification on your data source to tune query performance. Por exemplo, ajustando os índices para uma consulta do SQL Server.For example, adjusting indexes for a SQL Server query.

Você precisará modificar dois arquivos de configuração para determinar a duração de uma consulta.You will need to modify two configuration files to determine the duration of a query.

Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.configMicrosoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config

No arquivo Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config, altere o valor de EmitQueryTraces de False para True.Within the Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config file, change the EmitQueryTraces value from False to True. Este arquivo está localizado, por padrão, em C:\Arquivos de Programas\Gateway de dados local.This file is located, by default, at C:\Program Files\On-premises data gateway. Ao habilitar EmitQueryTraces, começarão ser registradas em log as consultas enviadas do gateway para uma fonte de dados.Enabling EmitQueryTraces will begin to log queries that are sent from the gateway to a data source.

Importante

Habilitar EmitQueryTraces pode aumentar o tamanho do log significativamente, dependendo do uso de gateway.Enabling EmitQueryTraces could increase the log size significantly depending on gateway usage. Depois de examinar os logs, você desejará definir EmitQueryTraces como False.Once you are done reviewing the logs, you will want to set EmitQueryTraces to False. Não é recomendável deixar esta configuração habilitada a longo prazo.It is not recommended to leave this setting enabled long term.

<setting name="EmitQueryTraces" serializeAs="String">
    <value>True</value>
</setting>

Exemplo de entrada de consultaExample query entry

DM.EnterpriseGateway Information: 0 : 2016-09-15T16:09:27.2664967Z DM.EnterpriseGateway    4af2c279-1f91-4c33-ae5e-b3c863946c41    d1c77e9e-3858-4b21-3e62-1b6eaf28b176    MGEQ    c32f15e3-699c-4360-9e61-2cc03e8c8f4c    FF59BC20 [DM.GatewayCore] Executing query (timeout=224) "<pi>
SELECT
TOP (1000001) [t0].[ProductCategoryName],[t0].[FiscalYear],SUM([t0].[Amount])
 AS [a0]
FROM
(
(select [$Table].[ProductCategoryName] as [ProductCategoryName],
    [$Table].[ProductSubcategory] as [ProductSubcategory],
    [$Table].[Product] as [Product],
    [$Table].[CustomerKey] as [CustomerKey],
    [$Table].[Region] as [Region],
    [$Table].[Age] as [Age],
    [$Table].[IncomeGroup] as [IncomeGroup],
    [$Table].[CalendarYear] as [CalendarYear],
    [$Table].[FiscalYear] as [FiscalYear],
    [$Table].[Month] as [Month],
    [$Table].[OrderNumber] as [OrderNumber],
    [$Table].[LineNumber] as [LineNumber],
    [$Table].[Quantity] as [Quantity],
    [$Table].[Amount] as [Amount]
from [dbo].[V_CustomerOrders] as [$Table])
)
 AS [t0]
GROUP BY [t0].[ProductCategoryName],[t0].[FiscalYear] </pi>"

Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.configMicrosoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config

No arquivo Microsoft.PowerBI.DataMovement.Pipeline.Diagnostics.dll.config, altere o valor de TraceVerbosity de 4 para 5.Within the Microsoft.PowerBI.DataMovement.Pipeline.Diagnostics.dll.config file, change the TraceVerbosity value from 4 to 5. Este arquivo está localizado, por padrão, em C:\Arquivos de Programas\Gateway de dados local.This file is located, by default, at C:\Program Files\On-premises data gateway. A alteração dessa configuração começará a registrar entradas detalhadas no log de gateway.Changing this setting will begin to log verbose entries to the gateway log. Isso inclui entradas que mostram a duração.This includes entries that show duration.

Importante

Habilitar o TraceVerbosity para 5 pode aumentar o tamanho do log significativamente, dependendo do uso do gateway.Enabling TraceVerbosity to 5 could increase the log size significantly depending on gateway usage. Depois de examinar os logs, você poderá definir TraceVerbosity como 4.Once you are done reviewing the logs, you will want to set TraceVerbosity to 4. Não é recomendável deixar esta configuração habilitada a longo prazo.It is not recommended to leave this setting enabled long term.

<setting name="TracingVerbosity" serializeAs="String">
    <value>5</value>
</setting>

Tipos de atividadeActivity Types

Tipo de atividadeActivty Type DescriçãoDescription
MGEQMGEQ Consultas executadas no ADO.NET.Queries executed over ADO.NET. Estão inclusas outras fontes de dados do DirectQuery.This includes DirectQuery data sources.
MGEOMGEO Consultas executadas no OLEDB.Queries executed over OLEDB. Inclui o SAP HANA e o Analysis Services 2016.This includes SAP HANA and Analysis Services 2016.
MGEMMGEM Consultas executadas do mecanismo de Mashup.Queries executed from the Mashup engine. Usadas com conjuntos de dados importados que usam a atualização agendada ou a atualização sob demanda.This is used with imported datasets that use scheduled refresh or refresh on-demand.

Determinar a duração de uma consultaDetermine the duration of a query

Para determinar o tempo necessário para consultar a fonte de dados, você pode fazer o seguinte.To determine the time it took to query the data source, you can do the following.

  1. Abra o log de gateway.Open the gateway log.
  2. Pesquise um Tipo de Atividade para localizar a consulta.Search for an Activity Type to find the query. Um exemplo seria MGEQ.An example of this would be MGEQ.
  3. Anote o segundo GUID, que é a ID de solicitação.Make note of the second GUID as this is the request id.
  4. Continue a pesquisar o MGEQ até encontrar a entrada FireActivityCompletedSuccessfullyEvent com a duração.Continue to search for MGEQ until you find the FireActivityCompletedSuccessfullyEvent entry with the duration. Você pode verificar se a entrada tem a mesma ID de solicitação. A duração estará em milissegundos.You can verify the entry has the same request id. Duration will be in milliseconds.

     DM.EnterpriseGateway Verbose: 0 : 2016-09-26T23:08:56.7940067Z DM.EnterpriseGateway    baf40f21-2eb4-4af1-9c59-0950ef11ec4a    5f99f566-106d-c8ac-c864-c0808c41a606    MGEQ    21f96cc4-7496-bfdd-748c-b4915cb4b70c    B8DFCF12 [DM.Pipeline.Common.TracingTelemetryService] Event: FireActivityCompletedSuccessfullyEvent (duration=5004)
    

    Observação

    FireActivityCompletedSuccessfullyEvent é uma entrada detalhada.FireActivityCompletedSuccessfullyEvent is a verbose entry. Essa entrada apenas será registrada se o TraceVerbosity estiver no nível 5.This entry will not be logged unless TraceVerbosity is at level 5.

Ferramentas para solução de problemasTools for troubleshooting

Coletando logs do configurador do gatewayCollecting logs from the gateway configurator

Existem vários logs que você pode coletar para o gateway e você sempre deve começar com os logs.There are several logs you can collect for the gateway, and you should always start with the logs. A maneira mais simples de coletar logs depois de instalar o gateway é por meio da interface do usuário.The simplest way to collect logs after installing the gateway is through the user interface. Na interface do usuário Gateway de dados local, selecione Diagnóstico e, em seguida, selecione o link Exportar logs próximo à parte inferior da página, conforme mostrado na imagem a seguir.In the On-premises data gateway user interface, select Diagnostics and then select the Export logs link near the bottom of the page, as shown in the following image.

On-prem-data-gateway-UI-logs

Logs do instaladorInstaller logs

%localappdata%\Temp\On-premises_data_gateway_*.log

Logs de configuraçãoConfiguration logs

%localappdata%\Microsoft\On-premises Data Gateway\GatewayConfigurator*.log

Logs de serviço do gateway de dados localOn-premises data gateway service logs

C:\Users\PBIEgwService\AppData\Local\Microsoft\On-premises Data Gateway\Gateway*.log

Logs de eventosEvent Logs

Os logs de eventos do serviço do gateway de dados local estão presentes nos Logs de Aplicativos e Serviços.The On-premises data gateway service event logs are present under Application and Services Logs.

On-prem-data-gateway-event-logs

Rastreamento do FiddlerFiddler Trace

Fiddler é uma ferramenta gratuita da Telerik que monitora o tráfego HTTP.Fiddler is a free tool from Telerik that monitors HTTP traffic. Você pode ver a parte de trás e frente com o serviço do Power BI do computador cliente.You can see the back and forth with the Power BI service from the client machine. Isso pode mostrar erros e outras informações relacionadas.This may show errors and other related information.

Histórico de atualizaçãoRefresh History

Ao usar o gateway para atualização agendada, o Histórico de Atualização pode ajudá-lo a ver quais erros ocorreram, além de fornecer dados úteis caso precise criar uma solicitação de suporte.When using the gateway for scheduled refresh, Refresh History can help you see what errors have occurred, as well as provide useful data if you should need to create a support request. Você pode exibir as atualizações programadas ou sob demanda.You can view both scheduled, as well as on demand, refreshes. Aqui está como você pode acessar o Histórico de atualização.Here is how you can get to the Refresh History.

  1. No painel de navegação do Power BI, em Conjuntos de Dados, selecione um conjunto de dados > Abrir Menu > Agendar Atualização.In the Power BI navigation pane, in Datasets, select a dataset > Open Menu > Schedule Refresh.

  2. Em Configurações de... > Agendar Atualização, selecione Histórico de Atualização.In Settings for... > Schedule Refresh, select Refresh History.

Para obter informações adicionais sobre como solucionar problemas de cenários de atualização, examine o artigo Solução de problemas de cenários de atualização.For additional information about troubleshooting refresh scenarios, take a look at the Troubleshooting Refresh Scenarios article.

Próximas etapasNext steps

Definindo as configurações de proxy dos gateways do Power BIConfiguring proxy settings for the Power BI gateways
Gateway de dados localOn-premises data gateway
Detalhes sobre o gateway de dados localOn-premises data gateway - in-depth
Gerenciar sua fonte de dados – Analysis ServicesManage your data source - Analysis Services
Gerenciar sua fonte de dados – SAP HANAManage your data source - SAP HANA
Gerenciar sua fonte de dados – SQL ServerManage your data source - SQL Server
Gerenciar sua fonte de dados – Importar/Atualização agendadaManage your data source - Import/Scheduled refresh
Mais perguntas?More questions? Experimente a Comunidade do Power BITry the Power BI Community