オンプレミス データ ゲートウェイのトラブルシューティングTroubleshooting the on-premises data gateway

この記事では、オンプレミス データ ゲートウェイを使用するときに発生する一般的な問題について説明します。This article discusses some common issues you may encounter when using the on-premises data gateway.

注意

以下に記載されていない問題が発生した場合は、次の場所でさらに支援を求めることができます。If you encounter an issue that is not listed below, you can ask for further assistance in the following locations.

最新のバージョンに更新するUpdate to the latest version

多くの問題は、ゲートウェイのバージョンが期限切れになると発生します。A lot of issues can surface when the gateway version is out of date. 常に最新のバージョンを使用することは一般に適切な方法です。It is a good general practice to make sure you are on the latest version. ゲートウェイを 1 か月以上更新していない場合は、ゲートウェイの最新バージョンのインストールを検討して問題が再発するかどうかを確認することをお勧めします。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.

一般的な問題Common issues

ここでは、インターネット アクセスが制限されている環境でのユーザーに役立つ、一般的な問題と解決策について説明します。Here are a few common issues and resolutions that have helped a number of customers in environments that restrict internet access.

プロキシ サーバーへの認証Authentication to proxy server

プロキシは、ドメイン ユーザー アカウントからの認証を必要とする場合があります。Your proxy may require authentication from a domain user account. 既定では、ゲートウェイは Windows サービスのログオン ユーザーのサービス SID を使用します。By default, the gateway uses a Service SID for the windows service log on user. ログオン ユーザーをドメイン ユーザーに変更すると、この認証に役立ちます。Changing the log on user to a domain user can help with this. 詳細については、「ドメイン ユーザーへのゲートウェイ サービス アカウントの変更」をご覧ください。For more information, see Changing the gateway service account to a domain user.

プロキシはポート 80 と 443 のトラフィックのみを許可するYour proxy only allows ports 80 and 443 traffic

一部のプロキシは、トラフィックをポート 80 と 443 のみに制限します。Some proxies restrict traffic to only ports 80 and 443. 既定では、Azure Service Bus への通信は 443 以外のポートで行われます。By default, communication to Azure Service Bus will occur on ports other than 443.

ゲートウェイと Azure Service Bus との間の通信に、直接 TCP ではなく HTTPS を使用するように強制できます。You can force the gateway to communicate with Azure Service Bus using HTTPS instead of direct TCP. Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config ファイルを変更する必要があります。You will need to modify the Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config file. 値を AutoDetect から Https に変更します。Change the value from AutoDetect to Https. このファイルは、既定では C:\Program Files\On-premises data gateway にあります。This file is located, by default, at C:\Program Files\On-premises data gateway.

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

インストールInstallation

エラー: ユーザーをグループに追加できませんでした。Error: Failed to add user to group. (-2147463168 PBIEgwService Performance Log Users )(-2147463168 PBIEgwService Performance Log Users )

ゲートウェイをドメイン コントローラーにインストールしようとした場合に、このエラーが発生することがあります。You may receive this error if you are trying to install the gateway on a domain controller. ドメイン コントローラーへの展開はサポートされていません。Deploying on a domain controller is not supported. ゲートウェイは、ドメイン コントローラーではないコンピューターに展開する必要があります。You will need to deploy the gateway on a machine that is not a domain controller.

構成Configuration

ゲートウェイを再起動する方法How to restart the gateway

ゲートウェイは Windows サービスとして実行するので、複数の方法で開始したり停止したりできます。The gateway runs as a Windows service, so you can start and stop it in multiple ways. たとえば、ゲートウェイを実行しているコンピューターで管理者特権を持つコマンド プロンプトを開き、次のいずれかのコマンドを実行できます。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:

  • サービスを停止する場合:To stop the service, run this command:

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

  • サービスを開始する場合:To start the service, run this command:

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

エラー: ゲートウェイを作成できませんでした。Error: Failed to create gateway. もう一度お試しください。Please try again.

すべての詳細情報を利用できますが、Power BI サービスの呼び出しでエラーが返されました。All of the details are available, but the call to the Power BI service returned an error. エラーとアクティビティ ID が表示されます。The error, and an activity id, will be displayed. このエラーは、さまざまな理由で発生することがあります。This could happen for different reasons. 以下で説明するように、ログを収集して内容を確認し、詳細を調査することができます。You can collect, and review, the logs, as mentioned below, to get more details.

このエラーは、プロキシの構成上の問題によって発生することもあります。This could also be due to proxy configuration issues. ユーザー インターフェイスからは、プロキシを構成することはできません。The user interface does now allow for proxy configuration. プロキシ構成の変更の詳細をご覧ください。You can learn more about making proxy configuration changes

エラー: ゲートウェイの詳細を更新できませんでした。Error: Failed to update gateway details. もう一度お試しください。Please try again.

Power BI サービスからの情報は、ゲートウェイで受信されました。Information was received from the Power BI service, to the gateway. この情報はローカルの Windows サービスに渡されましたが、必要な値を返すことができませんでした。The information was passed onto the local windows service, but it failed to return. または、対称キーの生成に失敗しました。Or, a symmetric key generation failed. [詳細を表示する]には、内部例外が表示されます。The inner exception will be displayed under Show details. 以下で説明するように、ログを収集して内容を確認し、詳細を調査することができます。You can collect, and review, the logs, as mentioned below, to get more details.

エラー: Power BI サービスからローカル ゲートウェイが到達不可という報告がありました。Error: Power BI service reported local gateway as unreachable. ゲートウェイを再起動してから、もう一度お試しください。Please restart the gateway and try again.

構成の最後に、Power BI サービスがもう一度呼び出されてゲートウェイが検証されます。At the end of configuration, the Power BI service will be called again to validate the gateway. Power BI サービスは、ゲートウェイを ライブ 状態として報告しませんでした。The Power BI service does not report the gateway as live. Windows サービスを再起動すると、通信が成功する場合があります。Restarting the windows service may allow the communication to be successful. 以下で説明するように、ログを収集して内容を確認し、詳細を調査することができます。You can collect, and review, the logs, as mentioned below, to get more details.

Power BI へのサインイン時のスクリプト エラーScript error during sign into Power BI

オンプレミス データ ゲートウェイの構成の一部として、Power BI にサインインしたとき、スクリプト エラーが表示される場合があります。You may receive a script error when signing into Power BI as part of the on-premises data gateway configuration. 次のセキュリティ更新プログラムをインストールすると、問題は解決します。Installing the following security update should resolve the issue. これは、Windows Update を介してインストールできます。This can be installed via Windows Update.

MS16-051: Internet Explorer のセキュリティ更新プログラム: 2016 年 5 月 10 日 (KB 3154070)MS16-051: Security update for Internet Explorer: May 10, 2016 (KB 3154070)

ゲートウェイの構成が null 参照例外で失敗するGateway configuration failed with a null reference exception

次のようなエラーが発生する場合があります。You may encounter an error similar to the following.

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

これにはスタック トレースが含まれ、そのスタック トレースには以下のものが含まれる場合があります。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

古いゲートウェイからアップグレードする場合、構成ファイルを保持します。If you are upgrading from an older gateway, we preserve the config file. 欠落しているセクションがある可能性があります。There may be a section that is missing. ゲートウェイがそれを読み取ろうとすると、上記の null 参照例外が発生します。When the gateway tries to read it, we will get the above null reference exception.

これを修正するには、次の操作を行います。To correct this, do the following.

  1. ゲートウェイをアンインストールします。Uninstall the gateway.
  2. 次のフォルダーを削除します。Delete the following folder.

     c:\Program Files\on-premises data gateway
    
  3. ゲートウェイを再インストールします。Reinstall the gateway.
  4. 必要に応じて、回復キーを適用して既存のゲートウェイを復元します。Optionally apply the recovery key to restore an existing gateway.

TLS 1.1/1.2 のサポートSupport for TLS 1.1/1.2

2017 年 8 月の更新以降、オンプレミス データ ゲートウェイは既定でトランスポート層セキュリティ (TLS) 1.1 または 1.2 を利用して Power BI サービスと通信します。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. オンプレミス データ ゲートウェイの以前のバージョンは、既定で、TLS 1.0 を使用します。Previous versions of the on-premises data gateway use TLS 1.0 by default. 2017 年 11 月 1 日に TLS 1.0 のサポートが終了します。そのため、オンプレミス データ ゲートウェイを引き続き利用するには、そのときまでに 2017 年 8 月公開以降のものにアップグレードする必要があります。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.

11 月 1 日まではオンプレミス データ ゲートウェイは TLS 1.0 に対応しており、フォールバック メカニズムとしてゲートウェイに利用されることにご留意ください。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. すべてのゲートウェイ トラフィックで TLS 1.1 または 1.2 が使用されるように (また、ゲートウェイで TLS 1.0 の使用を防止するために)、ゲートウェイ サービスを実行しているコンピューターで次のレジストリ キーを追加または変更する必要があります。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

注意

これらのレジストリ キーを追加したり、変更したりすると、すべての .NET アプリケーションに変更が適用されます。Adding or modifying these registry keys applies the change to all .NET applications. 他のアプリケーションの TLS に影響を与えるレジストリ変更については、トランスポート層セキュリティ (TLS) レジストリ設定をご覧ください。For information about registry changes that affect TLS for other applications, see Transport Layer Security (TLS) registry settings.

データ ソースData sources

エラー: 接続できません。Error: Unable to Connect. 詳細: "接続の資格情報が正しくありません"Details: "Invalid connection credentials"

[詳細を表示する]には、データ ソースから受信したエラー メッセージが表示されます。Within Show details, it should display the error message received from the data source. SQL Server の場合は、次のように表示されます。For SQL Server, you should see something like the following.

Login failed for user 'username'.

ユーザー名とパスワードが正しいことを確認します。Verify that you have the correct username and password. また、これらの資格情報を使用してデータ ソースに正常に接続できることを確認します。Also verify that those credentials can successfully connect to the data source. 使用されているアカウントが、 [認証方法]と一致していることを確認してください。Make sure the account being used matches the Authentication Method.

エラー: 接続できません。Error: Unable to Connect. 詳細: "データベースに接続できません"Details: "Cannot connect to the database"

サーバーには接続できましたが、指定されたデータベースには接続できませんでした。We were able to connect to the server, but not to the database supplied. データベースの名前を確認し、そのデータベースにアクセスできる適切なアクセス許可がユーザー資格情報に付与されていることを確認します。Verify the name of the database, and that the user credential as the proper permission to access that database.

[詳細を表示する]には、データ ソースから受信したエラー メッセージが表示されます。Within Show details, it should display the error message received from the data source. SQL Server の場合は、次のように表示されます。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'.

エラー: 接続できません。Error: Unable to Connect. 詳細: "Unknown error in data gateway" (データ ゲートウェイでの不明なエラー)Details: "Unknown error in data gateway"

このエラーは、さまざまな理由で発生する可能性があります。This error could occur for different reasons. ゲートウェイをホストしているコンピューターからデータ ソースに接続できることを必ず確認してください。Be sure to validate that you can connect to the data source from the machine hosting the gateway. サーバーにアクセスできない場合も、このエラーが表示されることがあります。This could be the result of the server not being accessible.

[詳細を表示する]には、 DM_GWPipeline_UnknownErrorのエラー コードが表示されます。Within Show details, you will see an error code of DM_GWPipeline_UnknownError.

また、[イベント ログ]、[アプリケーションとサービス ログ] > [On-premises Data Gateway Service](オンプレミス データ ゲートウェイ サービス) で、詳細を確認することができます。You can also look in the Event Logs > Applications and Services Logs > on-premises data gateway Service for more details.

エラー: に接続しようとしているときにエラーが発生しました。Error: We encountered an error while trying to connect to . 詳細: "data gateway に到達しましたが、ゲートウェイがオンプレミスのデータ ソースにアクセスできません。"Details: "We reached the data gateway, but the gateway can't access the on-premises data source."

指定したデータ ソースに接続できませんでした。We were unable to connect to the specified data source. そのデータ ソースについて提供された情報を検証してください。Be sure to validate the information provided for that data source.

[詳細を表示する]には、 DM_GWPipeline_Gateway_DataSourceAccessErrorのエラー コードが表示されます。Within Show details, you will see an error code of DM_GWPipeline_Gateway_DataSourceAccessError.

基になっているエラー メッセージが次のような場合は、データ ソースに対して使用しているアカウントがその 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. 詳細情報Learn more

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

基になっているエラー メッセージが次のような場合は、Analysis Services のサービス アカウントに token-groups-global-and-universal (TGGAU) ディレクトリ属性がない可能性があります。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.

Windows 2000 以前と互換性のあるアクセス権を持つドメインでは TGGAU 属性は有効になります。Domains with Pre-Windows 2000 compatibility access will have the TGGAU attribute enabled. ただし、最近作成されたドメインではこの属性が既定で有効になりません。However, most newly created domains will not enable this attribute by default. 詳細については、こちらを参照してください。You can read more about this here.

これは、以下のようにして確認できます。You can confirm this by doing the following.

  1. SQL Server Management Studio 内の Analysis Services マシンに接続します。Connect to the Analysis Services machine within SQL Server Management Studio. 詳細接続プロパティ内に、該当するユーザーの EffectiveUserName を含め、エラーが再現するかどうかを確認します。Within the Advanced connection properties, include EffectiveUserName for the user in question and see if this reproduces the error.
  2. dsacls Active Directory ツールを使用すれば、属性がリストされるかどうかを確認できます。You can use the dsacls Active Directory tool to validate whether the attribute is listed. このツールは、通常、ドメイン コントローラーにあります。This is tool is normally found on a domain controller. アカウントのドメインの識別名を確認し、ツールに渡す必要があります。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"
    

    結果は次のようになります。You want to see something similar to the following in the results.

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

この問題を修正するには、Analysis Services Windows サービスで使用するアカウントで TGGAU を有効にする必要があります。To correct this issue, you will need to enable TGGAU on account used for the Analysis Services windows service.

ユーザー名またはパスワードが間違っている可能性もあるAnother possibility for user name or password incorrect

Analysis Service サーバーがユーザーとは異なるドメインにあり、双方向の信頼が確立されていない場合にも、このエラーが発生することがあります。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.

ドメイン管理者と協力して、ドメイン間の信頼関係を確認する必要があります。You will need to work with your domain administrators to verify the trust relationship between domains.

Power BI サービスの Analysis Services の [データの取得] エクスペリエンスで、データ ゲートウェイのデータ ソースが表示されませんUnable to see the data gateway data sources in the 'Get Data' experience for Analysis Services from the Power BI service

ゲートウェイ構成内のデータ ソースの [ユーザー] タブに、自分のアカウントが表示されていることを確認します。Make sure that your account is listed in the Users tab of the data source within the gateway configuration. ゲートウェイへのアクセス権がない場合は、ゲートウェイの管理者に連絡して確認を依頼してください。If you don't have access to the gateway, check with the administrator of the gateway and ask them to verify. [ユーザー] の一覧にあるアカウントのみが、Analysis Services の一覧にあるデータ ソースを参照できます。Only accounts in the Users list will see the data source listed in the Analysis Services list.

データセットDatasets

エラー: この行に十分な領域がありません。Error: There is not enough space for this row.

このエラーは、1 つのサイズが 4 MB を超える行がある場合に発生します。This will occur if you have a single row greater than 4 MB in size. データ ソースから行を特定し、その行をフィルターで除外するか、その行のサイズを減らす必要があります。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.

エラー: 指定されたサーバー名が、SQL Server SSL 証明書のサーバー名と一致しません。Error: The server name provided doesn't match the server name on the SQL Server SSL Certificate.

このエラーは、証明書の CN がサーバーの完全修飾ドメイン名 (FQDN) に対するものであるときに、サーバーの netbios 名だけを指定すると発生します。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. これにより、証明書の不一致が発生します。This will cause a mismatch for the certificate. この問題を解決するには、ゲートウェイのデータ ソースおよび PBIX ファイルのサーバー名で、サーバーの FQDN を使うようにする必要があります。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.

スケジュールされた更新を構成するときに、オンプレミス データ ゲートウェイが表示されません。I don't see the on-premises data gateway persent when configuring scheduled refresh.

原因としてはさまざまなシナリオが考えられます。This could be because of a few different scenarios.

  1. サーバーおよびデータベース名が、Power BI Desktop で入力されたものと、ゲートウェイに対して構成されているデータの間で、一致していません。The server and database name don't match between what was entered in Power BI Desktop and the data source configured for the gateway. これらは同じ値である必要があります。These need to be the same values. 大文字と小文字は区別されません。They are not case sensitive.
  2. ゲートウェイ構成内のデータ ソースの [ユーザー] タブに、自分のアカウントが表示されていません。Your account is not listed in the Users tab of the data source within the gateway configuration. ゲートウェイの管理者に依頼して、そのリストに追加してもらう必要があります。You will need to get with the administrator of the gateway to be added to that list.
  3. Power BI Desktop ファイルに複数のデータ ソースがあり、ゲートウェイですべてのデータ ソースが構成されていません。Your Power BI Desktop file has multiple data sources within it and not all of those data sources are configured with the gateway. スケジュールされている更新にゲートウェイを表示させるには、ゲートウェイで各データ ソースを定義する必要があります。You will need to have each data source defined with the gateway for the gateway to show up within Scheduled Refresh.

エラー: ゲートウェイ クライアントで受信した非圧縮データが制限を超えています。Error: The received uncompressed data on the gateway client has exceeded limit.

テーブルごとの非圧縮データの上限は 10 GB です。The exact limitation is 10 GB of uncompressed data per table. この問題か発生した場合、最適化してこの問題を回避することができる適切な選択肢があります。If you are hitting this issue, there are good options to optimize and avoid the issue. 特に、繰り返しが多い長い文字列値の使用を減らし、代わりに正規化されたキーを使用するか、(使用されていない列の場合は) 列を削除する方法があります。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.

レポートReports

レポートからデータ ソースにアクセスできませんでした。オンプレミス データ ゲートウェイ経由でデータ ソースにアクセスできません。Report could not access the data source because you do not have access to our data source via an on-premises data gateway.

これは通常、次のいずれかの原因によって発生します。This is usually caused by one of the following.

  1. データ ソースの情報が、基になるデータセットの情報と一致しません。The data source information does not match what is in the underlying dataset. オンプレミス データ ゲートウェイ用に定義されているデータ ソースと 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. Power BI Desktop で IP アドレスを使用する場合は、オンプレミス データ ゲートウェイ用のデータ ソースでも 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. 組織内のゲートウェイには、使用可能なデータ ソースがありません。There is not a data source available on any gateway within your organization. 新規または既存のオンプレミス データ ゲートウェイでデータ ソースを構成できます。You can configure the data source on a new, or existing, on-premises data gateway.

エラー: データ ソースのアクセス エラー。Error: Data source access error. ゲートウェイの管理者にお問い合わせください。Please contact the gateway administrator.

このレポートで Analysis Services ライブ接続を使用している場合、有効でないか、Analysis Services コンピューターへのアクセス許可のない EffectiveUserName に渡される値に関する問題が発生することがあります。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. 通常、認証の問題は、EffectiveUserName に渡される値がローカルのユーザー プリンシパル名 (UPN) と一致していない場合に発生します。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).

これは、次の操作を行って確認できます。To confirm this, you can do the following.

  1. ゲートウェイ ログ内で有効なユーザー名を見つけます。Find the effective username within the gateway logs.
  2. 値が渡されたら、それが正しいことを確認します。Once you have the value being passed, validate that it is correct. 自分のユーザーの場合は、コマンド プロンプトから次のコマンドを使用して、UPN を確認できます。If it is your user, you can use the following command from a command prompt to see what the UPN should be. UPN は電子メール アドレスのようになります。The UPN will look like an email address.

     whoami /upn
    

必要に応じて、Azure Active Directory から Power BI が取得した内容を確認できます。Optionally, you can see what Power BI gets from Azure Active Directory.

  1. https://graphexplorer.cloudapp.net を参照します。Browse to https://graphexplorer.cloudapp.net.
  2. 右上の [サインイン] を選択します。Select Sign in in the upper right.
  3. 次のクエリを実行します。Run the following query. かなり大きな JSON 応答が表示されます。You will see a rather large JSON response.

     https://graph.windows.net/me?api-version=1.5
    
  4. userPrincipalName を探します。Look for userPrincipalName.

Azure Active Directory UPN がローカルの Active Directory UPN と一致しない場合は、[ユーザー名のマップ] 機能を使用して、有効な値に置き換えることができます。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. あるいは、テナント管理者、またはローカルの Active Directory 管理者と協力して、UPN を変更することができます。Or you can work with either your tenant admin, or local Active Directory admin, to get your UPN changed.

ファイアウォールまたはプロキシFirewall or Proxy

ゲートウェイのプロキシ情報の指定については、「Power BI Gateway のプロキシ設定を構成する」を参照してください。For information on providing proxy information for your gateway, see Configuring proxy settings for the Power BI gateways.

PowerShell プロンプトから Test-NetConnection を実行して、ファイアウォールまたはプロキシが接続をブロックしている可能性があるかどうかをテストできます。You can test to see if your firewall, or proxy, may be blocking conections by running Test-NetConnection from a PowerShell prompt. これは、Azure Service Bus への接続をテストすることになります。This will test connectivity to the Azure Service Bus. これはネットワーク接続のみをテストし、クラウド サーバー サービスやゲートウェイとはまったく関係ありません。This only tests network connectivity and doesn't have anything to do with the cloud server service or the gateway. コンピューターが実際にインターネットに接続できるかどうかを確認するのに役立ちます。It helps to determine if your machine can actually get out to the internet.

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

注意

Test-NetConnection を使用できるのは、Windows Server 2012 R2 以降だけです。Test-NetConnection is only available on Windows Server 2012 R2 and later. Windows 8.1 以降でも使用できます。It is also available on Windows 8.1 and later. これらより前のバージョンの OS では、Telnet を使ってポートの接続をテストできます。On earlier OS versions, you can use Telnet to test port connectivity.

結果は次のようになります。The results should look similar to the following. TcpTestSucceeded の値を確認してください。The difference will be with TcpTestSucceeded. TcpTestSucceededtrue でない場合、ファイアウォールによってブロックされています。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

すべてを網羅するには、ComputerNamePort の値を、「ポート」に記載されている値に置き換えます。If you want to be exhaustive, substitute the ComputerName and Port values with those listed for ports

ファイアウォールが Azure Service Bus から Azure データ センターへの接続をブロックしている場合もあります。The firewall may also be blocking the connections that the Azure Service Bus makes to the Azure data centers. そのような場合には、お住まいの地域のデータ センターの IP アドレスをホワイトリストに指定 (ブロック解除) します。If that is the case, you will want to whitelist (unblock) the IP addresses for your region for those data centers. Azure IP アドレスのリストはこちらで取得できます。You can get a list of Azure IP addresses here.

データ センターの地域は、次の手順を実行して見つけることができます。You can find the data center region you are in by doing the following:

  1. [?] (Select the ? Power BI サービスの右上にあります) を選択します。in the upper right of the Power BI service.
  2. [About Power BI] (Power BI のバージョン情報) を選択します。Select About Power BI.
  3. [データの保存先] にデータの地域がリストされます。Your data region will be listed in Your data is stored in.

それでも見つからない場合は、fiddler または netsh などのツールを使用してネットワーク トレースの取得を試みることができます。ただし、この方法は高度な収集方法であるため、収集したデータの分析に支援が必要になる場合があります。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. 支援が必要な場合は、サポートにお問い合わせください。You can contact support for assistance.

パフォーマンスPerformance

パフォーマンス カウンターPerformance Counters

ゲートウェイのアクティビティを計測するために使用できるパフォーマンス カウンターがいくつかあります。There are a number of performance counters that can be used to gauge the activities for the gateway. 大量のアクティビティが存在するため、新しいゲートウェイを用意する必要があるかどうかを判断するのに役立つことがあります。These can be helpful to understanding if we have a large load of activity and may need to make a new gateway. アクティビティに必要な時間は反映されません。These counters will not reflect how long something takes.

カウンターには Windows パフォーマンス モニター ツールからアクセスできます。These counters can be access through the Windows Performance Monitor tool.

カウンターには一般的なグループがあります。There are general groupings of these counters.

カウンターの種類Counter Type 説明Description
ADO.NETADO.NET DirectQuery 接続に使用されます。This is used for any DirectQuery connection.
ADOMDADOMD Analysis Services 2014 以前に使用されます。This is used for Analysis Services 2014 and earlier.
OLEDBOLEDB 特定のデータ ソースで使用されます。This is used by certain data sources. これには SAP HANA と Analysis Service 2016 以降が含まれます。This includes SAP HANA and Analysis Service 2016 or later.
MashupMashup これにはあらゆるインポートされたデータ ソースが含まれます。This includes any imported data source. 更新を予定している場合、またはオンデマンドの更新を実行している場合、マッシュアップ エンジンが利用されます。If you are scheduling refresh or doing an on-demand refresh, it will go through the mashup engine.

利用できるパフォーマンス カウンターの一覧は次のとおりです。Here is a listing of the available performance counters.

カウンターCounter 説明Description
# of ADO.NET open connection executed / sec# of ADO.NET open connection executed / sec 1 秒間に実行された ADO.NET オープン接続アクションの数 (成功または失敗)。Number of ADO.NET open connection actions executed per second (succeeded or failed).
# of ADO.NET open connection failed / sec# of ADO.NET open connection failed / sec 1 秒間に実行された ADO.NET オープン接続アクションの数 (失敗)。Number of ADO.NET open connections actions failed per second.
# of ADO.NET queries executed / sec# of ADO.NET queries executed / sec 1 秒間に実行された ADO.NET クエリの数 (成功または失敗)。Number of ADO.NET queries executed per second (succeeded or failed).
# of ADO.NET queries failed / sec# of ADO.NET queries failed / sec 1 秒間に実行された ADO.NET クエリの数 (失敗)。Number of ADO.NET failed queries executed per second.
# of ADOMD open connection executed / sec# of ADOMD open connection executed / sec 1 秒間に実行された ADOMD オープン接続の数 (成功または失敗)。Number of ADOMD open connection actions executed per second (succeeded or failed).
# of ADOMD open connection failed / sec# of ADOMD open connection failed / sec 1 秒間に実行された ADOMD オープン接続アクションの数 (失敗)。Number of ADOMD open connection actions failed per second.
# of ADOMD queries executed / sec# of ADOMD queries executed / sec 1 秒間に実行された ADOMD クエリの数 (成功または失敗)。Number of ADOMD queries executed per second (succeeded or failed).
# of ADOMD queries failed / sec# of ADOMD queries failed / sec 1 秒間に実行された ADOMD クエリの数 (失敗)。Number of ADOMD failed queries executed per second.
# of all open connection executed / sec# of all open connection executed / sec 1 秒間に実行されたオープン接続の数 (成功または失敗)。Number of open connection actions executed per second (succeeded or failed).
# of all open connection failed / sec# of all open connection failed / sec 1 秒間に実行されたオープン接続アクションの数 (失敗)。Number of failed open connection actions executed per second.
# of all queries executed / sec# of all queries executed / sec 1 秒間に実行されたクエリの数 (成功または失敗)。Number of queries executed per second (succeeded or failed).
# of items in the ADO.NET connection pool# of items in the ADO.NET connection pool ADO.NET 接続プールのアイテムの数Number of items in the ADO.NET connection pool.
# of items in the OLEDB connection pool# of items in the OLEDB connection pool OLEDB 接続プールのアイテムの数Number of items in the OLEDB connection pool.
# of items in the Service Bus pool# of items in the Service Bus pool Service Bus プールのアイテムの数Number of items in the Service Bus pool.
# of Mashup open connection executed / sec# of Mashup open connection executed / sec 1 秒間に実行された Mashup オープン接続アクションの数 (成功または失敗)。Number of Mashup open connection actions executed per second (succeeded or failed).
# of Mashup open connection failed / sec# of Mashup open connection failed / sec 1 秒間に実行された Mashup オープン接続アクションの数 (失敗)。Number of Mashup open connection actions failed per second.
# of Mashup queries executed / sec# of Mashup queries executed / sec 1 秒間に実行された Mashup クエリの数 (成功または失敗)。Number of Mashup queries executed per second (succeeded or failed).
# of Mashup queries failed / sec# of Mashup queries failed / sec 1 秒間に実行された Mashup クエリの数 (失敗)。Number of Mashup failed queries executed per second
# of multiple result set OLEDB queries failed / sec# of multiple result set OLEDB queries failed / sec 1 秒間に実行された複数結果セット OLEDB クエリの数 (失敗)。Number of multiple resultset OLEDB failed queries executed per second.
# of OLEDB multiple resultset queries executed / sec# of OLEDB multiple resultset queries executed / sec 1 秒間に実行された OLEDB 複数結果セット クエリの数 (成功または失敗)。Number of OLEDB multiple resultset queries executed per second (succeeded or failed).
# of OLEDB open connection executed / sec# of OLEDB open connection executed / sec 1 秒間に実行された OLEDB オープン接続アクションの数 (成功または失敗)。Number of OLEDB open connection actions executed per second (succeeded or failed).
# of OLEDB open connection failed / sec# of OLEDB open connection failed / sec 1 秒間に実行された OLEDB オープン接続アクションの数 (失敗)。Number of OLEDB open connection actions failed per second.
# of OLEDB queries executed / sec# of OLEDB queries executed / sec 1 秒間に実行された OLEDB 複数結果セット クエリの数 (成功または失敗)。Number of OLEDB multiple resultset queries executed per second (succeeded or failed).
# of OLEDB queries failed / sec# of OLEDB queries failed / sec 1 秒間に実行された OLEDB 複数結果セット クエリの数 (失敗)。Number of OLEDB mutiple resultset failed queries executed per second.
# of OLEDB single resultset queries executed / sec# of OLEDB single resultset queries executed / sec 1 秒間に実行された OLEDB 単一結果セット クエリの数 (成功または失敗)。Number of OLEDB single resultset queries executed per second (succeeded or failed).
# of queries failed / sec# of queries failed / sec 1 秒間に実行されたクエリの数 (失敗)。Number of failed queries executed per second.
# of single result set OLEDB queries failed / sec# of single result set OLEDB queries failed / sec 1 秒間に実行された単一結果セット OLEDB クエリの数 (失敗)。Number of single resultset OLEDB failed queries executed per second.

実行速度の遅いクエリを確認するReviewing slow performing queries

ゲートウェイを介した応答が遅いことがあります。You may find that response through the gateway is slow. DirectQuery クエリの場合や、インポートされたデータセットを更新する場合などです。This could be for DirectQuery queries or when refreshing your imported dataset. 追加のログを有効にしてクエリとそのタイミングを出力すると、実行が遅いものを見つける場合に役立ちます。You can enable additional logging to output queries and their timings to help understand what is performing slow. 実行時間の長いクエリが見つかったとき、クエリのパフォーマンスを調整するために、データ ソースの追加の修正が必要になることがあります。When you find a long running query, it may require additional modification on your data source to tune query performance. たとえば、SQL Server クエリのインデックスの調整などです。For example, adjusting indexes for a SQL Server query.

クエリの時間を判断するには、2 つの設定ファイルを修正する必要があります。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

Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config ファイル内で EmitQueryTraces 値を False から True に変更します。Within the Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config file, change the EmitQueryTraces value from False to True. このファイルは、既定では C:\Program Files\On-premises data gateway にあります。This file is located, by default, at C:\Program Files\On-premises data gateway. EmitQueryTraces を有効にすると、ゲートウェイからデータ ソースに送信されるクエリがログに記録されます。Enabling EmitQueryTraces will begin to log queries that are sent from the gateway to a data source.

重要

EmitQueryTraces を有効にすると、ゲートウェイの使用状況によっては、ログのサイズが大幅に増える可能性があります。Enabling EmitQueryTraces could increase the log size significantly depending on gateway usage. ログの確認が終了した後は、EmitQueryTraces を False に設定する必要があります。Once you are done reviewing the logs, you will want to set EmitQueryTraces to False. この設定を長期間有効のままにすることは推奨されません。It is not recommended to leave this setting enabled long term.

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

クエリ エントリの例Example 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

Microsoft.PowerBI.DataMovement.Pipeline.Diagnostics.dll.config ファイル内で TraceVerbosity 値を 4 から 5 に変更します。Within the Microsoft.PowerBI.DataMovement.Pipeline.Diagnostics.dll.config file, change the TraceVerbosity value from 4 to 5. このファイルは、既定では C:\Program Files\On-premises data gateway にあります。This file is located, by default, at C:\Program Files\On-premises data gateway. この設定を変更すると、詳細なエントリがゲートウェイ ログに記録されます。Changing this setting will begin to log verbose entries to the gateway log. 期間を示すエントリが含まれます。This includes entries that show duration.

重要

5 に対して TraceVerbosity を有効にすると、ゲートウェイの使用状況によっては、ログのサイズが大幅に増える可能性があります。Enabling TraceVerbosity to 5 could increase the log size significantly depending on gateway usage. ログの確認が終了した後は、TraceVerbosity を 4 に設定する必要があります。Once you are done reviewing the logs, you will want to set TraceVerbosity to 4. この設定を長期間有効のままにすることは推奨されません。It is not recommended to leave this setting enabled long term.

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

アクティビティの種類Activity Types

アクティビティの種類Activty Type 説明Description
MGEQMGEQ ADO.NET で実行されたクエリ。Queries executed over ADO.NET. DirectQuery データ ソースが含まれます。This includes DirectQuery data sources.
MGEOMGEO OLEDB で実行されたクエリ。Queries executed over OLEDB. これには SAP HANA と Analysis Services 2016 が含まれます。This includes SAP HANA and Analysis Services 2016.
MGEMMGEM マッシュアップ エンジンから実行されたクエリ。Queries executed from the Mashup engine. スケジュールされている更新、またはオンデマンドの更新を使用しているインポートされたデータセットで使用されます。This is used with imported datasets that use scheduled refresh or refresh on-demand.

クエリの時間を判断するDetermine the duration of a query

データ ソースのクエリにかかった時間は次の方法で判断できます。To determine the time it took to query the data source, you can do the following.

  1. ゲートウェイ ログを開きます。Open the gateway log.
  2. アクティビティの種類を探し、クエリを見つけます。Search for an Activity Type to find the query. この例では、MGEQ になります。An example of this would be MGEQ.
  3. 2 つ目の GUID をメモします。これが要求 ID です。Make note of the second GUID as this is the request id.
  4. FireActivityCompletedSuccessfullyEvent エントリと時間が見つかるまで MGEQ をさらに探します。Continue to search for MGEQ until you find the FireActivityCompletedSuccessfullyEvent entry with the duration. エントリに同じ要求 ID があることを確認できます。時間はミリ秒単位です。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)
    

    注意

    FireActivityCompletedSuccessfullyEvent は詳細エントリです。FireActivityCompletedSuccessfullyEvent is a verbose entry. TraceVerbosity のレベルが 5 でなければ、このエントリはログに記録されません。This entry will not be logged unless TraceVerbosity is at level 5.

トラブルシューティングするためのツールTools for troubleshooting

ゲートウェイ構成ウィザードからのログ収集Collecting logs from the gateway configurator

ゲートウェイに関していくつかのログを収集できます。常にログを確認することから始めてください。There are several logs you can collect for the gateway, and you should always start with the logs. ゲートウェイのインストール後にログを収集する最も簡単な方法は、ユーザー インターフェイスを利用することです。The simplest way to collect logs after installing the gateway is through the user interface. オンプレミス データ ゲートウェイ ユーザー インターフェイスで、[診断] を選択し、ページの下部付近にある [ログのエクスポート] リンクを選択します。次の画像をご覧ください。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

インストーラーのログInstaller logs

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

構成のログConfiguration logs

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

オンプレミス データ ゲートウェイ サービスのログOn-premises data gateway service logs

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

イベント ログEvent Logs

オンプレミス データ ゲートウェイ サービスのイベント ログは、アプリケーションとサービス ログの下にあります。The On-premises data gateway service event logs are present under Application and Services Logs.

On-prem-data-gateway-event-logs

Fiddler のトレースFiddler Trace

Fiddler は、HTTP トラフィックを監視する Telerik 提供の無償ツールです。Fiddler is a free tool from Telerik that monitors HTTP traffic. クライアント コンピューターから Power BI サービスによるやり取りを確認できます。You can see the back and forth with the Power BI service from the client machine. これにより、エラーとその他の関連する情報が表示される場合があります。This may show errors and other related information.

更新履歴Refresh History

スケジュールされた更新にゲートウェイを使用している場合、更新履歴が発生したエラーを確認するのに役に立つことがあります。サポート依頼を作成する必要がある場合は有用なデータを提供します。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. スケジュールされた更新のほか、オンデマンドの更新も表示できます。You can view both scheduled, as well as on demand, refreshes. 更新履歴を取得する方法を次に示します。Here is how you can get to the Refresh History.

  1. Power BI ナビゲーション ウィンドウの [データセット] で、データセットを選択してから、>[メニューを開く] > [更新のスケジュール設定] を選択します。In the Power BI navigation pane, in Datasets, select a dataset > Open Menu > Schedule Refresh.

  2. [設定]> [更新のスケジュール設定] で、[更新履歴] を選択します。In Settings for... > Schedule Refresh, select Refresh History.

更新に関するトラブルシューティングのシナリオの詳細については、「更新に関するトラブルシューティング シナリオ」を参照してください。For additional information about troubleshooting refresh scenarios, take a look at the Troubleshooting Refresh Scenarios article.

次の手順Next steps

Power BI Gateway のプロキシ設定を構成するConfiguring proxy settings for the Power BI gateways
オンプレミス データ ゲートウェイOn-premises data gateway
オンプレミス データ ゲートウェイの詳細On-premises data gateway - in-depth
データ ソースの管理 - Analysis ServicesManage your data source - Analysis Services
データ ソースの管理 - SAP HANAManage your data source - SAP HANA
データ ソースの管理 - SQL ServerManage your data source - SQL Server
データ ソースの管理 - インポート/スケジュールされた更新Manage your data source - Import/Scheduled refresh
他にわからないことがある場合は、More questions? Power BI コミュニティを利用してくださいTry the Power BI Community