トラブルシューティング Direct Access gateway

このセクションでは、Direct Access gateway のトラブルシューティングで実行できるさまざまなアクションについて説明します。

ログファイルの表示とダウンロード

ログファイルは、Direct Access gateway 操作の情報を提供します。Qlik サポートは、トラブルシューティングの目的でログファイルの提供を依頼する場合があります。ログビューアでログファイルを表示したり、ダウンロードしたりできます。通常の状況下では、ログファイルを確認する必要はありませんが、失敗が繰り返されたり、その他の問題が発生したりした場合に、ログファイルは原因を特定する助けになります

ログの表示とダウンロードには、[データ消費可能] の役割が必要です。

ログビューアを開くには、

Administration アクティビティセンターで、 [データゲートウェイ] に移動し、Direct Access gateway を検索します。
行の最後でをクリックし、[ログを表示] を選択します。

[ログビューア] ウィンドウが開きます。
左上のドロップダウンリストから、Qlik サポートが表示またはダウンロードするように依頼したログのタイプを選択します。

次のログを使用できます。
- Direct Access gateway のログ (DirectAccessAgent)
- DCaaS のログ (dcaas_logs)
- ODBC ベースのコネクタのログ (odbc-connector_logs)
- SAP BW コネクタのログ (QvSAPBwConnector-<date + timestamp>)
- SAP ODP コネクタのログ (QvSapConnectorPackage-<process_id>)
- SAP SQL コネクタのログ (QvSqlBwConnector-<date + timestamp>)
- コネクタエージェントのログ (connector-agent_logs_<date>)
隣接するドロップダウンリストから、表示またはダウンロードするログを選択します。ログファイルは、最新のファイル (現在アクティブのログファイル) から降順に並べ替えられます。ログファイルを選択した後、とボタンを使用してログファイルの最初または終わりに移動します。

ヒントメモログファイルのビューは、最新のメッセージで自動的に更新されません。ビューを更新するには、をクリックして、最新のメッセージで更新されたログファイルの最後まで移動します。
ログファイルをダウンロードするには、[ダウンロード] をクリックします。

ブラウザの設定により、ファイルがコンピュータにダウンロードされるか、保存するように促すメッセージが表示されます。

Direct Access gateway マシンで Direct Access gateway ログを開く

Direct Access gateway (DirectAccessAgent) のログは Administration アクティビティセンターからダウンロードできるだけでなく、Direct Access gateway マシンから直接開くこともできます。既定のインストールでは、これらのログの場所は次のとおりです。

C:\Program Files\Qlik\ConnectorAgent\data\logs

ログ詳細レベルの変更

Qlik サポート担当者から指示された場合にのみ、ログレベルを変更してください。

必要に応じて、Direct Access gateway (DirectAccessAgent) ログのログ詳細レベルを表示および変更できます。実行するには、ConnectorAgent サブフォルダー (既定のインストールの場合は C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent) から次のコマンドを実行します。

現在のログレベルを表示するには、次を実行します。

connectoragent configuration getloggers
ログレベルを Trace に設定するには、次を実行します。

connectoragent configuration setloggers -l Root -v DEBUG
ログレベルを Verbose に設定するには、次を実行します。

connectoragent configuration setloggers -l Root –v DETAILED_DEBUG

登録キーの更新

まれですが、登録キーが破損した場合や、データゲートウェイサーバーが不正にアクセスされたと思われる場合は、登録キーの変更が必要な場合があります。

登録キーを更新するには:

Direct Access ゲートウェイサーバーで、コマンドプロンプトを開いて、ConnectorAgent サブフォルダーの作業ディレクトリ (デフォルトインストールでは C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent) を変更します。
次のコマンドを実行します。
- 新規キーを生成します。
  
  connectoragent qcs generate_keys
- キーを表示します。
  
  connectoragent qcs get_registration
  
  キーが表示されます。
上の例のように、キー全体をコピーします。
Administration アクティビティセンターで、関連する行の終わりにある [] ボタンをクリックして、 [編集] を選択することにより、データゲートウェイ設定を開きます。
キーを [キー] フィールドに貼り付けて (現在のキーを置換する)、設定を保存します。
Direct Access ゲートウェイサーバーに戻り、「Qlik Data Gateway - 直接アクセスサービスの管理」の説明に従って Qlik Data Gateway - 直接アクセスサービスを再起動します。

リロードセッションの寿命を延長する

Direct Access gateway と Qlik Cloud の間の接続が 20 秒以上アイドル状態である場合、リロード操作が次のエラーで失敗することがあります。

Invalid object name '#<TempTableName>' (indicating that the Direct Access gateway temp tables are unavailable).

デフォルトのセッション存続期間は 20 秒ですが、このエラーが頻繁に発生する場合は、次のようにセッション存続期間を延長できます。

管理者として C:\ProgramData\Qlik\Gateway\configuration.properties を開きます。Windows エクスプローラーで実行する場合は、 [非表示のファイル、フォルダー、ドライブを表示する] が選択されていることを確認してください。
ODBC_RELOAD_SESSION_LIFE パラメータを見つけて、必要に応じてその値を増やします。
configuration.properties ファイルを保存し、Qlik Data Gateway - 直接アクセスサービスを再起動します。

ロードリクエストのタイムアウトを延長する

ネットワークの中断が発生すると、次のエラーでリロードが失敗する可能性があります。

Connector error: The session does not exist (DirectAccess-1509)

Connector error: The stream session expired for the load data request (DirectAccess-1012)

上記のエラーが頻繁に発生する場合は、EXTEND_FIRST_REQUEST_TIMEOUT パラメーターを 5 ～ 10 分に設定してみてください。

パラメーター値の測定単位は分です。

これを行うには、次の手順に従います。

管理者として C:\ProgramData\Qlik\Gateway\configuration.properties を開きます。Windows エクスプローラーで実行する場合は、 [非表示のファイル、フォルダー、ドライブを表示する] が選択されていることを確認してください。
EXTEND_FIRST_REQUEST_TIMEOUT パラメーターを見つけて、その値を 5 ～ 10 分に増やします。既定は「0」になっています。
configuration.properties ファイルを保存し、Qlik Data Gateway - 直接アクセスサービスを再起動します。

リロード中のコネクタのクラッシュを軽減する

プロセス分離により、ゲートウェイサーバーオペレーティングシステムに直接アクセスできる管理者は、コネクタタイプごとにリロードに使用できるプロセスの数を制御できます。リロードを複数のコネクタプロセスに分散すると、各コネクタプロセスで同時に実行されるリロードの数が減り、分離レベルが高まります。これにより、コネクタのクラッシュが発生した場合の Direct Access gateway 全体の安定性が向上します。

Direct Access gateway 1.6.1 以降が必要です。

プロセス分離をオフにする

Qlik サポートでは、トラブルシューティングの目的でプロセス分離をオフにするように依頼する場合があります。

クリーンインストールでは、プロセス分離は既定で有効になっています。各コネクタタイプの同時リロードの既定数は 9 です。以下の プロセス分離を有効にするか、同時リロードの数を変更する で説明されているように、既定を変更できます。

プロセス分離をオフにするには:

C:\ProgramData\Qlik\Gateway\configuration.properties ファイルを開きます。Windows エクスプローラーで実行する場合は、 [非表示のファイル、フォルダー、ドライブを表示する] が選択されていることを確認してください。
[[ODBC|SAPBW|SAPSQL|SAPPACKAGE]_PROCESS_ISOLATION_MODE] (すべての行の色分けの条件) を [None] (指定された行) に設定します。
configuration.properties ファイルを保存し、Qlik Data Gateway - 直接アクセスサービスを再起動します。

プロセス分離を有効にするか、同時リロードの数を変更する

プロセス分離を有効にする、または同時リロードの数を変更するには:

管理者として C:\ProgramData\Qlik\Gateway\configuration.properties を開きます。Windows エクスプローラーで実行する場合は、 [非表示のファイル、フォルダー、ドライブを表示する] が選択されていることを確認してください。

このファイルには、さまざまなコネクタタイプに対応する、ODBC_<property-name>、SAPBW_<property-name>、SAPSQL_<property-name>、SAPPACKAGE_<property-name> のプレフィックスが含まれています。
[ODBC|SAPBW|SAPSQL|SAPPACKAGE]_PROCESS_ISOLATION_MODE を Load に、[ODBC|SAPBW|SAPSQL|SAPPACKAGE]_MAX_PROCESS_COUNT を N に設定します。

説明:

N = 1 つのコマンドプロセス + 割り当てる同時リロードプロセスの数。例として、10 という値は、最大 9 回の同時リロードを意味します。
configuration.properties ファイルを保存し、Qlik Data Gateway - 直接アクセスサービスを再起動します。

ODBC コネクタのプロセス分離の例

次の configuration.properties ファイルの抜粋は、最大 12 回のリロードに対して ODBC コネクタのプロセス分離を有効にする方法を示しています。

ODBC_PROCESS_ISOLATION_MODE=Load

ODBC_MAX_PROCESS_COUNT=13

Direct Access gateway バージョン 1.6.7 以降では、他の設定を変更しなくても、MAX_PROCESS_COUNT 値が 10 を超えることができます。特定のコネクタタイプでのリロードを完全に分離するには (つまり、コネクタプロセスごとにリロードが 1 回だけになるようにするには)、この値を最小 30 に設定する必要がありますが、ワークロードによっては 60 まで設定する必要がある場合があります。

破損または欠落したデータチャンクを将来のリロードのために保存する

各リロード操作ごとに、Direct Access gateway は破損または欠落したデータチャンクをメモリに保存し、ディスクにオフロードできます。これは、自動リカバリを使用せず、4025、4020、4021 エラーが頻繁に発生する場合に特に役立ちます。この機能を有効にするには、破損または欠落したデータチャンクをディスクにオフロードするためのキャッシュサイズのしきい値を設定します (リロードごと)。指定されたしきい値に達すると、ゲートウェイは次の暗号化されたチャンクを Direct Access gateway マシンのディスクにオフロードします。

Direct Access gateway 1.6.8 以降が必要です。

キャッシュサイズを設定するには:

管理者として C:\ProgramData\Qlik\Gateway\configuration.properties を開きます。Windows エクスプローラーで実行する場合は、 [非表示のファイル、フォルダー、ドライブを表示する] が選択されていることを確認してください。
RELOAD_CACHE_MEMORY_MB を N に設定します (既定は 0 で、機能が有効になっていないことを意味します)。
説明:
N = データチャンクがリロードされる前に到達できるサイズ。
情報メモこの機能を有効にすると、Direct Access gateway マシンのメモリ消費量が増加するため、有効になっている間はメモリへの影響を監視することをお勧めします。ほとんどの状況では、RELOAD_CACHE_MEMORY_MB 値を 100 に設定すれば十分です。
configuration.properties ファイルを保存し、Qlik Data Gateway - 直接アクセスサービスを再起動します。

不要なファイルの蓄積によるパフォーマンスの低下を防ぐため、処理されたデータチャンクはマシンのメモリとディスクから削除されます。

このページは役に立ちましたか?

このページまたはコンテンツに、タイポ、ステップの省略、技術的エラーなどの問題が見つかった場合は、お知らせください。改善に役立たせていただきます。

こちらにフィードバックをお寄せください